Re: [yang-doctors] YD review and yang-push and friends

Martin Bjorklund <mbj@tail-f.com> Tue, 13 March 2018 08:22 UTC

Return-Path: <mbj@tail-f.com>
X-Original-To: yang-doctors@ietfa.amsl.com
Delivered-To: yang-doctors@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 74C2412D7E4 for <yang-doctors@ietfa.amsl.com>; Tue, 13 Mar 2018 01:22:22 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.91
X-Spam-Level:
X-Spam-Status: No, score=-1.91 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, SPF_PASS=-0.001, T_RP_MATCHES_RCVD=-0.01, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
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 2EmamMlw7NtR for <yang-doctors@ietfa.amsl.com>; Tue, 13 Mar 2018 01:22:21 -0700 (PDT)
Received: from mail.tail-f.com (mail.tail-f.com [46.21.102.45]) by ietfa.amsl.com (Postfix) with ESMTP id CA405126CB6 for <yang-doctors@ietf.org>; Tue, 13 Mar 2018 01:22:20 -0700 (PDT)
Received: from localhost (unknown [173.38.220.45]) by mail.tail-f.com (Postfix) with ESMTPSA id 07AC31AE046D; Tue, 13 Mar 2018 09:22:18 +0100 (CET)
Date: Tue, 13 Mar 2018 09:22:18 +0100 (CET)
Message-Id: <20180313.092218.1630545026391500372.mbj@tail-f.com>
To: bclaise@cisco.com
Cc: kwatsen@juniper.net, mersue@gmail.com, yang-doctors@ietf.org
From: Martin Bjorklund <mbj@tail-f.com>
In-Reply-To: <81dbd2c7-2962-12f0-0f58-81a5fbac648f@cisco.com>
References: <045201d3b7d7$62c2c6a0$284853e0$@gmail.com> <25C4AC06-F4CB-4303-B19C-CA7BBFEBACD8@juniper.net> <81dbd2c7-2962-12f0-0f58-81a5fbac648f@cisco.com>
X-Mailer: Mew version 6.7 on Emacs 24.5 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=utf-8
Content-Transfer-Encoding: base64
Archived-At: <https://mailarchive.ietf.org/arch/msg/yang-doctors/ZckFB3FEIyHQtB-J5YvHstb5BvQ>
Subject: Re: [yang-doctors] YD review and yang-push and friends
X-BeenThere: yang-doctors@ietf.org
X-Mailman-Version: 2.1.22
Precedence: list
List-Id: Email list of the yang-doctors directorate <yang-doctors.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/yang-doctors>, <mailto:yang-doctors-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/yang-doctors/>
List-Post: <mailto:yang-doctors@ietf.org>
List-Help: <mailto:yang-doctors-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/yang-doctors>, <mailto:yang-doctors-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 13 Mar 2018 08:22:22 -0000

Benoit Claise <bclaise@cisco.com> wrote:
> Why not review the document, even if there is no YANG module, and see
> if there is something to pay attention to? The examples, for example,
> are important to review and validate.

Yes, but is this something for the YANG doctors in general?

In this particular case, it doesn't really matter, since most likely
several YDs will review the document anyway.


/martin

> 
> Regards, B.
> 
> 
> > Now that the YD page has been restored, here's what it says:
> >
> > """
> >
> > What to look for during a review
> >
> > The most important item is to give the AD a sense of how important it
> > is that they pay attention to the document.
> > For YANG reviews the YANG Doctors will apply the RFC6087bis document
> > on the Guidelines for Authors and Reviewers of YANG Data Model
> > Documents
> > ​https://datatracker.ietf.org/doc/draft-ietf-netmod-rfc6087bis/. The
> > YANG language syntax and semantics should be analyzed. The compliance
> > with ​Network Management Datastore Architecture should to be ensured
> > (see also ​NMDA guidelines).
> >
> > Review Information
> >
> > Under some circumstances, the YANG doctors might discover open issues
> > or provide feedback worth documenting for the larger community. While
> > the NETMOD WG still work on RFC6087bis, updating this document is
> > preferred. If the topic is not appropriate for the RFC6087bis or if
> > RFC6087bis has already been published, then this must be documented on
> > the YANG questions/answers WIKI
> > https://trac.ietf.org/trac/ops/wiki/YANGDoctorsFAQ.
> >
> > """
> >
> > The scope of the YD's review is unclear.
> >
> > K.
> >
> >
> > ===== original message =====
> >
> > One question coming up in my mind is against which criteria should
> > such drafts be reviewed.
> > A YANG module has its review criteria defined in YANG RFCs.
> > However examples may be manifold and imperfect.
> >
> > Cheers,
> > Mehmet
> >
> >> -----Original Message-----
> >> From: Kent Watsen <kwatsen@juniper.net>
> >> Sent: Thursday, March 8, 2018 6:09 PM
> >> To: Mehmet Ersue <mersue@gmail.com>om>; 'Martin Bjorklund' <mbj@tail-
> >> f.com>
> >> Cc: yang-doctors@ietf.org
> >> Subject: Re: [yang-doctors] YD review and yang-push and friends
> >>
> >>
> >>
> >>> I did not start review for netconf-event-notifications-08.
> >>>
> >>> Netconf co-chairs: Please clarify whether a review is required.
> >>
> >> What's in a YANG Doctor review?  Is it just syntax, or semantics too?
> >> If it includes semantics, then does that then entail needing to read
> >> the draft
> >> text as well, to determine if the YANG module expresses the correct
> >> semantics or find that the draft text is wrong?  Would it also extend
> >> to
> >> reviewing the examples in the draft, to further ensure that the
> >> semantics are
> >> understood correctly or, possibly, that there is an error in the
> >> example?
> >>
> >> Yes, I am aware that netconf-event-notifications does not define a
> >> YANG
> >> module, but it does have examples that for the YANG modules in the
> >> yang-
> >> push and subscriber-notifications drafts.  In that sense, I'm
> >> wondering if they
> >> need to be reviewed, or do we expect the YD reviewers of those other
> >> two
> >> drafts to look at this draft already?
> >>
> >> FWIW, I not talking about what might be found via validation.  I've
> >> already
> >> asked the authors to post a script that validates the 14 examples in
> >> this
> >> draft...
> >>
> >>
> >> K.
> >>
> >
> >
> >
> > _______________________________________________
> > yang-doctors mailing list
> > yang-doctors@ietf.org
> > https://www.ietf.org/mailman/listinfo/yang-doctors
>