Author Topic: The "Summary" field  (Read 5393 times)

Sekoia

  • Titan Network Admin
  • Elite Boss
  • *****
  • Posts: 1,848
The "Summary" field
« on: July 09, 2012, 09:58:40 PM »
When editing an article, there's a box named "Summary" underneath the article text. Unsurprisingly, the purpose of this box is to provide a summary of the changes you made in this revision.

I have seen many, many people using this ways that I find mildly problematic. I'd like to highlight a few of these and explain why I think they're problematic, in the hopes that people might start using the field more optimally.

If you're someone who has done one of these things, please don't feel attacked or criticized; I think just about everybody does it, and I know I have as well at times. Clearly nobody is going to be "perfect", including myself, in the past or going forward. This is simply an explanation for how we can do better, and why, to make people aware.

Dittoing edits from other articles
It's very common for a kind of change to be made to many articles in a row. Sometimes, you'll see the same edit summary copy-and-pasted to all of them. Other times, only the first (or first few) messages get that summary; subsequent articles get "ditto" or "same" or some other message copy-and-pasted in.

When someone comes back a year later and views the edit history for one of those articles, "ditto" tells them absolutely nothing. Or worse, they might think you're dittoing the previous change in that article's history, which is completely wrong.

So instead, it's better to copy-and-paste your edit summary to all of the articles.

Referencing other edits
This is very similar to the above. Someone will make a change on an article. Then they'll make a related change in another article--or someone else will make a related change in another article--and they'll say something that references those other changes.

These kinds of comments work in the context of the Recent Changes page. Unfortunately, they lose context in the edit history and will leave people scratching their heads in confusion later. Make sure your edit summary stands on its own!

Asking a question
A typical scenario: Someone will make a change, perhaps they'll fix the spelling of "enhancement". And while they're at it, something will catch their eye that they are curious about. Perhaps there was a bug noted ten issues ago. So they'll make their edit summary "Is __ bug fixed yet?".

That edit summary has absolutely nothing to do with the change that was made, which is bad enough. But what's even worse is, there's no obvious way to respond! The "Recent Changes" page is not a chat board. If you have a question, post it separately to the page's talk page. That'll make it possible for people to respond. It'll also prevent your question from vanishing permanently from view, which means that if it doesn't get addressed within the next few days, maybe it'll at least get noticed later, eventually.

Summary
In short, the recommendation I'm trying to make is this: Write your edit summaries so that they'll be useful in the edit history. Forget about the Recent Changes list when writing summaries. If your edit summary is useful for the edit history, it'll also be useful in the Recent Changes list.

While it's not the most important of things, it is one of those things that does add up over time. And it will pay off later when you or someone else needs to dig through an article's history.

That said, the changes you're making to the article are much, much more important. Never let the "summary" field stop you from editing. A good edit with an empty or misleading edit summary is much better than no edit at all! :)

Thirty-Seven

  • Elite Boss
  • *****
  • Posts: 623
  • Keeper of the Sacred Number
Re: The "Summary" field
« Reply #1 on: July 10, 2012, 04:09:46 AM »
HA!  I have done all of those things... and recently too in some cases.  I agree with you on the issues there and will attempt to alter those habits.  I do have one comment though:

So instead, it's better to copy-and-paste your edit summary to all of the articles.
The reason that I personally "ditto" things, is because quite often when I am making a similar change in a lot of places, the thing I want to change is on my clipboard.  This makes copying my edit notes an issue.  However, when I am editing at home, that isn't a problem since the "summary" bar will remember the things I have typed in it and all i have to put is a few letters.  It's when I edit from work that it's an issue.

I suppose I could make a Notepad document to store both and alternate copying from the two different parts to get around this obstacle... but ultimately it came down to laziness and not really thinking about what the "ditto" will look like outside of "Recent Changes."

Sekoia

  • Titan Network Admin
  • Elite Boss
  • *****
  • Posts: 1,848
Re: The "Summary" field
« Reply #2 on: July 10, 2012, 12:05:52 PM »
The reason that I personally "ditto" things, is because quite often when I am making a similar change in a lot of places, the thing I want to change is on my clipboard.  This makes copying my edit notes an issue.

What I sometimes do is leave a tab open on Recent Changes, and then just copy-and-paste the edit summary from there. Then I'll go back and copy-and-paste from one of the articles I changed to get the text I'm looking to update. It takes a bit of tab shuffling though, which is still a bit of a hassle. I absolutely understand why the "easier" route tends to win out and have done it myself. :)

GuyPerfect

  • Mary Poppins
  • Titan Staff
  • Elite Boss
  • ****
  • Posts: 1,740
Re: The "Summary" field
« Reply #3 on: July 10, 2012, 04:18:48 PM »
Personally, I copy the contents of the Summary box before submitting, then when I begin to edit the next page, I paste into the Summary box first thing.

Sleepykitty

  • The Napping Cat
  • Elite Boss
  • *****
  • Posts: 266
Re: The "Summary" field
« Reply #4 on: July 11, 2012, 05:28:50 AM »
o.o you left out being purposelessly silly for no good reason!
-------------------------------------------------------------------
I am Sleepy! Hear me Yawn!

o.o reachable at: My Paragonwiki Page

Sekoia

  • Titan Network Admin
  • Elite Boss
  • *****
  • Posts: 1,848
Re: The "Summary" field
« Reply #5 on: July 11, 2012, 01:00:39 PM »
o.o you left out being purposelessly silly for no good reason!

Well, I figured there was no stopping that. :)

Zombie Man

  • Elite Boss
  • *****
  • Posts: 296
Re: The "Summary" field
« Reply #6 on: July 13, 2012, 05:38:08 AM »
May I continue to code secret messages timing The Event with The Collective into the summary field?

Thirty-Seven

  • Elite Boss
  • *****
  • Posts: 623
  • Keeper of the Sacred Number
Re: The "Summary" field
« Reply #7 on: July 13, 2012, 11:01:00 PM »
May I continue to code secret messages timing The Event with The Collective into the summary field?
You could, but... honestly, when was the last time you edited the Wiki?  :P

GuyPerfect

  • Mary Poppins
  • Titan Staff
  • Elite Boss
  • ****
  • Posts: 1,740
Re: The "Summary" field
« Reply #8 on: July 13, 2012, 11:08:49 PM »

Zombie Man

  • Elite Boss
  • *****
  • Posts: 296
Re: The "Summary" field
« Reply #9 on: July 14, 2012, 09:58:01 PM »
You could, but... honestly, when was the last time you edited the Wiki?  :P

That's why it's a secret.

Thirty-Seven

  • Elite Boss
  • *****
  • Posts: 623
  • Keeper of the Sacred Number
Re: The "Summary" field
« Reply #10 on: July 17, 2012, 08:26:38 AM »