Skip to content

Build Log — Overview

This section is the complete build log of the session that created these very docs. Recorded from the actual conversation: every question asked, every command run, every failure and fix, and — where valuable — the reasoning behind each decision.

A discussion about documentation-template platforms (Starlight, Astrogon, Docusaurus, Pure…) turned into a concrete build:

  • A public docs site (Astrogon template)
  • A private, login-gated docs site (Starlight)
  • Both running locally, both in Git repos on GitHub (one public, one private)
  • A full CI/CD pipeline (GitHub Actions → Cloudflare Pages)
  • And a genuine mystery along the way: the production URLs were serving someone else’s sites
Page What happened there
01 · Planning Evaluating Starlight & Astrogon, free hosting, the private-repo + CI/CD + Scrum idea
02 · Scaffolding Creating both projects, the npm install-scripts blocker, local verification
03 · GitHub Repos Repo creation, the master→main pipeline-killer, and its fix
04 · CI/CD Pipeline Workflows, two deploy failures and how they were fixed
05 · The Name-Collision Mystery Docusaurus on the public URL, a foreign Access gate on the private one — root cause and fix
06 · Current Status What’s live, what’s still manual, what’s next (including Scrum setup)
  • User ↔ assistant exchanges — real questions and answers, trimmed only where prose repeated itself
  • Tool calls — every significant command run, with key outputs (large dumps trimmed)
  • Decisions & why — condenses the reasoning: what was weighed, why the choice was made
  • Gotchas — the non-obvious pitfalls, so they never need rediscovering

Raw chain-of-thought. The assistant’s internal thinking process is not exported verbatim — it’s not stored as a copyable document, and it isn’t reproduced. Instead, every step carries a short Reasoning block: the decisions and trade-offs, reconstructed in readable form. That’s the part that’s actually useful to future readers anyway.

All commands were run on the author’s machine (Fedora Linux, hostname Zelus) during a single session on 2026-09-19.