Hacker News new | past | comments | ask | show | jobs | submit login

This statement is case in point that most documentation is dirt simple.

On the other hand, if you're documenting an end product with complex print output, hundreds of (slightly) different configurations, and need transclusion, partial transclusion, conditionals - to say nothing of wacky tables and olists- you end up with a giant pile of Markdown customization. It's easier to just use Asciidoc off the shelf, not to mention that you get DocBook interoperability, which lets you transform to all sorts of weird old formats.

But that complex use case often comes with dollars attached for big proprietary solutions. Asciidoc is a an open standard in a space that usually has vendor solutions.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: