Miscelaneus updates to docs and bufferreader/writer
Merge pull request #690 from eordano/feature/miscupdates

Miscelaneus updates to docs and bufferreader/writer