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

* add doc for thread safety * changes in document as recommended * change in document description.
googleapis · Nov 7, 2019 · f1136a7 · f1136a7
1 parent c996af0
commit f1136a7
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/firestore/docs/index.rst b/firestore/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
 -------------