Re: [Docutils-develop] time to release 0.22.b1 ?

Dear Adam, Engelbert, docutils developers,

back from the winter holidays...

On 2025-02-22, Adam Turner wrote:

>> how about releasing 0.22?

> Sounds good! I want to review the situation around type annotations
> before releasing, and I might revert some of the changes I have made.
> There are also a few updates to the packaging metadata we can take the
> opportunity to make before releasing.

Fine. Feel free to commit small, non-controversial changes right away
(bit for bit, so that I can have a look) and discuss the complex and
ambiguous ones either on this list, in private mail or the project tickets.
What would be your proposed timeframe? (I will be offline next week.)

>> IMO, we should start with a beta release, to give downstream users an easy
>> chance to test without breaking installations with `pip` auto-updates.

> Sphinx 8.2. (released last week) is fully compatible with Docutils
> master (although there are some deprecation warnings). 

We should try to solve the deprecation warnings. There should be a
documented way forward, if not, report back and well find a solution 
(as a last restort, we'll turn them into pending deprecation warnings).

Could you also test building a typical Sphinx doctree with the new
"validate__" parser setting set to True?
There may be problems with the custom nodes added by Sphinx.
(The setting was added due to a feature-request by a Sphinx-extension
developer.)

__ https://docutils.sourceforge.io/docs/user/config.html#validate

> I think we can request that other projects test a release candidate, as
> with previous releases.

I have no strong preference whether we call the next release 0.22rc1 or
0.22b1. (It depends on the probability of pending non-trivial changes.)

> I am happy to help with the release (perhaps publishing a release
> candidate), I think it might be useful to have more people who can do
> releases, to share the work and remove pressure on individuals. If this
> would be helpful, please could I be added to the Docutils PyPI project
> [1]_? My username on PyPI is ``AA-Turner`` [2]_.

Could you co-ordinate this with Engelbert, please?

> I can probably also co-ordinate with the downstream projects, should
> this be useful.

Thanks for the offer. For projects where the contact is via github, this
may be helpfull.

sincerely,

Günter