updates specs and read me