some docs before we forget what all of this is for