Cleanup of various documentation files

This pull request contains commits that clean the `README` file and update other files.

No changes in content.