Tag
Technical Writing
3 articles
-
Slow food for fast thinking: designing with cognitive ease in mind
What can Kahneman’s Systems 1 and 2 teach us about technical writing? This post explores how minimalism and DITA structure align with cognitive systems to make documentation more intuitive and human-centered.
-
What YAML gives technical docs that XML and Markdown can't
A growing engine-oil catalog - brands, viscosities, prices - becomes a maintenance nightmare as a Markdown table and a verbose tangle as DITA XML. One YAML file holds each fact once and generates every table, doc page, and app view from it.
-
Translating legacy French docs to English with DeepL and GPT-4o
Professionally translating hundreds of legacy French Markdown files would have cost a fortune. Instead, a DeepL-then-GPT-4o pipeline with Git diffs as a safety net: keep the good translations file by file, discard the rest, rebuild.