Repository navigation
Restructure Infrastructure AI docs to the standard IA - #22261
Conversation
Group /docs/ai/ by page type (Get started, Concepts, Guides, Integrations, Reference) like the other docs sections. Neo pages move under concepts/neo/, integrations become a top-level group, the MCP server page splits into a setup guide and a tools reference, and the Neo settings page splits out instructions and slash commands. Every moved page keeps an alias for its old URL, and moved anchors redirect to their new pages. Refs #22252 Co-Authored-By: Claude Opus 5.5 <[email protected]>
Refs #22252 Co-Authored-By: Claude Opus 5.5 <[email protected]>
Sentinel — merge gate statusAll gates green — nothing is blocking this merge.
Evaluated at head Need help, or think a gate got it wrong? Ask in |
Lighthouse Performance ReportCommit: a0f9ecc | Metric definitions
|
Resolve the billing-managers.md conflict by keeping master's sentence-cased "billing manager" and this branch's updated Neo usage limits link. Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_01TCgHH2NDHANbz8V8F7BLey
CamSoper
left a comment
CamSoper
left a comment
There was a problem hiding this comment.
LGTM. Merged master in to clear the one conflict in billing-managers.md (kept master's lowercase "billing manager" plus your new usage limits link). Nothing else touched.
Generated by Claude Code
github-actions
Bot
added
review:triaging
github-actions
Bot
added
review:in-progress
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
There was a problem hiding this comment.
🔧 One-click fixes for findings that block merge — each matches a Do this block on the author card. Commit one and the card picks up the fix; you can still disagree on the card instead.
Generated by Claude Code
Reviewer's guide v2 — not for the authorTip Check the PR author: nothing here is yours. Your to-do list is the "Author action guide" comment. Review requested from: @pulumi/docs-guild, @pulumi/docs-marketing-review, @pulumi/docs-tools — an approval from anyone with write access satisfies the merge gate. Note What this PR changes:
The main risk in a restructure is a reader landing on a broken link or a statement that disagrees with another page in the same section. Link and alias checks, the frontmatter sweep, a Hugo build, claim verification, and a readthrough of the new pages all ran. Review confidence:
|
Author action guide v2 — nothing blocks mergeImportant You = the PR author. Answer every item below before this PR can merge. To answer: push a fix, or reply This PR moves the Infrastructure AI docs into the standard concepts / get-started / guides / reference / integrations layout. The review checked links, aliases, the build, and the factual claims on the moved and new pages. ✅ Resolved since last review10 resolved items — click to expand
Full evidence: verification trail, investigation log, review history. Review v2 · updated 2026-10-22T20:31:02Z · head commit a0f9ecc Please don't edit or delete this comment; it's the review's record. |
github-actions
Bot
added
review:outstanding-issues
…ated screenshot - F2: link MCP-created tasks to the Pulumi MCP server guide - F3: name the VCS identity exceptions (repo creation, GHES individual auth) - F4: drop the claim that permission mode has an org-level default - F6/F7: move bootstrapping subsection under Repository instructions; remove duplicate sentence - F62, F64/F65, F69: tighten overclaims on agent accounts, read-only mode, and the integrations page - Remove the outdated Neo access screenshot from the settings page Co-Authored-By: Claude Opus 5.5 <[email protected]>
github-actions
Bot
added
review:stale
Co-Authored-By: Claude Opus 5.5 <[email protected]>
|
/update-review Fixed in 5dd6e0e: F2 (MCP link now points to /docs/ai/guides/set-up-mcp-server/), F3 (VCS sentence now names the repo-creation and GHES individual-auth exceptions), F4 (deleted the sentence; the control inventory already states the approval-mode org default). Also fixed reviewer checks: F6 (bootstrapping subsection moved into Repository instructions), F7 (duplicate sentence removed), F62 (dropped "entirely"), F64/F65 (read-only now scoped to Pulumi Cloud changes), F69 (credential storage links to external-mcp-servers#credential-storage). Also removed the outdated Neo access screenshot from the settings page. Fixed in a0f9ecc: F8 (settings page now says the per-feature controls are on the General tab, below the master switch). |
github-actions
Bot
added
review:in-progress
Resolves the conflict in content/what-is/mcp-for-infrastructure-as-code.md: keeps this PR's new "Best MCP Servers" bullet and master's new /docs/ai/guides/set-up-mcp-server/ path from #22261. Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_01NPURfyqXfEzFYxMVhqSMfe
/docs/ai/mcp-server/ and /docs/ai/neo/integrations/mcp/ moved in #22261 and now only resolve through aliases. Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_01NPURfyqXfEzFYxMVhqSMfe
Closes #22252.
/docs/ai/was the one docs section organized by product (skills, CLI, MCP server, and 13 sibling Neo folders) instead of by page type. This PR groups it the way ESC, Deployments, and Discovery & governance are grouped: Get started, Concepts, Guides, Integrations, Reference. Neo-specific concepts sit underconcepts/neo/, so the bring-your-own-agent pages and the Neo pages sit side by side.New tree
Redirects and links
make serve, including legacy ones like/docs/neo/,/docs/ai/tasks/, and/docs/iac/guides/ai-integration/mcp-server/.#custom-instructions,#repository-instructions,#slash-commands, and their children, plus MCP server#toolsand#prompts./docs/ai/get-started/and/docs/ai/integrations/are now group index pages, and/docs/ai/integrations/slack/is now the Slack page itself.llms.txt, the agent-start layout, the glossary, and one S3 redirect target. Blog posts are left alone and rely on aliases.Not in this PR
🤖 Generated with Claude Code