PEP 823: Expand 'How to Teach This' to a mini-tutorial - #5177
gvanrossum merged 8 commits into
Conversation
Sorry, something went wrong.
There was a problem hiding this comment.
🟢 Approval recommended
The documentation-only changes explain the proposed behavior consistently, with no blocking issues identified.
No open issues 🎉
What changed in this PRExpands PEP 823’s teaching guidance into a mini-tutorial for the proposed None-aware operators.
Changes:
- Adds prerequisites, examples, chaining rules, and caveats.
- Explains when to use—and avoid—the operators.
- Removes an outdated cross-reference to the teaching section.
| File | Description |
|---|---|
| peps/pep-0823.rst | Expands teaching guidance and adjusts related explanatory text. |
Review effort: Balanced
Sorry, something went wrong.
Documentation build overview10 files changed · ± 9 modified · - 1 deleted ± Modified
- Deleted |
Sorry, something went wrong.
cdce8p
left a comment
There was a problem hiding this comment.
Thanks for putting this together! I agree let's include it, it's a much better use for that section. Left some minor comments.
Sorry, something went wrong.
|
It might also be good to add a short note to the (to be created) Change History section (after the footnotes). |
Sorry, something went wrong.
|
@cdce8p If you have any concerns with my changes in response to your feedback, let's open a new PR to address those concerns. |
Sorry, something went wrong.
|
Nothing more to add here. Thanks again @gvanrossum! |
Sorry, something went wrong.
Don't merge until @cdce8p (Marc Müller, the PEP author) has approved this.