Add more API documentation

More api docs and a small fix for index.adoc