Readme cleanup

Trying to get the readme up to spec with the current code.


@beaulyddon-wf @ericolson-wf @nickjoyce-wf @tannermiller-wf