[docs] Fix the docs and document the API

2 jobs for cleanup in 3 minutes and 46 seconds (queued for 3 seconds)