Author: Doku
-
Guides
A WCAG 2.1 AA Checklist for Documentation Sites
Documentation sites fail accessibility in a small and predictable set of places. A working checklist of the WCAG 2.1 AA criteria docs actually trip on, the five failures we see most often,…
-
Writing
Writing Documentation That AI Assistants Cite Correctly
A growing share of documentation traffic never reaches a search results page. Here is how retrieval actually works, why the chunk rather than the page is the unit that matters, and the…
-
Migration
How to Migrate a GitBook Space to WordPress
A four-stage guide to moving documentation out of GitBook: getting the Markdown out via Git Sync, deciding your category structure before importing, running the import safely, and fixing links and redirects. Includes…
-
Tooling
Docs-as-Code or WordPress? How to Choose a Documentation Stack
Docs-as-code and a CMS both produce excellent documentation, and both produce abandoned documentation. The deciding question is not which is better but who is expected to edit. A side-by-side comparison, the costs…
-
Strategy
How to Structure a Documentation Site: A Practical Information Architecture Guide
Most documentation sites fail on structure, not on writing. Here is a practical method: how many top-level sections to use, how deep to nest, the four page types you actually need, and…
