We've recently dived into sphinx for documenting our python ros packages and had a whole bunch of notes on a private server. This is of not much use to many so I just updated the outdated and somewhat sparse notes that were previously on the ros wiki.
If you're interested in using something a whole lot better than doxygen for python, you might like to take a look.
Cheers,
Daniel.