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

gh-101100: Add a table of class attributes to the "Custom classes" section of the data model docs #124480

Merged
merged 6 commits into from
Sep 25, 2024

Conversation

AlexWaygood
Copy link
Member

@AlexWaygood AlexWaygood commented Sep 25, 2024

  • Convert the attribute references in the "Custom classes" section to a list table
  • Refer to the attributes as type.__*__ rather than class.__*__; this reflects the reality at runtime
  • Make sure all attribute references for custom classes are referenceable from other files
  • Add references for attributes that were not previously documented (such as __qualname__), and move some references from library/stdtypes.rst to the datamodel docs so that references for all class attributes can be found in a single location
  • Update and improve references to class attributes from other files so that they properly link to the canonical entries in the table
  • Fix 21 or so Sphinx nitpicks in the process

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

@bedevere-app bedevere-app bot added docs Documentation in the Doc dir skip news labels Sep 25, 2024
@AlexWaygood AlexWaygood added needs backport to 3.12 bug and security fixes needs backport to 3.13 bugs and security fixes labels Sep 25, 2024
Doc/faq/programming.rst Show resolved Hide resolved
Doc/whatsnew/2.2.rst Outdated Show resolved Hide resolved
Copy link
Contributor

@willingc willingc left a comment

Choose a reason for hiding this comment

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

Looks good @AlexWaygood. Thanks for doing this table.

As an FYI, it's much faster to review when the nitpick fixes are a separate PR. Makes it a little easier to grok what the new addition contains. No worries for this PR.

@AlexWaygood
Copy link
Member Author

As an FYI, it's much faster to review when the nitpick fixes are a separate PR. Makes it a little easier to grok what the new addition contains. No worries for this PR.

Thanks -- I'll separate it out into two PRs next time!

@AlexWaygood AlexWaygood enabled auto-merge (squash) September 25, 2024 18:51
@AlexWaygood AlexWaygood merged commit 0d9d56c into python:main Sep 25, 2024
23 checks passed
@AlexWaygood AlexWaygood deleted the class-attrs-docs branch September 25, 2024 19:29
@miss-islington-app
Copy link

Thanks @AlexWaygood for the PR 🌮🎉.. I'm working now to backport this PR to: 3.12, 3.13.
🐍🍒⛏🤖

@miss-islington-app
Copy link

Sorry, @AlexWaygood, I could not cleanly backport this to 3.13 due to a conflict.
Please backport using cherry_picker on command line.

cherry_picker 0d9d56c4e4246495f506f7fb319548fb105b535b 3.13

@miss-islington-app
Copy link

Sorry, @AlexWaygood, I could not cleanly backport this to 3.12 due to a conflict.
Please backport using cherry_picker on command line.

cherry_picker 0d9d56c4e4246495f506f7fb319548fb105b535b 3.12

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Documentation in the Doc dir needs backport to 3.12 bug and security fixes needs backport to 3.13 bugs and security fixes skip news
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants