Markup and Meaning
Practical approaches to docs-as-code, structured authoring, DITA, automation, and AI-assisted documentation.
Index
Recent Notes
Running make locally is one thing. Guaranteeing that every contributor’s push or YAML edit on GitHub produces the same press-ready artifact on a clean machine with a pinned toolchain is another. How two print projects implement that guarantee with GitHub Actions.
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.
Documentation Manual
Need structured reference material? Explore our comprehensive documentation manual covering end-to-end docs-as-code workflows, DITA XML, content reuse strategies, and automated CI/CD publishing.
Documentation Assistant
Ask a question in plain language. The assistant answers from the articles published on this site and lists the ones it used. To look up an exact term, use search.
Try rephrasing with a more specific term, browse by topic, or search the articles.
Need in-depth documentation guides? Consult the companion Documentation Manual (opens in a new tab).
