updates to API docs