continued work on updating documentation
Merge branch 'master' into feature/avro_work

* master:
  updated note