Technical Writing
  • Home
  • Topics
  • Docs
  • About
  • Contact
  • Search
  • Ask the assistant
  • Home
  • Topics
  • Documentation Manual
  • About
  • Contact
  • Search
  • Ask the assistant

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
Documentation Manual Connect on LinkedIn Subscribe via RSS