Improve readability of documentation

[enragedginger]

Hello and thank you so much for the Promesa library! It's been useful to me recently. I took the liberty of making some improvements to the documentation to make it more readable for other users. Please review.

Thanks!