update docs.  fixes #12 and #15