81

I am on Stack Overflow every day and, to be honest, there are only a few questions I can actually answer. Hence, I am usually on grammar and spelling patrol - to help improve the Stack Overflow community. How much do you think this contributes to the Stack Overflow community? Do you notice it? Has it helped you? Do you regularly edit other people's questions? If so, why do you do it?

6
  • 49
    As long as you try to address all issues with a post, cleaning up spelling and grammar is most welcome! Commented Aug 27, 2014 at 18:21
  • 10
    +2 reputation for a successful edit (up to a 2k reputation) should tell you that this is encouraged behaviour...cleanliness is nice on a site like this. Just be careful of too minor edits
    – Twelfth
    Commented Aug 27, 2014 at 19:55
  • 1
    Every site has an option to show the most active editors of that site where you can see users have made hundreds of edits. It's certainly encouraged and helps the site. Commented Aug 28, 2014 at 13:12
  • 3
  • 21
    People who don't know the difference between everyday and every day shouldn't be on grammar patrol. ;)
    – TRiG
    Commented Aug 29, 2014 at 14:34
  • One thing I worry about is going in and tipping the balance in an odd way. So someone who can't express themselves in English well--but "I know what they mean" and step in as a translator who knows both English and programming. Then I disappear because I don't monitor the ensuing conversation where answers start getting incoherent comments in reaction to a question I've cohered to be ordinary. As I haven't monitored (much), I don't know if this leads to future, more severe, misunderstandings. Commented Aug 30, 2014 at 5:59

5 Answers 5

88

Improving spelling and grammar makes questions easier to read and quicker to understand. Less time spent trying to understand a question means more time available to answer it. So it's absolutely a good thing.

9
  • 16
    Just beware of doing far too little, aka extinguishing the candle but leaving the bonfire. In In that case, I really hope it gets denied as "too minor". Commented Aug 27, 2014 at 18:47
  • 14
    @Deduplicator, I fail to see how that is detrimental to others or to the text at hand, though. If putting out candles is all you can do, at least it does not hurt. Commented Aug 29, 2014 at 8:42
  • 2
    Andrew, I'd add that less time understanding the question, or the answer, first and foremost means less time wasted over the man years for people using the QA as reference. If a question takes 4 seconds less on average to understand, and 100 000 people look at it, that is almost three work weeks saved. For a change that maybe took a few minutes. Commented Aug 29, 2014 at 8:46
  • 9
    @Prof.Falken: it wastes reviewer time. If you can't make a post actually useful, an edit is probably too minor.
    – Wooble
    Commented Aug 29, 2014 at 11:59
  • 3
    @Wobble, I am sorry, but I fail to see the argument. If the time spent by reviewer is recouped over a decade thousands of times over, how is that still a waste? Commented Aug 29, 2014 at 13:28
  • 1
    @Prof.Falken If somebody came along and just changed "i" to "I", that could be considered extinguishing a candle. There's literally zero time being recouped by additional understanding from future readers, though; it might be slightly jarring for me to read a lowercase i when it should be an uppercase, but I can still understand (or not, as the case may be) the post just as well. Commented Aug 29, 2014 at 14:34
  • 1
    Also, it may annoy certain people to have, say, all instances of "it's" converted to "it is". If that is the only thing that gets changed then it is not particularly useful. If I see an edit in the review queue where the only change is some minor spelling I would reject it as too minor.
    – nico
    Commented Aug 29, 2014 at 14:52
  • Also less error prone I'd say..
    – Marco A.
    Commented Aug 29, 2014 at 15:23
  • @Prof.Falken: If the question can't be made useful, the benefits won't be experienced over many thousands of views, it will just be deleted.
    – Ben Voigt
    Commented Aug 30, 2014 at 17:23
33

Yes, improving questions and answers by collaborative editing is on the site's DNA. One of the site founders announcing Stack Overflow launch:

There are lots of good ways to edit things. You can improve spelling, grammar, and even copy edit any question or answer to make it better. After all, for the next 20 years, this question will be the canonical place on the web where programmers will come to find out about enlarging fizzbars without overwriting snibbits. Anything you can do to clarify, explain, or improve the question or the answer will be a public service. If there’s code in the answer, you can debug it, refactor it, or tweak it to make it better.

