Improve side-effects docs

Make it clear that it is intended to replace "dumb mocks" only and if you need a "smart mock", use `with-redefs`. Perhaps show what it is equivalent to? Also, make clear that you can use to mock a specific result value, not map to another function to call.