updating spec/docs