Markdown vs reStructuredText vs AsciiDoc vs XML - Comparing Documentation Markup Languages
Ubuntu OnAir via YouTube
Overview
Syllabus
Welcome
Updates
Fight!
Markdown vs reStructuredText vs AsciiDoc vs XML
Why and when they were all created
What is docs-as-code?
Source code
Building documentation
Some pros and cons
Lightweight markup languages
Markdown
Markdown pros and cons
Restructured text
Restructured text pros and cons
AsciiDoc
AsciiDoc pros and cons
Comparison: verbosity
Comparison: general attributes
Comparison: tooling
XML
DITA
DITA summary
DocBook
DocBook summary
S1000D summary
XML-based tooling examples
XML-standards comparison
Madcap Flare
How to select a markup?
Overall comparison
Lightweight markup language selection
Documentation at Canonical
Questions
Taught by
Ubuntu OnAir