Update documentation to reflect reality

Minor typos and corrections to bring the readme more inline with the source