checkpoint, in progress
clean up doc and examples related to stubs/mocks