A few helpful comments/edits on API docs