Merge branch 'stable-3.9' into stable-3.10 * stable-3.9: Warn about off-line reindexing when using the owners' plugin Specify when owners.config label definition is required Change-Id: I928501a89a49911ab8406b36c3943711c3219ce3

diff --git a/owners/src/main/resources/Documentation/config.md b/owners/src/main/resources/Documentation/config.md
index 811325b..4baa2c5 100644
--- a/owners/src/main/resources/Documentation/config.md
+++ b/owners/src/main/resources/Documentation/config.md

@@ -33,6 +33,8 @@
     the owners of changes for approving them. When defined, it overrides any
     other label definition set by the OWNERS at any level in any project.
 
+> **NOTE:** Compulsory when the selected label's function is NoBlock/NoOp.
+
     Example:
 
     ```

diff --git a/owners/src/main/resources/Documentation/how-to-use.md b/owners/src/main/resources/Documentation/how-to-use.md
index 4a4d17f..e539d65 100644
--- a/owners/src/main/resources/Documentation/how-to-use.md
+++ b/owners/src/main/resources/Documentation/how-to-use.md

@@ -26,6 +26,15 @@
 - Enhanced UI experience with much clearer explanation of who owns what files,
   as explained below.
 
+> **NOTE**: The owners plugin uses multiple subsystems of Gerrit for determining
+> the status of the submit requirement predicates or Prolog functions.
+> When running a Gerrit off-line reindex using the `java -jar $GERRIT_SITE/bin/gerrit.war reindex`
+> command, the Gerrit daemon is not active and therefore the owners plugin will not
+> be able to expose its predicates and functions.
+> To perform a full reindexing of Gerrit projects using owners' submit requirements or
+> Prolog rules with owners' functions, the changes need to be reindex online using
+> the SSH command `gerrit index changes-in-project` command when Gerrit daemon is active.
+
 ## <a id="ownerStatus">Owner status on change page
 
 ### <a id="ownerStatus.submitRequirements">Owners status for submit requirements