446070 - Relabel "Edit Summary" in editor

Status: VERIFIED FIXED

(support.mozilla.org :: Knowledge Base Software, task)

Description

[Chris Ilias [:cilias]]

People are not summarizing their edits, or citing references.

Let's rename "Edit Summary" to:
"Describe your edit and cite a reference"

Comment 1

[Majken Connor [:Kensie]]

probably more effective to make the field required, but I agree "Edit Summary" always seems like you're editing the summary of the article rather than the edit.

Comment 2

[Chris Ilias [:cilias]]

Great idea. I've filed bug 446201.

Comment 3

[David Tenser [:djst]]

Seems very trivial, and would make the UI easier to understand.

Comment 4

[Paul Craciunoiu [:paulc]]

Note to self to check other places where "Edit Summary" may show up :)

Comment 5

[Paul Craciunoiu [:paulc]]

So we'll stick with "Describe your edit and cite a reference"?
That's a bit wordy. What if we just put "Describe your edit"? If references are much needed, however, we can make it as Chris suggested.

Comment 6

[Majken Connor [:Kensie]]

Is edit friendly enough? we could say "changes" instead, but maybe edit is more consistent with other references?

Comment 7

[David Tenser [:djst]]

Why the "cite a reference" part? That confuses me, as most of my edits don't have references. 

How about something like "Describe the changes you made:" ?

Comment 8

[Chris Ilias [:cilias]]

Sometimes people make edits with info that we can't confirm; so we want to encourage new contributors to cite references.

Comment 9

[Paul Craciunoiu [:paulc]]

What's the final word on this?

Comment 10

[David Tenser [:djst]]

Chris, it sounds like we're making the label harder to understand in order to avoid rare cases of people making claims that aren't validated. If this happens only "sometimes," I'd rather a reviewer ensures that the info is correct by e.g. testing it than relying on the author's reference (which might still be incorrect). Saying "cite a reference" for people that don't have one is going to be confusing.

My suggestion is still "Describe the changes you made:". What do you think?

Comment 11

[Chris Ilias [:cilias]]

This is more about instilling good practices. (Particularly in cases in which solutions cannot be tested on-demand, because we can't replicate the problem to begin with. :-) )

If it's going to cause more harm (confusion) than good, "Describe the changes you made:" sounds good.

Comment 12

[Paul Craciunoiu [:paulc]]

Okay, you guys have to agree before I post a patch :)

Comment 13

[Paul Craciunoiu [:paulc]]

Attachment: patch, v1

Also placed the colon inside the {tr}, yay!

Comment 14

[Paul Craciunoiu [:paulc]]

r29661 / r29662
Is 1.2.1 the next release?

Comment 15

[Stephen Donner [:stephend] Not actively reading bugmail]

Verified FIXED on https://support-stage.mozilla.org/tiki-editpage.php?locale=en-US&page=*Clearing+private+data.