Page MenuHomePhabricator

Revise HTTP 500 error message language
Open, Needs TriagePublic

Description

This task is about revising the error message language implemented in 544152 to make it more actionable.

Behavior

  1. Attempt to save an edit using an editing interface that depends on VE (e.g. the visual editor or the Reply Tool)
  2. An issue in VE's code or the wiki's configuration is preventing that edit from being saved.

Current

  1. An error message appears that contains one of the following messages:
    • "Error contacting the Parsoid/RESTBase server: $1"
    • "Error contacting the Parsoid/RESTBase server (no response)"

Desired

  1. An error message appears that contains one of the following messages:
    • "Error contacting the Parsoid/RESTBase server: $1. To have this issue resolved, please make the developers aware: [Share feedback](https://www.mediawiki.org/wiki/Talk:VisualEditor). "
    • "Error contacting the Parsoid/RESTBase server (no response). To have this issue resolved, please make the developers aware: [Share feedback](https://www.mediawiki.org/wiki/Talk:VisualEditor)."

Done

  • The "Desired" behavior is implemented

Event Timeline

This would probably apply to every unhandled error generated by the API (see below).

"To have this issue resolved, please make the developers aware"

I'm not sure this is true. Often the error will be some transient server error that we can't address. We would probably want to say something like "if this issue persists" or "try again later".

API error messages in VE:

"apierror-visualeditor-badcachekey": "No cached serialization found with that key",
"apierror-visualeditor-difffailed": "Diff failed",
"apierror-visualeditor-docserver-http-error": "Error contacting the Parsoid/RESTBase server: $1",
"apierror-visualeditor-docserver-http": "Error contacting the Parsoid/RESTBase server (HTTP $1)",
"apierror-visualeditor-docserver-unconfigured": "The VirtualRESTService for the document server is not defined; see https://www.mediawiki.org/wiki/Extension:VisualEditor",
"apierror-visualeditor-docserver": "Error contacting the Parsoid/RESTBase server (no response)",
"apierror-visualeditor-latestnotfound": "Could not find latest revision for title",