fixed failing tests
Added a readme providing the high-level project objectives