Re:Asciidoctor – A fast, open-source text processor and publ...
by mikeholler on Monday January 07, 2019 @04:10PM
(#18850116)
I think this is a bikeshedding criticism more than something that requires serious concern. Asciidoctor simply supports more out-of-the-box and officially than reStructuredText. Preferring reStructuredText to Asciidoctor this way is like comparing Python to Ruby for syntax alone. Function is just as important.
In Asciidoctor, I can:
* Use GraphViz (and other diagram) docs to describe architectural components.
* Actually test my example code, using named, delineating comments in my test suite and including the code between those comments as an example in my file.
* Support for WARNING, NOTE, etc. callout "admonitions"
* Auto-numbered list blocks with "."
Some of these may be possible with reStructuredText, and can definitely be supported with third party plugins, but all of this is first-party and amazing.
Note: IntelliJ's Asciidoctor plugin is incredible and it live renders mathematical equations AND graphing support in addition to everything else.
In Asciidoctor, I can:
* Use GraphViz (and other diagram) docs to describe architectural components.
* Actually test my example code, using named, delineating comments in my test suite and including the code between those comments as an example in my file.
* Support for WARNING, NOTE, etc. callout "admonitions"
* Auto-numbered list blocks with "."
Some of these may be possible with reStructuredText, and can definitely be supported with third party plugins, but all of this is first-party and amazing.
Note: IntelliJ's Asciidoctor plugin is incredible and it live renders mathematical equations AND graphing support in addition to everything else.