Add docs for error_code
Update the caveats to be more english and less bad.