diff --git a/docs/pages/release_notes.md b/docs/pages/release_notes.md
index b7ab311cb1..b882fa6516 100644
--- a/docs/pages/release_notes.md
+++ b/docs/pages/release_notes.md
@@ -29,6 +29,17 @@ This is a {{ site.pmd.release_type }} release.
 ### 🚨 API Changes
 
 #### Deprecations
+* pmd-gherkin
+  * {%jdoc gherkin::lang.gherkin.ast.GherkinBaseListener %} is deprecated for removal. This class was never intended
+    to be generated. It will be removed with no replacement.
+  * {%jdoc gherkin::lang.gherkin.ast.GherkinBaseVisitor %} is deprecated for removal. This class was never intended
+    to be generated. It will be removed with no replacement.
+  * {%jdoc gherkin::lang.gherkin.ast.GherkinListener %} is deprecated for removal. This class was never intended
+    to be generated. It will be removed with no replacement.
+  * {%jdoc gherkin::lang.gherkin.ast.GherkinParser %} is deprecated for removal. This class was never intended
+    to be generated. It will be removed with no replacement.
+  * {%jdoc gherkin::lang.gherkin.ast.GherkinVisitor %} is deprecated for removal. This class was never intended
+    to be generated. It will be removed with no replacement.
 * pmd-xml
   * {%jdoc xml::lang.xml.antlr4.XMLLexer %} is deprecated for removal. Use {%jdoc !!xml::lang.xml.ast.XMLLexer %}
     instead (note different package `ast` instead of `antlr4`).