dret / I-D

Internet Drafts I've authored or contributed to.
16 stars 13 forks source link

Add a note about line folding in linkset in headers #108

Closed ibnesayeed closed 4 years ago

ibnesayeed commented 5 years ago

When linkset is communicated using the Link header, one might fold (soft-wrap) each entry in a separate line with a white-space prefix for readability as linksets might be large. This is how it is illustrated in Figure 4 of the current draft. However, RFC7230 section 3.2.4 explicitly prohibits line-folding in HTTP headers (except in the message/http media type). This was also highlighted by @mnot in one of his blog posts.

While I am not suggesting that Figure 2, 4, and 6 be changed, I think a brief note somewhere with reference to RFC7230 section 3.2.4 will be helpful. Although, the responsibility of proper formatting of HTTP headers is out side of the scope of this (and every other HTTP-related RFC), repeating certain recommendations where a documented example has the potential to mislead the reader might be a good idea.

/cc @phonedude @hvdsomp

dret commented 5 years ago

On 2018-11-16 17:15, Sawood Alam wrote:

While I am not suggesting that Figure 2, 4, and 6 be changed, I think a brief note somewhere with reference to RFC7230 section 3.2.4 will be helpful. Although, the responsibility of proper formatting of HTTP headers is out side of the scope of this (and every other HTTP-related RFC), repeating certain recommendations where a documented example has the potential to mislead the reader might be a good idea.

agreed that a note here might be useful. thanks for pointing it out.

dret commented 4 years ago

done.