update documentation for new API
Merge pull request #3 from Trott/new-directory

update documentation for new API