docstring cleanup

[d-v-b]

This PR will do two things:

• remove outdated references to configuration options for controlling codecs (thereby closing DOC: Configuration value 'array.v3_default_compressors' has been removed, but is still documented #3389)
• make some of our function / method docstrings more consistent across the async / sync boundary.

The reason for two things in this PR, instead of 1, is that changing docstrings in zarr python is incredibly tedious because we have a lot of similar functions, with very similar docstrings: we have asynchronous.create, synchronous.create, asynchronous.create_array, synchronous.create_array, Group.create_array, AsyncGroup.create_array, init_array, from_array, ... So any PR that changes docstrings needs to be sure that all relevant docstrings are updated. This is more work, but it's part of the spirit of "leaving things better than you found it".

edit: this PR grew in scope, but not complexity. So I think it's fine to keep this in one PR.
Here's a list of the changes:

• remove outdated references to configuration options for controlling codecs (thereby closing DOC: Configuration value 'array.v3_default_compressors' has been removed, but is still documented #3389)
• Ensure that all docstrings for store parameters are consistent. They are all now correctly reporting the type of the parameter as StoreLike
• Test that array creation function/methods which use the same parameters have those parameters declared identically in docstrings. We could expand these tests as needed to include more functions, but I wanted to focus on array creation routines for now because removing the outdated config content touched the docstrings for compressor, serializer, and filters extensively, so these needed to be tested.
• Where necessary, change docstrings to pass the above tests.

One specific change: I normalized a large number of store docstring declarations to store : StoreLike or None, default=None (obviously this is only for functions where the store parameter is nullable). This is consistent with NumpyDoc and more informative that just saying "StoreLike, optional", because the latter does not convey what the default value is.

[codecov]

Codecov Report

❌ Patch coverage is 0% with 2 lines in your changes missing coverage. Please review.
✅ Project coverage is 60.58%. Comparing base (62d1a6a) to head (6422761).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
src/zarr/core/group.py	0.00%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3390      +/-   ##
==========================================
+ Coverage   60.54%   60.58%   +0.04%     
==========================================
  Files          81       81              
  Lines        9701     9694       -7     
==========================================
  Hits         5873     5873              
+ Misses       3828     3821       -7     

Files with missing lines	Coverage Δ
src/zarr/api/asynchronous.py	71.92% <ø> (ø)
src/zarr/api/synchronous.py	36.61% <ø> (ø)
src/zarr/core/array.py	69.13% <ø> (+0.49%)	⬆️
src/zarr/storage/_common.py	66.84% <ø> (ø)
src/zarr/core/group.py	70.51% <0.00%> (ø)

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[d-v-b]

would be great to get some eyes on this @zarr-developers/python-core-devs

[TomAugspurger]

Thanks. Just some formatting issues I spotted.

[d-v-b]

@TomAugspurger thanks for the fixes! tests are failing (as they should) because we only fixed one instance of a docstring that's duplicated across multiple functions. i'll get those fixes propagated, and then this should go green