People who write command line tools that require me to install a runtime make me sad.

Also, I thought we'd learned by now that javadoc/doxygen style comments are evil? Comments are most often read in the code in plaintext, so they need to be easy to read in the code. Also, no one writes useful comments about each and every parameter to a function. "reader is the stream the function reads from" ... thanks.

Take a look at how godoc works, and emulate that. It's awesome, easy to read and write in plaintext, and produces nice html output. It does require parsing the code itself to get function names, parameter names, etc. Obviously that makes it a lot more difficult to make cross-platform, but it means writing doc strings is super easy.