From b646c2fd98f80bfdd5a2bdf5abd60fe966bb5f3d Mon Sep 17 00:00:00 2001
From: jack1142 <6032823+jack1142@users.noreply.github.com>
Date: Tue, 14 Jan 2020 17:54:44 +0100
Subject: [PATCH] [Docs] Add links to operating systems + minor readability
 improvements (#3365)

* add operating systems links + some minor readability improvements

* meh, let's add this too, draper
---
 docs/install_linux_mac.rst | 48 ++++++++++++++++++++++++++++++++++++--
 1 file changed, 46 insertions(+), 2 deletions(-)

diff --git a/docs/install_linux_mac.rst b/docs/install_linux_mac.rst
index 04abf2bb0..45c792f8d 100644
--- a/docs/install_linux_mac.rst
+++ b/docs/install_linux_mac.rst
@@ -25,6 +25,16 @@ The pre-requirements are:
 We also recommend installing some basic compiler tools, in case our dependencies don't provide
 pre-built "wheels" for your architecture.
 
+
+*****************
+Operating systems
+*****************
+
+.. contents::
+    :local:
+
+----
+
 .. _install-arch:
 
 ~~~~~~~~~~
@@ -35,6 +45,10 @@ Arch Linux
 
     sudo pacman -Syu python python-pip git jre-openjdk-headless base-devel
 
+Continue by `creating-venv-linux`.
+
+----
+
 .. _install-centos:
 .. _install-rhel:
 
@@ -51,6 +65,8 @@ CentOS and RHEL 7
 
 Complete the rest of the installation by `installing Python 3.8 with pyenv <install-python-pyenv>`.
 
+----
+
 .. _install-debian-stretch:
 
 ~~~~~~~~~~~~~~
@@ -76,6 +92,8 @@ Debian Stretch. This guide will tell you how. First, run the following commands:
 
 Complete the rest of the installation by `installing Python 3.8 with pyenv <install-python-pyenv>`.
 
+----
+
 .. _install-debian:
 .. _install-raspbian:
 
@@ -96,6 +114,8 @@ Debian/Raspbian Buster. This guide will tell you how. First, run the following c
 
 Complete the rest of the installation by `installing Python 3.8 with pyenv <install-python-pyenv>`.
 
+----
+
 .. _install-fedora:
 
 ~~~~~~~~~~~~
@@ -109,6 +129,10 @@ them with dnf:
 
     sudo dnf -y install python38 git java-latest-openjdk-headless @development-tools
 
+Continue by `creating-venv-linux`.
+
+----
+
 .. _install-mac:
 
 ~~~
@@ -135,6 +159,10 @@ one-by-one:
 It's possible you will have network issues. If so, go in your Applications folder, inside it, go in
 the Python 3.8 folder then double click ``Install certificates.command``.
 
+Continue by `creating-venv-linux`.
+
+----
+
 .. _install-opensuse:
 
 ~~~~~~~~
@@ -175,6 +203,8 @@ Now, install pip with easy_install:
 
     sudo /opt/python/bin/easy_install-3.8 pip
 
+Continue by `creating-venv-linux`.
+
 openSUSE Tumbleweed
 *******************
 
@@ -186,6 +216,10 @@ with zypper:
     sudo zypper install python3-base python3-pip git-core java-12-openjdk-headless
     sudo zypper install -t pattern devel_basis
 
+Continue by `creating-venv-linux`.
+
+----
+
 .. _install-ubuntu:
 
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -207,6 +241,10 @@ Now install the pre-requirements with apt:
     sudo apt -y install python3.8 python3.8-dev python3.8-venv python3-pip git default-jre-headless \
       build-essential
 
+Continue by `creating-venv-linux`.
+
+----
+
 .. _install-ubuntu-non-lts:
 
 ~~~~~~~~~~~~~~~~~~~~~~~
@@ -226,11 +264,13 @@ non-LTS versions of Ubuntu. This guide will tell you how. First, run the followi
 
 Complete the rest of the installation by `installing Python 3.8 with pyenv <install-python-pyenv>`.
 
+----
+
 .. _install-python-pyenv:
 
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+****************************
 Installing Python with pyenv
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+****************************
 
 .. note::
 
@@ -268,6 +308,10 @@ After that is finished, run:
 
 Pyenv is now installed and your system should be configured to run Python 3.8.
 
+Continue by `creating-venv-linux`.
+
+.. _creating-venv-linux:
+
 ------------------------------
 Creating a Virtual Environment
 ------------------------------