I follow the PEP for at least 3 reasons: 1. The PEP. I like using the Python standards. 2. It matches a (the primary?) widespread convention for commit messages. 3. Imperative verbs tend to also be the shortest of the tenses, so that’s a nice side-effect.
Ryan > On Jan 23, 2015, at 11:27 AM, Tim Graham <[email protected]> wrote: > > The current version of our style guide [1] recommends to use "action verbs" > (Checks instead of Check). However this contradicts PEP 257 (Docstring > Conventions) [2]. The current code mixes these two forms. Claude advocates to > follow the PEP [3]. Anyone care to comment on the historical reason we > deviated from it and whether or not we should switch? > > [1] > https://docs.djangoproject.com/en/dev/internals/contributing/writing-code/coding-style/#python-style > > [2] https://www.python.org/dev/peps/pep-0257/ > > [3] https://code.djangoproject.com/ticket/24175 > > -- > You received this message because you are subscribed to the Google Groups > "Django developers (Contributions to Django itself)" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected] > <mailto:[email protected]>. > To post to this group, send email to [email protected] > <mailto:[email protected]>. > Visit this group at http://groups.google.com/group/django-developers > <http://groups.google.com/group/django-developers>. > To view this discussion on the web visit > https://groups.google.com/d/msgid/django-developers/a37f3514-1d2e-46b0-b104-c020166b8125%40googlegroups.com > > <https://groups.google.com/d/msgid/django-developers/a37f3514-1d2e-46b0-b104-c020166b8125%40googlegroups.com?utm_medium=email&utm_source=footer>. > For more options, visit https://groups.google.com/d/optout > <https://groups.google.com/d/optout>. -- You received this message because you are subscribed to the Google Groups "Django developers (Contributions to Django itself)" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/django-developers. To view this discussion on the web visit https://groups.google.com/d/msgid/django-developers/5EB6D262-380E-4401-9A68-B57F63E09811%40ryanhiebert.com. For more options, visit https://groups.google.com/d/optout.
