Skip to main content

Authoring

Route/authoring PlanAuthoring suiteauthoring

Authoring is the project version as documentation. Its surfaces share one shell — a scope header, a secondary navigation and a command palette — and split by job:

SurfaceJobNeeds
Authoring OverviewReadiness: one next action, signals, the setup checklist, the work queueauthoring
ScribeReference content: summaries, descriptions, examples; coverage; the READMEscribe
GuidesNarrative pages for a version: onboarding, authentication, migrationscribe
ChangelogReviewed release notes over each published revision's classified changesscribe
SlateThe portal: theme, navigation, blocks, preview, build, export, versions, domainslate
HostedReleases, Cache, Security, Edge, Insightshosted
Reference galleryEvery shared primitive in every state — a review aid, not a destinationany

Without any of these flags the shell shows Authoring is not enabled; with some but not the one a page needs, that page shows "Your plan does not include Surface. Ask a tenant admin to enable it." and a Current scope card. See Plans and entitlements.

The scope header​

Every authoring page works on one scope, chosen in the header and carried in the URL (projectId, versionId, env):

SelectorChoices
Project"Select project…"; "Loading projects…", "No projects available"
Version"Select version…" — disabled with "Select a project first"; each option is marked by its description or Published / Draft
EnvironmentPreview ("Draft content and preview deployments.") or Production ("The release currently serving production traffic.")

A scope is read-only when the environment is Production or the version is published: "This scope cannot be edited. Select a draft version or the preview environment." Author on a draft version in Preview. The last scope you used is remembered per tenant and offered on the Overview as Pick up where you left off.

Pages show their state as a badge — Offline, Conflict, No access, Read only, Unsaved changes, Saving, Loading, Saved — each with an explanation on hover.

The secondary navigation runs Overview · Scribe · Guides · Release notes · Slate · Releases · Cache · Security · Edge · Insights; a surface you are not entitled to stays in place, unlinked, and says so. Scribe and Slate add a product sidebar of their own pages.

Search or jump to… (Ctrl / ⌘+K) opens the command palette — "Search destinations, projects, versions and environments…" — which switches destination, project, version or environment in one step. The bare / key focuses the page's contextual search; the palette footer can switch that off.