update docs to recent changes in binary-data
also, clear up some of the documentation
Merge pull request #19 from dylan-lang/more-docs

update docs to recent changes in binary-data