Add cross-references to storage

Author: maxrjones

docs/user-guide/storage.md

@@ -3,7 +3,7 @@
 Zarr-Python supports multiple storage backends, including: local file systems,
 Zip files, remote stores via [fsspec](https://filesystem-spec.readthedocs.io) (S3, HTTP, etc.), and in-memory stores. In
 Zarr-Python 3, stores must implement the abstract store API from
-`zarr.abc.store.Store`.
+[`zarr.abc.store.Store`][].
 
 !!! note
     Unlike Zarr-Python 2 where the store interface was built around a generic `MutableMapping`
@@ -12,7 +12,7 @@ Zarr-Python 3, stores must implement the abstract store API from
 ## Implicit Store Creation
 
 In most cases, it is not required to create a `Store` object explicitly. Passing a string
-to Zarr's top level API will result in the store being created automatically.:
+to Zarr's top level API will result in the store being created automatically:
 
 ```python
 import zarr
@@ -38,13 +38,13 @@ zarr.create_group(store=data)
 ## Explicit Store Creation
 
 In some cases, it may be helpful to create a store instance directly. Zarr-Python offers four
-built-in store: `zarr.storage.LocalStore`, `zarr.storage.FsspecStore`,
-`zarr.storage.ZipStore`, `zarr.storage.MemoryStore`, and `zarr.storage.ObjectStore`.
+built-in store: [`zarr.storage.LocalStore`][], [`zarr.storage.FsspecStore`][],
+[`zarr.storage.ZipStore`][], [`zarr.storage.MemoryStore`][], and [`zarr.storage.ObjectStore`][].
 
 ### Local Store
 
-The `zarr.storage.LocalStore` stores data in a nested set of directories on a local
-filesystem.:
+The [`zarr.storage.LocalStore`][] stores data in a nested set of directories on a local
+filesystem:
 
 ```python
 store = zarr.storage.LocalStore('data/foo/bar', read_only=True)
@@ -54,8 +54,8 @@ zarr.open_group(store=store, mode='r')
 
 ### Zip Store
 
-The `zarr.storage.ZipStore` stores the contents of a Zarr hierarchy in a single
-Zip file. The [Zip Store specification](https://github.com/zarr-developers/zarr-specs/pull/311) is currently in draft form.:
+The [`zarr.storage.ZipStore`][] stores the contents of a Zarr hierarchy in a single
+Zip file. The [Zip Store specification](https://github.com/zarr-developers/zarr-specs/pull/311) is currently in draft form:
 
 ```python
 store = zarr.storage.ZipStore('data.zip', mode='w')
@@ -65,12 +65,12 @@ zarr.create_array(store=store, shape=(2,), dtype='float64')
 
 ### Remote Store
 
-The `zarr.storage.FsspecStore` stores the contents of a Zarr hierarchy in following the same
-logical layout as the `LocalStore`, except the store is assumed to be on a remote storage system
+The [`zarr.storage.FsspecStore`][] stores the contents of a Zarr hierarchy in following the same
+logical layout as the [`LocalStore`][zarr.storage.LocalStore], except the store is assumed to be on a remote storage system
 such as cloud object storage (e.g. AWS S3, Google Cloud Storage, Azure Blob Store). The
-`zarr.storage.FsspecStore` is backed by [fsspec](https://filesystem-spec.readthedocs.io) and can support any backend
+[`zarr.storage.FsspecStore`][] is backed by [fsspec](https://filesystem-spec.readthedocs.io) and can support any backend
 that implements the [AbstractFileSystem](https://filesystem-spec.readthedocs.io/en/stable/api.html#fsspec.spec.AbstractFileSystem)
-API. `storage_options` can be used to configure the fsspec backend.:
+API. `storage_options` can be used to configure the fsspec backend:
 
 ```python
 store = zarr.storage.FsspecStore.from_url(
@@ -97,8 +97,8 @@ store = zarr.storage.FsspecStore(fs)
 
 ### Memory Store
 
-The `zarr.storage.MemoryStore` a in-memory store that allows for serialization of
-Zarr data (metadata and chunks) to a dictionary.:
+The [`zarr.storage.MemoryStore`][] a in-memory store that allows for serialization of
+Zarr data (metadata and chunks) to a dictionary:
 
 ```python
 data = {}
@@ -110,8 +110,8 @@ zarr.create_array(store=store, shape=(2,), dtype='float64')
 
 ### Object Store
 
-`zarr.storage.ObjectStore` stores the contents of the Zarr hierarchy using any ObjectStore
-[storage implementation](https://developmentseed.org/obstore/latest/api/store/), including AWS S3 (`obstore.store.S3Store`), Google Cloud Storage (`obstore.store.GCSStore`), and Azure Blob Storage (`obstore.store.AzureStore`). This store is backed by [obstore](https://developmentseed.org/obstore/latest/), which
+[`zarr.storage.ObjectStore`][] stores the contents of the Zarr hierarchy using any ObjectStore
+[storage implementation](https://developmentseed.org/obstore/latest/api/store/), including AWS S3 ([`obstore.store.S3Store`][]), Google Cloud Storage ([`obstore.store.GCSStore`][]), and Azure Blob Storage ([`obstore.store.AzureStore`][]). This store is backed by [obstore](https://developmentseed.org/obstore/latest/), which
 builds on the production quality Rust library [object_store](https://docs.rs/object_store/latest/object_store/).
 
 ```python
@@ -144,10 +144,10 @@ group.info
 ```
 
 !!! warning
-    The `zarr.storage.ObjectStore` class is experimental.
+    The [`zarr.storage.ObjectStore`][] class is experimental.
 
 ## Developing custom stores
 
-Zarr-Python `zarr.abc.store.Store` API is meant to be extended. The Store Abstract Base
+Zarr-Python [`zarr.abc.store.Store`][] API is meant to be extended. The Store Abstract Base
 Class includes all of the methods needed to be a fully operational store in Zarr Python.
-Zarr also provides a test harness for custom stores: `zarr.testing.store.StoreTests`.
+Zarr also provides a test harness for custom stores: [`zarr.testing.store.StoreTests`][].