updated docs - refs #401, 402