editorials

[jouni.nospam@…]

As part of the document shepherd proto write-up I read the I-D. These are the editorials I found during the first read.

o The I-D uses multiple conventions for "timeout" such as "time out" and "time-out".
o I think is "a NAI" should be "an NAI".
o In section 2.1.1.3. "dynamic discover" is missing 'y'.
o TTL, DNS, PKI, RR, .. are never expanded. Loads of acronyms actually.
o In Section 3.1. the bullet list items lack full stops.
o In Section 3.4.1 the bullet list items lack full stops.
o In Section 7. "They re" should be "They are".
o In Section 7. [I-D.housley-pkix-oids] in now RFC7299.
o In Section 2.1.1.1. Figure 1 last line has unnecessary space in it.

[stefan.winter@…]

I have fixed the draft in these respects. Things to note:

• "timeout" and "time out" still both occur (only "time-out" has gone) - the former is used as a noun, whereas the latter is used as a verb as in constructions like "connections time out after a while". I believe this is correct use and have left this.

• "a NAI" is also fixed for "a NAIRealm" - all now use "an"

• TTL and RR expanded, but "DNS", "PKI", "TLSA" do not need to be expanded as per the RFC Style Guideline (​https://www.rfc-editor.org/rfc-style-guide/abbrev.expansion.txt) so I left them as-is

All other bullets in this ticket were fixed verbatim in my working copy. I consider this ticket complete.