Re: [Terminology] TERM & NISTIR 8366

Brian E Carpenter <brian.e.carpenter@gmail.com> Tue, 04 May 2021 20:07 UTC

Return-Path: <brian.e.carpenter@gmail.com>
X-Original-To: terminology@ietfa.amsl.com
Delivered-To: terminology@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id B09333A112D for <terminology@ietfa.amsl.com>; Tue, 4 May 2021 13:07:26 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.099
X-Spam-Level:
X-Spam-Status: No, score=-2.099 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, NICE_REPLY_A=-0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com
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 n9bX_bTT7bFL for <terminology@ietfa.amsl.com>; Tue, 4 May 2021 13:07:21 -0700 (PDT)
Received: from mail-pf1-x42a.google.com (mail-pf1-x42a.google.com [IPv6:2607:f8b0:4864:20::42a]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 8C9533A1129 for <terminology@ietf.org>; Tue, 4 May 2021 13:07:21 -0700 (PDT)
Received: by mail-pf1-x42a.google.com with SMTP id i13so249392pfu.2 for <terminology@ietf.org>; Tue, 04 May 2021 13:07:21 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=d40mKIE8DLhxv3CwA4ZM1pKrFNtYRrW9B6xYEp6C2bI=; b=bxm1Gp6tWnfIK6YR85dvzaCcIBrnKcUXfpV9X9/AYAqgHsM6MD6Kd9TAJ7P8gyh4oG dIx/gUZiwbPvvuTAFSp1cc8F4BwNL2mKA0yiqH0NPByr10yzX110DzTSk8zPYbKjr3+g k4i1ik79nVJXpA+fH42MxmenDyu1l+BwHYeTiB2oGP624AKeoX0XU/oT33YRmxpCtlhz qy9NtFd4pxmxB5e/xDUc7xbp3b1psrozbWHvmgPMuzj4cGOc8sJiC+42FJOhwkTTpz3K SosqV/hlfEzkP8OyQlFY7NqJtqDLyCyZmJtH2umG/PWX6igptrll8SVUzz/CjqafY4Tb DR1w==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:cc:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=d40mKIE8DLhxv3CwA4ZM1pKrFNtYRrW9B6xYEp6C2bI=; b=WL6GepJs2xQNUx58XS+4k7pWVjGZbwv75iEOYqOQlelhOCMlMg3IAQqGtAAjf0C8hl R0gHWjYikOadootD172edaHHXWD61/CnDjfkcSnAezYuCS+cc5Ea5e85SSa5n3hJupYB 5dABryA8KYeAVZ5ra9j/K9eYUHyeljSGCG6hk4CkFW/1pQS3taLzi24uxE1DQnG/uko7 W+rWJa/OCKt1oQJBkkFvpGGS4Ceyxp6F069leZyXK0/61hqQjNdgZkjjxvPl5W8ldYmq mN7jLa1KDiUNH/3I7oVKxLUxwJ3S5svvH3/uOYf0a+E1VmwC12dbZwBx/iU8r+pv0HjF E89A==
X-Gm-Message-State: AOAM533VEG3r3YTzDvIfUnS3hCW9EHFm0uDH0T1pcsvj8oH2i2+YW11z HaAp7H1BUFfHTBJ9LGTJpZUd2jw0340/DA==
X-Google-Smtp-Source: ABdhPJwOgpS5vihjSieFHtO+6yAK6HeUMhnFQhrMAlpEjPas8Z2BMT3dXL/Y9agVD6ZFQeJdmVe0qg==
X-Received: by 2002:a17:90a:a505:: with SMTP id a5mr29541994pjq.58.1620158838557; Tue, 04 May 2021 13:07:18 -0700 (PDT)
Received: from ?IPv6:2406:e003:100d:901:db7:d041:a2d:ce65? ([2406:e003:100d:901:db7:d041:a2d:ce65]) by smtp.gmail.com with ESMTPSA id s184sm4351362pgc.29.2021.05.04.13.07.16 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Tue, 04 May 2021 13:07:17 -0700 (PDT)
To: Dan York <york@isoc.org>, Lars Eggert <lars@eggert.org>
Cc: "terminology@ietf.org" <terminology@ietf.org>
References: <0D099A46-15A9-4427-A587-262897D9A722@eggert.org> <768C2555-7D00-4DB6-B03C-45A3913D64A3@isoc.org>
From: Brian E Carpenter <brian.e.carpenter@gmail.com>
Message-ID: <958f979a-15ac-8ae6-4061-bc9c7e16436e@gmail.com>
Date: Wed, 05 May 2021 08:07:15 +1200
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:78.0) Gecko/20100101 Thunderbird/78.10.0
MIME-Version: 1.0
In-Reply-To: <768C2555-7D00-4DB6-B03C-45A3913D64A3@isoc.org>
Content-Type: text/plain; charset="utf-8"
Content-Language: en-US
Content-Transfer-Encoding: quoted-printable
Archived-At: <https://mailarchive.ietf.org/arch/msg/terminology/CwneVf55Nf7tOOc2Wpm_SZ-bkRQ>
Subject: Re: [Terminology] TERM & NISTIR 8366
X-BeenThere: terminology@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Effective Terminology in IETF Documents <terminology.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/terminology>, <mailto:terminology-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/terminology/>
List-Post: <mailto:terminology@ietf.org>
List-Help: <mailto:terminology-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/terminology>, <mailto:terminology-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 04 May 2021 20:07:27 -0000

