update docs with potential exceptions