18

After reading a Stack Overflow answer, wondering why the code in the answer didn't work, reading quite a bit further on the topic, I discovered that was because of an error in the answer.

I corrected the answer: enter image description here but my edit was rejected. Both reviewers respond:

This edit does not make the post even a little bit easier to read, easier to find, more accurate or more accessible. Changes are either completely superfluous or actively harm readability.

I can understand that the edit LOOKS this way, but in reality, it IS more accurate. The original answer is not valid Python code, the edited answer is valid Python code.

How do I appeal?

And is there a way to be notified when revisions are rejected?

9
  • 1
    but the answer seems to be about documentation? Not about creating code that can be interpreted by Python.
    – rene
    Sep 1, 2017 at 20:51
  • 11
    Leave a comment with the correction and enjoy the rest of your day.
    – user1228
    Sep 1, 2017 at 21:03
  • 14
    The answer states that the code is also a quote. You should not be changing the text or code from a quoted source at all. The only exception would be if the text at the source changed and you edited the quote to match.
    – BSMP
    Sep 2, 2017 at 3:18
  • 2
    Duplicate on meta.stackexchange: meta.stackexchange.com/q/113727/168269 Sep 2, 2017 at 22:44
  • 4
    The Sphinx documentation, it is not accurately quoted, so it would have been legitimate to fix that.
    – jdigital
    Sep 3, 2017 at 6:12
  • 5
    To avoid this, try to clearly state why exactly this is an improvement on the post, possibly with a link, either in the edit description or in a comment, to make it a whole lot easier for the reviewers. This is especially useful for edits that correct factual things (since reviewers might not be experienced in a certain programming language).
    – Erik A
    Sep 3, 2017 at 18:37
  • The original poster of that edit has now accepted your edit. As @ErikvonAsmuth says, you should assume that the reviewers are not subject experts, so try to be as specific as possible in the edit comment. Sep 6, 2017 at 7:24
  • Also, if the edit gets rejected, then you could leave a comment to the post with a pointer to the rejected edit, as the author may still approve it Sep 6, 2017 at 7:27
  • Yup, just had one of these where I was editing an answer dealing with code that I was the original author and designer of to make the use more idiomatic and to reduce the clutter in the answer.
    – kortschak
    Jul 5, 2018 at 8:42

1 Answer 1

10

The edit was minor but in my opinion correct. It might seem to untrained eye that this edit was incorrect, but the fact is that there are 2 distinct syntaxes: Sphinx syntax that is rendered into a document

.. py:function:: send_message(sender, recipient, message_body, [priority=1])

and Python syntax that would be

def send_message(sender, recipient, message_body, priority=1):

without brackets. The brackets are never correct in the Python code. The author "quoted", i.e. paraphrased the Sphinx documentation, without even referring to the actual page. In its current state, the post might lead someone to believe that there is such a syntax somewhere that would allow writing

def send_message(sender, recipient, message_body, [priority=1]):

when nothing now, one, or 5 years ago, would have accepted that. Thus Josiah's edit was in my opinion very valid and improved the post by removing confusion.


Addendum. In the case of quoting documentation, and the original link not pointing to the exact source of the quote, or the link missing altogether, your edit should also include a more precise link.

2
  • 3
    FWIW, i was the original author of that comment and approved the submission, while linking to the original code as well. i hope that satisfies everyone.
    – anarcat
    Sep 5, 2017 at 22:14
  • @anarcat excellent! Sep 6, 2017 at 7:21

You must log in to answer this question.

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