> Extensive documentation with examples can be found inline in the source header files.
I don't see this as a proper way to do docs. At least give a first-time viewer a glimpse of what this might be useful for. I'm completely in the dark, myself.
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.
I don't see this as a proper way to do docs. At least give a first-time viewer a glimpse of what this might be useful for. I'm completely in the dark, myself.