Apply suggestions from code review

Co-authored-by: David Stansby <[email protected]>

Author: jhamman

docs/index.rst

@@ -54,7 +54,7 @@ Zarr is a file storage format for chunked, compressed, N-dimensional arrays base
         Guide
         ^^^^^
 
-        The user guide provides a detailed guide for how to use Zarr-Python.
+       A detailed guide for how to use Zarr-Python.
 
         +++
 
@@ -64,7 +64,7 @@ Zarr is a file storage format for chunked, compressed, N-dimensional arrays base
             :color: dark
             :click-parent:
 
-            To the User Guide
+            To the user guide
 
     .. grid-item-card::
         :img-top: _static/index_api.svg

docs/user-guide/performance.rst

@@ -5,7 +5,7 @@ Optimizing Performance
 .. ipython::
    :suppress:
 
-   In [144]: rm -r data/
+   rm -r data/
 
 .. _tutorial_chunks:
 

docs/user-guide/storage.rst

@@ -1,4 +1,4 @@
-.. _tutorial_storage:
+.. _guide_storage:
 
 Storage
 =======
@@ -22,17 +22,17 @@ to Zarr's top level API will result in the store being created automatically.
 
    import zarr
 
-   # implicitly create a writable LocalStore
+   # Implicitly create a writable LocalStore
    zarr.open_group("data/foo/bar", mode="w")
 
-   # implicitly create a read-only FsspecStore
+   # Implicitly create a read-only FsspecStore
    zarr.open_group(
       "s3://noaa-nwm-retro-v2-zarr-pds",
       mode="r",
       storage_options={"anon": True}
    )
 
-   # implicitly creates a MemoryStore
+   # Implicitly creates a MemoryStore
    data = {}
    zarr.open_group(data, mode="w")
 

pyproject.toml

@@ -86,9 +86,7 @@ docs = [
     'pydata-sphinx-theme',
     'numpydoc',
     'numcodecs[msgpack]',
-    'msgpack',
     'ipython',
-    'pickleshare',
     'rich',
     's3fs',
 ]