diataxis

Writing the Docs: 2026 Editionwrla.ch

The post revisits core documentation principles—separating what from how, grounding reference docs in source truth, and continuously improving—and examines how large language models fit into this workflow. It argues that diataxis still guides effective docs and that LLM‑generated drafts must be anchored to machine‑readable ground truth to avoid hallucination.