Improvements to documentation

Created by: wmortada

Great to see the new documentation pages! Thanks for creating this.

I gave it a proof read and have a few suggestions for improvement. Hope this all makes sense.