Merge "Adapt to Gerrit core change Ia8c03c86"
diff --git a/resources/Documentation/setup-guide.md b/resources/Documentation/setup-guide.md
index 801a0bd..cb1272e 100644
--- a/resources/Documentation/setup-guide.md
+++ b/resources/Documentation/setup-guide.md
@@ -21,6 +21,7 @@
8. [Optional Configuration](#optionalConfiguration)
9. [Stop using the find-owners Prolog submit rule](#stopUsingFindOwners)
10. [Add an initial code owner configuration at root level](#configureCodeOwners)
+11. [Disable/uninstall the find-owners plugin](#disableFindOwnersPlugin)
Recommendations about further configuration parameters can be found in the
[config guide](config-guide.html).
@@ -362,6 +363,19 @@
endpoint](rest-api.html#check-code-owner-config-files) and fix the reported
issues.
+### <a id="disableFindOwnersPlugin">11. Disable/uninstall the find-owners plugin
+
+If the `find-owners` plugin has been used so far, you likely want to
+disable/uninstall it after the `code-owners` plugin has been set up. Before
+doing this it is important to remove all usages of the [find-owners Prolog
+predicates](https://gerrit.googlesource.com/plugins/find-owners/+/refs/heads/master/src/main/resources/Documentation/config.md#submit-rules-and-filters)
+from all Prolog submit rules and filters. If the find-owners Prolog predicates
+are still used when the `find-owners` plugin is disabled/uninstalled, they can
+no longer be resolved which breaks the submit rules using them. If submit rules
+are broken, changes cannot be submitted, which most users would consider an
+outage. Hence before disabling/uninstalling the `find-owners` plugin you want
+to be sure that the find-owners Prolog predicates are no longer used.
+
---
Back to [@PLUGIN@ documentation index](index.html)
