Merge branch 'stable-3.9'

* stable-3.9:
  Explain on the about page when the code-owners plugin should/shouldn't be used

Change-Id: Idc42bb5c0ee0d445fab631f02e237771eed69f87
Reviewed-on: https://gerrit-review.googlesource.com/c/plugins/code-owners/+/409499
Tested-by: Zuul <zuul-63@gerritcodereview-ci.iam.gserviceaccount.com>
Reviewed-by: Nitzan Gur-Furman <nitzan@google.com>
diff --git a/resources/Documentation/about.md b/resources/Documentation/about.md
index fecbc41..1db9847 100644
--- a/resources/Documentation/about.md
+++ b/resources/Documentation/about.md
@@ -8,6 +8,12 @@
 
 An overview of the supported features can be found [here](feature-set.html).
 
+**IMPORTANT:** Using the @PLUGIN@ plugin is recommended only for repositories
+that contain files / folders that are owned by different users. If this is not
+the case, and all files / folders in the repository are owned by the same users
+[plain Gerrit permissions should be preferred
+instead](config-guide.html#configureCodeOwnersByPermissions).
+
 **IMPORTANT:** Before installing/enabling the plugin, or enabling the code
 owners functionality for further projects, follow the instructions from the
 [setup guide](setup-guide.html).