improving descriptions for specs