updated README and fixes spec