before work commit, made some changes to the specs and Readme