Skip to content

Add Administration docs group (DEL-32733)#264

Open
petemomo wants to merge 1 commit into
mainfrom
del-32733-administration-docs
Open

Add Administration docs group (DEL-32733)#264
petemomo wants to merge 1 commit into
mainfrom
del-32733-administration-docs

Conversation

@petemomo

Copy link
Copy Markdown
Collaborator

What

Adds a new top-level Administration navigation group to the docs, covering 13 pages that document the self-serve portal.

Ticket: https://speechmatics.atlassian.net/browse/DEL-32733

Structure

Administration is a navigation-group label only (no landing page), placed between Deployments and Developer Resources:

  • Accounts
  • Workspaces (sub-group): Workspaces concepts · Manage members · Domain verification · Single sign-on (SSO)
  • Projects · API keys · Management tokens
  • Billing · Plans · Usage
  • Regions · Security and compliance

All 13 pages live flat in docs/administration/ (URLs /administration/<page>); the Workspaces grouping is expressed in sidebar.ts only and does not change URLs.

Notes for reviewers

  • Pages were validated against the project style guide, terminology, and product architecture.
  • Intra-group and cross-section links were normalized to site-relative paths (e.g. /administration/projects, /api-ref/management/create-an-api-key) so they are covered by the broken-link check (onBrokenLinks: "throw").
  • npm run build passes with no broken links; cspell and biome are clean.
  • A few figures (Pro 6,000 h/mo cap, 20%/33% discounts, region availability) should get a final product check before publishing.

🤖 Generated with Claude Code

Add a new top-level Administration navigation group covering 13 portal
administration pages: accounts, workspaces, members, domain verification,
SSO, projects, API keys, management tokens, usage, plans, billing, regions,
and security & compliance.

- New docs/administration/ section with a nested Workspaces sub-group
- Registered between Deployments and Developer Resources in sidebars.ts
- Internal links use site-relative paths; production build passes broken-link validation

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 23, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Jun 23, 2026 9:24am

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant