Documentation for allow (counterpart to stub in the expect syntax)

As `allow(obj).to receive(:message)` is the counterpart to `stub`, we should document it alongside as we have done with `expect(obj).to receive(:message)` as a counterpart to `should_receive`.