Re: [netmod] WG Last Call: draft-ietf-netmod-rfc6087bis-14

Alexander Clemm <alexander.clemm@huawei.com> Tue, 17 October 2017 19:49 UTC

Return-Path: <alexander.clemm@huawei.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 9A6F513292A; Tue, 17 Oct 2017 12:49:38 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.221
X-Spam-Level:
X-Spam-Status: No, score=-4.221 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_PASS=-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 Pv4-Iu3VKNnV; Tue, 17 Oct 2017 12:49:36 -0700 (PDT)
Received: from lhrrgout.huawei.com (lhrrgout.huawei.com [194.213.3.17]) (using TLSv1 with cipher RC4-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 7A07D132705; Tue, 17 Oct 2017 12:49:35 -0700 (PDT)
Received: from 172.18.7.190 (EHLO lhreml703-cah.china.huawei.com) ([172.18.7.190]) by lhrrg02-dlp.huawei.com (MOS 4.3.7-GA FastPath queued) with ESMTP id DQV30202; Tue, 17 Oct 2017 19:49:32 +0000 (GMT)
Received: from SJCEML702-CHM.china.huawei.com (10.208.112.38) by lhreml703-cah.china.huawei.com (10.201.108.44) with Microsoft SMTP Server (TLS) id 14.3.361.1; Tue, 17 Oct 2017 20:49:31 +0100
Received: from SJCEML521-MBX.china.huawei.com ([169.254.1.102]) by SJCEML702-CHM.china.huawei.com ([169.254.4.145]) with mapi id 14.03.0361.001; Tue, 17 Oct 2017 12:49:27 -0700
From: Alexander Clemm <alexander.clemm@huawei.com>
To: Kent Watsen <kwatsen@juniper.net>, Alexander Clemm <ludwig@clemm.org>, "netmod@ietf.org" <netmod@ietf.org>
CC: "netmod-chairs@ietf.org" <netmod-chairs@ietf.org>, "draft-ietf-netmod-rfc6087bis@ietf.org" <draft-ietf-netmod-rfc6087bis@ietf.org>
Thread-Topic: [netmod] WG Last Call: draft-ietf-netmod-rfc6087bis-14
Thread-Index: AQHTK/QA8+mcxSk5vUmECY2lUkQ4OqLoNIuAgADU1oD//56TYA==
Date: Tue, 17 Oct 2017 19:49:26 +0000
Message-ID: <644DA50AFA8C314EA9BDDAC83BD38A2E0EAB6C8C@sjceml521-mbx.china.huawei.com>
References: <DE7DEC2E-F737-4020-8830-AF556A65EEF5@juniper.net> <001701d3470b$8f473fe0$add5bfa0$@clemm.org> <EA300017-CDE0-4006-95D5-D2E81CBBE9E3@juniper.net>
In-Reply-To: <EA300017-CDE0-4006-95D5-D2E81CBBE9E3@juniper.net>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
x-originating-ip: [10.213.48.110]
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-CFilter-Loop: Reflected
X-Mirapoint-Virus-RAPID-Raw: score=unknown(0), refid=str=0001.0A020206.59E65ECD.0075, ss=1, re=0.000, recu=0.000, reip=0.000, cl=1, cld=1, fgs=0, ip=169.254.1.102, so=2013-06-18 04:22:30, dmn=2013-03-21 17:37:32
X-Mirapoint-Loop-Id: 5fcc494bb5ef979f6997c9a15e26cdc5
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/04J9Qw0LhEDGsfz1lBnTumqjCbk>
Subject: Re: [netmod] WG Last Call: draft-ietf-netmod-rfc6087bis-14
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.22
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, 17 Oct 2017 19:49:38 -0000

Hi Kent

Two quick replies, inline, <ALEX>

Thanks
--- Alex

> -----Original Message-----
> From: netmod [mailto:netmod-bounces@ietf.org] On Behalf Of Kent Watsen
> Sent: Tuesday, October 17, 2017 11:30 AM
> To: Alexander Clemm <ludwig@clemm.org>rg>; netmod@ietf.org
> Cc: netmod-chairs@ietf.org; draft-ietf-netmod-rfc6087bis@ietf.org
> Subject: Re: [netmod] WG Last Call: draft-ietf-netmod-rfc6087bis-14
> 
> Hi Alex,
> 
> > (Resending, apologies in case of duplicates)
> 
> Resending? This is the first time I'm seeing these.  Did you send them when
> the Last Call was open before?  The Last Call closed a couple weeks ago  ;)

<ALEX> I suspected there was a problem with my mailer.  So I am glad I resent them. No, the comments are "fresh", not from weeks ago
</ALEX>

