[rfc-i] Inconsistency about the Chicago Manual Of Style in draft-iab-styleguide-02.txt

Paul Hoffman paul.hoffman at vpnc.org
Thu Apr 10 11:30:52 PDT 2014


The new draft, while much improved, still has a glaring inconsistency that was brought up in the threads about the -01 draft.

Section 1 says:

   The world of technical publishing has generally accepted rules for
   grammar, punctuation, capitalization, sentence length and complexity,
   parallelism, etc. The RFC Editor generally follows these accepted
   rules as defined by the Chicago Manual of Style (CMOS) [CMOS], with a
   few important exceptions to avoid ambiguity in complex technical
   prose and to handle mixtures of text and computer languages.  This
   document presents these exceptions as applied or recommended by the
   RFC Editor.  

However, on one topic, the Style Guide still mandates things contraindicated by CMOS that have nothing to do with ambiguity in complex technical prose or handling mixtures of text and computer languages.

Section 3.2 says:

   *  When a sentence ended by a period is immediately followed by
      another sentence, there must be two blank spaces after the period.

CMOS, rule 2.12, says:

  A single character space, not two spaces, should be left after periods at
  the ends of sentences (both in manuscripts and in final, published form)
  and after colons.

Thus, either the rule in Section 3.2 should (finally!) change, or you need to change Section 1 to say "...computer languages, or to preserve historical formatting rules".

--Paul Hoffman


More information about the rfc-interest mailing list