Improve layout of the documentation for array

[ad-chaos]

Documentation

Taking a look at the documentation for array and specifically the methods and module level attributes it defines, we see the following.

The layout — mentioning a module level constant array.typecodes after the array class description and before the methods on the type, would suggest that typecodes is an attribute of the array type, but it is actually an attribute of the array module

If one reads carefully they'll notice the line that states

The following data items and methods are also supported:

But an eye that skims past that text might mistake it for being an attribute of the array type.

Maybe a clear demarcation between the module definitions and the functions defined by the array type would be more helpful.

Taking a look at another standard library datatype collections.Counter, here the class methods are shown right below its description.

The datetime module has a section that defines module level constants and then shows the types.

It would be nice to follow the same pattern for array.

Linked PRs

• gh-100925: List array methods under class in array doc #101239
• gh-100925: Move array methods under class in array doc #101485
• [3.11] gh-100925: Move array methods under class in array doc (GH-101485) #101527
• [3.10] gh-100925: Move array methods under class in array doc (GH-101485) #101528

[theWiseAman]

@ad-chaos Okay let me author a pull request for this.

Edit: I have created the PR #101239 for it. @gvanrossum Can you please review and merge it?
This is how it looks now.

[hauntsaninja]

Thanks, looks like this was refactored