working with python 3

Author: kennethreitz

docs/starting/install3/linux.rst

@@ -22,6 +22,23 @@ If you're using another version of Ubuntu (e.g. the latest LTS release), we reco
     $ sudo apt-get update
     $ sudo apt-get install python3.6
 
+Working with Python 3
+---------------------
+
+At this point, you have the system Python 2.7 available, potentially the
+:ref:`Homebrew version of Python 2 <install-osx>` installed, and the Homebrew
+version of Python 3 as well.
+
+.. code-block:: console
+
+    $ python
+
+will launch the Python 2 interpreter.
+
+.. code-block:: console
+
+    $ python3
+
 
 Setuptools & Pip
 ----------------
@@ -59,6 +76,7 @@ To start using this and see more information: :ref:`Virtual Environments <virtua
 You can also use :ref:`virtualenvwrapper <virtualenvwrapper-ref>` to make it easier to
 manage your virtual environments.
 
+
 --------------------------------
 
 This page is a remixed version of `another guide <http://www.stuartellis.eu/articles/python-development-windows/>`_,

docs/starting/install3/osx.rst

@@ -90,7 +90,7 @@ will launch the Python 2 interpreter.
 
     $ python3
 
-will launch the Python 3 interpreter
+will launch the Python 3 interpreter.
 
 ``pip3`` and ``pip`` will both be available.  If the Homebrew version of Python
 2 is not installed, they will be the same.  If the Homebrew version of Python 2

docs/starting/install3/win.rst

@@ -41,6 +41,24 @@ described in the next section before you start building Python applications for
 real-world use. In particular, you should always install Setuptools, as it
 makes it much easier for you to use other third-party Python libraries.
 
+Working with Python 3
+---------------------
+
+At this point, you have the system Python 2.7 available, potentially the
+:ref:`Homebrew version of Python 2 <install-osx>` installed, and the Homebrew
+version of Python 3 as well.
+
+.. code-block:: console
+
+    $ python
+
+will launch the Python 2 interpreter.
+
+.. code-block:: console
+
+    $ python3
+
+
 Setuptools + Pip
 ----------------