Minor updates to the documentation.

Changed some README files and Doxygen comments.

Note: We have not yet decided on how frequent we want to make OSDU merge requests. Or even whether we should just do all our development in the OSDU repository instead of staging them in a private repository first.

My suggestion is that for now we will have roughly the same granularity of pull requests in OSDU as we have in the private repository. In those cases where changes were pushed directly to master (shame on me!) just group related changes as if they were made in a pull request.