Revert "docs fixes; mainly being ocd about line length"

This reverts commit 367c5cab3a2d7d282fa3a0d2ed219b0c836ee80a.
re-applied the parts of 6ee80a that were useful