diff --git a/doc/en/goodpractises.rst b/doc/en/goodpractises.rst
index fe3f41bd7..2359c562c 100644
--- a/doc/en/goodpractises.rst
+++ b/doc/en/goodpractises.rst
@@ -250,7 +250,21 @@ is equivalent to running ``py.test --durations=5``.
 (deprecated) Create a pytest standalone script
 -----------------------------------------------
 
-.. deprecated:: 2.7
+.. deprecated:: 2.8
+
+.. note::
+
+    ``genscript`` has been deprecated because:
+
+    * It cannot support plugins, rendering its usefulness extremely limited;
+    * Tooling has become much better since ``genscript`` was introduced;
+    * It is possible to build a zipped ``pytest`` application without the
+      shortcomings above (this will be documented in more detail in a later
+      version of this documentation).
+
+    There's no planned version in which this command will be removed
+    at the moment of this writing, but its use is discouraged for new
+    applications.
 
 If you are a maintainer or application developer and want people
 who don't deal with python much to easily run tests you may generate