Skip to content

gh-100925: Move array methods under class in array doc #101485

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

Merged

Conversation

CAM-Gerlach
Copy link
Member

@CAM-Gerlach CAM-Gerlach commented Feb 1, 2023

This fixes the issue reported in #100925 , where the attributes and methods of the array.array class are listed under the module rather than the class, and not clearly indicated as such, which is confusing to readers. This supersedes #101239 , which didn't quite solve the right problem; thanks @theWiseAman for your original PR that prompted this.

Also a followup to #98657 , which just fixed this for the one module-level attribute. As both of these are a fix to a docs defect that applies to all supported versions, ensures the stable version will be updated to avoid more reports like the one that prompted this one, and allows future PRs to be cleanly backported, I've queued up backports for both that PR, #98729 and this one, the latter of which should be merged first before this PR is, so that miss-islington can do the backports of this one cleanly:

To note, since the class name was included in the existing method/attribute directives, this change doesn't break any internal or Intersphinx links, and also maintains the same fragment ids, so external links will continue to work exactly the same as before. Therefore, I've confirmed it is fully backward-compatible.

Before After
image image

Closes #101239

@CAM-Gerlach CAM-Gerlach marked this pull request as draft February 1, 2023 04:44
@CAM-Gerlach
Copy link
Member Author

Just to be sure, marking as draft so this isn't merged until #101483 and #101484 are.

@CAM-Gerlach
Copy link
Member Author

@ezio-melotti @JelleZijlstra thanks for the reviews here; would one of you be able to help merge the prior backports to unblock this? Thanks!

@CAM-Gerlach CAM-Gerlach marked this pull request as ready for review February 2, 2023 23:53
@CAM-Gerlach
Copy link
Member Author

Looks like this is ready @JelleZijlstra and @ezio-melotti

Thanks for your help here!

@ezio-melotti ezio-melotti merged commit 1b60456 into python:main Feb 3, 2023
@miss-islington
Copy link
Contributor

Thanks @CAM-Gerlach for the PR, and @ezio-melotti for merging it 🌮🎉.. I'm working now to backport this PR to: 3.10, 3.11.
🐍🍒⛏🤖

@bedevere-bot
Copy link

GH-101527 is a backport of this pull request to the 3.11 branch.

@bedevere-bot bedevere-bot removed the needs backport to 3.11 only security fixes label Feb 3, 2023
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Feb 3, 2023
…H-101485)

* Move array methods under class in array doc

* Fix a few internal references related to the touched lines
(cherry picked from commit 1b60456)

Co-authored-by: C.A.M. Gerlach <[email protected]>
@bedevere-bot
Copy link

GH-101528 is a backport of this pull request to the 3.10 branch.

@bedevere-bot bedevere-bot removed the needs backport to 3.10 only security fixes label Feb 3, 2023
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Feb 3, 2023
…H-101485)

* Move array methods under class in array doc

* Fix a few internal references related to the touched lines
(cherry picked from commit 1b60456)

Co-authored-by: C.A.M. Gerlach <[email protected]>
miss-islington added a commit that referenced this pull request Feb 3, 2023
* Move array methods under class in array doc

* Fix a few internal references related to the touched lines
(cherry picked from commit 1b60456)

Co-authored-by: C.A.M. Gerlach <[email protected]>
miss-islington added a commit that referenced this pull request Feb 3, 2023
* Move array methods under class in array doc

* Fix a few internal references related to the touched lines
(cherry picked from commit 1b60456)

Co-authored-by: C.A.M. Gerlach <[email protected]>
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 news
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants