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

Re: Fellow Report - January 16, 2015

2015-01-23 Thread Tino de Bruijn
Hi Tim, Here a non-core-team perspective. Although I haven't worked on any Django bugs or code lately, I do frequently read this mailinglist. It was nice to see your weekly status updates (and Berker's), the updates and work on release blockers and the releases themselves. I got the feeling Django