Technical writing, docs-as-code, DITA, and AI-assisted documentation by Olivier Carrère.https://redaction-technique.org/enhttps://redaction-technique.org/blog/lightweight-cms-git-astro/https://redaction-technique.org/blog/lightweight-cms-git-astro/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.Tue, 08 Sep 2026 08:00:00 GMTastrowordpresscmsgitheadless-cmsvercelhttps://redaction-technique.org/blog/ai-will-soon-replace-guis/https://redaction-technique.org/blog/ai-will-soon-replace-guis/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.Tue, 01 Sep 2026 10:00:00 GMTaidocs-as-codelatexyamlclaudehuman-in-the-loophttps://redaction-technique.org/blog/structured-authoring-hidden-bill-dita/https://redaction-technique.org/blog/structured-authoring-hidden-bill-dita/DITA XML can shrink the volume a technical writer creates, translates, and maintains: and a firewall vendor once got its documentation praised by the press because of it. But the productivity comes with a complexity bill. Here’s where structured authoring earns its keep, and where it’s overkill.Tue, 25 Aug 2026 10:00:00 GMTdita-xmlstructured-authoringsingle-source-of-truthtechnical-writingi18nstructured-contentcontent-reusehttps://redaction-technique.org/blog/three-levels-of-technical-documentation/https://redaction-technique.org/blog/three-levels-of-technical-documentation/Technical documentation is like a garden, and it grows in three stages. The wasteland has no process and no owner. The English garden is cultivated but informal. The French garden is structured and deliberate. Knowing which one you’re standing in tells you what to fix next: and what not to.Tue, 18 Aug 2026 10:00:00 GMTtechnical-writingstructured-authoringdocs-as-codecontent-strategyhttps://redaction-technique.org/blog/rgb-to-cmyk-python/https://redaction-technique.org/blog/rgb-to-cmyk-python/The prepare_images.py walkthrough: converting every source image to CMYK using the FOGRA39 ICC profile via Pillow and LittleCMS, with black-point compensation. Resolution is checked at placed size: never faked, never upscaled.Tue, 11 Aug 2026 10:00:00 GMTdocs-as-codelatexautomationhttps://redaction-technique.org/blog/soft-hyphen-u00ad/https://redaction-technique.org/blog/soft-hyphen-u00ad/It’s invisible on screen. It prints correctly. But when text is extracted from the PDF — by an accessibility checker, a search engine, or a copy-paste — U+00AD surfaces as a garbage character between syllables. Here’s what it is, where it comes from, and how to find it.Tue, 04 Aug 2026 10:00:00 GMTtypographylatexdocs-as-codeaccessibilitypdf-uahttps://redaction-technique.org/blog/one-source-three-languages/https://redaction-technique.org/blog/one-source-three-languages/events.yaml holds no labels. traduction.yaml holds no facts. The generator resolves them at build time with --lang fr, --lang en, or --lang es. What enforcing this constraint looks like in practice, and why the discipline is worth the friction it creates.Tue, 28 Jul 2026 10:00:00 GMTdocs-as-codeyamlsingle-source-of-truthautomationstructured-contenthttps://redaction-technique.org/blog/reliability-vs-latency-claude-cli/https://redaction-technique.org/blog/reliability-vs-latency-claude-cli/Claude’s LaTeX output frequently didn’t compile. The fix wasn’t to prompt better — it was to close the feedback loop. What looked like a reliability problem turned out to be a latency problem.Tue, 21 Jul 2026 10:00:00 GMTailatexautomationclaudehuman-in-the-loophttps://redaction-technique.org/blog/persona-prompting-typographer/https://redaction-technique.org/blog/persona-prompting-typographer/The same PDF, two different prompts. 'Is this well laid out?' returned vague positivity. 'You’re an experienced typographer, check this before printing’ returned a structured technical review. The before/after register change is a clean, demonstrable lesson.Tue, 14 Jul 2026 10:00:00 GMTaipromptingtypographyhuman-in-the-loophttps://redaction-technique.org/blog/pdfx4-lualatex-without-ghostscript/https://redaction-technique.org/blog/pdfx4-lualatex-without-ghostscript/Producing a PDF/X-4 press-ready file from LuaLaTeX without touching Ghostscript: the pdfx package, TrimBox/BleedBox geometry in points, FOGRA39 OutputIntent, CMYK-only color discipline, and XMP metadata — everything a print shop will verify.Tue, 07 Jul 2026 10:00:00 GMTlatexdocs-as-codetypographyaccessibilityhttps://redaction-technique.org/blog/non-blocking-preflight-build-always-produces-pdf/https://redaction-technique.org/blog/non-blocking-preflight-build-always-produces-pdf/One hard stop, five soft failures, a renamed file, and a report alongside it. The design philosophy behind a preflight that never aborts — plus the pikepdf/PyMuPDF six-check implementation and the --strict flag for CI.Tue, 30 Jun 2026 10:00:00 GMTdocs-as-codelatexautomationhttps://redaction-technique.org/blog/indesign-vs-docs-as-code/https://redaction-technique.org/blog/indesign-vs-docs-as-code/A 370-cell calendar that shifts every year. A lead’s name in three places. An IBAN in an invisible text box. These are not unusual InDesign problems — they are what InDesign files become when they accumulate facts with no single home. Two projects show what the alternative looks like — and where InDesign’s own global tools stop short.Tue, 23 Jun 2026 10:00:00 GMTdocs-as-codelatexgitautomationsingle-source-of-truthhttps://redaction-technique.org/blog/transforming-corpus-ai-living-knowledge/https://redaction-technique.org/blog/transforming-corpus-ai-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.Sat, 01 Nov 2025 00:00:00 GMTAIKnowledgeCurationDiscoveryhttps://redaction-technique.org/blog/transforming-meditation-classes-ai-discovery/https://redaction-technique.org/blog/transforming-meditation-classes-ai-discovery/1,800 lecture transcripts — 1.8 million words once trapped in Word 97 files — converted to Markdown, scored and tagged by AI, and turned into a searchable discovery platform that also generates print-ready LaTeX anthologies.Tue, 28 Oct 2025 00:00:00 GMTAILaTeXDiscoveryContenthttps://redaction-technique.org/blog/less-is-more-layering/https://redaction-technique.org/blog/less-is-more-layering/How Kahneman’s idea of 'less is more’ connects with minimalist documentation — and how layering keeps clarity from becoming oversimplification.Tue, 21 Oct 2025 00:00:00 GMTMinimalismDocumentationUX WritingKahnemanLayeringhttps://redaction-technique.org/blog/systems-1-2-affordance-minimalism-technical-writing/https://redaction-technique.org/blog/systems-1-2-affordance-minimalism-technical-writing/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.Sat, 04 Oct 2025 00:00:00 GMTCognitive PsychologyTechnical WritingDITAMinimalismhttps://redaction-technique.org/blog/scalable-maintainable-technical-docs-with-yaml/https://redaction-technique.org/blog/scalable-maintainable-technical-docs-with-yaml/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.Sat, 27 Sep 2025 00:00:00 GMTYAMLOpenAPISchemaStructured DataTechnical WritingContent ReuseValidationhttps://redaction-technique.org/blog/experimental-astro-api-docs/https://redaction-technique.org/blog/experimental-astro-api-docs/Learn how one YAML file can serve as a single source of truth for APIs, powering docs, HTML documentation, and even mobile apps.Wed, 24 Sep 2025 00:00:00 GMTAstroAPIOpenAPIYAMLDocumentationhttps://redaction-technique.org/blog/ai-translation-legacy-technical-docs/https://redaction-technique.org/blog/ai-translation-legacy-technical-docs/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.Mon, 22 Sep 2025 01:00:00 GMTAITranslationTechnical WritingMarkdownDeepLGPT-4ohttps://redaction-technique.org/blog/manage-content-in-files-not-databases/https://redaction-technique.org/blog/manage-content-in-files-not-databases/Databases are not always the best place for your content. By storing it in plain files, you gain speed, security, Git-based workflows, and a simpler, more reliable publishing stack.Thu, 18 Sep 2025 10:12:00 GMTStatic SitesLinux PhilosophyDocs-as-CodeContent ManagementGithttps://redaction-technique.org/blog/strong-information-typing-without-xml-overhead/https://redaction-technique.org/blog/strong-information-typing-without-xml-overhead/You don’t need the complexity of DITA XML to benefit from its discipline. With Markdown and modern docs-as-code workflows, technical writers can apply strong information typing-tasks, concepts, and references-using lightweight, open tools.Wed, 17 Sep 2025 11:39:00 GMTDITAMarkdownInformation TypingContent ModelDocs-as-Codehttps://redaction-technique.org/blog/turn-word-files-seo-optimized-web-pages-ai/https://redaction-technique.org/blog/turn-word-files-seo-optimized-web-pages-ai/How we transformed unstructured Word 97/2000 files into a decade-long web publication of conferences-using Markdown, Python, and GPT-powered automation for just $30.Mon, 01 Sep 2025 11:39:00 GMTDITAMarkdownInformation TypingAIPythonDigital ArchivesAutomationSEOhttps://redaction-technique.org/blog/dita-xml-to-markdown-lightweight-information-typing/https://redaction-technique.org/blog/dita-xml-to-markdown-lightweight-information-typing/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.Fri, 01 Aug 2025 11:39:00 GMTDITAMarkdownInformation Typinghttps://redaction-technique.org/blog/web-journey-html-to-git-markdown/https://redaction-technique.org/blog/web-journey-html-to-git-markdown/Tracing over two decades of web publishing, from raw HTML and Dreamweaver to CMSes, structured content, static site generators, and modern Git-based Markdown workflows. Lessons for solo and team content developers on maintainability, collaboration, and performance.Thu, 10 Jul 2025 10:00:00 GMTHTMLWordPressDITAMarkdownSphinxStatic SitesDocs-as-CodeGitContent Management