Where should we document our public API?

Question

I'm looking for a wiki like software where we can publish our public api documentation. I have found many people to use MediaWiki but this does not seem to be the most elegant way of doing it.

I would love to have a place where we can easily define the APIs specs and have it in an easy to read format. I like how twitter did their api documentation (http://dev.twitter.com/doc/get/statuses/mentions).

Is there a service or open source project which has focused on this aspect of development?

EDIT: I do not want to publish a automated reference of my API. I much rather want to do something like Twitter has (see the example link).

Answer 1

I believe Doxygen will do what you request.

Here is a large C++ library's API published online. Live Example Site

HTH