Uncalled Innovators Docs

This site is designed to publish reviewed documentation from Notion into a versioned Astro and Starlight codebase. The repo is the publishing source of truth. Notion remains the writing surface.

Structured for review

Content lands in pull requests before it reaches production. Every update is inspectable, testable, and reversible.

Built for operations

GitHub Actions handles sync, validation, previews, and deployment without hiding the transformation logic inside workflow YAML.

Ready for richer docs

MDX gives the team room for callouts, custom components, richer diagrams, and stronger information architecture over time.

Publishing principle

The content pipeline is intentionally split:

• Notion handles writing and lightweight editorial collaboration.
• The repository handles generated MDX, review history, and deployment.
• Starlight handles navigation, search, and a durable docs experience.

What comes next

The next implementation layer is the sync script that pulls approved Notion pages, rewrites links and assets, and writes deterministic MDX into src/content/docs.