I've been intending for quite some time to buckle down and learn Doxygen, due both to its usefulness in maintaining large programming projects (which I'm increasingly becoming involved with) and its widespread use within the open source community.
For those of you who aren't familiar with it, the idea behind Doxygen is that you write code documentation in your source code files using a specific format, and then Doxygen will process the source files and automatically generate developer documentation. It's really quite nifty.
So the other day I decided, "Hey, I should learn Doxygen." Of course, being me, I couldn't just go and learn Doxygen with blinders on. No, I had to take a look at the alternatives out there first. And as it so happens, there are quite a few. However, none of them really perked my interest except for one: Natural Docs. Which I will now discuss.
The main difference between Natural Docs and Doxygen is that Natural Docs places a heavy emphasis on making the documentation readable in the source files, not just the generated documentation. That's not to say that the Doxygen syntax is particularly obtuse or anything. It's not. But Natural Docs is just so... natural. It's so intuitive that it's almost scary.