slight improvements to API docs