Move deprecation notices to the top of docstrings#2637

dstansby merged 3 commits intozarr-developers:mainzarr-developers/zarr-python:mainfrom

dstansby:deprecation-docstringsdstansby/zarr-python:deprecation-docstringsCopy head branch name to clipboard