minor doco edits

Author: alimanfoo

docs/spec/v1.rst

@@ -1,9 +1,9 @@
 Zarr storage specification version 1
 ====================================
 
-This document provides a technical specification of the format used
-for storing a Zarr array. The key words "MUST", "MUST NOT",
-"REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT",
+This document provides a technical specification of the protocol and
+format used for storing a Zarr array. The key words "MUST", "MUST
+NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT",
 "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be
 interpreted as described in `RFC 2119
 <https://www.ietf.org/rfc/rfc2119.txt>`_.
@@ -185,8 +185,8 @@ Initialize the store::
     ...                 dtype='i4', fill_value=42, compression='zlib',
     ...                 compression_opts=1, overwrite=True)
 
-No chunks are initialized yet, so only the 'meta' and 'attrs' keys are
-present::
+No chunks are initialized yet, so only the 'meta' and 'attrs' keys
+have been set::
 
     >>> import os
     >>> sorted(os.listdir('example.zarr'))

zarr/compressors.py

@@ -330,7 +330,7 @@ class NoCompressor(object):
     --------
     >>> import zarr
     >>> z = zarr.zeros((10000, 10000), chunks=(1000, 1000), dtype='i4',
-    ...                compression=None)
+    ...                compression='none')
 
     """
 

zarr/storage.py

@@ -112,7 +112,7 @@ def init_store(store, shape, chunks, dtype=None, compression='default',
 
 class DirectoryStore(MutableMapping):
     """Mutable Mapping interface to a directory. Keys must be strings,
-    values must be bytes.
+    values must be bytes-like objects.
 
     Parameters
     ----------