Rename Insights Discovery / Insights Accounts terminology to Discovery / Cloud Accounts - #20528
Rename Insights Discovery / Insights Accounts terminology to Discovery / Cloud Accounts#20528CamSoper wants to merge 1 commit into
Conversation
Adopt the agreed naming for the Discovery feature ahead of the broader naming cleanup: - "Pulumi Insights Discovery" / "Insights Discovery" -> "Discovery" - "Insights account(s)" -> "cloud account(s)" - "Insights & Governance" section label -> "Discovery & Governance" (docs nav, header/footer nav, homepage, pricing, product page) Terminology and labels only: no URLs, filenames, menu keys, or aliases change. API scope identifiers (insights_account:*), the auto-generated CLI docs, the OpenAPI tag intro, blog history, and standalone "Pulumi Insights" brand mentions are intentionally left as-is. Also fixes a few adjacent issues surfaced while renaming: two links that pointed at the legacy /docs/insights/accounts/ alias, the mislabeled "Insights discovery overview" links on the cloud integration pages, and wrong image alt text on the Resource Explorer get-started page. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KhVcxmBo96dQZH7fnDgq1f
Lighthouse Performance ReportCommit: 3b54cfa | Metric definitions
|
Pre-merge Review — Last updated 2026-07-28T00:03:04ZTip Summary: This is a repository-wide terminology rename across docs, marketing, nav, and data files (+180/-180 over 44 files): "Insights Discovery" → "Discovery", "Insights Accounts" → "Cloud Accounts", and the "Insights & Governance" section label → "Discovery & Governance". Every edit is prose, frontmatter, or nav-label text — no code, no structural moves. The kind of wrongness that would hurt a reader here is an incomplete rename (some references updated while siblings keep the old term) or an internal link broken by the change; the review therefore leaned on cross-sibling consistency and link/frontmatter checks. External claim verification (215 claims), a cross-sibling read of the RBAC-scopes and insights directories, a frontmatter/alias sweep, and style linting all ran. Note: many claims were flagged "contradicted" purely because the verification step compared the PR's new wording against the still-live production pages, which haven't been updated yet — the expected signal for a not-yet-merged rename, not a defect. After triage, nothing in this PR blocks merge; the only substantive findings (a possibly-broken REST-API link and two alias collisions) are pre-existing on lines this PR doesn't touch. Review confidence:
Investigation log
🔍 Verification trail215 claims extracted · 194 verified · 4 unverifiable · 8 contradicted
|
continued from previous comment
|
🚨 Outstanding in this PRNo outstanding blockers. Every contradiction flag was triaged as an artifact of comparing new wording against the not-yet-updated live site (see 📋 Triaged verifier findings), and the substantive link/alias issues are pre-existing (see 💡 Pre-existing).
|
Proposed changes
Implements the naming decision from this Slack thread (Tatiana, signed off by Dylan, Cam, and Alex): start using the language we want to land at for the Discovery feature, ahead of the broader naming cleanup.
Renames applied (44 files, terminology and labels only):
data/docs_menu_sections.yml, flows to/llms.txtand/docs/llm-sitemap.json), header nav, footer, docs landing card, homepage, pricing, and/product/insights-governance/page copytitle_tags rebranded from... | Pulumi Insightsto... | Discovery & Governance, and"Pulumi Insights:"H1 prefixes dropped, matching the pattern the Policies subtree already usesDeliberately unchanged (so reviewers can veto scope choices cheaply):
/docs/insights/...paths stay; the section-directory rename belongs to the future broader cleanup, so no redirects are needed hereinsights_account:*,insights_scan) — product API stringscontent/docs/iac/cli/commands/*— auto-generated frompulumi/pulumi; the ~42 "Insights account" mentions there (and thepulumi insights accountcommand itself) need an upstream changeassets/openapi/tag-intros/insights-accounts.md(tied to the OpenAPI tag name), standalone "Pulumi Insights" brand mentions (glossary term, schema.org entities, pricing SKU copy), blog posts, events, releases, and customer quotes (the Modivcare quote in what-is-policy-as-code keeps its original wording)Small adjacent fixes made while renaming:
/docs/insights/accounts/alias instead of the canonical/docs/insights/discovery/accounts/(visual-import, policy-groups)Insights Account Discovery Scan) on two Resource Explorer screenshotsVerification:
lint-markdownpasses (0 errors, 1828 files), Prettier clean on all changed files, full Hugo production build succeeds with 0 errors, and rendered output spot-checked: left nav /llms.txt/ llm-sitemap show "Discovery & Governance", the accounts page renders "Create and Manage Cloud Accounts", homepage/pricing/product pages show the new label with zero stale occurrences.git diff --name-statusconfirms zero renames.Unreleased product version (optional)
N/A
Related issues (optional)
Naming decision: Slack thread in #C0737NLJCJ3
Generated by Claude Code