document what the various stuff is for