updates docs from PR #20