Review the documentation / README and suggest changes

[drstarson]

Review the README and suggest changes / improvements. Most importantly we need to remove everything that is outdated.

• Suggest your changes here and I will review

• When implementing, we need to make sure we update both the README here and the GitBook