updating docs, fixes #257