On Fri, Apr 30, 2021 at 6:57 AM Larry Hastings
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 now does this new thing [...]"
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". Also, I like to use :func:`foo` Sphinx markup
to add a link in the changelog, and Sphinx adds parentheses for me
*but* I don't add parentheses :-)
By the way, I recently discovered that :data:, :func:, :option:, etc.
accept references written as <ref>. Examples:
* :option:`-X utf8 <-X>`
* :data:`sys.flags.dev_mode