Agreed. However, it's still viable to go that route if you have a document-generating tool like doxygen that will pull all of this data out and make a (rather hideous, but usable) bunch of html documentation.

This is not an example of that.