Updated formatting of README, also made explicit note where the documentation is out of sync