Merge pull request #11323 from pradyunsg/add-notes-to-divert-adding-n…

…ew-docs-content-on-long-pages Add note to divert away from adding content to user guide
pypa · Jul 29, 2022 · 0755d5c · 0755d5c
2 parents b8ccb04 + 3ebcc71
commit 0755d5c
Showing 1 changed file with 9 additions and 0 deletions.
diff --git a/docs/html/user_guide.rst b/docs/html/user_guide.rst
@@ -2,6 +2,15 @@
 User Guide
 ==========
 
+.. Hello there!
+
+   If you're thinking of adding content to this page... please take a moment
+   to consider if this content can live on its own, within a topic guide or a
+   reference page.
+
+   There is active effort being put toward *reducing* the amount of content on
+   this specific page (https://github.com/pypa/pip/issues/9475) and moving it
+   into more focused single-page documents that cover that specific topic.
 
 Running pip
 ===========