bug fixes and docs
docs fixes