> 
> I don't want to reopen rfc6087bis for anything less than Errata at this point (or
> promoting it to a BCP, but that's a different thing altogether).  It seems that
> some of your suggestions could go into the new "guidelines-next" issue
> tracker [1].  We may also consider adding information to the FAQ [2].
> Regarding Security Considerations, I think that a "node" can be the root of a
> subtree, and the rubbery- ness is likely from [3] and can be addressed
> separately.

<ALEX> I saw other comments on the list just yesterday, and was encouraged off-line to send my comments and also to review more documents;-)  so I just went ahead and did.  Sure, I have no problems to not hold up the draft - as commented on the other thread, I would like to see drafts progress faster, not slower, even if it means some churn further down the road.  That said, I do think that guidelines re: RPC modeling, and extending/augmenting groupings are currently lacking and needing improvement at some point.  

Re: rubbery-ness, no, this is taken from this draft, not from 6087.  

--- Alex
</ALEX>

> 
> [1] https://github.com/netmod-wg/guidelines-next/issues
> [2] https://github.com/netmod-wg/FAQ/wiki
> [3] http://trac.tools.ietf.org/area/ops/trac/wiki/yang-security-guidelines
> 
> What do you think?
> 
> Kent // shepherd
> 
> 
> 
> I have reviewed some parts of the draft and have just a few comments as
> well:
> 
> -	One area where guidelines are missing, but where guidance would
> be
> needed, concerns how to model return values from RPCs, as well as how to
> model the handling of RPC error conditions.  This is an area where I think
> YANG itself could need some improvement, and in its absence good
> guidelines would be even more important.
> -	It would be also useful to provide guidelines regarding how to
> augment/extend groupings.  This is a common scenario and what to do is not
> necessarily intuitive, so I am sure many users would appreciate guidelines
> here.
> -	Section 3.4: It would be good to provide a guideline regarding lines
> that exceed 70 columns (from the pyang tree output), at least mention that
> authors need to manually address this issue
> -	Section 3.7: Personally, I think the security considerations as
> currently stated, while well-intended, introduce a bit too much red tape.
> Specifically, this concerns having to list nodes individually - this can lead to
> defining many "trees" while missing the "forest".  The guidelines are a bit
> "rubbery" here, by the way, stating that data nodes MUST be individually
> listed and discussed, at the same time only if they "could be especially
> disruptive" - what does that mean - so maybe the requirement should simply
> be a "SHOULD" here?
> -	Observation: there is no mention/guideline canonical order of YANG
> statements.
> 
> Thanks
> --- Alex
> 
> -----Original Message-----
> From: netmod [mailto:netmod-bounces@ietf.org] On Behalf Of Kent Watsen
> Sent: Tuesday, September 12, 2017 11:22 AM
> To: netmod@ietf.org
> Cc: netmod-chairs@ietf.org; draft-ietf-netmod-rfc6087bis@ietf.org
> Subject: [netmod] WG Last Call: draft-ietf-netmod-rfc6087bis-14
> 
> 
> This starts a two-week working group last call on:
> 
>     Guidelines for Authors and Reviewers of YANG Data Model Documents
>     https://urldefense.proofpoint.com/v2/url?u=https-
> 3A__tools.ietf.org_html_draft-2Dietf-2Dnetmod-2Drfc6087bis-
> 2D14&d=DwICAg&c=HAkYuh63rsuhr6Scbfh0UjBXeMK-
> ndb3voDTXcWzoCI&r=9zkP0xnJUvZGJ9EPoOH7Yhqn2gsBYaGTvjISlaJdcZo&m
> =iR7m1fbjxuH4HW0Ws7SS-
> jWBlHsFIVCZEbG2vxMtmno&s=mQRtxCYVsN0ttmets8w-8a-
> VBh3vh9rJj_NJVhtGa4k&e=
> 
> Please send email to the list indicating your support or concerns.
> 
> We are particularly interested in statements of the form:
>   * I have reviewed this draft and found no issues.
>   * I have reviewed this draft and found the following issues: ...
> 
> 
> Thank you,
> NETMOD WG Chairs
> 
> 
> 
> _______________________________________________
> netmod mailing list
> netmod@ietf.org
> https://urldefense.proofpoint.com/v2/url?u=https-
> 3A__www.ietf.org_mailman_listinfo_netmod&d=DwICAg&c=HAkYuh63rsuh
> r6Scbfh0UjBXeMK-
> ndb3voDTXcWzoCI&r=9zkP0xnJUvZGJ9EPoOH7Yhqn2gsBYaGTvjISlaJdcZo&m
> =iR7m1fbjxuH4HW0Ws7SS-
> jWBlHsFIVCZEbG2vxMtmno&s=NeFF02cR18ZWLxBX0kSsjAolx0QUWN4ChF3_
> GJc9WMc&e=
> 
> 
> 
> _______________________________________________
> netmod mailing list
> netmod@ietf.org
> https://www.ietf.org/mailman/listinfo/netmod