edit docs

Author: alimanfoo

docs/release.rst

@@ -146,6 +146,9 @@ Documentation
 * A new tutorial section on :ref:`tutorial_pickle` has been added (:issue:`91`).
 * A new tutorial section on :ref:`tutorial_datetime` has been added.
 * A new tutorial section on :ref:`tutorial_diagnostics` has been added.
+* The tutorial sections on :ref:`tutorial_sync` and :ref:`tutorial_tips_blosc` have been
+  updated to provide information about how to avoid program hangs when using the Blosc
+  compressor with multiple processes (:issue:`199`, :issue:`201`).
 
 Maintenance
 ~~~~~~~~~~~
@@ -161,7 +164,8 @@ Acknowledgments
 Code was contributed to this release by :user:`John Kirkham <jakirkham>` and
 :user:`Prakhar Goel <newt0311>`.
 
-Documentation was contributed to this release by :user:`Mamy Ratsimbazafy <mratsim>`.
+Documentation was contributed to this release by :user:`Mamy Ratsimbazafy <mratsim>`
+and :user:`Charles Noyes <CSNoyes>`.
 
 Thank you to :user:`John Kirkham <jakirkham>`, :user:`Stephan Hoyer <shoyer>`,
 :user:`Francesc Alted <FrancescAlted>`, and :user:`Matthew Rocklin <mrocklin>` for code

docs/tutorial.rst

@@ -981,10 +981,10 @@ some networked file systems). E.g.::
 
 This array is safe to read or write from multiple processes.
 
-When using multiple processes to parallelize reads or writes with the blosc
-compression library, it is necessary to set ``zarr.blosc.use_threads = False``,
-as blosc's context manager will share incorrect global state amongst processes.
-Disabling will allow the 'contextual' manager to have correct local state.
+When using multiple processes to parallelize reads or writes on arrays using the Blosc
+compression library, it may be necessary to set ``numcodecs.blosc.use_threads = False``,
+as otherwise Blosc may share incorrect global state amongst processes causing programs
+to hang. See also the section on :ref:`tutorial_tips_blosc` below.
 
 Please note that support for parallel computing is an area of ongoing research
 and development. If you are using Zarr for parallel computing, we welcome
@@ -1087,7 +1087,7 @@ Configuring Blosc
 ~~~~~~~~~~~~~~~~~
 
 The Blosc compressor is able to use multiple threads internally to accelerate
-compression and decompression. By default, Zarr allows Blosc to use up to 8
+compression and decompression. By default, Blosc uses up to 8
 internal threads. The number of Blosc threads can be changed to increase or
 decrease this number, e.g.::