Feature/update docs

[Smartitect]

Updated documentation following run through with three of our interns. This included getting the pre-requisites installed onto a Mac.