more documentation

can @ChristinaLK or @drlabratory merge this if it looks reasonable, or make suggestions