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