Tag
YAML
3 articles
-
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.
-
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.
-
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.