updated readme and a little bit of spec tidying