Adds back a collection of documentation in README.

  Previous review of README.md resulted in removal of some documentation,
  after subsequent review this will add it back.  Few release notes
  added to account for things added since the first patch set of the new
  README was submitted.

Change-Id: I453a6dc46561c02c73bb97d40691a1c45ea36614