Improve our towncrier template, to do the right thing after releases

[pradyunsg]

This also adds a bunch of comments, which should serve as useful guides
to future humans that work on these files.

[DiddiLeija]

Excellent! I was just gonna point a missing backticks, but then I saw you fixed them 😅.

[pradyunsg]

I was just gonna point a missing backticks

Eh, they were all in comments.

It is easier to just add eight characters, than to figure out how to disable the check which has caught this mistake in actual reST files. :)

[DiddiLeija]

It is easier to just add eight characters, than to figure out how to disable the check which has caught this mistake in actual reST files. :)

Yup :)

Now, what is happening with the vendoring step? Maybe this is related to #10570

[pradyunsg]

Yup yup, it’s exactly that.

[uranusjr]

I'm going to assume you already figured out all the - newline suppressions because I never could myself.

[sbidoul]

Is there an abbreviation for "looks like you know what you are doin'" ? :)

[pradyunsg]

I'm going to assume you already figured out all the - newline suppressions because I never could myself.

One of the joys of writing a Sphinx theme. 😅

The big quirk is that towncrier sets trim_blocks=True in Jinja, which makes it a bit more difficult to reason about.

Is there an abbreviation for "looks like you know what you are doin'" ? :)

😅