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

Tag

OpenAPI

2 articles

  • 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