Documentation
This section is the human-readable counterpart to the machine-readable
/.well-known/api-catalog and
/llms.txt endpoints. It describes how the site is built,
what data it depends on, and how to contribute.
Pages
- Architecture - system overview, build flow, rendering model, and where to change things.
- Content Model - front-matter and data contracts for posts, books, data files, and top-level pages.
- Development - local setup, validation commands, content update workflow, and Python maintenance scripts.
Agent-Readable Endpoints
For automated consumption, the site exposes several machine-readable endpoints.
These are also advertised via RFC 8288 <link> elements on every page and via
an RFC 9727 api-catalog Linkset.
| Endpoint | Purpose | Content Type |
|---|---|---|
/.well-known/api-catalog |
RFC 9727 catalog of all machine-readable endpoints | application/linkset+json |
/llms.txt |
Short site summary for LLM ingestion | text/plain |
/llms-full.txt |
Full site content for LLM ingestion | text/plain |
/search.json |
Search index (posts and books) | application/json |
/feed.xml |
Blog RSS 2.0 feed | application/rss+xml |
/sitemap.xml |
Sitemaps 0.9 | application/xml |
/sitemapindex.xml |
Sitemap index | application/xml |
/robots.txt |
Crawler policy with AI content signals | text/plain |