Hello Mahesh, I was asked by the group to include in each import statement whether the imported module is needed as import-only or as implemented. IMHO netmod/netconf group should agree on some standard text for model designers to use. Maybe the text proposed below can be used everywhere. The sentence starting with Revision yyyy-mm-dd may not always be needed.
I propose the text
import ietf-netconf-acm {
prefix nacm;
description
"The module ietf-netconf-acm is OPTIONAL to implement.";
}
import ietf-yang-library {
prefix yanglib;
description "The module ietf-yang-library is REQUIRED to
be implemented. Revision 2019-01-04 or a
revision derived from it is REQUIRED.";
}
Regards Balazs
P.S. In Yang-Next this could be a candidate for a formal substatement instead
of a description text.
From: Mahesh Jethanandani <mjethanand...@gmail.com>
Sent: 2019. december 18., szerda 3:20
To: Kent Watsen <kent+i...@watsen.net>
Cc: Balázs Lengyel <balazs.leng...@ericsson.com>
Subject: Re: [netconf] New Version Notification for
draft-ietf-netconf-notification-capabilities-08.txt
Hi Balazs,
Additionally, it would be important to address some of the normative text in
the module. Specifically, we were looking at the following description
statements:
import ietf-yang-push {
prefix yp;
description
"This module requires ietf-yang-push to be implemented for the
two subscription-capabilities containers.";
}
import ietf-yang-library {
prefix yanglib;
description "This module requires ietf-yang-library to
be implemented. Revision 2019-01-04 or a
revision derived from it is required.";
}
The requirement in the description statement feels and smells like words one
would use to signify requirements in a specification. However, you are not
using any of the words like REQUIRED etc. to describe it. Why is it?
Mahesh Jethanandani
mjethanand...@gmail.com <mailto:mjethanand...@gmail.com>
smime.p7s
Description: S/MIME cryptographic signature
_______________________________________________ netmod mailing list netmod@ietf.org https://www.ietf.org/mailman/listinfo/netmod
