From 97ebece5f1be1a895f65bead01a9472db91f182c Mon Sep 17 00:00:00 2001
From: Kenneth Reitz <me@kennethreitz.org>
Date: Wed, 30 Aug 2017 18:55:26 -0400
Subject: [PATCH] Update installation.rst

---
 docs/starting/installation.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/starting/installation.rst b/docs/starting/installation.rst
index a21e1ae..e6ef246 100644
--- a/docs/starting/installation.rst
+++ b/docs/starting/installation.rst
@@ -16,11 +16,18 @@ Installation Guides
 These guides go over the proper installation of :ref:`Python <which-python>`
 for development purposes, as well as setuptools, pip and virtualenv.
 
+.. note:: The use of **Python 3** is *highly* preferred over Python 2. Consider upgrading your applications and infrastructure if you find yourself *still* using Python 2 in production today. If you are using Python 3, congratulations — you are indeed a person of excellent taste.
+  —*Kenneth Reitz*
+  
+  Python 3 Installation Guides
+  ////////////////////////////
+
 - :ref:`Python 3 on MacOS <install3-osx>`.
 - :ref:`Python 3 on Windows <install3-windows>`.
 - :ref:`Python 3 on Linux <install3-linux>`.
 
---------------------------------
+Legacy Python 2 Installation Guides
+///////////////////////////////////
 
 - :ref:`Python 2 on MacOS <install-osx>`.
 - :ref:`Python 2 on Microsoft Windows <install-windows>`.