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 firstname.lastname@example.org wrote:
On 29. 04. 22 19:02, Guido van Rossum wrote:
On Fri, Apr 29, 2022 at 10:15 AM Petr Viktorin <email@example.com mailto:firstname.lastname@example.org> 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
> 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 -- email@example.com To unsubscribe send an email to firstname.lastname@example.org https://mail.python.org/mailman3/lists/python-dev.python.org/ Message archived at https://email@example.com/message/L6IGXJ5O... Code of Conduct: http://python.org/psf/codeofconduct/