Two-Site Docs Model
Giant Realms uses two documentation surfaces:
wiki.giantrealms.comis the internal developer wiki.docs.giantrealms.comis the public documentation site.
Both sites are Starlight applications backed by MDX files in git. The intended CMS layer edits those MDX files directly so git remains the source of truth and version history.
Internal Wiki
Section titled “Internal Wiki”The wiki is for draftable, fast-changing, and developer-facing knowledge:
- architecture notes
- implementation plans
- runbooks
- HiTL operating notes
- technical research
- draft canon and systems thinking
The wiki can move quickly and stay internal.
Public Docs
Section titled “Public Docs”The public docs site is for polished documentation:
- stable guides
- public architecture summaries
- product-facing explanations
- reviewed operational docs safe for external use
Public docs should only receive reviewed content.
Promotion
Section titled “Promotion”Promotion from wiki to public docs should create or update public MDX files through the git-backed CMS workflow. Internal wiki pages are not exposed directly as public docs.