update docs, refs #45 and #46