Kafka API docs

Hi,

The API description at http://kafka.apache.org/documentation.html#api is
rather thin -- when you are used to the API docs of other apache projects
like hadoop , cassandra , tomcat etc etc.

Is there a comprehensive API description somewhere (like javadocs) ?

Besides looking at the source code, what are users doing to get a handle on
the full feature set of the Kafka API ?

regards