From 071fdf2dcc9d558e1acc17017b73dedb4eefa9da Mon Sep 17 00:00:00 2001
From: pswietojanski <p.swietojanski@gmail.com>
Date: Tue, 22 Sep 2015 17:08:07 +0100
Subject: [PATCH] initial readme 2

---
 README.md | 35 +++++++++++++++++++++++++----------
 1 file changed, 25 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index 44a8d9a..73685d3 100644
--- a/README.md
+++ b/README.md
@@ -5,11 +5,16 @@ To run the notebooks (and later the code you are going to write within this cour
 you are expected to have installed the following packages:
 
 python 2.7+
+
 numpy (anything above 1.6, 1.9+ recommended, optimally
        compiled with some BLAS library [MKL, OpenBLAS, ATLAS, etc.)
+
 scipy (optional, but may be useful to do some tests)
+
 matplotlib (for plotting)
+
 ipython (v3.0+, 4.0 recommended)
+
 notebook (notebooks are in version 4.0)
 
 You can install them straight away on your personal computer, 
@@ -20,29 +25,39 @@ personal computers so you can start ipython notebook server
 and open the inital introductory tutorial (which will be make
 publicitly available next Monday).
 
-I) Installing the software on personal computers
+### Installing the software on personal computers
 
-a) On Windows: download and install the Anaconda package 
-   (https://store.continuum.io/cshop/anaconda/)
+#### On Windows: 
 
-b) On Mac (use macports): 
+Download and install the Anaconda package 
+(https://store.continuum.io/cshop/anaconda/)
+
+#### On Mac (use macports): 
 
 Install macports following instructions at https://www.macports.org/install.php
-Install the relevant python packages in macports
+
+Install the relevant python packages in macports:
+
 sudo port install py27-scipy +openblas
+
 sudo port install py27-ipython +notebook
+
 sudo port install py27-notebook
+
 sudo port install py27-matplotlib
+
 sudo port select --set python python27
+
 sudo port select --set ipython2 py27-ipython
+
 sudo port select --set ipython py27-ipython
 
 Also, make sure that your $PATH has /opt/local/bin before /usr/bin 
 so you pick up the version of python you just installed
 
-c) On DICE (we will do this during the first lab)
+#### On DICE (we will do this during the first lab)
 
-II) Setting up the repository
+### Setting up the repository
 
 Assuming ~/mlpractical is a target workspace you want to use during
 this course (where ~ denotes your home path, i.e. /home/user1). 
@@ -53,7 +68,7 @@ git clone https://github.com/CSTR-Edinburgh/mlpractical.git
 
 (Note: you can do it from your git account if you have one as the
 above just clone the repo as anonymous user, though it does not 
-matter at this point, as you will not submit pull requests)
+matter at this point, as you probably will not submit pull requests)
 
 Naviagate to the checked out directory by typing cd ~/mlpractical and type:
 
@@ -62,8 +77,8 @@ ipython notebook
 This should start notebook server and open the browser with the page
 listing files/subdirs in the current directory.
 
-To update the repository (for example, on Monday), enter ~/mlpractical
-and type git pull.
+To update the repository (for example, on Monday), 
+enter ~/mlpractical and type git pull.