February 29, 2012

asciidoc

Today, I finally realized it's so much better to write documentation using asciidoc

asciidoc cheat sheet
Adding filters

We're using the program to traverse a build and collect readme files that then serves as different sections of a document. This has the documentation as close to source code as possible. That is a clear advantage. Also we can run scripts from inside the documents that ensure the latest version of the documentation is used.

Asciidoc ROCKs!!!! In a way Metallica can't even imagine!!!

No comments: