flatten in the docs
updated docs