update read me and a few specs