Improved Docs

[Carreau]

Thanks for your contribution, though please if this is for hacktoberfest try to make something which is higher quality than just cosmetic rephrasing.