content(iac): consolidate day-2 docs under IaC Operations (#16045)#19382
content(iac): consolidate day-2 docs under IaC Operations (#16045)#19382jkodroff wants to merge 3 commits into
Conversation
Paused pending CI/CD page cleanup landing first; do not merge as-is.
Adds a new top-level `Operations` section under `iac/` to consolidate
day-2 operational content that was scattered across `iac/guides/basics/`,
`iac/guides/continuous-delivery/`, and `support/troubleshooting/`. See
Why this is WIP
---------------
The CI/CD pages (`iac/operations/continuous-delivery/`) are a mess and
need their own cleanup pass before this lands. That cleanup is being
done on a separate branch and will merge first; this branch should be
rebased on master afterward and the CI/CD content re-evaluated against
the new structure.
Structure
---------
content/docs/iac/operations/
├── _index.md (new landing)
├── iac-least-privileges/ ← from guides/basics/
├── stack-management/
│ ├── _index.md (new)
│ ├── targeted-updates.md ← from guides/basics/
│ ├── update-plans.md ← from guides/basics/
│ └── editing-state-files.md ← from support/troubleshooting/
├── continuous-delivery/ ← from guides/continuous-delivery/ (17 files; slug preserved)
└── troubleshooting/ ← from support/troubleshooting/, common-issues/ flattened
├── _index.md (cards rewritten)
├── ci-cd.md
└── 7 ex-common-issues pages
Adjacent changes
----------------
- `support/troubleshooting/using-dev-builds.md` → `support/debugging/`
(so `support/troubleshooting/` disappears cleanly).
- `support/_index.md` Troubleshooting card now links to `iac/operations/troubleshooting/`.
- `iac/_index.md` gets a new Operations card section; Continuous Delivery dropped from Guides.
- `guides/basics/_index.md` drops moved pages, adds a cross-link to Operations.
- `layouts/page/superpowers.html` and `layouts/product/github-actions.html`
`relref` paths updated to the new continuous-delivery location.
- `Operations` declared via `iac/operations/_index.md` frontmatter (parent `iac-home`,
weight 25), not via `config/_default/menus.yml` — matches how Concepts is wired.
Aliases
-------
Every moved page has an alias to its old URL. Verified by inspecting
generated redirects in `public/` after `make build`. Spot-checked URLs:
old `/docs/iac/guides/basics/...`, `/docs/iac/guides/continuous-delivery/...`,
`/docs/support/troubleshooting/...`, and `/docs/support/troubleshooting/common-issues/...`
all redirect to the new canonical paths.
A bulk sed for internal-link rewrites over-reached and rewrote aliases
on 5 non-moved files (support/debugging/_index, 4 integrations pages
under integrations/version-control/ and integrations/clouds/kubernetes/
that historically lived under /docs/iac/guides/continuous-delivery/X/).
Those were manually reverted; their original old-URL aliases are
preserved.
Ambiguity decisions made interactively
--------------------------------------
- `iac-least-privileges` placed directly under `operations/`, not under
`operations/stack-management/`.
- `support/troubleshooting/using-dev-builds.md` kept under `support/`
(moved to `support/debugging/`); it's installation guidance, not
troubleshooting.
- `common-issues/` subdirectory flattened into `operations/troubleshooting/`
(matches the issue's proposed tree literally; new URLs are
`/docs/iac/operations/troubleshooting/<page>/`).
- CI/CD directory slug kept as `continuous-delivery/` (issue suggested
`ci-cd-pipelines/` but preserving the slug shrinks the alias surface
and avoids a second URL change later).
Build / lint state at WIP point
-------------------------------
- `make build` clean (no errors, no REF_NOT_FOUND).
- `make lint` clean (1760 files, 0 errors).
- 32 file renames, 54 modifications, 2 new files, 1 deletion = 89 changes.
Follow-ups when picking this back up
------------------------------------
- Rebase on master after the CI/CD cleanup branch merges; resolve
conflicts in `iac/operations/continuous-delivery/` against the
cleaned-up versions.
- Re-evaluate the `operations/troubleshooting/_index.md` cards —
current version was rewritten from scratch and may benefit from a
pass after the CI/CD work clarifies how the CI/CD troubleshooting
card should read.
- Decide whether `iac-least-privileges/` should stay flat under
`operations/` or be folded into a "security" sub-section if more
security pages move in.
- The `update-plans.md` frontmatter still has `concepts.weight: 11`
in its menu block (carried over from before #19016 was reverted) —
decide whether to keep or strip.
- Consider whether to also move `concepts/state-and-backends.md` into
Operations; it's adjacent to editing-state-files but it's concept-y.
- The issue (#19022) lists `refresh-strategies` as a future
stack-management page; not in scope here.
🤖 Generated with Claude Code (Opus 4.7).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Follow-up to the Operations section introduced in #19022: - Move debugging under iac/operations/, splitting debugging-providers out to the providers section where authoring-focused content belongs. - Move using-a-diy-backend under iac/operations/stack-management/. - Rewrite the Support & Troubleshooting overview to point readers to Operations for day-2 workflows and keep Support for FAQs and support channels. - Add Getting Support page covering community channels and paid support options (fixes #16045). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
github-actions
Bot
added
the
review:triaging
github-actions
Bot
added
domain:docs
|
Your site preview for commit d77aa2b is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-19382-d77aa2bb.s3-website.us-west-2.amazonaws.com |
Lighthouse Performance ReportCommit: d77aa2b | Metric definitions
|
Pre-merge Review — Last updated 2026-05-24T00:00:00ZTip Summary: This PR consolidates day-2 docs under a new Review confidence:
Investigation log
🔍 Verification trail238 claims extracted · 159 verified · 19 unverifiable · 26 contradicted
🚨 Outstanding in this PRNo outstanding findings — all previously flagged items resolved.
|
github-actions
Bot
added
review:outstanding-issues
The migration guides linked to /docs/iac/operations/continuous-delivery/github-app/, which doesn't exist — the GitHub App page lives at /docs/integrations/version-control/github-app/. Also corrects the GitHub Actions caching anchor in insights/policy/ci-cd.md to match the actual heading (#speed-up-runs-with-caching). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
github-actions
Bot
added
review:stale
|
@claude #update-review |
github-actions
Bot
added
review:in-progress
|
🤖 Review updated on @jkodroff's request. |
github-actions
Bot
added
review:no-blockers
2 participants
Follow-up to the Operations section introduced earlier on this branch. Pulls scattered day-2 content into
iac/operations/, reframes the Support section as FAQs + support channels, and adds a Getting Support page that spells out community vs. paid options.Changes
/docs/support/debugging/→/docs/iac/operations/debugging/(splitdebugging-providersback into the providers guide).using-a-diy-backend→/docs/iac/operations/stack-management/./docs/support/getting-support/covering Community Slack, GitHub issues, and paid support channels.Fixes #16045
Fixes #19022