diff --git a/AUTHORS.rst b/AUTHORS.rst
index bf03e504..22ddfc63 100644
--- a/AUTHORS.rst
+++ b/AUTHORS.rst
@@ -19,6 +19,7 @@ These people have contributed to `pytest-bdd`, in alphabetical order:
 * `Floris Bruynooghe <flub@devork.be>`_
 * `Harro van der Klauw <hvdklauw@gmail.com>`_
 * `Hugo van Kemenade <https://github.com/hugovk>`_
+* `Kyle Adams <https://github.com/kadams54>`_
 * `Laurence Rowe <l@lrowe.co.uk>`_
 * `Leonardo Santagada <santagada@github.com>`_
 * `Milosz Sliwinski <sliwinski-milosz>`_
diff --git a/CHANGES.rst b/CHANGES.rst
index d1ca8b7d..048b3179 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -3,6 +3,7 @@ Changelog
 
 Unreleased
 ----------
+- Update documentation to clarify that `--gherkin-terminal-reporter` needs to be used with `-v` or `-vv`.
 - Drop compatibility with pytest < 7.0.0.
 
 8.0.0b1
diff --git a/README.rst b/README.rst
index 1a6d2bd5..5bd1d099 100644
--- a/README.rst
+++ b/README.rst
@@ -1054,11 +1054,11 @@ To have an output in json format:
 
 This will output an expanded (meaning scenario outlines will be expanded to several scenarios) Cucumber format.
 
-To enable gherkin-formatted output on terminal, use
+To enable gherkin-formatted output on terminal, use `--gherkin-terminal-reporter` in conjunction with the `-v` or `-vv` options:
 
 ::
 
-    pytest --gherkin-terminal-reporter
+    pytest -v --gherkin-terminal-reporter
 
 
 Test code generation helpers