Page MenuHomePhabricator

Convert Reference button - change or expand the user-guidance wording
Open, Needs TriagePublicFeature

Description

Feature summary:
Help editors to use the Convert button in constructive ways and avoid using it in deleterious ways, by providing clearer instructions in the workflow.
Currently the user-guidance above the Convert button says:

You can use the "Convert" button below to generate a properly formatted reference from the external link.

We could add helpful nuances to this guidance in order to make editors (especially newcomers) aware of potential problems that they should consider during the workflow.

Use case(s):
In circumstances where an existing reference has more than a plain link, sometimes using the Convert button will discard useful information that was stored in unstructured text. E.g.

image.png (1,343×445 px, 240 KB)

Editors should be reminded to check the before/after contents of the converted reference. E.g. Perhaps text like this could be added/appended to the existing guidance. [Very rough draft]

"Please check the details that were changed in this conversion. If any relevant information was lost during the automatic citation generation, then copy those details from the original plaintext version into the structured template version."

Benefits:
To increase the potential for unambiguously-constructive edits.
To reduce the potential for unintentionally-deleterious edits (and thus potentially reverted edits).
To remind/teach editors about [broad or specific] nuances and edge-cases that they should consider/check for during the workflow.

Notes:
Ideally, we could provide the editor with easily accessible copy of the original citation text, whilst they are editing the structured version, for easy copy&pasting. That probably requires a distinct sub-task?