updated specs and README