Technical Writing
  • Home
  • Topics
  • About
  • Contact
  • Search
  • Smart Docs →
  • Home
  • Topics
  • About
  • Contact
  • Search
  • Smart Docs →

Tag

YAML

4 articles

  • An ornate Wurlitzer theatre organ console with rows of stop tabs, multiple keyboards, and a pedalboard

    AI will soon replace GUIs: rebuilding an InDesign leaflet through conversation, not clicks

    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.

    Sep 1, 2026
  • A sign giving the same message in three languages

    One source, three languages: the strict facts-vs-display-strings split

    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.

    Jul 28, 2026
  • A honeycomb of hexagonal cells

    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.

    Sep 27, 2025
  • A river delta seen from the air

    One YAML file, three outputs: API docs, web, and mobile

    Learn how one YAML file can serve as a single source of truth for APIs, powering docs, HTML documentation, and even mobile apps.

    Sep 24, 2025
← Back to Blog
Connect on LinkedIn Subscribe via RSS