WG Review: Effective Terminology in IETF Documents (term)

Lars Eggert <lars@eggert.org> Fri, 23 April 2021 14:43 UTC

Return-Path: <lars@eggert.org>
X-Original-To: ietf@ietfa.amsl.com
Delivered-To: ietf@ietfa.amsl.com
Received: from localhost (localhost []) by ietfa.amsl.com (Postfix) with ESMTP id 985B73A0BAB; Fri, 23 Apr 2021 07:43:32 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.099
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, HTML_MESSAGE=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=unavailable autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=eggert.org
Received: from mail.ietf.org ([]) by localhost (ietfa.amsl.com []) (amavisd-new, port 10024) with ESMTP id RoeRxEa8_yzY; Fri, 23 Apr 2021 07:43:27 -0700 (PDT)
Received: from mail.eggert.org (mail.eggert.org []) (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 F09B63A0888; Fri, 23 Apr 2021 07:43:26 -0700 (PDT)
Received: from [IPv6:2a00:ac00:4000:400:111a:ae16:2b19:6db2] (unknown [IPv6:2a00:ac00:4000:400:111a:ae16:2b19:6db2]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.eggert.org (Postfix) with ESMTPSA id B5834600342; Fri, 23 Apr 2021 17:43:16 +0300 (EEST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=eggert.org; s=dkim; t=1619188996; bh=bem+mgKEXK7NXBa5XJXr66WA3iZr5tWjO3ol3DpyWbs=; h=Subject:From:Date:Cc:Reply-To:References:To; b=mMzGYkjCax8uzuwEfDku5Jal+jQFXTdwHaGM3VNqGOFxenzLFyJZS97E54gS2cOAS jKJIN4h8oxa54JvFpyR3g5PORobAYD0wUM4lceZpct1gV0kL7AJkThXctG7sztFOZo WIEu1KtD+94DDOIn59um+KazXBm5XRHGF8RgyZJM=
Content-Type: multipart/signed; boundary="Apple-Mail=_63819CCE-7BBD-488A-94B8-E2CFD375DA9D"; protocol="application/pgp-signature"; micalg=pgp-sha512
Mime-Version: 1.0 (Mac OS X Mail 14.0 \(3654.\))
Subject: WG Review: Effective Terminology in IETF Documents (term)
From: Lars Eggert <lars@eggert.org>
Date: Fri, 23 Apr 2021 17:43:16 +0300
Cc: ietf@ietf.org, gendispatch@ietf.org
Reply-To: terminology@ietf.org
Message-Id: <2563B42A-20A4-4A9F-B9CA-518A72A0A095@eggert.org>
References: <161918836800.7390.6996403788262551415@ietfa.amsl.com>
To: terminology@ietf.org
X-Mailer: Apple Mail (2.3654.
X-MailScanner-ID: B5834600342.A6265
X-MailScanner: Found to be clean
X-MailScanner-From: lars@eggert.org
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf/olt8FUb_PIQvTWlGkFqE7HWLI9E>
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF-Discussion <ietf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ietf>, <mailto:ietf-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/ietf/>
List-Post: <mailto:ietf@ietf.org>
List-Help: <mailto:ietf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 23 Apr 2021 14:43:33 -0000


the latest version of the charter for TERM just went out for IETF-wide review. This is the second such review cycle, which I deemed necessary due to the number of changes to the charter text the first review resulted in.

Please send constructive comments on the charter for the proposed WG to terminology@ietf.org <mailto:terminology@ietf.org>, or privately to the IESG or even only to me as the responsible AD.

To make sure that your feedback is taken into account on this latest version of the charter text, I encourage you to send comments even if you commented during the last IETF review cycle, or when the charter was earlier discussed in GENDISPATCH.


> A new IETF WG has been proposed in the General Area. The IESG has not made
> any determination yet. The following draft charter was submitted, and is
> provided for informational purposes only. Please send your comments to the
> IESG mailing list (iesg@ietf.org) by 2021-05-03.
> Effective Terminology in IETF Documents (term)
> -----------------------------------------------------------------------
> Current status: Proposed WG
> Chairs:
>  TBD
> Assigned Area Director:
>  Lars Eggert <lars@eggert.org>
> General Area Directors:
>  Lars Eggert <lars@eggert.org>
> Mailing list:
>  Address: terminology@ietf.org
>  To subscribe: https://www.ietf.org/mailman/listinfo/terminology
>  Archive: https://mailarchive.ietf.org/arch/browse/terminology/
> Group page: https://datatracker.ietf.org/group/term/
> Charter: https://datatracker.ietf.org/doc/charter-ietf-term/
> The mission of the IETF as specified in BCP 95 is to produce high quality,
> relevant technical documents that influence the way people design, use, and
> manage the Internet. Contributions to the IETF, including Internet-Drafts and
> RFCs, are most understandable and effective when they use terminology that is
> clear, precise, and widely accessible to readers from varying backgrounds and
> cultures. This maximizes the benefits the IETF derives from its central
> principles, such as its open process and volunteer core.
> In the years leading up to the chartering of this working group, there has
> been discussion in the IETF, in other standards organizations, and in the
> broader technology industry about the use of certain terms of art in
> technical writing and whether those and other terms have an exclusionary
> effect. While opinions vary among IETF participants about this topic, there
> is widespread agreement that the IETF community would benefit from advice
> about using effective terminology that would improve clarity and
> approachability.
> The TERM working group is therefore chartered to produce an Informational RFC
> containing guidance to IETF participants on the use of effective terminology
> that also minimizes exclusionary effects. The RFC will express general
> principles for assessing when language is effective. The principles should be
> derived considering input from a broad set of IETF participants. The WG will
> identify and recommend external, independently updated resources containing
> examples of potentially problematic terms and potential alternatives to IETF
> participants for their consideration, to align its efforts with broader
> activities by the technology industry.
> The TERM working group is a focused group aiming to produce a single
> deliverable. It is designed to complement other efforts at fostering
> inclusivity in the IETF and will liaise with appropriate external groups,
> such as other SDOs or industry initiatives, to coordinate.
> The output of this WG will provide guidance to IETF participants and will not
> restrict the type or content of contributions that can be made to the IETF
> standards process. The output of this WG may inform a potential future
> activity by the RFC Editor to establish terminology guidance for the overall
> RFC series, but does not constrain any such future action.
> Milestones:
>  Jun 2021 - Adopt draft providing informational terminology recommendations
>  Dec 2021 - Submit informational terminology recommendations to IESG