Skip to content

gh-133510: Added Resources section #133559

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

Closed
wants to merge 1 commit into from

Conversation

Nneoma00
Copy link

@Nneoma00 Nneoma00 commented May 7, 2025

Issue #133511 :
points out the lack of detailed examples and use cases for the match statement in Python

I added a resources section, and listed 2 sites(hyperlinks) for beginners seeking examples/tutorials to find, in addition to the previously linked PEP 636 tutorial.


📚 Documentation preview 📚: https://cpython-previews--133559.org.readthedocs.build/

@python-cla-bot
Copy link

python-cla-bot bot commented May 7, 2025

All commit authors signed the Contributor License Agreement.

CLA signed

@bedevere-app bedevere-app bot added docs Documentation in the Doc dir skip news awaiting review labels May 7, 2025
@github-project-automation github-project-automation bot moved this to Todo in Docs PRs May 7, 2025
@ZeroIntensity ZeroIntensity changed the title Fix issue: #133511: Added Resources section gh-133511: Added Resources section May 7, 2025
@ZeroIntensity ZeroIntensity changed the title gh-133511: Added Resources section gh-133510: Added Resources section May 7, 2025
Copy link
Member

@ZeroIntensity ZeroIntensity left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There's already a PR up for gh-133510, and we shouldn't be linking to other Python tutorials.

For more detailed explanation and additional examples, you can look into the
following resources, which are written in tutorial format:
- :pep:`636`
- `W3Schools <https://www.w3schools.com/python/python_match.asp>`_
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think it's a good idea to link to other documentation pages that we don't control. I'm particularly against linking W3Schools, considering their example of creating a tuple looks like this:

x = tuple(("apple", "banana", "cherry"))

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
awaiting core review docs Documentation in the Doc dir skip news
Projects
Status: Todo
Development

Successfully merging this pull request may close these issues.

3 participants