updating spec and README