We adopted AsciiDoctor to keep developer docs versioned with the codebase.
Pros:
- Works with GitHub rendering
- Clean syntax, supports diagrams
- Can generate HTML, PDF with theming
Snippet:
= My Service Design Shivprasad Bade :toc: :icons: font
Good docs age well when versioned with your APIs.