C++ API Documentation Framework?

[kmiklas]

Heya Peeps,

I'm building an API, and need to document it.

Any recommendations? I'm looking for something:

1. Collaborative, so that contributors can create a user ID to document their contributions.
2. Free and Open Source.
3. To auto-generate or not? I'm not sure here.
a. Half of me thinks that the best docs are those that have been carefully written by the author. The key here is to make it EASY--don't make the developer struggle to get their thoughts down. Also, adding lots of comments clutters the code, and makes it hard to read. Don't drink where you eat; separate these concerns.
b. The other half thinks that auto-generation makes documentation easier, and allows developers to document as they go.

I've looked at
- Mediawiki
- Wordpress with a doc theme
- Slate
- Doxygen

Any recommendations?

Thanks, Keith :^)