From: Guenter M. <mi...@us...> - 2025-03-03 13:42:34
|
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 |