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