updated documentation to close #348