Skip to content

docs: restructure Platform accounts, security, and billing IA - #25982

Draft
akristen wants to merge 18 commits into
docker:mainfrom
akristen:platform-enterprise-IA
Draft

docs: restructure Platform accounts, security, and billing IA#25982
akristen wants to merge 18 commits into
docker:mainfrom
akristen:platform-enterprise-IA

Conversation

@akristen

@akristen akristen commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

To dos

  • Evaluate _index pages and standardize across account + admins category
  • Freshness sweep on FAQ section
  • Edit weights of topics
  • Notify TSEs, other stakeholders
  • TW sign off

Summary

This PR restructures the Platform documentation into a clearer Accounts, Security, and Subscription and billing information architecture, with aliases so existing URLs keep working.

Work from these PRs was merged into this feature branch:

Accounts

  • Moves organization, company, and admin content under Accounts.
  • Splits individual-account docs into their own subsection.
  • Removes the standalone Admin section; those pages now live under Accounts.

Security

  • Publishes Security at /security/, matching other Platform sections.
  • Groups authentication (SSO, 2FA, OIDC), access tokens, provisioning, and roles under Security.
  • Leaves Enterprise Hardened Desktop and related enterprise security docs under Enterprise.
  • Restores shipped Hardened Desktop and security FAQ URLs so they match main.

Subscription and billing

  • Merges Subscription and Billing into a single Subscription and billing section.
  • Drops the extra subcategory wrappers and nests billing tasks under Manage.
  • Shortens the billing details sidebar label.

FAQs

  • Consolidates Platform FAQs onto four pages: Accounts, Security, Subscription and billing, and Platform.
  • Folds leftover general, container, and network/VM security FAQs into Platform FAQs.
  • Folds SSO enforcement FAQs into the SSO FAQ.
  • Templates FAQ pages with H2 topics and H3 questions, and limits the table of contents to H2.

Navigation and follow-ups

  • Renames the manuals sidebar group from Platform to Accounts and admin, and updates the manuals landing heading and copy to match.
  • Fixes the MSI install Settings Management link after the security path move.
  • Updates CODEOWNERS, the labeler, and in-repo links to the new paths.

akristen and others added 16 commits August 31, 2026 10:11
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
… sections

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Drop the Subscription and Billing subcategory wrappers, merge those landings onto the parent, and move billing docs under Manage. Keep shipped main aliases; do not alias branch-only nested URLs.

Co-authored-by: Cursor <cursoragent@cursor.com>
Undo the HDD promotion to /enterprise/hardened-desktop/ and the lift of Container, Network and VM, and General security FAQs into /faqs/. Shipped URLs again match main: HDD under /enterprise/security/hardened-desktop/, FAQs under /security/faqs/.

Co-authored-by: Cursor <cursoragent@cursor.com>
…ploy

Co-authored-by: Cursor <cursoragent@cursor.com>
Platform FAQs were split across Accounts, Organizations, Companies, SSO, Domain, and nested billing pages. Merge them into one page per Platform category so the sidebar matches the IA.

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Leftover Security FAQ pages had no home after Accounts/Security/billing consolidation. Merge them into /faqs/platform/ and alias the old URLs.

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Match the manuals landing heading, shorten the billing details sidebar label, and fix the MSI Settings Management link after the security path move.

Co-authored-by: Cursor <cursoragent@cursor.com>
@netlify

netlify Bot commented Aug 31, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 9ce82d3
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a95e6677ac8f30008b7d425
😎 Deploy Preview https://deploy-preview-25982--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions Bot added area/hub Issue affects Docker Hub area/desktop Issue affects a desktop edition of Docker. E.g docker for mac area/security area/subscription Relates to Docker pricing and subscription area/extensions Relates to Docker Extensions area/api Relates to Docker API docs area/release Relates to CI or deployment area/admin Relates to Docker Admin area/scout Relates to Docker Scout area/billing area/accounts Relates to Docker accounts area/build-cloud area/guides labels Aug 31, 2026
akristen and others added 2 commits August 31, 2026 15:31
FAQ headings cannot contain a period, and two SCIM pages both aliased /platform/security/provisioning/scim/, which made Hugo panic on duplicate paths.

Co-authored-by: Cursor <cursoragent@cursor.com>
The relative manage.md fragment did not resolve after billing flatten, so htmltest failed on a missing #upgrade-plans hash.

Co-authored-by: Cursor <cursoragent@cursor.com>
@akristen akristen self-assigned this Aug 31, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/accounts Relates to Docker accounts area/admin Relates to Docker Admin area/ai area/api Relates to Docker API docs area/billing area/build-cloud area/desktop Issue affects a desktop edition of Docker. E.g docker for mac area/dhi area/extensions Relates to Docker Extensions area/guides area/hub Issue affects Docker Hub area/offload area/release Relates to CI or deployment area/scout Relates to Docker Scout area/security area/subscription Relates to Docker pricing and subscription

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant