update documentation per #102
Merge branch 'docs-102'