Major rewrite of the README

Also some changes to soothe the Scrutinizer.