[v3] consider using position only and keyword only arguments

[joshmoore]

As a side note we might consider using position only and keyword only arguments in Zarr 3 to avoid these issues around renaming arguments.

Originally posted by @jakirkham in https://github.com/zarr-developers/zarr-python/issues/1018#issuecomment-1116879414

[jhamman]

@jakirkham and @joshmoore - would either of you care to expand on this issue to make it more actionable?

[joshmoore]

My limited memory, @jhamman, is that for signatures with very long lists of arguments, maintaining the ordering of those lists becomes a burden and therefore one can make use of keyword only arguments -- https://peps.python.org/pep-3102/ -- to simplify things.

[jhamman]

My first attempt at recreating the top level API for v3 definitely highlighted that this would be useful. I could use some input on #1884 deciding how best to introduce this.