slightly better docs
reflect docs