prompt: We are currently solving the following issue within our repository. Here is the issue text:
  --- BEGIN ISSUE ---
  Improve unexpected error message
  Many users are reporting / filling an issue in our issue tracker when this message is shown to them, which is logic because it's what the message says.
  
  > There was a problem with Read the Docs while building your documentation. Please report this to us with your build id (1234)
  
  Although, I think we should improve this message saying something like "if this problem persists, please report..." or something similar to that. Otherwise, sometimes it's a temporal failure and we get tons of reports.
  
  --- END ISSUE ---
  
  Below are some code segments, each from a relevant file. One or more of these files may contain bugs.
  --- BEGIN FILES ---
  Path: `readthedocs/doc_builder/exceptions.py`
  Content:
  ```
  1 # -*- coding: utf-8 -*-
  2 """Exceptions raised when building documentation."""
  3 
  4 from __future__ import division, print_function, unicode_literals
  5 
  6 from django.utils.translation import ugettext_noop
  7 
  8 
  9 class BuildEnvironmentException(Exception):
  10 
  11     message = None
  12     status_code = None
  13 
  14     def __init__(self, message=None, **kwargs):
  15         self.status_code = kwargs.pop('status_code', None) or self.status_code or 1
  16         message = message or self.get_default_message()
  17         super(BuildEnvironmentException, self).__init__(message, **kwargs)
  18 
  19     def get_default_message(self):
  20         return self.message
  21 
  22 
  23 class BuildEnvironmentError(BuildEnvironmentException):
  24 
  25     GENERIC_WITH_BUILD_ID = ugettext_noop(
  26         'There was a problem with Read the Docs while building your documentation. '
  27         'Please report this to us with your build id ({build_id}).',
  28     )
  29 
  30 
  31 class BuildEnvironmentCreationFailed(BuildEnvironmentError):
  32 
  33     message = ugettext_noop('Build environment creation failed')
  34 
  35 
  36 class VersionLockedError(BuildEnvironmentError):
  37 
  38     message = ugettext_noop('Version locked, retrying in 5 minutes.')
  39     status_code = 423
  40 
  41 
  42 class ProjectBuildsSkippedError(BuildEnvironmentError):
  43 
  44     message = ugettext_noop('Builds for this project are temporarily disabled')
  45 
  46 
  47 class YAMLParseError(BuildEnvironmentError):
  48 
  49     GENERIC_WITH_PARSE_EXCEPTION = ugettext_noop(
  50         'Problem parsing YAML configuration. {exception}',
  51     )
  52 
  53 
  54 class BuildTimeoutError(BuildEnvironmentError):
  55 
  56     message = ugettext_noop('Build exited due to time out')
  57 
  58 
  59 class BuildEnvironmentWarning(BuildEnvironmentException):
  60     pass
  61
  ```
  --- END FILES ---
  
  Please first localize the bug based on the issue statement, and then generate a patch according to the `git diff` format fenced by three backticks.
  
  Here is an example:
  
  ```diff
  diff --git a/examples/server_async.py b/examples/server_async.py
  --- a/examples/server_async.py
  +++ b/examples/server_async.py
  @@ -313,4 +313,4 @@
   
   
   if __name__ == "__main__":
  -    asyncio.run(run_async_server("."), debug=True)
  +    asyncio.run(run_async_server(), debug=True)
  diff --git a/examples/server_sync.py b/examples/server_sync.py
  --- a/examples/server_sync.py
  +++ b/examples/server_sync.py
  @@ -313,5 +313,5 @@
   
   
   if __name__ == "__main__":
  -    server = run_sync_server(".")
  +    server = run_sync_server()
       server.shutdown()
  
  ```
  
golden_diff: diff --git a/readthedocs/doc_builder/exceptions.py b/readthedocs/doc_builder/exceptions.py
  --- a/readthedocs/doc_builder/exceptions.py
  +++ b/readthedocs/doc_builder/exceptions.py
  @@ -24,7 +24,9 @@
   
       GENERIC_WITH_BUILD_ID = ugettext_noop(
           'There was a problem with Read the Docs while building your documentation. '
  -        'Please report this to us with your build id ({build_id}).',
  +        'Please try again later. '
  +        'However, if this problem persists, '
  +        'please report this to us with your build id ({build_id}).',
       )
  
