update sample_spec docs