Revert "improve docs"

This reverts commit e32b22f3223d6000d0866a9d8c65e05634c71636.
second try at fixing docs