more documentation about this library
further improvements, and a note on efficiency
minor heading fix
fix typos
Merge pull request #15 from dylan-lang/doc-improvements

more documentation about this library