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:
Post a Comment