update the readme and fix a few formatting errors