Andrew Sutton wrote:
The reference section produced by Doxygen for Quickbook saves a lot of tedious work, and most important, is updated as the code changes.
So I would say that not only the C++ stuff but the docs should be uploaded very often - each time some section is working at all, and probably more frequently than weekly. Warts and all!
I'm a big fan of Doxygen + Quickbook :) Is there a template floating around that we give to students that will work once they're properly set up their environments?
I would not say a template, but I found Boost.Asio docs as the best example of integration of Doxygen with Boostbook + Quickbook. It is fairly complex and uses XSL(T) but gives very good results, IMHO. Best regards, -- Mateusz Loskot, http://mateusz.loskot.net Charter Member of OSGeo, http://osgeo.org