Re: [netmod] <CODE BEGINS> file "ietf-foo@2016-03-20.yang" or <CODE BEGINS> file "ietf-foo.yang"

t.petch <ietfc@btconnect.com> Fri, 24 March 2017 17:34 UTC

Return-Path: <ietfc@btconnect.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 5EEF8126C23 for <netmod@ietfa.amsl.com>; Fri, 24 Mar 2017 10:34:40 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.698
X-Spam-Level:
X-Spam-Status: No, score=-4.698 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-2.796, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=btconnect.onmicrosoft.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 mRyZ11tnTVOp for <netmod@ietfa.amsl.com>; Fri, 24 Mar 2017 10:34:37 -0700 (PDT)
Received: from EUR02-HE1-obe.outbound.protection.outlook.com (mail-eopbgr10093.outbound.protection.outlook.com [40.107.1.93]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 8ACCA1201F2 for <netmod@ietf.org>; Fri, 24 Mar 2017 10:34:36 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=btconnect.onmicrosoft.com; s=selector1-btconnect-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=V4k0dFSzD/vkfvbpurwJ0zsAwoi6wnmbKD87xRlcT10=; b=Z/Z4XaFnqgOa9tn9BnG2782VbKDSCLpTtEJr5TlwmPWZ8Y2VHl0FH/sBZ5n1WtqztZ8ioLhL4/rB8QqdndYDI0e8IV1NPwkJIOcXh1S7vcDr5WTACBr1H6A5HI2TktXpld0WkNv7m2Fsk1EbbvDSEFMJ9H8iNZ3mYldZCTs6UIY=
Authentication-Results: cisco.com; dkim=none (message not signed) header.d=none;cisco.com; dmarc=none action=none header.from=btconnect.com;
Received: from pc6 (86.169.157.161) by HE1PR0701MB3001.eurprd07.prod.outlook.com (10.168.93.135) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.991.4; Fri, 24 Mar 2017 17:34:33 +0000
Message-ID: <01a501d2a4c4$ac2c5ee0$4001a8c0@gateway.2wire.net>
From: "t.petch" <ietfc@btconnect.com>
To: rwilton@cisco.com, Martin Bjorklund <mbj@tail-f.com>
CC: netmod@ietf.org
References: <30B9FE1D-D8E8-4255-847B-DBAD1AA6E73D@juniper.net> <f536f12f-3afa-2501-12ff-15c8159c59e0@cisco.com> <146c5483-6e6d-a581-781b-bf5351b1df68@cisco.com> <20170324.144408.1191664098390131544.mbj@tail-f.com>
Date: Fri, 24 Mar 2017 17:22:35 +0000
MIME-Version: 1.0
Content-Type: text/plain; charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-Priority: 3
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook Express 6.00.2800.1106
X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1106
X-Originating-IP: [86.169.157.161]
X-ClientProxiedBy: VI1PR09CA0058.eurprd09.prod.outlook.com (10.174.49.26) To HE1PR0701MB3001.eurprd07.prod.outlook.com (10.168.93.135)
X-MS-Office365-Filtering-Correlation-Id: ad2423bf-b74a-4e41-18d1-08d472dc0988
X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001); SRVR:HE1PR0701MB3001;
X-Microsoft-Exchange-Diagnostics: 1; HE1PR0701MB3001; 3:UkQNUOkdzQVKrpsaaYR8Dk6QyGWVBmBkKFndo8l7JBZ93ZZpBkbT/zwyp/6K8ButjNhEPitWBLho13BgMrw/PhXqwy0uuXfRb0K9OKEMprmEHgOFYIJ93Im3qIOK5Qn9h+s+k7HYOxMPRr08v56wCk4bzLCoaRU1siS3o/5dCNK3RLEb66G2gRHcGHbGafOfvgXY0xT1a5MPcmiEM85YcvsVGJgScLyB0z0xpHroLP0FYpscPx5XdY4tfFIz/Qu69KhBGDEoT9iVaC7cG4pdaA==; 25:0kGZQSTnR1iDFJugSxUjyako59KK4LKr2LblSS1q0nxXZYtjGBKk9JXjcONweZOHGeCDDSjtIIks6ZFfK8S9S1Ndu3hE/XUXzMoamMDCm2qWb75QaWse0upOPfZwB67oBKnZSoYzrR+DYbBjV5OyrTgW8T1QNRLIpjMqIVIr1Z41hg11iPUqEmMDGWOwpf2nbaLV14YVV/PE+ubGarqFDeCxXe8Si2qLhkXXyAi26cSKwrsycIo5IBacB+3WqOLz7gzH93WP2KtDuJESc7J64oB4YwI0ZhV/ZPSctluRJ1QJq7nmhwrX92Vv0lVWJJyqYtrQVhanOq0/Mi8LTg2dFqcKxHISHJvsCFNhC7/cuYEjtZgLyFIDQapmvgiNJpihEf+oHxkZwBq+m46lF2lzk43rRkMIaVQJwHaWYbp14nz6pzV9S6/YtBXBD0ZWh7cUSOBdGInl+CzMc0iK2NepWA==
X-Microsoft-Exchange-Diagnostics: 1; HE1PR0701MB3001; 31:ZsAdqBbj0a7XLuVB29Wh+eUUf5qGqa9u4SjY+2tyV/Zlbhcfv/mYkCJpiizPxMd7Vx4X+iB2oFDi3Q9qf0gM3RjeNjXvwgEi3xqvAEUHfViFGnlwz0xTBZY04PR5WV1L4ZRAnmc/RgUQ83y0tQGqt+Ff+k8DSRKSIWTBgbzK13F0amDRxETdcaA2toVkmjDPk24xLxXWqaMx4c2ZQOtI5TPM74ecnOpAag7xnLYDYaOVQdVNXtzkGnA3Rab64MBSO+pYHwcEKCGLQsPa2ViDaw==
X-Microsoft-Antispam-PRVS: <HE1PR0701MB300100B372B1A5AEE6E13F5EA03E0@HE1PR0701MB3001.eurprd07.prod.outlook.com>
X-Exchange-Antispam-Report-Test: UriScan:(95692535739014);
X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040375)(601004)(2401047)(5005006)(8121501046)(10201501046)(3002001)(6041248)(20161123555025)(20161123560025)(20161123562025)(20161123564025)(20161123558025)(6072148); SRVR:HE1PR0701MB3001; BCL:0; PCL:0; RULEID:; SRVR:HE1PR0701MB3001;
X-Microsoft-Exchange-Diagnostics: 1; HE1PR0701MB3001; 4:SnnMmhKbObZihrhZ9gki2hKor15ebt4SOBywhgBxZgvYxGpuN3pCy0YK3FjqNJOAgQj92TEFu93e2oC/t37sx4j0114UuUeVbc9WzC/I+Ql1yTa11SEMRfAs5LBmaO7KyyXdGVMySzuq79z7rD0AmeKXi1Wj7PZk2TDFucy0Vqw47XGkPnPhnW0rhfCLiyqHmm6qT/YhjQkBhA8GvGWbLpJksrHZWHeP7L7ILdXrivBjVs+CqZsMZGqyrojNhAyX88z9j+9c+/ZDPKMlZ17H9aFGZURHdTH7m2KReB0SKW3JKaBLlSLqBpqnxxnL5oTwE2bs4/UK0+101o8rqFbgAtbVRO8afOCVeM/dEC5cbUVUZ9RCWAlwMs/j1FVw89N9N2vKLtdzgByqUkWCQd0b4jaKN6QQnfLOiw+nmxZMPnfiWDBmU5SJtEhs6bAvjQxO7oOV0uJQSNy0fQEqOlYGLmwQbMOe0wao+gMFcGgseaL1SScZFJSSlyupoAJB/BRK+I2oKemH1ldUnmgU4rDAZUwdsTGgo3Z2fcB6VQVqdImuid/oH+liXRj+X34zUWF/gLtzuxUWWD+7nBGN0a2nZBV4SKnwxb+pB3cmkP94hxKNAtFlXbKrGXgpZKKag2AG7DC79sPz0bYDSJAKl2jBGw==
X-Forefront-PRVS: 0256C18696
X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10019020)(4630300001)(6009001)(39450400003)(39860400002)(39850400002)(39840400002)(39410400002)(13464003)(377454003)(24454002)(5423002)(81686999)(50986999)(9686003)(76176999)(6306002)(4720700003)(230700001)(42186005)(230783001)(3846002)(33646002)(61296003)(84392002)(189998001)(86362001)(7736002)(2906002)(93886004)(1456003)(5660300001)(44736005)(23756003)(6246003)(50226002)(6496005)(50466002)(6486002)(305945005)(53936002)(1556002)(38730400002)(81166006)(66066001)(62236002)(47776003)(53546009)(25786009)(8676002)(4326008)(44716002)(229853002)(6116002)(74416001)(7726001)(222073002); DIR:OUT; SFP:1102; SCL:1; SRVR:HE1PR0701MB3001; H:pc6; FPR:; SPF:None; MLV:sfv; LANG:en;
X-Microsoft-Exchange-Diagnostics: 1; HE1PR0701MB3001; 23:gr9vPNc3sveqZXrKSiN/h/UBNIYbM0hTXEjNIfhQY7Bu2/dIGZqOpn3bEOBfvZT6zAA8WqDObJi0NhkOP4Hc6kv49T1DbIrxMvFy5EgJqXJG8KKOUW9w1vE525XvPDk3jOz+q6AFcO2+60AVxYs3BvYxRt93lt+7Atm76sjJ1bbhfGBwcebqoUEK2pTxue7VC999WyF8qY/Sc/lozaemvwCikmM8aeJ2MJkexj4nx/qYY0UP87UToCiZ1kd3bTroLI6l01pN/8IAUeuS/6zYnsk2906O/6NVp7elXJTbzB64Z6j2whIUcNgFJaEjpC+vgPIgoL/EsxJE/AByhneTtoH3n/hKoU0WuZJsoG+k9O9d4WlhhxCaxnPeoecEB8lu/2I1G/zfB3kyTXBhgbrCaXTkwuZ8lTIbqMXWDYXqvdl9HHzjlmwiRjLZFz9cybFjzmNRR7hdIEfOc1eX/3JelYwpiSE7BuOEiZgku5VErKdGW9Aguv5870PzcEgAr8KPxfHCFR5M797GEMxA/T5bICpZR4/tkN3FrMigk+1Xj7FEQcdWY7FDkH0sZjieA7p4tWSu/rID7GSBvDTYbIoj34BusrNsaZEJ31N02k7EivhhcpA6xClJejfxouctp3a/GIYpv9pyr6yQFt9OJfopcB9DpYbCYDxVbuOHb5gvwBK2lR3C8KO32HeiXXcZxn7j73XvBMRYH6sBlS1h+rb2T1diwTn6UrdM0/cfyBo+pIt+Sm2Ps54L5T9D85F/gTcCftdBEL8DZkj2XA8Kn+0lWva0ImWhtGvqZ8AChPkdbPobOhrgfEYNzvWc0mfiguVL53nZCMqNcoi735mm42qw3ZEguj4M/e67e3/cHb27+QI/Qyze9s1mY8U+hx8WcHnyO6SB1bT2fSrOFWIgA90QZAB9bzgR0UIioQd3EWCIkHqn73aDE4oMhcZ1UukJm8p8l7yrc+Yq4JdTWA3jl6kAk46ktin8IwxWD69Dhkp1OwxvW2EY19XlEpINHv3dCScT2BW+NsYrtjhTR0za9WydvqIOKQX8Bh+uL762RP67G4M+4CH3YAYl4F1sAW/xsWkV4ZqQZekMnU8Uojo8mYhH5WPNzG5jbpbEfQ3MGyWq++yryoqj/w9wjnWL+EhlH8qHiS43BmKSUtvMBf4rSjsjHGgO0uUdkjNYPFUgeZ6Gu8EacjlcM07NWXir2yFynPx/1aQw5cVuLLsqt6d1p+XrchPkhOb0nKvQ4AAfhOJGF24/RnbH5eerdWmMikwn1DCE2RWKeAuoHQEnH1nzaOeWDo0XHWCG5X6L4oZVj6m7gQrpTnc9nyfsqriv8b+dO4fa9cOb6+ZGLLfHhAQArveoBg==
X-Microsoft-Exchange-Diagnostics: 1; HE1PR0701MB3001; 6:orbPX2Hk5BUQ50Q5yMFqCf8r09BXLtv7ijZKaMoM4oOHscEeJ2ujnensM0CqT8pBTNedtRLI3EfRy+6MNAmUNQIUyVc2MZOg0hN5PLmzURHIHWJiyKbFHiMvgsH/qBhHkJKWNkPeDddhe/CTD0ayMM2N5k3rIZ4uYNEyoFfQHqNeJnZo27qXgeWsF7cOKDtJK4t6QWJClCn0lmSR5Nio1zbhf+MjWxw1k2fzXOhfX/KTDmmD74tONSS823XR4bibIY0AxuJw108IUd1bq+N5Lj2Gs6zO6LQ0P/dhjphlgJP1EXf7YPpPi3R16C7TKUGIaHPP5aaAdmzW7hVOiEFOzAvskTNDEZEyaeRM+cu0D3y7uj5Fzv9IKI1QiuWFlSWRR3e+wACkCs6M5+wFhe/wDg==; 5:RgwCoKyOQNbEtta6DN9TNAmRac/ev5rUeLLejkwsgNW6kazCrSkj+Eu5uBRBDRAOKgOan8RHAaccoejn7EaI2c/ftoL7Ugjc5Mq5CDQZzvxAq79+33ACjX+zuhKCZE9A3xN81ZVGi3aIZCaYy7vy9A==; 24:bA888jgw1ipN43bO7CXSXqvXOKnVTMWBLj5JvKOZfHGL0i7QlWghdQZD4OLZGKjtwdUBX+Fgq3BFcg2+MUAmt817ulwyXoYLoBOdfebLXxQ=
SpamDiagnosticOutput: 1:99
SpamDiagnosticMetadata: NSPM
X-Microsoft-Exchange-Diagnostics: 1; HE1PR0701MB3001; 7:olMBfDV6B915RTxp7ozA3BdFF3idYmXYLwQt1EQV1HR3XGT3iZFXw2MJ7ZrLIhc7uuzgaklpnPP3Fzc9taXAazEloYv0VT4paugIomP076sC4aR3wz+HXb6hppSxEIhq2KWP2218f0nGPRdgdPduC306eZxepti8j/HjKxx09OchtB+LWorwESv9vYiBOqf2wYVwaUyk7CI9rmF8sXiDl+wnIgVysDrPl8m2Qd4/lYUdU2vCF+UhIzzXB98VSBsufRbH5cxWqc3GWRXZoQqIjlYUOeFCeNYZfiEtaMwke4RiKLWKJhBxvwgubjxmb0C2QRB9XlgOEdBgmwUJI2R1MQ==
X-OriginatorOrg: btconnect.com
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 24 Mar 2017 17:34:33.9103 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-Transport-CrossTenantHeadersStamped: HE1PR0701MB3001
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/k9ttbKj9dyvXJQsxOEJAYtd3DIs>
Subject: Re: [netmod] <CODE BEGINS> file "ietf-foo@2016-03-20.yang" or <CODE BEGINS> file "ietf-foo.yang"
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: Fri, 24 Mar 2017 17:34:40 -0000

