more sensible descriptions for some of the variables