[Python-Dev] Re: In what tense should the changelog be written?

2021年4月30日 09:32:22 -0700

On Apr 30, 2021, at 04:11, Antoine Pitrou <[email protected]> wrote:
> 
> On 2021年4月29日 21:52:14 -0700
> Larry Hastings <[email protected]> wrote:
>> D'oh! I have a second draft already.
>> 
>> Your NEWS entry should be written in the /present tense,/ and should
>> start with a verb:
>> 
>> * Add foo [...]
>> * Change bar [...]
>> * Remove bat [...]
>> * Fix buffalo.spam [...]
>> 
>> Function and class names should not be followed by parentheses,
>> unless demonstrating an example call.
>> 
>> 
>> Slapping my forehead,
> 
> You probably mean "Slap my forehead".
Actually, he probably meant "Slappa da bayss".
-Barry
P.S. I was going to say that I prefer past tense when writing news items, but 
then I looked at the change log files for some of my personal projects and I 
came to the shocking realization that I actually don’t! Looks like the FLUFL 
prefers present tense.
I do however like to use parentheses for functions and methods.
-Barry

Attachment: signature.asc
Description: Message signed with OpenPGP

_______________________________________________
Python-Dev mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3/lists/python-dev.python.org/
Message archived at 
https://mail.python.org/archives/list/[email protected]/message/2AJW22GLM2YXCCAZBMARGU3UI4MFWV4Y/
Code of Conduct: http://python.org/psf/codeofconduct/

Reply via email to