Automatically document Array members

[dstansby]

This PR uses the automodapi sphinx extension to automatically document members of the Array class. Previously these were manually listed, meaning they have to be manually updated every time the actual method or property is updated in the code. Now they are autogenerated.

Fixes #1546

TODO:

• Add unit tests and/or doctests in docstrings
• Add docstrings and API docs for any new/modified user-facing classes and functions
• New/modified features documented in docs/tutorial.rst
• Changes documented in docs/release.rst
• GitHub Actions have all passed
• Test coverage is 100% (Codecov passes)

[d-v-b]

this is great, thank you!

[dstansby]

Hmm, it seems like the link to the Array class is broken in the doc build: https://zarr--1547.org.readthedocs.build/en/1547/api/core.html - I'll take a look and try and fix.

[codecov]

Codecov Report

Merging #1547 (5ca3c93) into main (8a7b415) will decrease coverage by 0.01%.
The diff coverage is 100.00%.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1547      +/-   ##
==========================================
- Coverage   99.99%   99.99%   -0.01%     
==========================================
  Files          37       37              
  Lines       14740    14737       -3     
==========================================
- Hits        14739    14736       -3     
  Misses          1        1              

Files	Coverage Δ
zarr/core.py	100.00% <100.00%> (ø)

... and 3 files with indirect coverage changes

[dstansby]

This is fixed up now: https://zarr--1547.org.readthedocs.build/en/1547/api/core.html

[joshmoore]

Wow. Nice, @dstansby! Even got rid of a few items that were incorrectly listed! (compression, compression_opts, dimension_separator). Thanks again.