Since I haven't seen any really big questions and the fact that when I watch the edits the interesting parts are highlighted, I wonder who is really reading the "Edit Summary" and especially why I should write something into it.
1 Answer
The edit summary is the place you justify your edit. For example in an edit that changes this code
if [$a -eq $b ]
to this
if [ "$a" -eq "$b" ]
I would write an edit summary like
The
[
needs spaces bofore and after, added quotes to prevent word splitting.
This explains to future readers why the edit is valid.
Especially when making a suggested edit, it is important to convince the reviewers that your edit is correct, otherwise they might reject it as invalid. The edit summary is a perfect place for that.
-
isn't it clear when watching it? and if so shouldn't it be explained in the context then instead of somewhere "hidden"? Commented Jul 25, 2014 at 13:48
-
3The reson for the edit is not always clear without the message. Commented Jul 25, 2014 at 13:50
-
1And, the edit reason is shown at the very top of the suggested edit, so it's (likely) the very first thing the reviewer sees. Commented Jul 11, 2015 at 22:48