Skip to content

Doc: mark up classes, attributes, parameters, and methods in dataclasses.rst#117820

Merged
erlend-aasland merged 12 commits into
python:mainfrom
erlend-aasland:docs/dataclasses-markup-params
Apr 14, 2024
Merged

Doc: mark up classes, attributes, parameters, and methods in dataclasses.rst#117820
erlend-aasland merged 12 commits into
python:mainfrom
erlend-aasland:docs/dataclasses-markup-params

Conversation

@erlend-aasland

@erlend-aasland erlend-aasland commented Apr 12, 2024

Copy link
Copy Markdown
Contributor

@ericvsmith ericvsmith left a comment

Copy link
Copy Markdown
Member

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.

Comment thread Doc/library/dataclasses.rst Outdated

@hugovk hugovk left a comment

Copy link
Copy Markdown
Member

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.)

@erlend-aasland

Copy link
Copy Markdown
Contributor Author

Thanks for the reviews!

@erlend-aasland erlend-aasland enabled auto-merge (squash) April 14, 2024 10:10
Comment thread Doc/library/dataclasses.rst Outdated
@AlexWaygood AlexWaygood disabled auto-merge April 14, 2024 10:21
@erlend-aasland

Copy link
Copy Markdown
Contributor Author

Thanks for chiming in Alex 🙏 I think we can land this now.

Comment thread Doc/library/dataclasses.rst Outdated
Comment thread Doc/library/dataclasses.rst Outdated
Comment thread Doc/library/dataclasses.rst

@AlexWaygood AlexWaygood left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Thanks!

@erlend-aasland erlend-aasland enabled auto-merge (squash) April 14, 2024 16:26
@erlend-aasland erlend-aasland merged commit e018317 into python:main Apr 14, 2024
@erlend-aasland erlend-aasland deleted the docs/dataclasses-markup-params branch April 14, 2024 16:29
@miss-islington-app

This comment was marked as outdated.

@miss-islington-app

This comment was marked as outdated.

@erlend-aasland erlend-aasland added needs backport to 3.12 only security fixes and removed needs backport to 3.12 only security fixes labels Apr 14, 2024
@miss-islington-app

This comment was marked as outdated.

miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Apr 14, 2024
…ses.rst (pythonGH-117820)

(cherry picked from commit e018317)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
@bedevere-app

bedevere-app Bot commented Apr 14, 2024

Copy link
Copy Markdown

GH-117877 is a backport of this pull request to the 3.12 branch.

@bedevere-app bedevere-app Bot removed the needs backport to 3.12 only security fixes label Apr 14, 2024
erlend-aasland added a commit that referenced this pull request Apr 14, 2024
…ataclasses.rst (GH-117820) (#117877)

(cherry picked from commit e018317)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
diegorusso pushed a commit to diegorusso/cpython that referenced this pull request Apr 17, 2024
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 skip issue skip news

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants