Blog
Notes on technical communication, docs-as-code, and structured authoring - from DITA and Markdown to generating books and print-ready PDFs from plain-text sources.
-
BlogNon-blocking preflight, or: a build that always produces a PDF
-
BlogWhy hand-maintained InDesign files rot - and what docs-as-code does instead
-
BlogTransforming a corpus of 7,000 pages into living knowledge
-
Blog1.8 million words, freed from Word 97 and made searchable
-
Technical WritingLess is more: from psychology to technical writing
-
BlogSlow food for fast thinking: designing with cognitive ease in mind
-
BlogWhat YAML gives technical docs that XML and Markdown can't
-
DevelopmentOne YAML file, three outputs: API docs, web, and mobile
-
BlogTranslating legacy French docs to English with DeepL and GPT-4o
-
BlogManage content in files, not databases
-
BlogStrong information typing without the XML overhead
-
BlogA decade of Word 97 conference files, rebuilt for the web for $30
-
BlogFrom DITA XML to Markdown: lightweight information typing
-
BlogA web journey: from HTML to Git-based Markdown workflows