Enhance policy documentation by adding description of policy as code #16645
Conversation
This comment was marked as resolved.
This comment was marked as resolved.
|
Your site preview for commit 446a847 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-16645-446a8478.s3-website.us-west-2.amazonaws.com. |
This comment was marked as resolved.
This comment was marked as resolved.
This comment was marked as resolved.
This comment was marked as resolved.
- Restructure sentence for better flow and readability - Reformat benefits section as bulleted list for improved scannability - Maintain 'Pulumi Policies brings' as singular per product naming Co-authored-by: Cam Soper <CamSoper@users.noreply.github.com>
|
Your site preview for commit c62566a is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-16645-c62566ad.s3-website.us-west-2.amazonaws.com. |
|
Your site preview for commit 4563a2a is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-16645-4563a2a0.s3-website.us-west-2.amazonaws.com. |
|
Your site preview for commit c0a61c0 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-16645-c0a61c0f.s3-website.us-west-2.amazonaws.com. |
|
I added a revision to Policies so it isn't so abrupt to go from Policies to Policy as Code while keeping the same context. FYI @arunkumar611 |
Co-authored-by: Sara <100384099+SaraDPH@users.noreply.github.com>
|
Your site preview for commit fac0910 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-16645-fac0910c.s3-website.us-west-2.amazonaws.com. |
Proposed changes
Added a section on "Policy as code" to the policy documentation, outlining its definition and key benefits, including cost control, compliance and security, early validation, best practices as code, and integration with cloud-native tools.
I also included a small change to the style guide, mostly for Claude's benefit.
Related issues (optional)
Fixes #16609