News for hackers. Stuff that matters.

A comment on Improved Doxygen documentation and search for C++ projects. Parent comment

Re:Improved Doxygen documentation and search for C++ projects by bluGill on Thursday January 03, 2019 @02:07PM (#18818130)
I have found doxygen useful, but only in the context where you don't have the source code. QT has a doxygen like tool which means I don't have to understand how the source is structured to know how to use it. I know of other closed source projects (which I'm not allowed to name) that similarly use doxygen like things so that you don't need the source code.

Note that to be useful someone needs to their full time job to edit it and make sure there are good examples.

[ Parent | on HN ]
Re:Improved Doxygen documentation and search for C++ projects by mosra on Thursday January 03, 2019 @02:27PM (#18818338)
Definitely. Maintaining the Magnum documentation is the most time-consuming portion of the development (tests are second, the actual code takes the least amount of time), but so far it was very worth it.
[ Parent | on HN ]