diff --git a/docs/html/reference/index.rst b/docs/html/reference/index.rst
index f25568bfb..f33129481 100644
--- a/docs/html/reference/index.rst
+++ b/docs/html/reference/index.rst
@@ -17,3 +17,4 @@ Reference Guide
pip_config
pip_wheel
pip_hash
+ pip_debug
diff --git a/docs/html/reference/pip_debug.rst b/docs/html/reference/pip_debug.rst
new file mode 100644
index 000000000..e9489c3c2
--- /dev/null
+++ b/docs/html/reference/pip_debug.rst
@@ -0,0 +1,23 @@
+.. _`pip debug`:
+
+pip debug
+-----------
+
+.. contents::
+
+Usage
+*****
+
+.. pip-command-usage:: debug
+
+
+Description
+***********
+
+.. pip-command-description:: debug
+
+
+Options
+*******
+
+.. pip-command-options:: debug
diff --git a/docs/man/commands/debug.rst b/docs/man/commands/debug.rst
new file mode 100644
index 000000000..9dda071b2
--- /dev/null
+++ b/docs/man/commands/debug.rst
@@ -0,0 +1,20 @@
+:orphan:
+
+==========
+pip-debug
+==========
+
+Description
+***********
+
+.. pip-command-description:: debug
+
+Usage
+*****
+
+.. pip-command-usage:: debug
+
+Options
+*******
+
+.. pip-command-options:: debug