Update from suggestions

Author: christopher-wild

docs/source/index.rst

@@ -1,7 +1,4 @@
 .. Causal Testing documentation master file, created by
-sphinx-quickstart on Thu Nov 11 12:31:23 2021.
-You can adapt this file completely to your liking, but it should at least
-contain the root `toctree` directive.
 
 Welcome to Causal Testing's documentation!
 ==========================================
@@ -34,7 +31,7 @@ system-under-test that is expected to cause a change to some output(s).
 
 .. toctree::
    :maxdepth: 2
-   :caption: Code Docs
+   :caption: API
    :titlesonly:
 
    /autoapi/causal_testing/index

docs/source/installation.rst

@@ -9,19 +9,27 @@ If installing on Windows, ensure `Microsoft Visual C++ <https://docs.microsoft.c
 Pygraphviz
 ----------
 
-Pygraphviz can be installed through the conda-forge channel
-
-.. code-block:: console
+Pygraphviz can be installed through the conda-forge channel::
 
     conda install -c conda-forge pygraphviz
 
 
 Alternatively, on Linux systems, this can be done with `sudo apt install graphviz libgraphviz-dev`.
 
+Pip Install
+-----------
+To install the Causal Testing Framework using :code:`pip` for the latest stable version::
+
+    pip install causal-testing-framework
+
+To install with development packages/tools::
+
+    pip install causal-testing-framework[dev]
+
 Install from source
 -------------------
 
-In future it will be possible to install from PyPI, but for now::
+To install from source::
 
     git clone https://github.com/CITCOM-project/CausalTestingFramework
     cd CausalTestingFramework
@@ -30,20 +38,20 @@ then, to install a specific release::
 
     git fetch --all --tags --prune
     git checkout tags/<tag> -b <branch>
-    pip install -e .
+    pip install . # For core API only
+    pip install -e . # For editable install, useful for development work
 
 e.g. version `1.0.0`::
 
     git fetch --all --tags --prune
     git checkout tags/1.0.0 -b version
-    pip install -e .
+    pip install .
 
 or to install the latest development version::
 
-    pip install -e .
+    pip install .
 
-Use::
+To also install developer tools::
 
     pip install -e .[dev]
 
-to also install developer tools.