Docs: bring API docs up-to-date; expand thoroughly.