----- Original Message -----
From: "Martin Bjorklund" <mbj@tail-f.com>
To: <rwilton@cisco.com>
Cc: <jclarke@cisco.com>; <netmod@ietf.org>
Sent: Friday, March 24, 2017 1:44 PM


> Robert Wilton <rwilton@cisco.com> wrote:
> >
> >
> > On 24/03/2017 08:09, Benoit Claise wrote:
> > > On 3/24/2017 2:32 AM, Kent Watsen wrote:
> > >> Hi Benoit,
> > >>
> > >> Section 4.2 of rfc6187bis says:
> > >>
> > >>     The "<CODE BEGINS>" tag SHOULD be followed by a string
> > >>     identifying the file name specified in Section 5.2 of
> > >>     [RFC7950].
> > >>
> > >> While Section 5.2 of RFC7950 says:
> > >>
> > >>     The name of the file SHOULD be of the form:
> > >>
> > >>       module-or-submodule-name ['@' revision-date] ( '.yang' /
'.yin' )
> > >>
> > >>     "module-or-submodule-name" is the name of the module or
> > >>     submodule, and the optional "revision-date" is the latest
> > >>     revision of the module or submodule, as defined by the
> > >>     "revision" statement (Section 7.1.9).
> > >>
> > >> While the SHOULD statements provide a recommendation, the
> > >> square-brackets "[]" impart no bias, and the text is ambiguous.
> > >> That is, is the revision-date optional *only* because the
> > >> revision statement is optional within the module?  What is
> > >> the recommendation for when the revision statement is present?
> > >> The RFC7950 text isn't clear.
> > >>
> > >> My opinion is that RFC7950 errata should state that the file
> > >> name SHOULD include the revision-date when the revision
> > >> statement appears within the module.
> > > That makes sense.
> > > Any other views?
> >
> > I don't feel strongly, but would it make more sense if instead
> > rfc6187bis stated that the file name SHOULD include the revision
date?
> > I.e. 7950 states what the filename is allowed to look like and
6187bis
> > states what they should look like for IETF produced models.

Yes, and I would also like RFC6087bis to require the date on the file
statement, if present, to match that on the revision statement - I have
seen several I-D where this has not been the case.  Something a tool
could check.

Should the date be the most recent revision statement?  I cannot see why
not.

Will there always be a revision statement?  RFC7950 says SHOULD,
cardinality 0..n so not always.

Tom Petch


> +1
>
>
> /martin
>
> _______________________________________________
> netmod mailing list
> netmod@ietf.org
> https://www.ietf.org/mailman/listinfo/netmod