Dan,

In brief, and IMHO, the answers (for the medium term) depend on how the RFC editor futures discussion comes out. In the short term, I imagine somebody will edit https://www.rfc-editor.org/styleguide/. But neither of these are IETF decisions, since the RFC Editor isn't an IETF function.

Regards
   Brian

On 05-May-21 00:46, Dan York wrote:
> Lars, (or perhaps for John Levine or a member of the RSOC)
> 
> [Disclaimer: I work for the Internet Society but am writing in my personal capacity and this does not represent a statement of the views of the Internet Society.]
> 
>> On May 3, 2021, at 6:14 AM, Lars Eggert <lars@eggert.org> wrote:
>>
>> It seems like we have broad consensus to refer to NISTIR 8366 (https://doi.org/10.6028/NIST.IR.8366) to provide guidance to IETF contributors on using inclusive terminology, in lieu of documenting our own guidance.
> 
> It’s been great to see this gathering consensus (I support it), 
but before we abandon this working group (your item 1), I have a question 
about *how* we make this reference to the NIST document. Most of the broad consensus I’ve seen on this list has been in response to Brian’s note last week:
> 
>> On Apr 29, 2021, at 4:50 PM, Brian E Carpenter <brian.e.carpenter@gmail.com> wrote:
>>
>> Yes. The IESG could suggest to the RFC Editor team to add an informative reference to the NIST document to the style guide, and remind the IETF 
that Internet-Drafts should aim to adhere to the RFC style guide, and we're done.
> 
> Personally, I do agree that this guidance makes sense to live in the RFC Style Guide. NIST has also included this in their style guide equivalent ("author instructions”) and the W3C added a section to their manual of style earlier this year. ISO also has a section in their style guide.
> 
> https://www.nist.gov/nist-research-library/nist-technical-series-publications-author-instructions#inclusive 
> https://www.w3.org/Guide/manual-of-style/#inclusive
> https://www.iso.org/ISO-house-style.html#iso-hs-s-text-r-s-inclusive
> 
> There are any number of corporate/organization style guides that now include similar sections on inclusive language. The work of the Inclusive Naming Initiative (INI) - https://inclusivenaming.org/ - aims to help organizations update their own style guides and provide recommendations. I suspect many more style guides will publish new versions with such language 
in the months (and years) ahead.
> 
> 
> So if we can agree that the RFC Style Guide should be updated with an informative reference over to the NISTIR 8366 document, then…  
> 
> HOW does the RFC Style Guide actually get updated?  (I ask because I honestly don’t know.)
> 
> Looking at https://www.rfc-editor.org/styleguide/ I see that the style is guide is formally RFC 7322 ( https://www.rfc-editor.org/info/rfc7322 ) 
which has been updated by RFC 7997 ( https://www.rfc-editor.org/info/rfc7997 ). I also see from RFC 7322 that there is a “Web Portion of the Style Guide” at https://www.rfc-editor.org/styleguide/part2/ that includes newer decisions since 2014 when RFC 7322 was published.
> 
> Further I see that back in 2018 Heather Flanagan started to develop a (now expired) 7322bis draft - https://tools.ietf.org/html/draft-flanagan-7322bis-03
> 
> Is the first step to add a row to the page for the “Web Portion 
of the Style Guide” linking to the NIST doc? If so, who does that? (John?) 
> 
> And in the longer term, who would bring forward the 7322bis document that would include this reference to the NIST.IR 8366 document?
> 
> Do these steps fall to John Levine in his role as Temporary RFC Series Project Manager?  Or is this something the RSOC needs to bring forward? Or the IAB? Or someone else? And to whom do they bring it? Who approves the new version of the RFC Style Guide? The IAB? RSOC?
> 
> Or does it need a working group such as what was in the process of being chartered here?
> 
> If we are going to stop the work proposed for TERM to produce an Informational RFC with guidance for IETF participants - and instead link over to the NIST document, I would find it useful and helpful to understand how 
we are actually going to do this.
> 
> Thanks for any info,
> Dan
> 
> 
>