This library collects the documentation maintained across Fairy Fox's work: an overview of how the projects fit together, how this site itself is built, the shared engineering standards the repositories follow, and a documentation entry point for each project. Every project also keeps its own full documentation site — linked from its page.
Overview
This site
How fairyfox.io is built
The stack, the repository layout, and the three concerns that share one repo.
The system map
The four cooperating systems — website, updates, hub, and cross-project sync — and how they relate.
Build and deployment
How the site builds and deploys itself through GitHub Actions, with no manual publish step.
Updates and cross-project round-ups
How update posts are written, including the round-ups that report what changed across the projects.
Design decisions
The key structural choices behind the site and hub — and a few things deliberately not done.
Principles and voice
What the site and repository value — and the writing voice the whole site holds to.
Shared standards
Git workflow
Branch model, fast-forward merges, and the safety rules shared across repositories.
Versioning
Semantic Versioning with a single source of truth in a VERSION file.
The living-notes system
A structured notes/ tree that keeps each repository self-documenting.
Cross-project sync
How the hub and the projects share standards through git, without coupling.
AI context (CLAUDE.md)
A root entry-point file that orients an AI assistant opening a repository.
Documentation and house style
The documentation set each repository keeps, and the plain house style used to write it.
Project documentation
Project documentation sites
Each project is also published with its own full documentation site, served under this domain.