diff --git a/scripts/docspregen.py b/scripts/docspregen.py
index f895c25d..b0fe2ade 100644
--- a/scripts/docspregen.py
+++ b/scripts/docspregen.py
@@ -473,11 +473,12 @@ Stable
 
 .. code-block:: ini
 
-    ; Latest stable version
+    ; Latest stable version, NOT recommended
+    ; Pin the version as shown below
     [env:latest_stable]
     platform = {name}
     {board}
-    ; Custom stable version
+    ; Specific version
     [env:custom_stable]
     platform = {name}@x.y.z
     {board}