verification_info: {"golden_diff": "diff --git a/readthedocs/doc_builder/exceptions.py b/readthedocs/doc_builder/exceptions.py\n--- a/readthedocs/doc_builder/exceptions.py\n+++ b/readthedocs/doc_builder/exceptions.py\n@@ -24,7 +24,9 @@\n \n     GENERIC_WITH_BUILD_ID = ugettext_noop(\n         'There was a problem with Read the Docs while building your documentation. '\n-        'Please report this to us with your build id ({build_id}).',\n+        'Please try again later. '\n+        'However, if this problem persists, '\n+        'please report this to us with your build id ({build_id}).',\n     )\n", "issue": "Improve unexpected error message\nMany users are reporting / filling an issue in our issue tracker when this message is shown to them, which is logic because it's what the message says.\r\n\r\n> There was a problem with Read the Docs while building your documentation. Please report this to us with your build id (1234)\r\n\r\nAlthough, I think we should improve this message saying something like \"if this problem persists, please report...\" or something similar to that. Otherwise, sometimes it's a temporal failure and we get tons of reports.\n", "before_files": [{"content": "# -*- coding: utf-8 -*-\n\"\"\"Exceptions raised when building documentation.\"\"\"\n\nfrom __future__ import division, print_function, unicode_literals\n\nfrom django.utils.translation import ugettext_noop\n\n\nclass BuildEnvironmentException(Exception):\n\n    message = None\n    status_code = None\n\n    def __init__(self, message=None, **kwargs):\n        self.status_code = kwargs.pop('status_code', None) or self.status_code or 1\n        message = message or self.get_default_message()\n        super(BuildEnvironmentException, self).__init__(message, **kwargs)\n\n    def get_default_message(self):\n        return self.message\n\n\nclass BuildEnvironmentError(BuildEnvironmentException):\n\n    GENERIC_WITH_BUILD_ID = ugettext_noop(\n        'There was a problem with Read the Docs while building your documentation. '\n        'Please report this to us with your build id ({build_id}).',\n    )\n\n\nclass BuildEnvironmentCreationFailed(BuildEnvironmentError):\n\n    message = ugettext_noop('Build environment creation failed')\n\n\nclass VersionLockedError(BuildEnvironmentError):\n\n    message = ugettext_noop('Version locked, retrying in 5 minutes.')\n    status_code = 423\n\n\nclass ProjectBuildsSkippedError(BuildEnvironmentError):\n\n    message = ugettext_noop('Builds for this project are temporarily disabled')\n\n\nclass YAMLParseError(BuildEnvironmentError):\n\n    GENERIC_WITH_PARSE_EXCEPTION = ugettext_noop(\n        'Problem parsing YAML configuration. {exception}',\n    )\n\n\nclass BuildTimeoutError(BuildEnvironmentError):\n\n    message = ugettext_noop('Build exited due to time out')\n\n\nclass BuildEnvironmentWarning(BuildEnvironmentException):\n    pass\n", "path": "readthedocs/doc_builder/exceptions.py"}], "after_files": [{"content": "# -*- coding: utf-8 -*-\n\"\"\"Exceptions raised when building documentation.\"\"\"\n\nfrom __future__ import division, print_function, unicode_literals\n\nfrom django.utils.translation import ugettext_noop\n\n\nclass BuildEnvironmentException(Exception):\n\n    message = None\n    status_code = None\n\n    def __init__(self, message=None, **kwargs):\n        self.status_code = kwargs.pop('status_code', None) or self.status_code or 1\n        message = message or self.get_default_message()\n        super(BuildEnvironmentException, self).__init__(message, **kwargs)\n\n    def get_default_message(self):\n        return self.message\n\n\nclass BuildEnvironmentError(BuildEnvironmentException):\n\n    GENERIC_WITH_BUILD_ID = ugettext_noop(\n        'There was a problem with Read the Docs while building your documentation. '\n        'Please try again later. '\n        'However, if this problem persists, '\n        'please report this to us with your build id ({build_id}).',\n    )\n\n\nclass BuildEnvironmentCreationFailed(BuildEnvironmentError):\n\n    message = ugettext_noop('Build environment creation failed')\n\n\nclass VersionLockedError(BuildEnvironmentError):\n\n    message = ugettext_noop('Version locked, retrying in 5 minutes.')\n    status_code = 423\n\n\nclass ProjectBuildsSkippedError(BuildEnvironmentError):\n\n    message = ugettext_noop('Builds for this project are temporarily disabled')\n\n\nclass YAMLParseError(BuildEnvironmentError):\n\n    GENERIC_WITH_PARSE_EXCEPTION = ugettext_noop(\n        'Problem parsing YAML configuration. {exception}',\n    )\n\n\nclass BuildTimeoutError(BuildEnvironmentError):\n\n    message = ugettext_noop('Build exited due to time out')\n\n\nclass BuildEnvironmentWarning(BuildEnvironmentException):\n    pass\n", "path": "readthedocs/doc_builder/exceptions.py"}]}