API docs in DITA & Markdown

API docs in DITA & Markdown

This talk proposes a hybrid approach to API documentation that combines Markdown output generated by API docs tools like API Blueprint, RAML, or Swagger with more complex content authored in DITA and published via the DITA-OT Markdown plug-in for delivery via GitBook or other Markdown-based publishing systems.

Presented March 4, 2016 at the Write The Docs London mini-conference on Documenting APIs hosted by the UK’s Government Digital Service.

64b5f80a188b6d76cf27f4cb2144d6f8?s=128

Roger Sheen

March 04, 2016
Tweet