Updating readme

@maartenvg @costford 
@dtKinger @jonasll 

Changes
=======
* Added url creation helper methods
* updated the readme and tested the getting started procedure
* updated several links to point to the appropriate doc page

Notes - merge after #79