-
-
Notifications
You must be signed in to change notification settings - Fork 31.3k
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
gh-129015: Move link supression around in a Note for exceptions.rst #129562
Conversation
This makes it similar to the same text in constants.rst.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good
Requesting @picnixz |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'll merge this one once I'm back. Otherwise @Eclips4 may do it if he has time.
@nexushoratio I've taken over your branch 😈 so you can still the credited commit. Thanks for the initial work and for spotting this discrepency which is important as many users mistake those two (I was mistaken when I first started learning Python!!!) |
@AA-Turner friendly ping |
@AA-Turner I'd like to merge this one with the following commit title gh-129015: Clarify notes for `NotImplemented` and `NotImplementedError` (#129564) I don't really know how to explain that I changed the box from notes to caution without using sloppy English. Do you have some suggestions? |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Sounds good! Perhaps "Improve disambiguation between `NotImplemented` and `NotImplementedError`
"? But your proposed commit message is also fine, a "caution" admonition is just a fancy nota bene to the reader!
A
I will take your suggestion as it indicates more cleanly what was improved. Mine was too generic. Thanks! |
Thanks @nexushoratio for the PR, and @picnixz for merging it 🌮🎉.. I'm working now to backport this PR to: 3.12, 3.13. |
…`NotImplementedError` (pythonGH-129562) --------- (cherry picked from commit a85eeb9) Co-authored-by: Mike Castle <[email protected]> Co-authored-by: Bénédikt Tran <[email protected]> Co-authored-by: Adam Turner <[email protected]>
GH-130776 is a backport of this pull request to the 3.13 branch. |
…`NotImplementedError` (pythonGH-129562) --------- (cherry picked from commit a85eeb9) Co-authored-by: Mike Castle <[email protected]> Co-authored-by: Bénédikt Tran <[email protected]> Co-authored-by: Adam Turner <[email protected]>
GH-130777 is a backport of this pull request to the 3.12 branch. |
… `NotImplementedError` (GH-129562) (#130776) gh-129015: Improve disambiguation between `NotImplemented` and `NotImplementedError` (GH-129562) --------- (cherry picked from commit a85eeb9) Co-authored-by: Mike Castle <[email protected]> Co-authored-by: Bénédikt Tran <[email protected]> Co-authored-by: Adam Turner <[email protected]>
… `NotImplementedError` (GH-129562) (#130777) gh-129015: Improve disambiguation between `NotImplemented` and `NotImplementedError` (GH-129562) --------- (cherry picked from commit a85eeb9) Co-authored-by: Mike Castle <[email protected]> Co-authored-by: Bénédikt Tran <[email protected]> Co-authored-by: Adam Turner <[email protected]>
This makes it similar to the same text in constants.rst.
NotImplementedError
andNotImplemented
have inconsistent linking #129015📚 Documentation preview 📚: https://cpython-previews--129562.org.readthedocs.build/