Re: QUERY: HTTPDIR review of Appendix section, was: draft-ietf-httpbis-safe-method-w-body-11 early Httpdir review

Am 23.06.2025 um 15:37 schrieb Julian Reschke:
> Hi Roy,
> 
> for the appendix related comments, I have opened <https://github.com/ 
> httpwg/http-extensions/issues/3114> (yes, I'm staring with the long 
> hanging fruits).
> 
> One really quick answer:
> 
>> Note that the text version isn't indenting examples, so it can be hard
>> to discern when commentary is inserted in the middle. I would prefer
>> that the protocol examples be placed in the protocol definition above,
>> but that's editorial discretion. I agree that the longer query examples
>> are better as an appendix.
> 
> That's a ... shortcoming ... of xml2rfc (as of today, and as opposed to 
> a few years ago; see <https://github.com/ietf-tools/xml2rfc/issues/1191>.
> 
> Best regards, Julian

Please review: https://github.com/httpwg/http-extensions/pull/3116

Best regards, Julian

Received on Tuesday, 24 June 2025 13:31:35 UTC