Documentation Clean up - Large commit.

We cleaned up the documentation and some spacing issues. We also
fixed spelling mistakes across the whole framework in terms of
documentation.

We have also updated the readme.

[branch: development]