test passes, everything is now working, refactoring accomplished
documented connector code
cleaning test code and writing README