make docs better (rewriting and styling)