Readthedocs.org: Improve unexpected error message

[humitos]

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.

[dojutsu-user]

I would like to take this issue.
My suggestion for the error message is this -
"There was a problem with Read The Docs while building your documentation. This might be a temporary error. We suggest you to try again. However, if this problem persists, please report to us with your build id (1234)."

[humitos]

This might be a temporary error. We suggest you to try again

"try again _later_.", maybe is better.

The rest is perfect to me.

[dojutsu-user]

@humitos I found this error message in files located at readthedocs/locale/ and logs/debug.log, should i change this line there too?

[humitos]

@dojutsu-user no. Those files do not require modifications for this.

[dojutsu-user]

@humitos okay, I have made the PR, please review it.

[stsewd]

@humitos I think your past self already filled this issue :D https://github.com/rtfd/readthedocs.org/issues/4010

[humitos]

@humitos I think your past self already filled this issue :D #4010

I really hate how GitHub search issues/prs work. I never find what I'm looking for.