docs(firestore): clarify client threadsafety (#9254)

* add doc for thread safety * changes in document as recommended * change in document description.
googleapis · Nov 7, 2019 · 4963eee · 4963eee
1 parent 5e9fe4f
commit 4963eee
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/docs/index.rst b/docs/index.rst
@@ -1,5 +1,12 @@
 .. include:: README.rst
 
+.. note::
+
+   Because the firestore client uses :mod:`grpcio` library, it is safe to
+   share instances across threads. In multiprocessing scenarios, the best
+   practice is to create client instances *after* the invocation of
+   :func:`os.fork` by :class:`multiprocessing.Pool` or
+   :class:`multiprocessing.Process`.
 
 API Reference
 -------------