Why you don't simplify with api A,B,C and  forth and then follows explanation ofr what is stable, unstable, semi... So forth....

On Wed, May 4, 2022, 6:10 AM Petr Viktorin <encukou@gmail.com> wrote:

On 29. 04. 22 19:02, Guido van Rossum wrote:
> On Fri, Apr 29, 2022 at 10:15 AM Petr Viktorin <encukou@gmail.com
> <mailto:encukou@gmail.com>> wrote:
>     On 29. 04. 22 16:32, Victor Stinner wrote:
>      > Ok, let me start with the serious business: API name.
>      >
>      > I'm not comfortable with "semi-stable". Python already has a "limited
>      > API" and a "stable ABI". Just by its name, it's unclear what
>      > "semi-stable" means.
>     Nick Coghlan argued against that term:
>     But I also like “unstable” better than “semi-stable”. Splitting the
>     internals into “private”/“internal” and “unstable” seems reasonable.
> I think picking "semi-stable" would be giving in to the OCD nerd in all
> of us. :-) While perhaps technically less precise, "unstable" is the
> catchy name with the right association. (And yes, we should keep it
> stable within bugfix releases, but the name doesn't need to reflect that
> detail.) The "internal API" isn't an API at all (except for CPython core
> developers and contributors). The "unstable API" would definitely be an
> *API* for users outside the core.
> So let's please go with "unstable".

Thanks, you worded that perfectly!

Alright, the PEP now uses “unstable” rather than “semi-stable”. And I
don't see any issues with the technical details, so I'll see if it can
still get into Python 3.11. Hopefully Pablo agrees as the Release Manager.
Thanks for the discussion, everyone!
Python-Dev mailing list -- python-dev@python.org
To unsubscribe send an email to python-dev-leave@python.org
Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/L6IGXJ5OM2GHAFTAEWWB35STT3MBQL2J/
Code of Conduct: http://python.org/psf/codeofconduct/