Adjust example in docs or add warning

[OttoAndrey]

Hello! I tried this example from docs and it didn't work. I spent couple of hours to figure it out :(
But it doesn't work because two settings in the same time: response_only and requests_only. Do they interfere with each other?

Shouldn't it raise warning or raise error if both of them have True value?
Or maybe at least mark one of them with # in the beginning of the row? Like this

            request_only=True, # signal that example only applies to requests
            # response_only=True, # signal that example only applies to responses

because I believe examples should work after simple copy-paste without any changes :)

[tfranzel]

Hi @OttoAndrey,

i mean there is only request and response. When the example is supposed to apply only to requests, it cannot by definition also be only for responses. This is mutually exclusive by definition, and I never figured this to be confusing.

because I believe examples should work after simple copy-paste without any changes :)

I agree, but I thought this was kind of obvious. Writing out every variation of examples would create more noise that benefit imho.

However, since this is optional anyway, we could comment both lines out to signal that it is indeed optional