diff --git a/doc/requirements.txt b/doc/requirements.txt
index e8212f9b..ab38d284 100644
--- a/doc/requirements.txt
+++ b/doc/requirements.txt
@@ -1,6 +1,3 @@
-# The order of packages is significant, because pip processes them in the order
-# of appearance. Changing the order has an impact on the overall integration
-# process, which may cause wedges in the gate later.
 sphinx>=2.0.0,!=2.1.0 # BSD
 os-client-config>=1.28.0 # Apache-2.0
 openstackdocstheme>=2.2.1 # Apache-2.0
diff --git a/requirements.txt b/requirements.txt
index bcadc00d..d4b3a965 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,3 +1,7 @@
+# Requirements lower bounds listed here are our best effort to keep them up to
+# date but we do not test them so no guarantee of having them all correct. If
+# you find any incorrect lower bounds, let us know or propose a fix.
+
 pbr!=2.1.0,>=2.0.0 # Apache-2.0
 requests>=2.14.2 # Apache-2.0
 stevedore>=1.20.0 # Apache-2.0