From aeaced8a604bbfeceef71b1c297ab54f8630ae3f Mon Sep 17 00:00:00 2001
From: Arif Ali <arif.ali@canonical.com>
Date: Wed, 10 Jun 2020 22:29:36 +0100
Subject: [PATCH] Upddate README.md

---
 README.md | 34 +++++++++++++++++++++++++---------
 1 file changed, 25 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index ae8bd80..1f6447c 100644
--- a/README.md
+++ b/README.md
@@ -1,16 +1,32 @@
+# Compile and Running HowTo
+
 This is a collection of scripts and configuration that would
 allow to compile and run the benchmark in a consistent way
 
 The following will clone, and compile all the stuff
 
-```bash
-git clone https://gitlab.arif-ali.co.uk:8543/arif/raspberrypi-hpl
-cd raspberrypi-hpl/scripts
-./compile_all.sh
-```
+First clone the repository
 
-Then we can run the benchmark using the following script
+    git clone https://gitlab.arif-ali.co.uk:8543/arif/raspberrypi-hpl.git
 
-```bash
-./run_job.sh
-```
+Change to the scripts directory
+
+    cd raspberrypi-hpl/scripts
+
+You will find many scripts, and a `CONFIG` file. The one script will compile everything for you, i.e. by running the following command
+
+    ./compile_all.sh
+
+If at any time any of the parts fail, you can run the individual `make_*` scripts
+
+In order, the `compile_all.sh` will compile the applications in the following order
+
+1. mpich
+2. OpenBLAS
+3. HPL
+
+If for any reason you need to change any of the compilation flags or options, you can either udpate them in the `CONFIG` file or the corresponding `make_*.sh` script. For HPL, you will need to update `config/Make.rpi4_mpich` for any extra flags that you may require
+
+Finallu, once you're happy that the relevant applications have compiled, then we can run HPL using the following command
+
+    ./run_job.sh