Re: [Docutils-develop] Release 0.20

[Guenter M. <mi...@us...>]

Dear Docutils developers,

On 2023-04-23, Adam Turner wrote:

> I have tested on Ubuntu 22.04 LTS and Windows 10, and against Sphinx.
> All tests are passing, 

Good news. What are the tested Python versions?
Could someone test with Python 3.11?

> though I would strongly reccomend to apply the
> attached patch to avoid a false-positive warning during testing.

I agree with the patch.


...

> Please may we release a 0.20b1 first so that I might ask downstream
> projects to test, as with the 0.19 release?

My experience from the latest pre-releases was minimal to no feedback.
However, if you have other experiences of expectations, I agree with a
pre-release. 

I suggest "rc1" instead of "beta" (as I really like
0.20 coming out soon and rather see a not too distant 0.21...).


...

>> The API documentation "publisher.txt" now has the example

>>     output = bytes(publish_string(...))

>> (which depends on `OutputString` features).

> Can we mark this feature as provisional? Personally, I don't think
> that we should support this form of ``bytes`` conversion long-term,
> and I see the ``OutputString`` as a transitional class, again not
> one that will be around for a long time.

OK.

...

> Sorry for the rather long message appended to a release thread, but
> as you note, perhaps the decision cannot be delayed, as the
> documentation contains a recipie that we may later regret declaring
> support for.

My suggestion for the next steps:

* "Thaw" the repository.

* Push "deprecation warning" patch (Adam).

* Reach a consensus about the parts of `publish_string()`
  that need to be settled in release 0.20 (see separate reply).

  Implement/revert changes. (GM)
  
* Release 0.21rc1 (Engelbert?)


@engelbert: Can we thaw for "last minute fixes".


Günter