adapting tests

- lots of new resolve shim related tests
- adapting old tests to new API
improving diagnostics messages
updating examples to v3
updating readme to v3