docs improvements

See issue #23
Merge pull request #24 from garak/patch-1

docs improvements