Markup and Meaning
A technical-editorial notebook exploring the craft of modular documentation, static site generation, and long-term content maintainability.
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.
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 ↗.
Companion Site
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.
Index
