adds examples showing how to use mocks implementing interfaces
updates the README
Merge branch 'api_for_interface_oriented_code'