complete documentation for datastructures and expand vocabulary
this closes issue #17