diff --git a/README.md b/README.md
index bafaa27..7296a97 100644
--- a/README.md
+++ b/README.md
@@ -2,3 +2,7 @@
 
 All documentation may be found under
 [src/main/resources/Documentation/](./src/main/resources/Documentation/).
+
+**NOTE:** The find-owners plugin has been deprecated in favour of the
+[code-owners](https://gerrit.googlesource.com/plugins/code-owners/+/HEAD/resources/Documentation/about.md)
+plugin.
diff --git a/src/main/resources/Documentation/about.md b/src/main/resources/Documentation/about.md
index 3a3e5cd..1fff919 100644
--- a/src/main/resources/Documentation/about.md
+++ b/src/main/resources/Documentation/about.md
@@ -1,3 +1,7 @@
+**NOTE:** The find-owners plugin has been deprecated in favour of the
+[code-owners](https://gerrit.googlesource.com/plugins/code-owners/+/HEAD/resources/Documentation/about.md)
+plugin.
+
 This plugin works with Gerrit projects that
 use Android or Chromium compatible **OWNERS** files.
 The **OWNERS** files specify *owners*, or active maintainers,
diff --git a/src/main/resources/Documentation/syntax.md b/src/main/resources/Documentation/syntax.md
index a535788..1bb4b7d 100644
--- a/src/main/resources/Documentation/syntax.md
+++ b/src/main/resources/Documentation/syntax.md
@@ -1,3 +1,10 @@
+**NOTE:** The find-owners plugin has been deprecated in favour of the
+[code-owners](https://gerrit.googlesource.com/plugins/code-owners/+/HEAD/resources/Documentation/about.md)
+plugin. For the code-owners plugin the syntax is documented
+[here](https://gerrit.googlesource.com/plugins/code-owners/+/HEAD/resources/Documentation/backend-find-owners.md)
+and OWNERS examples can be found in the
+[cookbook](https://gerrit.googlesource.com/plugins/code-owners/+/HEAD/resources/Documentation/backend-find-owners-cookbook.md).
+
 OWNERS File Syntax
 ==================