Improve general grammar & clarity of docs

[mdarocha]

Some parts of the documentation can be rewritten or improved to make the initial user experience smoother.

Requires further work on what exactly needs improvement.