jayvdb added a comment.

IMO the errors rejecting 'Create/Edit' and '(Un)protect' feel like an 
"over-reach" bug in pep257.  It feels like they are not allowing the first word 
to be .. interesting.  But to be fair, pep257 is partly intended to simplify 
docstrings , and thus help ESL-people to understand the documentation, so a 
simplistic definition of 'sentence' is not a bad thing.

Most of the others can be 'fixed' by starting the docstring with "Return ...", 
and will not cause a line length problem.  I personally find 'Return' at start 
of docstrings to be superfluous, but it probably helps ESL-people, and it 
solves the pep257 problem.


TASK DETAIL
  https://phabricator.wikimedia.org/T121365

EMAIL PREFERENCES
  https://phabricator.wikimedia.org/settings/panel/emailpreferences/

To: jayvdb
Cc: gerritbot, Aklapper, StudiesWorld, jayvdb, pywikibot-bugs-list



_______________________________________________
pywikibot-bugs mailing list
pywikibot-bugs@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/pywikibot-bugs

Reply via email to