add login command to the command line client and update authentication section in the README
fix for SYNR-562: upgrade message should direct user to pypi not github
improvements to doc strings in response to SYNR-583
SYNR-601: improve handling of __version__
more api docs improvements
fixes to README
cleanup around createOrUpdate on entities
Merge pull request #104 from cbare/api_docs

Api docs and updates to handling of __version__