httpwg / http-core

Core HTTP Specifications
https://httpwg.org/http-core/
469 stars 43 forks source link

Tables #1036

Closed reschke closed 2 years ago

reschke commented 2 years ago
<!--[rfced] Tables: We had the following questions related to tables
     throughout the document.

a) References in tables: many tables list only the section number.  We
will update to include the document as well (even though it is a
reference within this document) for clarity and to match the style of
other RFCs.

We have also updated the column heading "Changes" in Table 1 for
similar reasons (i.e., at first glance a reader might think Appendix
B.1 of RFC 2818 is what is being changed).  HTML/PDF versions with
links would not be unclear, but the text version may be.  Please let
us know any objections.

b) Table 7 uses the column heading "Method" while the corresponding registry uses "Method Name".  May we update to the latter for consistency?

c) Would you like the tables throughout to have titles?

-->
reschke commented 2 years ago

a) no, please don't; this is redundant information

b) yes

c) no; actually, we prefer none of them to have titles. Optimally, we could also avoid the distracting table number.