updated docs to resolve issue #3
fixed docs issue #26