Make OSX docs clearer
Merge pull request #314 from theodi/feature-improve-osx-docs

Make OSX docs clearer