jayktaylor · April 13, 2022 08:23 · Jan 31, 2017 · Jan 31, 2017 · Jan 31, 2017
diff --git a/guide.md b/guide.md
@@ -24,6 +24,6 @@ Now we've installed the correct version, setting the version of Python we wish t
 pyenv global 3.5.2
 ```
 
-To test that this worked, try running the command `python` on your system.
+To test that this worked, try running the command `python --version` on your system to confirm the version being used.
 
 **You should have now installed Python 3.5 on Debian Jessie.**
diff --git a/guide.md b/guide.md
@@ -18,7 +18,7 @@ pyenv install 3.5.2
 If you have issues with this, or you need another Python version, you can see available versions by running `pyenv install --list`.
 
 ### Setting the system-wide Python version
-Now we've installed the correct version, this is as simple as running this command:
+Now we've installed the correct version, setting the version of Python we wish to use system-wide is as simple as running this command:
 
 ```
 pyenv global 3.5.2

diff --git a/guide.md b/guide.md
@@ -0,0 +1,29 @@
+## Installing Python 3.5 on Debian Jessie with `pyenv`
+Debian Jessie does not come with the correct Python version out of the box, and instead comes with Python 2. To be able to install Python 3(.5), we have a few options. We *could* build and install from source, but as per [Debian's website](https://wiki.debian.org/DontBreakDebian), we shouldn't do this. Instead, we will use **[pyenv](https://github.com/yyuu/pyenv)**, a tool that allows users to switch Python versions easily without breaking their system.
+
+### Installing `pyenv`
+To install pyenv, we will use the [official installer](https://github.com/yyuu/pyenv-installer).
+
+```
+curl -L https://raw.githubusercontent.com/yyuu/pyenv-installer/master/bin/pyenv-installer | bash
+```
+
+### Installing Python 3.5
+Using pyenv, we can install specific Python versions. pyenv will build these from source using [python-build](https://github.com/yyuu/pyenv/tree/master/plugins/python-build), but won't install them in a way that overwrites the system's version.
+
+```
+pyenv install 3.5.2
+```
+
+If you have issues with this, or you need another Python version, you can see available versions by running `pyenv install --list`.
+
+### Setting the system-wide Python version
+Now we've installed the correct version, this is as simple as running this command:
+
+```
+pyenv global 3.5.2
+```
+
+To test that this worked, try running the command `python` on your system.
+
+**You should have now installed Python 3.5 on Debian Jessie.**
No results found