refs #57 some more code tweaks and documentation