Skip to content

docs: unify Accounts and Admin under /accounts/ - #25960

Closed
akristen wants to merge 3 commits into
docker:mainfrom
akristen:accounts-admin-migration
Closed

docs: unify Accounts and Admin under /accounts/#25960
akristen wants to merge 3 commits into
docker:mainfrom
akristen:accounts-admin-migration

Conversation

@akristen

@akristen akristen commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

Summary

Merges the Accounts and Administration sections into a single Accounts tree (individual accounts under /accounts/individual/, organization admin under /accounts/organization/), folds the organization overview into the section landings, and moves account FAQs into a top-level Platform FAQs section between Security and Support. Old URLs are preserved with aliases.

Related work: #25957

akristen and others added 3 commits August 27, 2026 16:06
Accounts and Administration were separate Platform sections. Nest individual account docs under /accounts/individual/ and move organization admin docs under /accounts/organization/, preserving old URLs with aliases.

Co-authored-by: Cursor <cursoragent@cursor.com>
Move account, organization, and company FAQs out of the Accounts tree into a top-level FAQs section between Security and Support.

Co-authored-by: Cursor <cursoragent@cursor.com>
Retarget in-repo links and labeler paths so they point at the new Accounts, Organization, and FAQs URLs.

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

netlify Bot commented Aug 27, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit fc83f53
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a90a7947c4b2900086d2c16
😎 Deploy Preview https://deploy-preview-25960--docsdocker.netlify.app/accounts/
📱 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/release Relates to CI or deployment area/admin Relates to Docker Admin area/billing area/accounts Relates to Docker accounts area/build-cloud area/guides area/ai area/dhi area/offload labels Aug 27, 2026
@akristen

Copy link
Copy Markdown
Contributor Author

This work has been merged into the combined feature branch and continues in #25982. Closing this PR in favor of that one.

@akristen akristen closed this Aug 31, 2026
akristen added a commit that referenced this pull request Sep 3, 2026
# To dos

~- Evaluate _index pages and standardize across account + admins
category~
~- 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:

- #25957 (Security IA)
- #25960 (Accounts and Admin)
- #25981 (Subscription and billing)

### 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.

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
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/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/security area/subscription Relates to Docker pricing and subscription

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant