[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Editorial comments on draft-rfc-editor-rfc2223bis
Greetings again. Seeing draft-rfc-editor-rfc2223bis in IETF Last Call
made me review it again. I have a few editorial comments you will
hopefully find helpful.
1. The document should spell out the first use of "URL", or "URL"
should be added to the list of acronyms that don't need to be spelled
out. (My preference is for the former, given how many people forget
what the "U" stands for.)
1.3.1. s/TYI-sub-series/FYI-sub-series/
1.3.1, Individual submissions. It says that individuals can submit
documents to the RFC Editor for Informational and Experimental RFCs.
What abut BCPs and FYIs? Those are not standards-track. If you mean
to say that individual submissions for BCP and FYI must go through
the IESG, you should say so explicitly.
2.2. s/salesmen/salespeople/
2.4. The document jumps back and forth between usages of words:
Postscript file <--> .ps file
text file <--> .txt file
Also, it sometimes equates Postscript files with PDF files, which is
not correct. My preference is to never use ".ps file" or ".txt file",
and toyou make it clear that PostScript files have very different
properties for viewing than PDF files. (Oh, and you should spell out
"PDF" the first time you use it.)
2.8. In the first sentence, add "in references" after "The use of
URLs". Otherwise, it sounds like one can never use a URL in an RFC.
4. "11. IANA Considerations" should be floating and optional, not
just floating. This document is a good example of it being optional.
4.12. The document does not give a preferred format for references,
but doing so would be very useful. You folk have re-written many of
my references at RFC publication time, but I would have done it right
the first time if I had a template.
4.12. The template for Internet-Drafts seems odd to me. It doesn't
include the draft name, and there is no indication in the reference
that this is an Internet Draft.
4.13. You have started to let people use URLs instead of email
addresses; that should be mentioned here.
5. I couldn't find any mention of the "RFC-DIST" list anywhere on the
RFC Editor site. I found it through Google, but not on the site. This
is the first I had ever heard of the list.
--Paul Hoffman, Director
--Internet Mail Consortium