adding README.md. refactored to more closely follow other client designs