Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix: Enable control of docs by provider authors #1024

Merged
merged 1 commit into from
Apr 21, 2023

Conversation

AaronFriel
Copy link
Contributor

This enables the Docker provider to explicitly embed {{% examples %}} after introductory text, unblocking:

This fix addresses this issue:

All of these might be fixed by a change to Docker that added introductory text above examples, but as observed in pulumi/pulumi-docker#600, it's not currently possible to render text outside of an examples block.

This change to docs rendering allows us to explicitly add the examples shortcode block in the input docs, and pass-through tfgen rendering entirely.

This enables the Docker provider to explicitly embed `{{% examples %}}` after
introductory text, unblocking:
- pulumi/pulumi-docker#592
- pulumi/pulumi-docker#588

This fix addresses this issue:
- pulumi/pulumi-docker#600

All of these might be fixed by a change to Docker that added introductory text
above examples, but as observed in pulumi/pulumi-docker#600, it's not currently
possible to render text outside of an examples block.

This change to docs rendering allows us to explicitly add the examples shortcode
block in the input docs, and pass-through tfgen rendering entirely.
Copy link
Member

@t0yv0 t0yv0 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Test would be nice but currently testing this area is ~1d of effort :) LGTM.

@github-actions
Copy link

Diff for pulumi-azuread with merge commit 4eb02ce

@github-actions
Copy link

Diff for pulumi-random with merge commit 4eb02ce

@github-actions
Copy link

Diff for pulumi-gcp with merge commit 4eb02ce

@github-actions
Copy link

Diff for pulumi-azure with merge commit 4eb02ce

@AaronFriel AaronFriel merged commit 1eff241 into master Apr 21, 2023
@AaronFriel AaronFriel deleted the friel/full-control-examples branch April 21, 2023 23:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants