Closed ibnesayeed closed 4 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.
done.
When
linkset
is communicated using theLink
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 themessage/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