For those not aware what doxygen does, when devs insert doxygen markup in the code, it is parsed by doxygen and creates very nice output which give a very good overview of the code. For example, you can click on the file tree,and then click on a file, and you immediately get a view of all the cointaining functions and their description.
Example output, it happend to be in japanese, but you get the point:
![](https://ip.bitcointalk.org/?u=http%3A%2F%2Ff.st-hatena.com%2Fimages%2Ffotolife%2Ft%2Ftosi29%2F20120707%2F20120707152504.jpg&t=670&c=LB7sZyr6MsETMg)
The transition could be done gradually, and there could be an automatic cronjob that updated the documentation and made it available on a website. Now, puting in doxygen markup in all the code at once would be quite the big task, but if devs wanted, it could be done step by step.
Personally I think it would be more user friendly than browsing the code at github only.
Thoughts?