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

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

Received on Monday, 23 June 2025 13:37:45 UTC