-
-
Notifications
You must be signed in to change notification settings - Fork 33.6k
Doc: mark up classes, attributes, parameters, and methods in dataclasses.rst #117820
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
Doc: mark up classes, attributes, parameters, and methods in dataclasses.rst #117820
Conversation
ericvsmith
left a comment
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 don't know enough about sphinx to do a decent review here, but I don't see anything obviously wrong.
hugovk
left a comment
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 👍
Another little improvement that could be in this or another PR, in the first paragraph:
-adding generated :term:`special method`\s such as :meth:`~object.__init__` and
+adding generated :term:`special methods <special method>` such as :meth:`~object.__init__` and"generated special methods" -> "generated special methods"
(We already have it like this further down the page.)
|
Thanks for the reviews! |
|
Thanks for chiming in Alex 🙏 I think we can land this now. |
AlexWaygood
left a comment
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.
Thanks!
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
…ses.rst (pythonGH-117820) (cherry picked from commit e018317) Co-authored-by: Erlend E. Aasland <erlend@python.org>
|
GH-117877 is a backport of this pull request to the 3.12 branch. |
📚 Documentation preview 📚: https://cpython-previews--117820.org.readthedocs.build/en/117820/library/dataclasses.html