Re: [yang-doctors] Re-review of YANG Modules following the NMDA Guidelines WAS:RE: Fwd: Important: Guidelines for YANG module authors
"Mehmet Ersue" <mersue@gmail.com> Thu, 10 August 2017 16:21 UTC
Return-Path: <mersue@gmail.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 709BC13239E for <yang-doctors@ietfa.amsl.com>; Thu, 10 Aug 2017 09:21:35 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.998
X-Spam-Level:
X-Spam-Status: No, score=-1.998 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com
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 va1BNbdEwxcX for <yang-doctors@ietfa.amsl.com>; Thu, 10 Aug 2017 09:21:31 -0700 (PDT)
Received: from mail-wm0-x229.google.com (mail-wm0-x229.google.com [IPv6:2a00:1450:400c:c09::229]) (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 8FAB91323A7 for <yang-doctors@ietf.org>; Thu, 10 Aug 2017 09:21:30 -0700 (PDT)
Received: by mail-wm0-x229.google.com with SMTP id i66so26957322wmg.0 for <yang-doctors@ietf.org>; Thu, 10 Aug 2017 09:21:30 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:references:in-reply-to:subject:date:message-id :mime-version:thread-index:content-language; bh=NkXlO8yg071whWlzSH44ovZzRB4yCzukFvPbSTJADNE=; b=vQEmM7hV3CKMhQNLSGKxKfQc05IDMdiOsKSvJZImNP4sK6iR9FLUdFC2VbK3sfTp1T K7vrkc03nT0i4RL9xNbjnqF56cHkR0PtVPOA+Zs6qKfTGrc8noo43RzPVkgQ0T3WUCPe Nwv4ruX+Cz5ao7Hh4+Tob3CSa6gWdb0oOOK2bJIX16wSyGfq984hXx56G7a6bCgFVEKe hFC1/V+rU7K8vucyOmyc+cMPy7oB/5KPDlBvVgkKjEhF3ooImSDnSSWyUECkl5ki1Kb8 OrKCHIOUkH0DZhuz1zalQBXKIalqVhkL06YmeFb9QlFCaZ2AtmXsJ1kz4ED+wHQhqLgu lZHQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:references:in-reply-to:subject:date :message-id:mime-version:thread-index:content-language; bh=NkXlO8yg071whWlzSH44ovZzRB4yCzukFvPbSTJADNE=; b=L+6ASta6mEnWiTK1LGXKDch8xAgU9gDl5SFEw/5svW4VTJTGqCMW6k/R52u4ULBZmT V4Y6C//TBaqVaXjxMrYhEcIjtp7Sf0S/J++iQpIA8Gtu/sx5hDlw5fDjPh7IzuPhmxuQ OvF0+9shpshhUdZQOX6m6pvBtnCsISAqIud1ELlXsWUv5+cmmHY3kPPeLO1rqGD6W9h2 TQJ2U0Cp26UzJFpZXS1Mt8qGlk4/CWuXARm9pyhhXlyaD83KSATqZImORp9DXFi5kcrS xj8isYZUthXVOp+WocVAg0rfMrpJz6dBi24mUrGiwuMZsrDRcrL+RYNbF+uKWMuj6to2 wEyw==
X-Gm-Message-State: AHYfb5i9qii1Op56vyvtnn19CmlraRZRZs0yQi+SjO82xbcAChWyubbi EyYVQqBqkmo/tMbd
X-Received: by 10.28.208.78 with SMTP id h75mr7726165wmg.119.1502382088985; Thu, 10 Aug 2017 09:21:28 -0700 (PDT)
Received: from DESKTOPFLHJVQJ (p57A77FD9.dip0.t-ipconnect.de. [87.167.127.217]) by smtp.gmail.com with ESMTPSA id k134sm6376408wmg.12.2017.08.10.09.21.27 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 10 Aug 2017 09:21:28 -0700 (PDT)
From: Mehmet Ersue <mersue@gmail.com>
To: 'YANG Doctors' <yang-doctors@ietf.org>
Cc: 'Dan Romascanu' <dromasca@gmail.com>
References: <007e01d2f019$eb5d13c0$c2173b40$@gmail.com>
In-Reply-To: <007e01d2f019$eb5d13c0$c2173b40$@gmail.com>
Date: Thu, 10 Aug 2017 18:21:26 +0200
Message-ID: <031e01d311f4$b7b289e0$27179da0$@gmail.com>
MIME-Version: 1.0
Content-Type: multipart/alternative; boundary="----=_NextPart_000_031F_01D31205.7B3F9FA0"
X-Mailer: Microsoft Outlook 16.0
Thread-Index: AQKq4XgVZBJJ0TP8/31AhqTzCHStU6DOIpsA
Content-Language: de
Archived-At: <https://mailarchive.ietf.org/arch/msg/yang-doctors/eg2VdEGhRSzd-Mj5nC7rpIQEx4M>
Subject: Re: [yang-doctors] Re-review of YANG Modules following the NMDA Guidelines WAS:RE: Fwd: Important: Guidelines for YANG module authors
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: Thu, 10 Aug 2017 16:21:36 -0000
Dear YANG Doctors, we think it is important that the YANG modules we are developing are NMDA compliant. If not done yet, please indicate the necessary actions needed for NMDA compliance on the review page of a draft. This is an essential help for the draft authors to get their document final before IETF LC. The review update can be entered on the draft review page under "Correct review". See the mail below for the documents you reviewed. See the URL below for the reviews done so far: https://datatracker.ietf.org/group/yangdoctors/reviews/?since=all#closed-rev iew-requests Many Thanks for your kind efforts!! Cheers, Mehmet (YANG Doctors Secretary) From: yang-doctors [mailto:yang-doctors-bounces@ietf.org] On Behalf Of Mehmet Ersue Sent: Wednesday, June 28, 2017 4:22 PM To: 'YANG Doctors' <yang-doctors@ietf.org> Cc: 'Dan Romascanu' <dromasca@gmail.com> Subject: [yang-doctors] Re-review of YANG Modules following the NMDA Guidelines WAS:RE: Fwd: Important: Guidelines for YANG module authors Dear YANG Doctors, following Benoit's request I'm going to restart the review of the YANG modules listed below to achieve the NMDA compliance. Please use for your review the criteria and guidelines in: <https://datatracker.ietf.org/doc/draft-dsdt-nmda-guidelines/> https://datatracker.ietf.org/doc/draft-dsdt-nmda-guidelines/ If there is any issue or unclear guideline we need to clarify this on YANG Doctors maillist. I would like to ask you to finish your review at the latest during or right after the IETF week so that we can give the draft authors feedback as early as possible (potentially during IETF #99). Currently running reviews should already consider the NMDA guidelines. These are: <https://datatracker.ietf.org/doc/draft-ietf-i2rs-yang-l3-topology/reviewreq uest/8890/> draft-ietf-i2rs-yang-l3-topology-09 Ladislav Lhotka <https://datatracker.ietf.org/doc/draft-ietf-rtgwg-device-model/reviewreques t/8513/> draft-ietf-rtgwg-device-model-02 Giles Heron <https://datatracker.ietf.org/doc/draft-ietf-mpls-ldp-yang/reviewrequest/845 9/> draft-ietf-mpls-ldp-yang-01 Dean Bogdanovic <https://datatracker.ietf.org/doc/draft-ietf-netmod-syslog-model/reviewreque st/8317/> draft-ietf-netmod-syslog-model-12 Kent Watsen Below are the drafts which need to be re-reviewed by original reviewers. - To enter your review result please click on the draft name (on the page for closed reviews: https://datatracker.ietf.org/group/yangdoctors/reviews/?since=all#closed-rev iew-requests) - Please use the button "Correct review" to enter the review results. - Please send an email to the authors AND YANG Doctors maillist. <https://datatracker.ietf.org/doc/draft-ietf-pim-yang/reviewrequest/8484/> draft-ietf-pim-yang-00 Dean Bogdanovic Ready with Issues NOTE: Publication requested, not yet in IETF LC, i.e. an urgent review is very useful. <https://datatracker.ietf.org/doc/draft-ietf-l3sm-l3vpn-service-model/review request/8246/> draft-ietf-l3sm-l3vpn-service-model-16 Giles Heron Ready NOTE: Already published. Review can be useful. <https://datatracker.ietf.org/doc/draft-ietf-netmod-intf-ext-yang/reviewrequ est/8458/> draft-ietf-netmod-intf-ext-yang-04 Andy Bierman Almost Ready <https://datatracker.ietf.org/doc/draft-ietf-netconf-yang-push/reviewrequest /8237/> draft-ietf-netconf-yang-push-04 Bert Wijnen On the Right Track <https://datatracker.ietf.org/doc/draft-ietf-i2rs-yang-l3-topology/reviewreq uest/8481/> draft-ietf-i2rs-yang-l3-topology-02 Carl Moberg Ready with Issues <https://datatracker.ietf.org/doc/draft-ietf-lime-yang-oam-model/reviewreque st/8236/> draft-ietf-lime-yang-oam-model-08 Carl Moberg On the Right Track <https://datatracker.ietf.org/doc/draft-ietf-lime-yang-connectionless-oam-me thods/reviewrequest/8235/> draft-ietf-lime-yang-connectionless-oam-methods-00Carl Moberg On the Right Track <https://datatracker.ietf.org/doc/draft-ietf-lime-yang-connectionless-oam/re viewrequest/8234/> draft-ietf-lime-yang-connectionless-oam-03 Carl Moberg On the Right Track <https://datatracker.ietf.org/doc/draft-ietf-trill-yang-oam/reviewrequest/88 16/> draft-ietf-trill-yang-oam Jan Lindblad On the Right Track <https://datatracker.ietf.org/doc/draft-ietf-ippm-twamp-yang/reviewrequest/8 483/> draft-ietf-ippm-twamp-yang-00 Jan Lindblad Ready with Issues <https://datatracker.ietf.org/doc/draft-ietf-pim-igmp-mld-yang/reviewrequest /8263/> draft-ietf-pim-igmp-mld-yang-01 Jan Lindblad On the Right Track <https://datatracker.ietf.org/doc/draft-ietf-i2rs-yang-network-topo/reviewre quest/8482/> draft-ietf-i2rs-yang-network-topo-02 Kent Watsen Almost Ready <https://datatracker.ietf.org/doc/draft-ietf-rtgwg-yang-rip/reviewrequest/84 86/> draft-ietf-rtgwg-yang-rip-02 Ladislav Lhotka Ready with Issues <https://datatracker.ietf.org/doc/draft-ietf-rtgwg-yang-key-chain/reviewrequ est/8239/> draft-ietf-rtgwg-yang-key-chain-13 Ladislav Lhotka Almost Ready <https://datatracker.ietf.org/doc/draft-ietf-teas-yang-te-topo/reviewrequest /8747/> draft-ietf-teas-yang-te-topo-08 Mahesh Jethanandani Ready with Issues <https://datatracker.ietf.org/doc/draft-ietf-netmod-acl-model/reviewrequest/ 8480/> draft-ietf-netmod-acl-model-07 Mahesh Jethanandani Ready with Issues <https://datatracker.ietf.org/doc/draft-ietf-rtgwg-ni-model/reviewrequest/84 93/> draft-ietf-rtgwg-ni-model-02 Martin Bjorklund Not Ready <https://datatracker.ietf.org/doc/draft-ietf-rtgwg-lne-model/reviewrequest/8 491/> draft-ietf-rtgwg-lne-model-02 Martin Bjorklund Ready with Issues <https://datatracker.ietf.org/doc/draft-ietf-lmap-yang/reviewrequest/8485/> draft-ietf-lmap-yang-05 Martin Bjorklund Ready with Issues <https://datatracker.ietf.org/doc/draft-ietf-rtgwg-routing-types/reviewreque st/8529/> draft-ietf-rtgwg-routing-types Radek Krejčí Ready with Nits <https://datatracker.ietf.org/doc/draft-ietf-rtgwg-yang-vrrp/reviewrequest/8 487/> draft-ietf-rtgwg-yang-vrrp-01 Radek Krejčí Ready with Issues Many Thanks for your efforts. Cheers, Mehmet From: yang-doctors [ <mailto:yang-doctors-bounces@ietf.org> mailto:yang-doctors-bounces@ietf.org] On Behalf Of Benoit Claise Sent: Monday, June 26, 2017 1:01 PM To: YANG Doctors < <mailto:yang-doctors@ietf.org> yang-doctors@ietf.org>; Robert Wilton -X (rwilton - Ensoft Ltd at Cisco) < <mailto:rwilton@cisco.com> rwilton@cisco.com>; < <mailto:rtg-ads@ietf.org> rtg-ads@ietf.org> < <mailto:rtg-ads@ietf.org> rtg-ads@ietf.org>; <mailto:ops-ads@ietf.org> ops-ads@ietf.org Subject: Re: [yang-doctors] Fwd: Important: Guidelines for YANG module authors Dear YANG doctors, Thinking some more about it, I believe we want to review one more time the already-reviewed YANG modules to flag whether they align with the guidelines below. Background: the TEAS YANG module draft-ietf-teas-yang-te-topo, which we're discussing now. On this specific one, not only it's not aligned with the NMDA guidelines, but he doesn't align with any of of the known YANG module structure, as Rob mentioned: My comment actually relates to the fact the structure used by TE YANG modules don't match any other YANG modules - they are using their own unique style of structure. Practically, it means that this YANG module will be hard to integrate. Regards, Benoit Dear YANG doctors, Here is an important message for your YANG doctor reviews. Rob Wilton developed some tooling to help YANG module designers to transition to NMDA. Rob, would you mind explaining to everybody on this list, and maybe on the NETMOD if you believe this is relevant for everybody. Regards, Benoit -------- Forwarded Message -------- Subject: Important: Guidelines for YANG module authors Date: Fri, 9 Jun 2017 15:56:39 +0200 From: Benoit Claise <mailto:bclaise@cisco.com> <bclaise@cisco.com> To: NETMOD Working Group <mailto:netmod@ietf.org> <netmod@ietf.org> Dear all, Now that the new NETMOD and NETCONF charters have been approved, it's time to think about the guidelines for YANG module authors. The Network Management Datastore Architecture (NMDA) addresses the so-called "OpState problem" that has been the subject of much discussion in the IETF. NMDA is still in development, and there will be a transition period before NMDA solutions are universally available. The NETMOD Datastore Design Team and the Routing Yang Architecture Design Team have worked with Alia and Benoit to create initial guidelines for how the NMDA, as defined in <https://datatracker.ietf.org/doc/draft-ietf-netmod-revised-datastores/> draft-ietf-netmod-revised-datastores, impacts Yang models. The <https://datatracker.ietf.org/doc/draft-dsdt-nmda-guidelines/> draft-dsdt-nmda-guidelines individual draft was foundational in helping creating those guidelines. If you have questions or concerns on how these guidelines should apply to work of interest, please contact your WG Chairs or ADs. It is our strong recommendation, as ADs with agreement from the NETMOD WG Chairs, that models SHOULD move as quickly as possible to the NMDA. The specific approach to be taken for models being developed now and during the NMDA transition period should be based on both the expected usage and the maturity of the data model. 1. New models and models that are not concerned with the operational state of configuration information SHOULD immediately be structured to be NMDA-compatible. 2. Models that require immediate support for "in use" and "system created" information SHOULD be structured for NMDA. Then derived versions of these models SHOULD be created, either by hand or with suitable tools, that follow the current modeling strategies. In some cases, the non-NMDA model may be an existing model and not derived from the NMDA model. In all cases, the NMDA and non-NMDA modules SHOULD be published in the same document, with NMDA modules in the document main body and the non-NMDA modules in an Appendix. The use of the non-NMDA model will allow temporary bridging of the time period until NMDA implementations are available. The non-NMDA module names should include '-state' appended. We would like to thank Kent Watsen, Lou Berger, Rob Wilton, Martin Bjorklund, Phil Shafer, Acee Lindem, Chris Hopps, Juergen Schoenwaelder, and all others who helped develop these guidelines. Regards, Alia Atlas, Routing AD Deborah Brungard, Routing AD Alvaro Retana, Routing AD Warren Kumari, Operations & Management AD Benoit Claise, Operations & Management AD _______________________________________________ yang-doctors mailing list <mailto:yang-doctors@ietf.org> yang-doctors@ietf.org <https://www.ietf.org/mailman/listinfo/yang-doctors> https://www.ietf.org/mailman/listinfo/yang-doctors
- [yang-doctors] Re-review of YANG Modules followin… Mehmet Ersue
- Re: [yang-doctors] Re-review of YANG Modules foll… Andy Bierman
- Re: [yang-doctors] Re-review of YANG Modules foll… Juergen Schoenwaelder
- Re: [yang-doctors] Re-review of YANG Modules foll… Mehmet Ersue