make `requests` example more canonical wrt error handling
add link to `requests` library documentation for reference
fix typos and omissions.