Practical approaches to technical writing, docs-as-code, structured authoring, and AI-assisted documentation.
AI Assistant
Have a question about technical writing, DITA, Markdown, docs-as-code, or AI-assisted documentation? For comprehensive step-by-step guides, visit our companion Documentation Manual ↗.
Blog
Most of a small organization’s website barely changes. This is an argument for building the smallest editing interface it actually needs, using Astro, Git, YAML, and a small admin layer instead of a full CMS.
A GUI hides complex code behind menus and drag handles you operate by hand. AI hides the same complexity behind a conversation. Recreating a hand-built InDesign leaflet as a YAML-to-LaTeX pipeline: abandoned in 2025 as beyond the time I could afford: is what made the difference concrete.
DITA XML can shrink the volume a technical writer creates, translates, and maintains: and a firewall vendor once got its documentation praised by the press because of it. But the productivity comes with a complexity bill. Here’s where structured authoring earns its keep, and where it’s overkill.
Companion Site
Need step-by-step guidance? Explore our structured documentation manual covering end-to-end docs-as-code workflows, DITA XML, content reuse strategies, and automated CI/CD publishing.
Browse articles by subject area
