finish specs, and some fixes
update readme