More consistent store docstrings (#2976)

Co-authored-by: Davis Bennett <[email protected]>

Author: dstansby

src/zarr/storage/_fsspec.py

@@ -32,7 +32,7 @@
 
 class FsspecStore(Store):
     """
-    A remote Store based on FSSpec
+    Store for remote data based on FSSpec.
 
     Parameters
     ----------

src/zarr/storage/_local.py

@@ -67,7 +67,7 @@ def _put(
 
 class LocalStore(Store):
     """
-    Local file system store.
+    Store for the local file system.
 
     Parameters
     ----------

src/zarr/storage/_logging.py

@@ -24,7 +24,7 @@
 
 class LoggingStore(WrapperStore[T_Store]):
     """
-    Store wrapper that logs all calls to the wrapped store.
+    Store that logs all calls to another wrapped store.
 
     Parameters
     ----------

src/zarr/storage/_memory.py

@@ -19,7 +19,7 @@
 
 class MemoryStore(Store):
     """
-    In-memory store.
+    Store for local memory.
 
     Parameters
     ----------
@@ -173,8 +173,10 @@ async def list_dir(self, prefix: str) -> AsyncIterator[str]:
 
 
 class GpuMemoryStore(MemoryStore):
-    """A GPU only memory store that stores every chunk in GPU memory irrespective
-    of the original location.
+    """
+    Store for GPU memory.
+
+    Stores every chunk in GPU memory irrespective of the original location.
 
     The dictionary of buffers to initialize this memory store with *must* be
     GPU Buffers.

src/zarr/storage/_obstore.py

@@ -37,7 +37,8 @@
 
 
 class ObjectStore(Store):
-    """A Zarr store that uses obstore for fast read/write from AWS, GCP, Azure.
+    """
+    Store that uses obstore for fast read/write from AWS, GCP, Azure.
 
     Parameters
     ----------

src/zarr/storage/_wrapper.py

@@ -18,7 +18,8 @@
 
 class WrapperStore(Store, Generic[T_Store]):
     """
-    A store class that wraps an existing ``Store`` instance.
+    Store that wraps an existing Store.
+
     By default all of the store methods are delegated to the wrapped store instance, which is
     accessible via the ``._store`` attribute of this class.
 

src/zarr/storage/_zip.py

@@ -24,7 +24,7 @@
 
 class ZipStore(Store):
     """
-    Storage class using a ZIP file.
+    Store using a ZIP file.
 
     Parameters
     ----------