Page MenuHomePhabricator

MediaWiki:Tog-previewonfirst badly worded: Unclear what "first edit" in "Show preview on first edit" means
Closed, ResolvedPublic

Description

It currently says:

  • Show preview on first edit

It's not clear what's "first edit" here.

To see its usage, access Preferences special page while logged in on English Wikipedia, under "Editing" section, last segment titled "Preview" Direct url: https://en.wikipedia.org/wiki/Special:Preferences#mw-prefsection-editing.

Three options are given:

  1. Show preview on first edit -Unclear wording. If selected, preview is shown AFTER the edit box
  2. Show preview before edit box -It does what it says; if selected, preview is shown BEFORE the edit box
  3. Show previews without reloading the page -It does exactly what it says (apart from the minor issue of using plural 'previews')

So the message should be reworded to say exactly what it does:

  • Show preview after edit box

Or maybe I am missing something, (the message has been there for a long time). If someone could explain why the current wording was chosen, that should be added to the message's documentation

Event Timeline

Aklapper renamed this task from MediaWiki:Tog-previewonfirst badly worded to MediaWiki:Tog-previewonfirst badly worded: Unclear what "first edit" in "Show preview on first edit" means.May 5 2020, 11:50 PM

Change 802948 had a related patch set uploaded (by EpicPupper; author: EpicPupper):

[mediawiki/core@master] Clarify wording of preview settings

https://gerrit.wikimedia.org/r/802948

EpicPupper triaged this task as High priority.
EpicPupper added a project: User-EpicPupper.
EpicPupper moved this task from Backlog to Patch for Review on the User-EpicPupper board.

The first patchset at https://gerrit.wikimedia.org/r/c/mediawiki/core/+/802948 suggests "Show preview after edit box on every edit". There are two problems with it:

One

If I understand correctly, it's not necessarily shown after the edit box, but can also be before.

Two

I've always found "on first edit" clear to me. I can imagine why would some people think that it's not clear, but changing it to "on every edit" doesn't make it clearer. An "edit" is an action of editing that creates a revision. When editing in wikitext, it may involve several clicks on the Preview button, but ultimately, it's one edit.

Perhaps you could write something like "Show preview when starting to edit".

Finally, now that Real time preview is starting to appear, the general nature of this function may be rethought, and some input from that feature's designers can be useful.

The first patchset at https://gerrit.wikimedia.org/r/c/mediawiki/core/+/802948 suggests "Show preview after edit box on every edit". There are two problems with it:

One

If I understand correctly, it's not necessarily shown after the edit box, but can also be before.

Two

I've always found "on first edit" clear to me. I can imagine why would some people think that it's not clear, but changing it to "on every edit" doesn't make it clearer. An "edit" is an action of editing that creates a revision. When editing in wikitext, it may involve several clicks on the Preview button, but ultimately, it's one edit.

Perhaps you could write something like "Show preview when starting to edit".

Finally, now that Real time preview is starting to appear, the general nature of this function may be rethought, and some input from that feature's designers can be useful.

Thanks for your feedback! I've changed it to your suggestion, "Show preview when starting to edit". I've also subscribed the members of the Real-Time Preview project in case they have any thoughts about this change.

Change 802948 merged by jenkins-bot:

[mediawiki/core@master] Clarify wording of preview settings

https://gerrit.wikimedia.org/r/802948