tangly

Build, customize, and ship documentation sites with Tangly — a self-hosted, open-source documentation framework that renders Mintlify projects unmodified. Covers initializing a documentation project, validating with `tangly check`, authoring docs.json + MDX content, porting an existing Mintlify docs site via `tangly migrate`, and deploying static output to Vercel, Cloudflare, Netlify, or any CDN (including subpath hosting via --base). Apply when: working in a Tangly documentation repo; building, scaffolding, or editing a docs site; running any `tangly` CLI command (init, dev, build, preview, check, migrate, add, eject); editing docs.json or MDX frontmatter; migrating documentation from Mintlify or mint.json; deploying a documentation site to production. Trigger keywords: tangly, docs.json, mintlify, documentation site, docs framework, mdx docs, static docs.

Write effective technical documentation — READMEs, API references, guides, tutorials, runbooks, release notes. Applies Diátaxis to pick the right doc type (tutorial / how-to / reference / explanation), structures pages top-down, enforces active voice, grounds claims in runnable examples. Apply when writing or editing docs, reviewing a docs PR, or auditing for clarity.