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

changes to docs for 0.3, first draft #447

Merged
merged 4 commits into from
Apr 11, 2024
Merged

changes to docs for 0.3, first draft #447

merged 4 commits into from
Apr 11, 2024

Conversation

lbialy
Copy link
Collaborator

@lbialy lbialy commented Apr 10, 2024

  • better explanation of resource constructor syntax
  • better explanation of Output/Input dynamics, how they work
  • draft of explanation of how to structure besom programs, I think we should expand upon this

@lbialy lbialy requested a review from pawelprazak April 10, 2024 09:54
Copy link
Contributor

@pawelprazak pawelprazak left a comment

Choose a reason for hiding this comment

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

Thank you, got one suggestion.

</TabItem>
</Tabs>

There is a way to inform Pulumi engine that some of the resources have to be created, updated or deleted
Copy link
Contributor

Choose a reason for hiding this comment

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

It would be worth noting that "depends on" is needed only when Pulumi cannot infer the sequence from output dependency graph

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

yes, this is exactly what I had in mind here:

draft of explanation of how to structure besom programs, I think we should expand upon this

but it feels like a big topic and I'm thinking about a best practices section to distill what happens if you do stuff what way there and explain it a bit more

Copy link
Contributor

@pawelprazak pawelprazak Apr 10, 2024

Choose a reason for hiding this comment

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

I'd add a word explicitly before inform.

And add a short remark that Pulumi tries to infer sequence from dependency graph.

@lbialy lbialy force-pushed the explain-opts-in-docs branch from 67b1de4 to a8bf7e3 Compare April 10, 2024 13:19
@lbialy lbialy merged commit 08708e6 into main Apr 11, 2024
3 checks passed
@lbialy lbialy deleted the explain-opts-in-docs branch April 11, 2024 11:24
polkx pushed a commit that referenced this pull request Apr 18, 2024
* changes to docs for 0.3.x
* updated changelog for 0.3.0
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.

2 participants