rejig readme and correct errors