Re: docstring verbs

2015-01-23 Thread Ryan Hiebert
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, Ti

docstring verbs

2015-01-23 Thread Tim Graham
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 w