update readme for completed spec, and tidy