[yang-doctors] draft-ietf-netconf-yang-library-augmentedby-13 ietf last call Yangdoctors review

Andy Bierman via Datatracker <noreply@ietf.org> Wed, 24 December 2025 17:43 UTC

MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit
From: Andy Bierman via Datatracker <noreply@ietf.org>
To: yang-doctors@ietf.org
Auto-Submitted: auto-generated
Precedence: bulk
Message-ID: <176659819613.1118050.9554013467420750418@dt-datatracker-5656579b89-p6k4r>
Date: Wed, 24 Dec 2025 09:43:16 -0800
Message-ID-Hash: D5MCGUX2HWXLJEXNPENMO3SH3P3NMXGC
CC: draft-ietf-netconf-yang-library-augmentedby.all@ietf.org, last-call@ietf.org, netconf@ietf.org
Reply-To: Andy Bierman <andy@yumaworks.com>
Subject: [yang-doctors] draft-ietf-netconf-yang-library-augmentedby-13 ietf last call Yangdoctors review
Archived-At: <https://mailarchive.ietf.org/arch/msg/yang-doctors/nD1s4ZAJ5mcJTav4XescYOX9dgk>

Document: draft-ietf-netconf-yang-library-augmentedby
Title: Augmented-by Addition to the YANG Library
Reviewer: Andy Bierman
Review result: Ready with Nits

Draft: draft-ietf-netconf-yang-library-augmentedby-13.txt
Module: ietf-yang-library-augmentedby
Revision: 2025-05-28
Status: Ready with nits

Issues:  none

Nits:

1) In the grouping description:

s/Leaf-list of the augmentation used/Leaf-list of the augmentations used/

2) same grouping

"modify the conformance of the module."

RFC 7950 does not describe augment in terms of conformance.

Suggest: "modify the schema tree of the module."

3) cut-and-paste in 3 places

The same normative description appears in 3 places:

-  augment "/yanglib:yang-library/yanglib:module-set/yanglib:module"
-  augment "/yanglib:modules-state/yanglib:module"
-  4.2.1.  The scope of augmented-by

Suggest moving this text to the leaf-list description and not
repeating it anywhere.

4) Security considerations

Suggest mentioning that the security considerations in RFC 8525,
sec. 6 apply here.

[yang-doctors] draft-ietf-netconf-yang-library-au… Andy Bierman via Datatracker