Repository navigation
Conversation
Add an AGENTS.md section on HCL positioning and point the docs-review criteria, glow-up taxonomy, content-review lane, and blog known-issues taxonomy (new hcl-positioning category) at it, so reviews flag HCL gaps and the glow-up lane executes them. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RR4MzpSTovKZAqW9HVfd74
Name the second-tier phrasings the audit panel found, drop the two-tier wording from hcl-note, and file the hcl blog tag under languages instead of non-Pulumi tools. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RR4MzpSTovKZAqW9HVfd74
Collaborator
|
Your site preview for commit 2271fd6 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-22992-2271fd6e.s3-website.us-west-2.amazonaws.com |
Collaborator
Lighthouse Performance ReportCommit: 2271fd6 | Metric definitions
|
This branch was previously deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Requested by Cam · project thread
Proposed changes
Marketing wants HCL treated as a first-class Pulumi language, in the same tier as Python and TypeScript, and wants the docs pipeline to find and fix the places where it isn't. The August 2026 release already says it ("write programs in HCL as a first-class Pulumi language"), but none of the review machinery knew. This PR teaches it, so reviews flag the gaps and the glow-up lane executes them.
AGENTS.md: new HCL as a Pulumi language section, modeled on "AI and agent positioning". It covers naming (HCL vs. Pulumi HCL vs. Terraform HCL), using{{< pulumi-languages >}}for language lists,hclchooser tabs where Pulumi HCL supports the feature (never invented), dropping the "HCL is the enemy" and second-tier framing ("config languages like YAML and HCL", "a general-purpose language is the recommended destination", "real languages, not DSLs" next to a list that includes HCL), keeping staying in HCL as a migration path, neutral comparison pages, no ranking language, and{{% hcl-note %}}for older blog posts instead of rewriting them.docs-reviewcriteria:shared-criteria.mdgets an HCL criterion that applies to every review. HCL findings aredocs.mdadds HCL gaps to its pre-existing-issue scope, andblog.mdadds thehcl-notecheck.glow-up.md: HCL checks in the text analysis and the content-enhancement taxonomy, which the unattended glow-up lane's secondary sweep applies.review-existing-content: HCL gaps are listed among the findings the fix lane reports and banks, without applying them.hcl-positioningcategory in the taxonomy,validate-findings.py, and the findings schema.hcl-noteshortcode: drops "alongside general-purpose languages like…", which kept the two-tier framing, for "alongside TypeScript, Python, Go, C#, and Pulumi's other languages".data/blog_tags.yaml: moveshclfrom the non-Pulumiecosystemgroup tolanguages.What this doesn't change: the fix lane still applies only high-confidence fixes, and glow-up's bounds (no superlatives, 400 lines, protected frontmatter) are untouched. The sitewide language order in
pulumi-languages(HCL last) is left for a messaging decision.make test-review-pipelineandmake lintpass.Related issues (optional)
Brand guide counterpart: pulumi/marketing-web#387.
🤖 Generated with Claude Code
https://claude.ai/code/session_01RR4MzpSTovKZAqW9HVfd74