Close #8829: doc: Update description of paralle-read-safe

1 files changed, 16 insertions, 0 deletions

diff --git a/doc/extdev/index.rst b/doc/extdev/index.rst
index ad04951f3..d9c04f413 100644
--- a/doc/extdev/index.rst
+++ b/doc/extdev/index.rst
@@ -171,10 +171,26 @@ as metadata of the extension.  Metadata keys currently recognized are:
   source files can be used when the extension is loaded.  It defaults to
   ``False``, i.e. you have to explicitly specify your extension to be
   parallel-read-safe after checking that it is.
+
+  .. note:: The *parallel-read-safe* extension must satisfy the following
+            conditions:
+
+            * The core logic of the extension is parallely executable during
+              the reading phase.
+            * It has event handlers for :event:`env-merge-info` and
+              :event:`env-purge-doc` events if it stores dataa to the build
+              environment object (env) during the reading phase.
+
 * ``'parallel_write_safe'``: a boolean that specifies if parallel writing of
   output files can be used when the extension is loaded.  Since extensions
   usually don't negatively influence the process, this defaults to ``True``.
 
+  .. note:: The *parallel-write-safe* extension must satisfy the following
+            conditions:
+
+            * The core logic of the extension is parallely executable during
+              the writing phase.
+
 
 APIs used for writing extensions
 --------------------------------