Differences

This shows you the differences between two versions of the page.

--- terms [2025/05/07 23:32] – created sginoza
+++ terms [2026/02/12 05:44] (current) – external edit 127.0.0.1
@@ Line 3: / Line 3: @@
 At the lowest level, clarity of presentation in RFCs requires
 consistent capitalization, hyphenation, and spelling of terms, both
-within a single RFC and across related RFCs.  In some cases the rules
+within a single RFC and across related RFCs.  In some cases, the rules
 are provided by English style manuals, but more often they are specific
 to the Internet field and to RFCs.
-This file is a list of common terms the RFC Editor has encountered and
+The list highlights terms that were frequently inconsistent and the decisions the RFC Production made regarding consistency, often after discussion with authors and/or working group chairs.
-the decisions that were made, often at the request of authors or WG
-chairs.
+|< 100% - 75% >|
+^ Term        ^ Notes ^
+| Acknowledgments  and Acknowledgements   |If consistent (with or without the "e"), leave it. If inconsistent, delete the "e".   |
+| ASCII    | Not 'US-ASCII' |
+| Autonomous System (AS) | Plural is 'Autonomous Systems (ASes)' |
+| demultiplexer | As used in recent RFCs (not 'demultiplexor') |
+| Diffserv | Consistent with RFC titles except RFC 4594 (not 'DiffServ')|
+| email | Per common use and as primary entry in various dictionaries\\ (not 'e-mail' or 'Email' or 'E-mail', etc.)|
+| I-D | Long-standing abbreviation (see [[https://www.rfc-editor.org/rfc/rfc4677.html|RFC 4677]])\\ I-D and Internet-Draft - with hyphen (not 'ID') |
+| Internet | Capitalized when referring to the global IP-based Internet |
+| IPsec | Not 'IPSEC' or 'IPSec' |
+| multihomed and multihoming | Per more common use in RFCs (multi-homed or multi-homing) |
+| online | No space or hyphen (not 'on-line') |
+| pseudowire | No space or hyphen (see RFCs [[https://www.rfc-editor.org/rfc/rfc4385.html|4385]], [[https://www.rfc-editor.org/rfc/rfc4618.html|4618]], [[https://www.rfc-editor.org/rfc/rfc4619.html|4619]], and [[https://www.rfc-editor.org/rfc/rfc4447.html|4447]]) \\ Google shows this to be the most common usage.\\ Exception: quoted titles of previously published documents. |
+| public key | No hyphen in attributive position; consistent with PKIX documents and [[https://www.rfc-editor.org/rfc/rfc4253.html|RFC 4253]] |
+| qubit     | No hyphen  |
+| subdomain | No hyphen |
+| suboptions | No hyphen, except with referring to IANA registries, where used with a hyphen. |
+| TEXTUAL-CONVENTION | Within ASN.1 of a MIB, 'TEXTUAL-CONVENTION' is used.  However, in general text, it is more correct to use 'Textual Convention'.\\ For example, see RFCs [[https://www.rfc-editor.org/rfc/rfc3811.html|3811]], [[https://www.rfc-editor.org/rfc/rfc3812.html|3812]], [[https://www.rfc-editor.org/rfc/rfc3813.html|3813]], [[https://www.rfc-editor.org/rfc/rfc3814.html|3814]], and [[https://www.rfc-editor.org/rfc/rfc3815.html|3815]] |
+| timestamp | More frequent in RFCs 4000+ (not 'time-stamp') |
-  * 'Acknowledgments' vs. 'Acknowledgements'
-    * If consistent (with or without the "e"), leave it.
-    * If inconsistent, delete the "e".
-  * 'ASCII' (not 'US-ASCII')
-  * 'Autonomous System (AS)': plural is 'Autonomous Systems (ASes)'
-  * 'demultiplexer' (not 'demultiplexor')
-    * Note: Consistent with RFC titles except RFC 4594
-  * 'email' (not 'e-mail' or 'Email' or 'E-mail', etc.)
-    * as it appears in media type registration template:\\ "Person & email address to contact for further information:"
-  * 'I-D' (not 'ID') - long-standing abbreviation (see [[https://www.rfc-editor.org/rfc/rfc4677.html|RFC 4677]])
-    * I-D - with hyphen
-    * Internet-Draft - with hyphen
-  * Internet (capitalized when referring to the global IP-based Internet)
-  * 'IPsec' (not 'IPSEC' or 'IPSec', etc.)
-  * 'online' (not 'on-line' -- no space or hyphen)
-  * 'pseudowire' (no space or hyphen)
-    * See RFCs [[https://www.rfc-editor.org/rfc/rfc4385.html|4385]], [[https://www.rfc-editor.org/rfc/rfc4618.html|4618]], [[https://www.rfc-editor.org/rfc/rfc4619.html|4619]], and [[https://www.rfc-editor.org/rfc/rfc4447.html|4447]].)