Add cross-links between IaC testing, policy, and agentic explainers#20097
Add cross-links between IaC testing, policy, and agentic explainers#20097alexleventer wants to merge 1 commit into
Conversation
Connect three closely related pages that were barely linked to each other. Each link sits where the prose already makes the connection and a reader would want to follow it: the testing guide now points to the policy-as-code and IaC explainers; the agentic page links to the testing guide and policy explainer; the policy page links to the agentic and testing pages and adds the agentic explainer to its related-reading list. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
Your site preview for commit 7201a7d is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-20097-7201a7d9.s3-website.us-west-2.amazonaws.com |
Pre-merge Review — Last updated 2026-07-06T23:16:20ZTip Summary: This PR adds seven internal cross-links interconnecting three existing pages — the How to Test Infrastructure as Code blog post and the What is agentic infrastructure? / What is policy as code? explainers — including one new "Related reading" entry. It adds no new prose or factual claims; the only reader-facing risk is a broken link target, and all four distinct targets ( Review confidence:
Investigation log
🔍 Verification trail209 claims extracted · 183 verified · 10 unverifiable · 11 contradicted
|
continued from previous comment
|
📊 Editorial balanceSection depth, mention distribution, recommendation steering
🚨 Outstanding in this PRNo outstanding findings in this PR. This PR only adds internal cross-links; the contradicted/mismatch claims surfaced by the full-file scan all sit on lines this PR did not touch and are logged under 💡 Pre-existing.
|
Proposed changes
Three closely related pages — the How to Test Infrastructure as Code blog post, What Is Agentic Infrastructure?, and What Is Policy as Code? — cover overlapping ground but were barely linked to one another. A reader on any one of them had no easy path to the others.
This PR adds cross-links at the points where the prose already makes the connection, so each link is somewhere a reader would actually want to click through:
blog/how-to-test-infrastructure-as-code— links "policy as code" and "infrastructure as code" to their explainer pages at first mention (the post previously had no concept-explainer links).what-is/what-is-agentic-infrastructure— links "unit tests" to the testing guide, and the Policy as code governance heading to the policy explainer (alongside the existing Pulumi Policies docs link).what-is/what-is-policy-as-code— links the "AI agents write and modify infrastructure" passage to the agentic explainer, links "unit tests" to the testing guide, and adds What is agentic infrastructure? to the related-reading list.No prose was rewritten and no anchor text was forced — only existing phrases were turned into links. Net result: the three pages now reference each other bidirectionally and each ties back to the IaC concept hub.
Related issues (optional)
None.