updating docs
fixes #701