update docs to mention how exceptions are handled