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

On Fri, Apr 30, 2021, 16:28 wrote: > This was also my understanding. The last time I looked at writing good > commit messages (a similar form), the standard was to finish the sentence: > "This commit will...", e.g. "This commit will fix buffalo.spam" from "Fix > buffalo.spam". > I like this a

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

On Fri, Apr 30, 2021 at 02:22 Steven D'Aprano > wrote: Without a subject of the sentence, that's not present tense, it is the imperative mood.     "Fix buffalo.spam ..." is a command or suggestion. While it could be read that way, I don't think

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

By the way, https://docs.python.org/dev/whatsnew/3.10.html#improved-modules is inconsistent: "asyncio: Added missing ..." versus "base64: Add base64.b32hexencode() ..." You can also find such inconsistencies in "versionchanged" markups. Victor On Fri, Apr 30, 2021 at 5:01 AM Larry Hastings

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

A lot of times the present tense in changelogs and similar is the English "historical present", also called "narrative present." When the verb comes first, it is usually imperative, but these shade with context. E.g. * Give class Froz a .bar() method * Adding metaclass gives class Froz a .bar()

[Python-Dev] Re: PEP 654: Exception Groups and except* [REPOST]

Nathaniel Smith (in a conversation with Irit) wrote: > ... suggested having each > 'except Blah as exc' clause be executed once, receiving an > ExceptionGroup containing all the Blah exceptions. Guido pointed out > that this broke typing -- 'exc' would not longer have type 'Blah' -- > and I was

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

This was also my understanding. The last time I looked at writing good commit messages (a similar form), the standard was to finish the sentence: "This commit will...", e.g. "This commit will fix buffalo.spam" from "Fix buffalo.spam". ___ Python-Dev

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

Hm, I actually like the imperative. In a commit or news message it feels very natural to me. And in that context there is no confusion about whether we’re commanding anyone (maybe we’re commanding git? :-). But I am the ultimate intuitive writer — I never took a class in English grammar or

[Python-Dev] Summary of Python tracker Issues

ACTIVITY SUMMARY (2021-04-23 - 2021-04-30) Python tracker at https://bugs.python.org/ To view or respond to any of the issues listed below, click on the issue. Do NOT respond to this message. Issues counts and deltas: open7453 (-21) closed 48273 (+86) total 55726 (+65) Open issues

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

On Apr 30, 2021, at 04:11, Antoine Pitrou wrote: > > On Thu, 29 Apr 2021 21:52:14 -0700 > Larry Hastings 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 [...] >> *

[Python-Dev] Re: SC feedback: PEP 648 -- Extensible customizations of the interpreter at startup

Hello All, I've pushed a change to rework a bit the pep wording and add further details on its working. It needed indeed some extra work. PR still in flight: https://github.com/python/peps/pull/1941 I've also changed it to target 3.11. I believe most of your concerns should be answered in the PEP

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

On 4/30/21 4:51 AM, Victor Stinner wrote: On Fri, Apr 30, 2021 at 6:57 AM Larry Hastings wrote: Function and class names should not be followed by parentheses, unless demonstrating an example call. Oh, I love putting parentheses when mentionning a function: "foo() now does thigs new thing".

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

On Thu, Apr 29, 2021 at 09:52:14PM -0700, Larry Hastings 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: Without a subject of the sentence, that's not present tense, it is the imperative

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

On Fri, Apr 30, 2021 at 6:57 AM Larry Hastings wrote: > 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 [...] You might suggest using "now" when describing a behavior change: "foo

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

On Fri, Apr 30, 2021 at 6:22 AM Guido van Rossum wrote: > There’s something in the dev guide, but not about tense. Worth adding. (My > pet peeve is not to write “The foo module resets the bar state when spam > happens,” because that isn’t clear about whether that’s the before or after >

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

On Thu, 29 Apr 2021 21:52:14 -0700 Larry Hastings 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

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

On Fri, Apr 30, 2021 at 09:43:44AM +0300, Serhiy Storchaka wrote: > 30.04.21 05:57, Larry Hastings пише: > > When one writes one's "blurb" for the changelog, in what tense should it > > be? > > See the previous discussion on this topic: >

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

30.04.21 05:57, Larry Hastings пише: > When one writes one's "blurb" for the changelog, in what tense should it > be? See the previous discussion on this topic: https://mail.python.org/archives/list/python-dev@python.org/thread/C342Y73LALVFLI2ACFB3SH6ZDT2YTGPC/ . I always use "fixed", "removed",