add doc section on error handling, misc edits