Hub Docs Platform

Welcome to Innovation Hub Docs. This section explains how to use the published site, author and update content with the in-browser editor, and how reviews and publishing work.

Looking for platform engineering docs? Architecture, deployment runbooks, admin configuration, and the canonical engineering specification (ADRs, implementation plans, branching/pipelines, access-control, visibility) all live on this site under the Administration, Deployment, Integration, and Build Specification sections. All are gated to the Hub Docs - Web Admins group via access: admin.

Sections

Getting Started -- Sign in, find content, and make your first edit using the web editor.
Guides -- Authoring content, using the editor, importing Word docs, understanding access tiers, and the content review lifecycle.
Reference -- Frontmatter schema and the supported Markdown subset.
Administration -- (Web Admins only) Entra ID setup, environments, content governance internals.
Deployment -- (Web Admins only) Infrastructure, CI/CD pipelines, and deployment procedures.
Integration -- (Web Admins only) Azure DevOps Git API and Word ingestion internals.
Build Specification -- (Web Admins only) Authoritative platform spec, ADRs, implementation plans, access-control and visibility design.

Three ways to author content

Web editor (recommended for most authors) -- TipTap-based rich text editor with WYSIWYG parity. Save creates a pull request automatically.
Word upload -- Upload .docx files through the ingestion pipeline. Pandoc converts them to Markdown.
Git + Markdown -- Clone the repo, edit .md files locally, push via Git. Best for bulk edits and structural changes.

All documentation is stored as Markdown with YAML frontmatter in the content/docs/ directory of the repository -- Git is the single source of truth.