Posted this because I started exploring Asciidoc recently as a medium for documentation. Here’s a link for the last time this was posted:
https://news.ycombinator.com/item?id=11292280
Markdown is incredible and probably the best tool for writing simple documentation. I started using asciidoc recently due to its native support for table of contents, links and the excellent support for tables. Was inspired by Ciro Santilli’s use of asciidoc for his documentation projects. Ultimately tools are tools and nothing is perfect, but hope that this might also inspire people to increase their documentation game.