You can also improve on the answers. If an answer is incomplete, expand on it. If an answer has a bug in it or is obsolete, you can edit it and fix it. Because Q&A in Stack Overflow are editable, you can safely link to a Stack Overflow permalink knowing it will always have a good answer. Stack Overflow won’t have the problem of other sites where obsolete or incorrect answers have high Google PageRank simply because they’ve been on the Internet for so long. If someone finds a security bug in an answer, it can be fixed… it won’t keep coming up in Google’s results for years and years poisoning future code.

PS: Note that the part about refactoring and tweaking an answer's code is not about a regular edit, it can be done but with extreme caution.

Normally, my edit workflow is:

  • Remove tags from title or make its use organic.

  • Descriptive title ("Problem with X" => "X does Y in Z circumstances").

  • Remove noise ("hello", "thanks", "I'm newbie", "Sorry for engrish", signatures).

  • Grammar and spelling.

  • Code indentation, if the lack of it makes the code unreadable, and if possible/allowed by the language. Removing excessive empty lines may also be warranted. Don't touch anything else on a question's code. Changing coding style is not ok.

  • Add or replace tags.

  • Use the field "Edit summary" to describe your changes, so the OP and others can learn from it.

Important: read Why can people edit my posts? How does editing work? to know the site guidelines about this feature.

7
  • 4
    Please, however, be scarce in changing code indentation. Do it really only if the code is unreadable. Changing indentation style is just annoying.
    – nico
    Commented Aug 29, 2014 at 14:54
  • Thanks for the input, @nico, updated.
    – brasofilo
    Commented Aug 29, 2014 at 15:00
  • "There are lots of good ways to edit things." Well, a "lot" is a parcel of land or goods. That should read "There are many good ways to edit things." :) Commented Aug 29, 2014 at 15:29
  • 1
    @DonBranson, the dictionary is telling me both are correct, could this be an issue of UK/USA English?
    – brasofilo
    Commented Aug 29, 2014 at 15:35
  • Could be. Could also be that the dictionary is not correct and my English teacher was. :) Neither one is perfect. Commented Aug 29, 2014 at 15:51
  • OT: In one of the Pratchett books, some tribe (trolls?) does math in terms of "one, two, many, lots". So "lots" is canonical enough usage for me :)
    – user3458
    Commented Aug 29, 2014 at 19:52
  • @Arkadiy, not so OT, before knowing it better, I'd change "colour" for "color". So, if not sure about a word, don't change it ;) Oh, yeah, good to know that lots is more than many..!
    – brasofilo
    Commented Aug 29, 2014 at 20:01
24

Technical writing commands a high degree of accuracy. The simplest preposition could change the meaning of an entire paragraph, which could then change the entire interpretation of what a program should do. Each time I read a well-written question, there's the profile icon of an editor peering right back at me. So yes, I definitely notice it.

1
  • "commands" or "demands"? Commented Jun 5, 2017 at 13:14
16

I'd like to add that as someone who's had my answers edited, it's helped me learn how to write better questions/answers. It's one thing to see a good question/answer, but it's another to see how your own was changed to make it more readable. The latter is much easier to apply to future questions/answers.

I know there are some people who hate to have their work edited, but there are also many of us who appreciate the efforts of the editors and actually learn from your contributions. We just don't tend to be as vocal about it.

Thank you!

6
  • 2
    That's great to hear Rob! It's interesting to hear your opinion, from the other side of the editing.
    – Xanco
    Commented Aug 29, 2014 at 12:41
  • 2
    Someone needs to edit this post to remove the "Thank you" ;-) Commented Aug 29, 2014 at 14:47
  • @Michael: that would definitely be too minor :P
    – nico
    Commented Aug 29, 2014 at 14:55
  • "Thank you" about what? It's noise on a question, on an answer is doesn't make any sense... Please, check Should 'Hi', 'thanks,' taglines, and salutations be removed from posts?
    – brasofilo
    Commented Aug 29, 2014 at 15:03
  • 5
    @brasofilo "Thank you" to the OP and others who improve the site by editing. Perfectly appropriate in a meta post such as this. Commented Aug 29, 2014 at 15:28
  • @ThisSuitIsBlackNot, I hear you. I missed the sub-text "Thank you (for doing the internet a better place)". Yes, indeed :)
    – brasofilo
    Commented Aug 29, 2014 at 20:06
14

I must add this is a must for those of us who aren't native English speakers.

Many times I wished to thank someone who editing one of my post to fix these kind of issues. This Meta question gave me that opportunity!

Having someone "kind enough" to fix both my grammar and my spelling not only improves the SO experience for those who read my answers/questions, but is also a great help for me in learning how to write better "less worse" English.

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .