Message102087
> As per PEP 257, “Returns” should become “Return” (it’s a command, not a description).
Upstream ET uses JavaDoc conventions, where the conventions are
designed by technical writers, not hackers. In JavaDoc, descriptions
are 3rd person declarative (after all, the documentation describes
what the function does, not what you want it to do).
http://java.sun.com/j2se/javadoc/writingdoccomments/
The incompatibilities with Python's NIH-standards are unfortunate, but
that's the way it is. |
|
Date |
User |
Action |
Args |
2010-04-01 12:02:35 | effbot | set | recipients:
+ effbot, georg.brandl, jaraco, eric.araujo, MLModel, r.david.murray, flox |
2010-04-01 12:02:35 | effbot | set | messageid: <1270123355.34.0.146210893617.issue6488@psf.upfronthosting.co.za> |
2010-04-01 12:02:34 | effbot | link | issue6488 messages |
2010-04-01 12:02:33 | effbot | create | |
|