Update docs to reflect that we should commit changes in after_request rather than teardown_request

[carlos-alberto]

If an error is raised in the commit call in teardown_request, the failed transaction won't be rolled back.