Skip to content

docs(integrations): cross-link old paths and signal deprecation (Phase 2)#1354

Draft
gavinelder wants to merge 1 commit intodocs/integrations-section-phase-1from
docs/integrations-section-phase-2
Draft

docs(integrations): cross-link old paths and signal deprecation (Phase 2)#1354
gavinelder wants to merge 1 commit intodocs/integrations-section-phase-1from
docs/integrations-section-phase-2

Conversation

@gavinelder
Copy link
Copy Markdown
Contributor

Summary

Phase 2 of the Platform Cloud Integrations migration. Stacked on top of #1353.

This PR makes the old paths self-aware: visitors to `/platform-cloud/credentials/`, `/platform-cloud/git/overview`, and IAM sections inside `compute-envs/` see a banner pointing them at the new integrations location, and internal callers across the rest of the docs point to the new URLs.

No content is removed yet — that's Phase 3.

What changed

  • 15 deprecation admonitions (`:::info This page has moved`) at the top of every legacy `credentials/*` and `git/overview.md` file
  • 7 `:::tip` "canonical reference moved" banners above the migrated IAM/permission sections in compute-env files:
    • `aws-batch.md`, `aws-cloud.md`, `eks.md`
    • `azure-batch.md`, `azure-cloud.md`
    • `google-cloud-batch.md`, `google-cloud.md`
  • 13 internal caller updates — `quickstart.md`, `getting-started/*`, `launch/launchpad.md`, `orgs-and-teams/workspace-management.md`, `compute-envs/{gke,k8s,hpc,aws-batch,eks,azure-batch}`, etc., now link to `/platform-cloud/integrations/...` (absolute paths so they survive future moves)

What's still left

  • Phase 3 — Strip duplicated IAM content from compute-envs, delete `credentials/`, `git/`, and `enterprise/advanced-topics/manual-*-batch-setup` files, remove `Credentials (legacy)` from sidebar, add redirects (`@docusaurus/plugin-client-redirects` decision needed)
  • Phase 4 — Editorial review pass on the new `integrations/` content

Stacked on

Test plan

  • `docusaurus build` passes with no broken links or anchors
  • Reviewer: visit any old page (e.g. `/platform-cloud/credentials/overview`) in the preview and confirm the deprecation admonition renders at the top
  • Reviewer: visit a compute-env page (e.g. `/platform-cloud/compute-envs/aws-batch`) and confirm the `:::tip` banner appears above the IAM section
  • Reviewer: spot-check that updated internal callers (e.g. Launchpad page) link to the new integrations URLs

🤖 Generated with Claude Code

…e 2)

Phase 2 of the Integrations migration:
- Adds :::info admonitions to all 14 platform-cloud/docs/credentials/*
  pages and platform-cloud/docs/git/overview.md, pointing readers to the
  new integrations/ location.
- Adds :::tip "canonical reference moved" banners above the migrated
  IAM/permission sections in 7 compute-envs/*.md files (aws-batch,
  aws-cloud, eks, azure-batch, azure-cloud, google-cloud-batch,
  google-cloud).
- Updates 13 internal callers in platform-cloud/docs/ to point at the
  new integrations/* URLs. Convert to absolute /platform-cloud/...
  paths so they survive future moves.

No content is removed in this phase. Old URLs continue to resolve.
Phase 3 will strip the duplicated content and delete legacy paths.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant