This explains in readme pattern to use the expectations in reference to after the actual request, still using stub before the actual request.
In RSpec, you could be having stuff .should_receive where you set expectations mostly before doing the real call(in this case request).
This is to help others not to be confused by the usage of these expectations.
I was a bit confused but the past tense used helped me to finally reach at the conclusion.
Thanks for the great gem,
Usage clarification for a_request expectation for example
Usage clarification formatting for a_request expectation for example
Thanks for feedback and patch. If someone is used to RSpec it can be indeed confusing that WebMock uses stub-run-verify convention.
I'd like WebMock to have proper documentation, with all functionalities well documented separately.