Improve intelligibility and add a readme