Markup and Meaning
Articles on docs-as-code, structured authoring, and AI-assisted documentation by Olivier Carrère — a technical writer specialising in DITA XML, Markdown, and YAML. Practical writing on how structure, automation, and the right tools make documentation scale.
Latest
Transforming a Corpus of 7,000 Pages into Living Knowledge
From a massive archive of 7,000 pages to daily insights, quote retrieval, and AI-powered thematic digests—this project turns static content into a living flow of clarity, focus, and well-being.
Transforming a Corpus of 1,800 Articles into an AI-Powered Discovery Service
DITA brought structure through XML, but its complexity often felt heavy. Markdown offers a lightweight alternative where technical writers can still apply DITA’s information typing principles—using open, freely available tools and without the XML overhead.
Less Is More: From Psychology to Technical Writing
How Kahneman’s idea of 'less is more' connects with minimalist documentation — and how layering keeps clarity from becoming oversimplification.
More articles
- Slow Food for Fast Thinking: Designing with Cognitive Ease in Mind · 8 min
- Boost Documentation Efficiency: How YAML Outperforms XML, Markdown, and Databases · 8 min
- Distribute API Reference from YAML Across Docs, and Apps · 2 min
- An AI-based workflow to translate legacy content · 4 min
- Manage content in files, not databases · 5 min
- Strong information typing without the XML overhead · 3 min
- Turn Word files into SEO-optimized web pages: Boost your content reach with AI · 5 min
- From DITA XML to Markdown: lightweight information typing · 2 min
- A web journey: From HTML to Git-based Markdown workflows · 4 min