Skip to content
Uncalled Innovators Docs

Overview

Overview

Section titled “Overview”

Uncalled Innovators needs a documentation system that is easy to write in, easy to review, and safe to ship. The recommended architecture is:

  1. Write in Notion.
  2. Convert approved pages to MDX with a repo-owned sync script.
  3. Commit generated content into this repository.
  4. Review the content in GitHub.
  5. Deploy the Starlight site from main.

This keeps content publishing deterministic. The live site is always backed by versioned files in git, not a dynamic fetch from Notion at runtime.

Why this structure works

Section titled “Why this structure works”
  • Writers stay in Notion, where editing is fast.
  • Engineering keeps control over URLs, frontmatter, link rewriting, and assets.
  • CI can build the exact docs payload that will go live.
  • Rollbacks are simple because every published page is represented in git history.

Key design rule

Section titled “Key design rule”

Notion is the authoring source. The repository is the publishing source.

That distinction keeps the pipeline debuggable and makes the Starlight app stable even when Notion content changes shape.