docs: restructure Platform accounts, security, and billing IA - #25982
Open
akristen wants to merge 21 commits into
Open
docs: restructure Platform accounts, security, and billing IA#25982akristen wants to merge 21 commits into
akristen wants to merge 21 commits into
Conversation
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>
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>
✅ Deploy Preview for docsdocker ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
github-actions
Bot
added
area/hub
This was referenced Aug 31, 2026
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>
…nterprise-IA Keep the Platform IA paths while taking CODEOWNERS, Scout retirement, and Docker Pro upgrade copy from main. Co-authored-by: Cursor <cursoragent@cursor.com>
htmltest failed because /enterprise/security/access-tokens/ is now an alias without the #create-an-organization-access-token heading. Co-authored-by: Cursor <cursoragent@cursor.com>
akristen
marked this pull request as ready for review
September 2, 2026 12:43
akristen
requested review from
aevesdocker and
craig-osterhout
as code owners
September 2, 2026 12:43
akristen
enabled auto-merge (squash)
September 2, 2026 12:43
Contributor
Author
|
Follow-up landing-page work for this IA is in akristen#4 (\docs/accounts-admin-index-landings\ into \platform-enterprise-IA). |
* docs: fill empty Authentication, Access tokens, and Manage billing landings These section indexes used render: never, so the published URLs had no page. They now render as chooser landings with grids of child topics. Co-authored-by: Cursor <cursoragent@cursor.com> * docs: move billing portal walkthrough onto Manage billing The Subscription and billing parent was carrying the portal tutorial. That content now lives on Manage billing, the parent is a plans chooser, and #credits/#usage links point at the new page. Agentic Platform stays off the parent table and grids. Co-authored-by: Cursor <cursoragent@cursor.com> * docs: make Accounts a chooser and complete org and manage grids Account-type comparison belongs on the Accounts landing. Organization and Manage grids were missing Activity logs, Insights, Teams, Seats, and Licenses even though those pages already exist. Co-authored-by: Cursor <cursoragent@cursor.com> * docs: expand Plans and FAQs landings and complete the Manuals admin grid Plans was repeating Manage plans instead of helping readers choose. FAQs needed a short map of each collection. The Manuals Accounts and admin grid was missing Support and Release notes from the sidebar group. Co-authored-by: Cursor <cursoragent@cursor.com> * docs: drop duplicate account, token, and role recaps from child indexes Account types, OIDC versus OAT, and core versus custom roles each had a second copy after the parent landings took that job. Company keeps owner and seat rules and links up to the hierarchy diagram. Co-authored-by: Cursor <cursoragent@cursor.com> * docs: split the Security landing into administrator and developer grids The page was still titled Security for developers and omitted SSO, provisioning, roles, OATs, and OIDC even though those pages already live in this section. Co-authored-by: Cursor <cursoragent@cursor.com> * docs: add a conceptual overview to the Security landing The page was still framed for developers and split into three grids. Individual and organization sections plus one child grid match the rest of Accounts and admin. Co-authored-by: Cursor <cursoragent@cursor.com> * docs: add individual summary bars and point Security H2s at product pages The banner only appeared on enterprise admin docs, and the landing linked choosers instead of 2FA, PAT, SSO, OIDC, and OATs. Co-authored-by: Cursor <cursoragent@cursor.com> * docs: order organization Security setup as sign-in, join, then access SSO and provisioning come before automation credentials, and roles apply after members join. Co-authored-by: Cursor <cursoragent@cursor.com> * docs: promote Company to a top-level Accounts section Company lived under Organization, so the Accounts landing could not treat it as a sibling account type. A top-level section matches how owners switch between org and company. Co-authored-by: Cursor <cursoragent@cursor.com> --------- Co-authored-by: Cursor <cursoragent@cursor.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
To dos
- Evaluate _index pages and standardize across account + admins category- Edit weights of topicsSummary
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
Security
/security/, matching other Platform sections.main.Subscription and billing
FAQs
Navigation and follow-ups