Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

A tweak in PEP 689 -- Unstable C API tier #185

Closed
encukou opened this issue Apr 24, 2023 · 1 comment
Closed

A tweak in PEP 689 -- Unstable C API tier #185

encukou opened this issue Apr 24, 2023 · 1 comment

Comments

@encukou
Copy link
Member

encukou commented Apr 24, 2023

Hi,
When reviewing PEP 689 PR, we found a slightly better policy for moving an API from the unstable tier to the public tier. Instead of:

- The old name should remain available until the first incompatible change
- is made or the API is removed.
+ The old name should remain available until the API is deprecated or removed.

The policy of keeping old names means users don't need to make unnecessary changes when unstable API matures. But a deprecation means you'll need to stop using the API eventually.
And if anyone uses the unstable name, they've already signed up for removals without a deprecation period.

Is that OK?

The published docs have the new text, I'll revert if you have objections.
For the PEP there's a PR with a rendered preview.

@Yhg1s
Copy link
Member

Yhg1s commented May 8, 2023

The SC is happy with the updated PEP.

@Yhg1s Yhg1s closed this as completed May 8, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants