I have just created this minor issue to update the main README of the project https://issues.apache.org/jira/browse/BOOKKEEPER-1027
It's trivial but newbies will see that file as presentation of the code https://github.com/apache/bookkeeper In general I would like to clean up things in order to make BookKeeper more "user-friendly" this includes at least: - Documentation - Main API clean up -- Enrico