Single-binary Go server that fetches markdown from Gitea (mc org),
renders to HTML with goldmark (GFM, chroma syntax highlighting,
heading anchors), and serves a navigable read-only documentation site.
Features:
- Boot fetch with retry, webhook refresh, 15-minute poll fallback
- In-memory cache with atomic per-repo swap
- chi router with htmx partial responses for SPA-like navigation
- HMAC-SHA256 webhook validation
- Responsive CSS, TOC generation, priority doc ordering
- $PORT env var support for MCP agent port assignment
33 tests across config, cache, render, and server packages.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Design specification for mcdoc: a public documentation server that
fetches markdown from Gitea, renders with goldmark, and serves via
mc-proxy. Cache-first architecture with webhook refresh. No auth,
no database, no local state beyond config.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>