Re: [Rats] [rfc-i] document conventions around Capitalization of Terminology

Paul Hoffman <paul.hoffman@vpnc.org> Tue, 13 April 2021 16:15 UTC

Return-Path: <paul.hoffman@vpnc.org>
X-Original-To: rats@ietfa.amsl.com
Delivered-To: rats@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 903243A1D62 for <rats@ietfa.amsl.com>; Tue, 13 Apr 2021 09:15:36 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -0.189
X-Spam-Level:
X-Spam-Status: No, score=-0.189 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, KHOP_HELO_FCRDNS=0.399, RCVD_IN_VALIDITY_RPBL=1.31, SPF_HELO_NONE=0.001, SPF_NONE=0.001] autolearn=no autolearn_force=no
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 4FFKDyhcP_11 for <rats@ietfa.amsl.com>; Tue, 13 Apr 2021 09:15:32 -0700 (PDT)
Received: from mail.proper.com (Opus1.Proper.COM [207.182.41.91]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 54FED3A1D60 for <rats@ietf.org>; Tue, 13 Apr 2021 09:15:32 -0700 (PDT)
Received: from [10.32.60.51] (76-209-242-70.lightspeed.mtryca.sbcglobal.net [76.209.242.70]) (authenticated bits=0) by mail.proper.com (8.15.2/8.15.2) with ESMTPSA id 13DGFu2B018087 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO); Tue, 13 Apr 2021 09:15:57 -0700 (MST) (envelope-from paul.hoffman@vpnc.org)
X-Authentication-Warning: mail.proper.com: Host 76-209-242-70.lightspeed.mtryca.sbcglobal.net [76.209.242.70] claimed to be [10.32.60.51]
From: "Paul Hoffman" <paul.hoffman@vpnc.org>
To: "Michael Richardson" <mcr+ietf@sandelman.ca>
Cc: rats@ietf.org, rfc-interest <rfc-interest@rfc-editor.org>
Date: Tue, 13 Apr 2021 09:15:27 -0700
X-Mailer: MailMate (1.13.2r5673)
Message-ID: <92A38E3E-EBD8-4A14-8B47-9080694E736A@vpnc.org>
In-Reply-To: <10996.1618327990@localhost>
References: <10996.1618327990@localhost>
MIME-Version: 1.0
Content-Type: text/plain; format=flowed
Archived-At: <https://mailarchive.ietf.org/arch/msg/rats/8i-pbmOmjIiVF4GC70d_uNArqyg>
Subject: Re: [Rats] [rfc-i] document conventions around Capitalization of Terminology
X-BeenThere: rats@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Remote ATtestation procedureS <rats.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/rats>, <mailto:rats-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/rats/>
List-Post: <mailto:rats@ietf.org>
List-Help: <mailto:rats-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/rats>, <mailto:rats-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 13 Apr 2021 16:15:37 -0000

On 13 Apr 2021, at 8:33, Michael Richardson wrote:

> In the RATS Architecture document we have spent some time (maybe too 
> much
> time), making sure that if we define some Term, that it is 
> consistently
> rendered like a Proper Noun. That is capitalized.
> There are some terms which have renderings in both capitalized (our
> definition), and uncapitalized (not exactly our definition).
>
> In a document of mine (BRSKI) which has now entered AUTH48, the RPC 
> has
> lower-cased all our in-document defined terminology.  I was very 
> surprised by this.
> I have asked to have that reversed, and I imagine that my wish will be 
> granted.
>
> But, I am wondering about convention, and I wonder if there is some 
> magic
> keyphrase that needs to go into a Terminology Section such to indicate 
> that
> to the editors and the readers that we are following that convention.
> Or if we should make up such a phrase.

The convention for techie writers is to assume that new things should be 
proper nouns. The convention for copy editors is to make them regular 
nouns because over-capitalizing makes documents hard to read.

As a guidepost, in the non-technical world, new nouns that are like the 
new nouns we make are basically never treated as proper nouns.

--Paul Hoffman