Improvements to API docs - sort-of fixes #5