Message416760
| Author |
slateny |
| Recipients |
belopolsky, docs@python, fdrake, p-ganssle, slateny |
| Date |
2022年04月05日.07:58:04 |
| SpamBayes Score |
-1.0 |
| Marked as misclassified |
Yes |
| Message-id |
<1649145484.32.0.775961793852.issue47207@roundup.psfhosted.org> |
| In-reply-to |
| Content |
Is there a bpo page or some sort that discusses why the imperative mood is used over the indicative mood other than convention of PEP 257? I found this (https://mail.python.org/pipermail/tutor/2012-May/089584.html) question and answer that seems to make sense, but it's not quite an official source.
If the reason for using imperative mood in docstrings doesn't apply to documentation, then I think there wouldn't be any problems in changing it. One thing raised in the mail thread was that 'Returns ...' isn't strictly grammatical, so perhaps that's something to consider. |
|
History
|
|---|
| Date |
User |
Action |
Args |
| 2022年04月05日 07:58:04 | slateny | set | recipients:
+ slateny, fdrake, belopolsky, docs@python, p-ganssle |
| 2022年04月05日 07:58:04 | slateny | set | messageid: <1649145484.32.0.775961793852.issue47207@roundup.psfhosted.org> |
| 2022年04月05日 07:58:04 | slateny | link | issue47207 messages |
| 2022年04月05日 07:58:04 | slateny | create |
|