[netmod] [Editorial Errata Reported] RFC8407 (7791)

RFC Errata System <rfc-editor@rfc-editor.org> Tue, 30 January 2024 17:01 UTC

Return-Path: <wwwrun@rfcpa.amsl.com>
X-Original-To: netmod@ietfa.amsl.com
Delivered-To: netmod@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 2C122C14F5FD for <netmod@ietfa.amsl.com>; Tue, 30 Jan 2024 09:01:03 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.358
X-Spam-Level:
X-Spam-Status: No, score=-2.358 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, HEADER_FROM_DIFFERENT_DOMAINS=0.249, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01, URIBL_BLOCKED=0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id WJwV9e6W4kqW for <netmod@ietfa.amsl.com>; Tue, 30 Jan 2024 09:00:59 -0800 (PST)
Received: from rfcpa.amsl.com (rfcpa.amsl.com [50.223.129.200]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 7EB96C14F6B3 for <netmod@ietf.org>; Tue, 30 Jan 2024 09:00:59 -0800 (PST)
Received: by rfcpa.amsl.com (Postfix, from userid 499) id 5B59D1A3A476; Tue, 30 Jan 2024 09:00:59 -0800 (PST)
To: rfc-editor@rfc-editor.org
From: RFC Errata System <rfc-editor@rfc-editor.org>
Cc: worley@alum.mit.edu, andy@yumaworks.com, netmod@ietf.org
Content-Type: text/plain; charset="UTF-8"
Message-Id: <20240130170059.5B59D1A3A476@rfcpa.amsl.com>
Date: Tue, 30 Jan 2024 09:00:59 -0800
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/ALVFsaFQzJkl-s554Lw8u6drKXA>
Subject: [netmod] [Editorial Errata Reported] RFC8407 (7791)
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: NETMOD WG list <netmod.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netmod>, <mailto:netmod-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netmod/>
List-Post: <mailto:netmod@ietf.org>
List-Help: <mailto:netmod-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netmod>, <mailto:netmod-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 30 Jan 2024 17:01:03 -0000

The following errata report has been submitted for RFC8407,
"Guidelines for Authors and Reviewers of Documents Containing YANG Data Models".

--------------------------------------
You may review the report below and at:
https://www.rfc-editor.org/errata/eid7791

--------------------------------------
Type: Editorial
Reported by: Dale R. Worley <worley@alum.mit.edu>

Section: GLOBAL

Original Text
-------------
There are two related items.

1) Section 3.7.1 "Security Considerations Section Template" begins

   X.  Security Considerations

   The YANG module specified in this document defines a schema for data
   that is designed to be accessed via network management protocols such
   as NETCONF [RFC6241] or RESTCONF [RFC8040].  The lowest NETCONF layer
   is the secure transport layer, and the mandatory-to-implement secure
   transport is Secure Shell (SSH) [RFC6242].  The lowest RESTCONF layer
   is HTTPS, and the mandatory-to-implement secure transport is TLS
   [RFC8446].

2) RFC 8470 says "the latest approved template (available at
<https://trac.ietf.org/trac/ops/wiki/yang-security-guidelines>)".  But
the template at that URL says "the latest approved template (available
at
http://trac.tools.ietf.org/area/ops/trac/wiki/yang-security-guidelines)."


Corrected Text
--------------
1) It would be helpful if the beginning of the template contained a
reference to RFC 8407 to provide a pointer back to where the templated
section of Yang module definitions was instantiated from.  Perhaps
starting the template with "[Instantiated from the template of
[RFC8407] section 3.7.1.]"

2) While the URL given in RFC 8407 works, the URL given in the online
template only goes to a generic page, "Welcome to the IETF Community
Wiki".  Presumably the URL in the online template should be the URL of
that page itself.



Notes
-----
Item (2) is a straightforward correction.  Item (1) is in service to
having better pointers/references in our documents.

Instructions:
-------------
This erratum is currently posted as "Reported". (If it is spam, it 
will be removed shortly by the RFC Production Center.) Please
use "Reply All" to discuss whether it should be verified or
rejected. When a decision is reached, the verifying party  
will log in to change the status and edit the report, if necessary.

--------------------------------------
RFC8407 (draft-ietf-netmod-rfc6087bis-20)
--------------------------------------
Title               : Guidelines for Authors and Reviewers of Documents Containing YANG Data Models
Publication Date    : October 2018
Author(s)           : A. Bierman
Category            : BEST CURRENT PRACTICE
Source              : Network Modeling
Area                : Operations and Management
Stream              : IETF
Verifying Party     : IESG