updated parts of the readme for the documentation overhaul