adding documentation.  improving error messages
added example identities.json
slight error message modification
pep8 fixes