Hi Mark,
Thank you for checking the complier. Regarding the module metadata, we can work together to put it into the module in the next ballot cycle.
Best Regards,
Yan
发件人: Mark Ellison [mailto:mark@xxxxxxxxxxxxxxxxxxx]
发送时间: 2018年9月7日
3:47
收件人: Zhuangyan (Yan) <zhuangyan.zhuang@xxxxxxxxxx>; STDS-802-3-YANG@xxxxxxxxxxxxxxxxx
抄送: Benoit Claise <bclaise@xxxxxxxxx>
主题: Re: [802.3_YANG] IEEE 802 compilation report (yang catalog)
Hello Yan,
For the 802.3 YANG modules, the revision issue is the only outstanding concern.
The issues reported by yangdump-pro for ieee802-ethernet-link-oam.yang:
Error: Mandatory object 'enable' not allowed in external augment statement
ieee802-ethernet-link-oam.yang:1025.11: error(335): mandatory object not allowed
(and several other leafs cited with an error(335)
turn out to be a validation bug within yangdump-pro. This warnings will not appear for the next version of yangdump-pro. The compiler was validating properly for the 'mandatory' tags appearing in a 'container', and not
validating properly for 'mandatory' tags appearing in an 'action' or 'notification'.
I have one more issue to investigate, but it is unique to the 802.1 set of YANG modules.
Earlier you had mentioned a concern about module metadata- can you provide additional details about this concern?
Regards,
Hi Mark,
Thanks for the work and help. We will start the next ballot cycle after the September
meeting and then open to collect comments to update our modules and draft.
You can comment on the modules at github now (https://github.com/YangModels/yang/tree/master/standard/ieee/802.3/draft
) and I will collect them (including issues and how to resolve them) from github for the group to consider in the next ballot cycle.
Otherwise, you can also provide comments against the modules/draft directly and send your
comments to our Editor Marek Hajduczenia (Marek.Hajduczenia@xxxxxxxxxxx) and myself. Both are good.
For the revision date update, even a single “revision” statement, we would have to submit
a comment every time to change the dates…
Thank you very much.
Best Regards,
Yan
From: Mark
Ellison [mailto:mark@xxxxxxxxxxxxxxxxxxx]
Sent: Friday, August 31, 2018 10:24 PM
To: Zhuangyan (Yan) <zhuangyan.zhuang@xxxxxxxxxx>
Cc: STDS-802-3-YANG@xxxxxxxxxxxxxxxxx
Subject: Re: [802.3_YANG] IEEE 802 compilation report (yang catalog)
I am available to work with the group on other warnings as well as module metadata.
Regarding the omission of a "revision" statement- I understand not wanting to have an accumulating number of revision statements for a module in development. Note
there is a middle path between all or nothing, the following excerpt appears on page 12 of RFC 6087, "Guidelines for Authors and Reviewers of YANG Data Model Documents":
"It is acceptable to reuse the same revision statement within
unpublished versions (i.e., Internet-Drafts), but the revision date
MUST be updated to a higher value each time the Internet-Draft is re-
posted."
Thus, an alternative would be to maintain a single "revision" sub-statement across iterations of a work-in-progress and just change the
revision date each iteration.
Regards,
Hi Mark,
Thank you for the email and report.
Regarding the error of missing “revision” sub-statement, we had a discussion in the group
and decided to add this revision statements to all modules once the modules are finalized. It avoids adding too much revision statements into modules and comments to these revisions every time.
For the other warnings and metadata, it would be good to work with you to resolve them.
Thank you very much.
Best Regards,
Yan
From: Mark
Ellison [mailto:mark@xxxxxxxxxxxxxxxxxxx]
Sent: Thursday, August 30, 2018 3:18 AM
To: STDS-802-3-YANG@xxxxxxxxxxxxxxxxx
Subject: [802.3_YANG] IEEE 802 compilation report (yang catalog)
Following up on my action item from our call this morning-
Here is a link to the IEEE compilation report from the YANG Catalog. There are a number of reported errors and warnings, plus a need to add metadata about the
modules for the catalog.
http://www.claise.be/IEEEStandardYANGPageCompilation.html
I am happy to work on resolution of these issues.
Mark Ellison
Ellison Software Consulting, Inc.
38 Salem Road
Atkinson, NH 03811, USA
To unsubscribe from the STDS-802-3-YANG list, click the following link:
https://listserv.ieee.org/cgi-bin/wa?SUBED1=STDS-802-3-YANG&A=1
To unsubscribe from the STDS-802-3-YANG list, click the following link: https://listserv.ieee.org/cgi-bin/wa?SUBED1=STDS-802-3-YANG&A=1
|