Rewriting readme 6.

Author: James Mac Hale

tutorials.00.index.md

@@ -4,8 +4,6 @@
 This page serves as the index for a series of tutorials on using and building
 ORE python wrappers and wheels.
 
-[Run Jupyter Notebook Examples using the published ORE Python module](tutorials.06.notebooks.md)
-
 [Installing ORE Python Libraries and Example Scripts on Windows](tutorials.01.install_windows.md)
 
 [Installing ORE Python Libraries and Example Scripts on Posix Systems (e.g. MacOS and Linux)](tutorials.02.install_posix.md)
@@ -16,3 +14,5 @@ ORE python wrappers and wheels.
 
 [Managing Wheels](tutorials.05.wheels.md)
 
+[Run Jupyter Notebook Examples using the published ORE Python module](tutorials.06.notebooks.md)
+

tutorials.06.notebooks.md

@@ -1,48 +1,56 @@
 # Run Juyper Notebook examples using the ORE Python wheels
 
-This tutorial is aimed at the user who wants to install the ORE
-Python module and use it to execute example Jupyter notebooks provided on
-https://github.com/OpenSourceRisk/ORE-SWIG.  No compilation is necessary.
+This tutorial is aimed at the user who wants to install the pre-built ORE
+Python module and use it to execute example Jupyter notebooks provided in
+[the notebooks directory](https://github.com/OpenSourceRisk/ORE-SWIG/tree/master/OREAnalytics-SWIG/Python/Examples/Notebooks). No compilation is necessary.
 
 [Back to tutorials index](tutorials.00.index.md)
 
 **Please note** that (as of October 2023) the published ORE Python wheels are
 available for Python versions 3.8 up to 3.11 for Windows, Linux and macOS arm64,
-and Python versions up to 3.10 for Intel Mac users.
+and Python versions up to 3.10 for Intel Mac users.  
 
-We assume below that the python executable points to a permissible Python 3 version.
+We assume below that the python executable points to a permissible Python 3 version. You can check your system's default python version with
 
-## Create a virtual environemnt
+    python --version
 
-    python -m venv venv
+## Quick Set Up and First Run
 
-## Activate the virtual environment (Windows)
+Please note that these steps must be executed sequentially in a single command prompt/shell. The working directory, for ease, should be OREAnalytics-SWIG/Python/Examples/Notebooks.
 
-    CALL .\venv\Scripts\activate.bat
+1. Create a virtual environment:
 
-## Activate the virtual environment (Linux, Mac)
+    ``` python -m venv venv ```
 
-    source "$(pwd)/venv/bin/activate"
+2. Activate the virtual environment: 
 
-## Upgrade pip
+    (Windows): ```.\venv\Scripts\activate.bat ```
+    
+    (Linux, Mac): ```source "$(pwd)/venv/bin/activate" ```
 
-    python -m pip install --upgrade pip
+3. Install required Python modules. The notebook examples require Jupyter, the ORE Python module and a few additional packages for e.g. plotting. To install these in the virtual environment please make sure to execute this **after** activating the virtual environment as above.
 
-## Install required Python modules
+    ``` python -m pip install open-source-risk-engine matplotlib pandas plotly jupyter_server==2.8.0 jupyter ```
 
-The Notebook examples require Jupyter, the ORE Python module and a few additional packages.
+4. Launch Jupyter! This opens a browser window that shows the list of Example folders on the left hand side. Double click to change into any of the Example folders and then double click the Jupyter notebook to open.
 
-    python -m pip install open-source-risk-engine pytest matplotlib pandas plotly jupyter_server==2.8.0 jupyter
+    ``` python -m jupyterlab ```
 
-## Launch Jupyter with reference to the Notebooks directory 
+## Normal Usage
 
-    python -m jupyterlab --notebook-dir=/path/to/OREAnalytics-SWIG/Python/Examples/Notebooks
+After the first time run, you simply need to activate the virtual environment and run jupyter lab.
 
-This opens a browser window that shows the list of Example folders on the left hand side.
-Double click to change into any of the Example folders and then double click the Jupyter notebook to open. 
+    (Windows): ```.\venv\Scripts\activate.bat ```
+    
+    (Linux, Mac): ```source "$(pwd)/venv/bin/activate" ```
+    
+    python -m jupyterlab
 
 ## Exit the virtual environment
 
-    deactivate
+    To deactivate the virtual environment you can simply close the command prompt/terminal window. Othewise you can run the relevant deactivation script (assuming that the working directory is the Notebooks directory:
 
+    (Windows): ```.\venv\Scripts\deactivate.bat ```
+    
+    (Linux, Mac): ```source "$(pwd)/venv/bin/deactivate" ```