update README for completed spec, and tidy