[netmod] Status Update of draft-ietf-netmod-node-tags
Current Status: * The updated revision -03 posted on May 12,2021 > Add five Metric tags; > Separate use cases as separate section; > Security section enhancement; > Editorial fixes; Open Issues: * None. Next Steps: * Update the document to align with Module tag RFC8819 * Remove Histogram metric type tag from metric type tags. * Update targeted data object collection example. * Get more reviews. * Working Group Last Call after completing above. ___ netmod mailing list netmod@ietf.org https://www.ietf.org/mailman/listinfo/netmod
Re: [netmod] Status update on
YANG parser in this document context is XML/JSON parser for YANG defined data, in my understanding. Not sure this is right term or whether there is any better term. We will figure it out. Thanks. -Qin -邮件原件- 发件人: Juergen Schoenwaelder [mailto:j.schoenwael...@jacobs-university.de] 发送时间: 2018年5月31日 12:55 收件人: Qin Wu 抄送: dingxiaojian (A); netmod@ietf.org 主题: Re: [netmod] Status update on What is a 'YANG parser'? For me, a YANG parser is something that parses YANG, i.e., not an XML or JSON parser. /js On Thu, May 31, 2018 at 03:21:27AM +, Qin Wu wrote: > This is exactly what we proposed in v-(02) , > https://www.ietf.org/rfcdiff?url2=draft-wu-netmod-yang-xml-doc-convent > ions-02 > > Regarding machine parsing data, please see last paragraph of abstract: > " >There are no implications in this >document for YANG parsers: this document does not change the rules >for presenting YANG models or for encoding YANG in data files or in >the wire. > " > This has already been highlighted in v-(00). > > -Qin > -邮件原件- > 发件人: dingxiaojian (A) > 发送时间: 2018年5月31日 11:15 > 收件人: Juergen Schoenwaelder; Qin Wu > 抄送: netmod@ietf.org > 主题: RE: [netmod] Status update on > > > Agree with Jurgen, I think what need to be emphasized is how machine parse > the data should not be changed,in draft-wu-netmod-yang-xml-doc-conventions, > what is required is additional encoding and decoding mechanism to make data > better fit into RFC and I-D. > > Xiaojian > > -Original Message- > From: netmod [mailto:netmod-boun...@ietf.org] On Behalf Of Juergen > Schoenwaelder > Sent: Wednesday, May 30, 2018 1:34 PM > To: Qin Wu > Cc: netmod@ietf.org > Subject: Re: [netmod] Status update on > > > I think the title of the document is misleading. The convention for > expressing YANG in XML is called YIN, defined in RFC 7950. There are other > phrases that I find misleading, for example, Automatic Generation of Valid > XML From Examples. For me, the example is the XML (or JSON) and what you call > an example is the encoding of an XML in the RFC format and what you define is > an RFC format qencoding and a decoding function. Perhaps it helps to properly > define the terminology you use and then to go through the document to make > sure terms are used consistently. > > /js > > On Wed, May 30, 2018 at 01:39:42AM +, Qin Wu wrote: > > Hi, WG: > > We have made an update Documentation Conventions for Expressing YANG in XML > > I-D based on last meeting discussion. > > The changes include: > > 1. Add JSON support. > > 2. Add objectives section > > 3. Consolidate Mandatory Boilerplate for both leaf node and metadata > > annotation. > > 4. Move complex case to Appendix. > > 5. Better Align abstract and introduction section with objectives sections. > > The diff is: > > https://www.ietf.org/rfcdiff?url2=draft-wu-netmod-yang-xml-doc-conve > > nt > > ions-01 We believe the v-(01) address all the comments in last > > meeting and can serve a good basis to move to the next step. > > Thanks. Further Comments and suggestions are welcome. > > > > -Qin > > -邮件原件- > > 发件人: internet-dra...@ietf.org [mailto:internet-dra...@ietf.org] > > 发送时间: 2018年5月30日 9:17 > > 收件人: Benoit Claise; Qin Wu; Adrian Farrel; Benoît Claise > > 主题: New Version Notification for > > draft-wu-netmod-yang-xml-doc-conventions-01.txt > > > > > > A new version of I-D, > > draft-wu-netmod-yang-xml-doc-conventions-01.txt > > has been successfully submitted by Qin Wu and posted to the IETF repository. > > > > Name: draft-wu-netmod-yang-xml-doc-conventions > > Revision: 01 > > Title: Documentation Conventions for Expressing YANG in XML > > Document date: 2018-05-29 > > Group: Individual Submission > > Pages: 10 > > URL: > > https://www.ietf.org/internet-drafts/draft-wu-netmod-yang-xml-doc-conventions-01.txt > > Status: > > https://datatracker.ietf.org/doc/draft-wu-netmod-yang-xml-doc-conventions/ > > Htmlized: > > https://tools.ietf.org/html/draft-wu-netmod-yang-xml-doc-conventions-01 > > Htmlized: > > https://datatracker.ietf.org/doc/html/draft-wu-netmod-yang-xml-doc-conventions > > Diff: > > https://www.ietf.org/rfcdiff?url2=draft-wu-netmod-yang-xml-doc-conventions-01 > > > > Abstract: > >Many documents that define YANG modules also include artwork examples > >presented in XML/JSON. > > > >IETF documentation has specific limits on line
Re: [netmod] Status update on
What is a 'YANG parser'? For me, a YANG parser is something that parses YANG, i.e., not an XML or JSON parser. /js On Thu, May 31, 2018 at 03:21:27AM +, Qin Wu wrote: > This is exactly what we proposed in v-(02) , > https://www.ietf.org/rfcdiff?url2=draft-wu-netmod-yang-xml-doc-conventions-02 > > Regarding machine parsing data, please see last paragraph of abstract: > " >There are no implications in this >document for YANG parsers: this document does not change the rules >for presenting YANG models or for encoding YANG in data files or in >the wire. > " > This has already been highlighted in v-(00). > > -Qin > -邮件原件- > 发件人: dingxiaojian (A) > 发送时间: 2018年5月31日 11:15 > 收件人: Juergen Schoenwaelder; Qin Wu > 抄送: netmod@ietf.org > 主题: RE: [netmod] Status update on > > > Agree with Jurgen, I think what need to be emphasized is how machine parse > the data should not be changed,in draft-wu-netmod-yang-xml-doc-conventions, > what is required is additional encoding and decoding mechanism to make data > better fit into RFC and I-D. > > Xiaojian > > -Original Message- > From: netmod [mailto:netmod-boun...@ietf.org] On Behalf Of Juergen > Schoenwaelder > Sent: Wednesday, May 30, 2018 1:34 PM > To: Qin Wu > Cc: netmod@ietf.org > Subject: Re: [netmod] Status update on > > > I think the title of the document is misleading. The convention for > expressing YANG in XML is called YIN, defined in RFC 7950. There are other > phrases that I find misleading, for example, Automatic Generation of Valid > XML From Examples. For me, the example is the XML (or JSON) and what you call > an example is the encoding of an XML in the RFC format and what you define is > an RFC format qencoding and a decoding function. Perhaps it helps to properly > define the terminology you use and then to go through the document to make > sure terms are used consistently. > > /js > > On Wed, May 30, 2018 at 01:39:42AM +, Qin Wu wrote: > > Hi, WG: > > We have made an update Documentation Conventions for Expressing YANG in XML > > I-D based on last meeting discussion. > > The changes include: > > 1. Add JSON support. > > 2. Add objectives section > > 3. Consolidate Mandatory Boilerplate for both leaf node and metadata > > annotation. > > 4. Move complex case to Appendix. > > 5. Better Align abstract and introduction section with objectives sections. > > The diff is: > > https://www.ietf.org/rfcdiff?url2=draft-wu-netmod-yang-xml-doc-convent > > ions-01 We believe the v-(01) address all the comments in last meeting > > and can serve a good basis to move to the next step. > > Thanks. Further Comments and suggestions are welcome. > > > > -Qin > > -邮件原件- > > 发件人: internet-dra...@ietf.org [mailto:internet-dra...@ietf.org] > > 发送时间: 2018年5月30日 9:17 > > 收件人: Benoit Claise; Qin Wu; Adrian Farrel; Benoît Claise > > 主题: New Version Notification for > > draft-wu-netmod-yang-xml-doc-conventions-01.txt > > > > > > A new version of I-D, draft-wu-netmod-yang-xml-doc-conventions-01.txt > > has been successfully submitted by Qin Wu and posted to the IETF repository. > > > > Name: draft-wu-netmod-yang-xml-doc-conventions > > Revision: 01 > > Title: Documentation Conventions for Expressing YANG in XML > > Document date: 2018-05-29 > > Group: Individual Submission > > Pages: 10 > > URL: > > https://www.ietf.org/internet-drafts/draft-wu-netmod-yang-xml-doc-conventions-01.txt > > Status: > > https://datatracker.ietf.org/doc/draft-wu-netmod-yang-xml-doc-conventions/ > > Htmlized: > > https://tools.ietf.org/html/draft-wu-netmod-yang-xml-doc-conventions-01 > > Htmlized: > > https://datatracker.ietf.org/doc/html/draft-wu-netmod-yang-xml-doc-conventions > > Diff: > > https://www.ietf.org/rfcdiff?url2=draft-wu-netmod-yang-xml-doc-conventions-01 > > > > Abstract: > >Many documents that define YANG modules also include artwork examples > >presented in XML/JSON. > > > >IETF documentation has specific limits on line length and some > >artwork examples such as XML examples have to include line wraps that > >would not normally be allowed according to the XML representation > >rules of RFC7950 and RFC7952.The same applies to JSON. > > > >This document lays out documentation conventi
Re: [netmod] Status update on
This is exactly what we proposed in v-(02) , https://www.ietf.org/rfcdiff?url2=draft-wu-netmod-yang-xml-doc-conventions-02 Regarding machine parsing data, please see last paragraph of abstract: " There are no implications in this document for YANG parsers: this document does not change the rules for presenting YANG models or for encoding YANG in data files or in the wire. " This has already been highlighted in v-(00). -Qin -邮件原件- 发件人: dingxiaojian (A) 发送时间: 2018年5月31日 11:15 收件人: Juergen Schoenwaelder; Qin Wu 抄送: netmod@ietf.org 主题: RE: [netmod] Status update on Agree with Jurgen, I think what need to be emphasized is how machine parse the data should not be changed,in draft-wu-netmod-yang-xml-doc-conventions, what is required is additional encoding and decoding mechanism to make data better fit into RFC and I-D. Xiaojian -Original Message- From: netmod [mailto:netmod-boun...@ietf.org] On Behalf Of Juergen Schoenwaelder Sent: Wednesday, May 30, 2018 1:34 PM To: Qin Wu Cc: netmod@ietf.org Subject: Re: [netmod] Status update on I think the title of the document is misleading. The convention for expressing YANG in XML is called YIN, defined in RFC 7950. There are other phrases that I find misleading, for example, Automatic Generation of Valid XML From Examples. For me, the example is the XML (or JSON) and what you call an example is the encoding of an XML in the RFC format and what you define is an RFC format qencoding and a decoding function. Perhaps it helps to properly define the terminology you use and then to go through the document to make sure terms are used consistently. /js On Wed, May 30, 2018 at 01:39:42AM +, Qin Wu wrote: > Hi, WG: > We have made an update Documentation Conventions for Expressing YANG in XML > I-D based on last meeting discussion. > The changes include: > 1. Add JSON support. > 2. Add objectives section > 3. Consolidate Mandatory Boilerplate for both leaf node and metadata > annotation. > 4. Move complex case to Appendix. > 5. Better Align abstract and introduction section with objectives sections. > The diff is: > https://www.ietf.org/rfcdiff?url2=draft-wu-netmod-yang-xml-doc-convent > ions-01 We believe the v-(01) address all the comments in last meeting > and can serve a good basis to move to the next step. > Thanks. Further Comments and suggestions are welcome. > > -Qin > -邮件原件- > 发件人: internet-dra...@ietf.org [mailto:internet-dra...@ietf.org] > 发送时间: 2018年5月30日 9:17 > 收件人: Benoit Claise; Qin Wu; Adrian Farrel; Benoît Claise > 主题: New Version Notification for > draft-wu-netmod-yang-xml-doc-conventions-01.txt > > > A new version of I-D, draft-wu-netmod-yang-xml-doc-conventions-01.txt > has been successfully submitted by Qin Wu and posted to the IETF repository. > > Name: draft-wu-netmod-yang-xml-doc-conventions > Revision: 01 > Title:Documentation Conventions for Expressing YANG in XML > Document date:2018-05-29 > Group:Individual Submission > Pages:10 > URL: > https://www.ietf.org/internet-drafts/draft-wu-netmod-yang-xml-doc-conventions-01.txt > Status: > https://datatracker.ietf.org/doc/draft-wu-netmod-yang-xml-doc-conventions/ > Htmlized: > https://tools.ietf.org/html/draft-wu-netmod-yang-xml-doc-conventions-01 > Htmlized: > https://datatracker.ietf.org/doc/html/draft-wu-netmod-yang-xml-doc-conventions > Diff: > https://www.ietf.org/rfcdiff?url2=draft-wu-netmod-yang-xml-doc-conventions-01 > > Abstract: >Many documents that define YANG modules also include artwork examples >presented in XML/JSON. > >IETF documentation has specific limits on line length and some >artwork examples such as XML examples have to include line wraps that >would not normally be allowed according to the XML representation >rules of RFC7950 and RFC7952.The same applies to JSON. > >This document lays out documentation conventions that allow YANG >examples to be presented in IETF documentation when XML/JSON encoded >YANG data instance would otherwise exceed the maximum line length and >provide consistent XML/JSON encoded YANG data node instance example >within an Internet-Draft or RFC. There are no implications in this >document for YANG parsers: this document does not change the rules >for presenting YANG models or for encoding YANG in data files or in >the wire. > > > > > > Please note that it may take a couple of minutes from the time of submission > until the htmlized version and diff are available at tools.ietf.org. > > The IETF Secretariat > &g
Re: [netmod] Status update on
Agree with Jurgen, I think what need to be emphasized is how machine parse the data should not be changed,in draft-wu-netmod-yang-xml-doc-conventions, what is required is additional encoding and decoding mechanism to make data better fit into RFC and I-D. Xiaojian -Original Message- From: netmod [mailto:netmod-boun...@ietf.org] On Behalf Of Juergen Schoenwaelder Sent: Wednesday, May 30, 2018 1:34 PM To: Qin Wu Cc: netmod@ietf.org Subject: Re: [netmod] Status update on I think the title of the document is misleading. The convention for expressing YANG in XML is called YIN, defined in RFC 7950. There are other phrases that I find misleading, for example, Automatic Generation of Valid XML From Examples. For me, the example is the XML (or JSON) and what you call an example is the encoding of an XML in the RFC format and what you define is an RFC format qencoding and a decoding function. Perhaps it helps to properly define the terminology you use and then to go through the document to make sure terms are used consistently. /js On Wed, May 30, 2018 at 01:39:42AM +, Qin Wu wrote: > Hi, WG: > We have made an update Documentation Conventions for Expressing YANG in XML > I-D based on last meeting discussion. > The changes include: > 1. Add JSON support. > 2. Add objectives section > 3. Consolidate Mandatory Boilerplate for both leaf node and metadata > annotation. > 4. Move complex case to Appendix. > 5. Better Align abstract and introduction section with objectives sections. > The diff is: > https://www.ietf.org/rfcdiff?url2=draft-wu-netmod-yang-xml-doc-convent > ions-01 We believe the v-(01) address all the comments in last meeting > and can serve a good basis to move to the next step. > Thanks. Further Comments and suggestions are welcome. > > -Qin > -邮件原件- > 发件人: internet-dra...@ietf.org [mailto:internet-dra...@ietf.org] > 发送时间: 2018年5月30日 9:17 > 收件人: Benoit Claise; Qin Wu; Adrian Farrel; Benoît Claise > 主题: New Version Notification for > draft-wu-netmod-yang-xml-doc-conventions-01.txt > > > A new version of I-D, draft-wu-netmod-yang-xml-doc-conventions-01.txt > has been successfully submitted by Qin Wu and posted to the IETF repository. > > Name: draft-wu-netmod-yang-xml-doc-conventions > Revision: 01 > Title:Documentation Conventions for Expressing YANG in XML > Document date:2018-05-29 > Group:Individual Submission > Pages:10 > URL: > https://www.ietf.org/internet-drafts/draft-wu-netmod-yang-xml-doc-conventions-01.txt > Status: > https://datatracker.ietf.org/doc/draft-wu-netmod-yang-xml-doc-conventions/ > Htmlized: > https://tools.ietf.org/html/draft-wu-netmod-yang-xml-doc-conventions-01 > Htmlized: > https://datatracker.ietf.org/doc/html/draft-wu-netmod-yang-xml-doc-conventions > Diff: > https://www.ietf.org/rfcdiff?url2=draft-wu-netmod-yang-xml-doc-conventions-01 > > Abstract: >Many documents that define YANG modules also include artwork examples >presented in XML/JSON. > >IETF documentation has specific limits on line length and some >artwork examples such as XML examples have to include line wraps that >would not normally be allowed according to the XML representation >rules of RFC7950 and RFC7952.The same applies to JSON. > >This document lays out documentation conventions that allow YANG >examples to be presented in IETF documentation when XML/JSON encoded >YANG data instance would otherwise exceed the maximum line length and >provide consistent XML/JSON encoded YANG data node instance example >within an Internet-Draft or RFC. There are no implications in this >document for YANG parsers: this document does not change the rules >for presenting YANG models or for encoding YANG in data files or in >the wire. > > > > > > Please note that it may take a couple of minutes from the time of submission > until the htmlized version and diff are available at tools.ietf.org. > > The IETF Secretariat > > ___ > netmod mailing list > netmod@ietf.org > https://www.ietf.org/mailman/listinfo/netmod -- Juergen Schoenwaelder Jacobs University Bremen gGmbH Phone: +49 421 200 3587 Campus Ring 1 | 28759 Bremen | Germany Fax: +49 421 200 3103 <https://www.jacobs-university.de/> ___ netmod mailing list netmod@ietf.org https://www.ietf.org/mailman/listinfo/netmod ___ netmod mailing list netmod@ietf.org https://www.ietf.org/mailman/listinfo/netmod
[netmod] Status update on
Hi, WG: We have made an update Documentation Conventions for Expressing YANG in XML I-D based on last meeting discussion. The changes include: 1. Add JSON support. 2. Add objectives section 3. Consolidate Mandatory Boilerplate for both leaf node and metadata annotation. 4. Move complex case to Appendix. 5. Better Align abstract and introduction section with objectives sections. The diff is: https://www.ietf.org/rfcdiff?url2=draft-wu-netmod-yang-xml-doc-conventions-01 We believe the v-(01) address all the comments in last meeting and can serve a good basis to move to the next step. Thanks. Further Comments and suggestions are welcome. -Qin -邮件原件- 发件人: internet-dra...@ietf.org [mailto:internet-dra...@ietf.org] 发送时间: 2018年5月30日 9:17 收件人: Benoit Claise; Qin Wu; Adrian Farrel; Benoît Claise 主题: New Version Notification for draft-wu-netmod-yang-xml-doc-conventions-01.txt A new version of I-D, draft-wu-netmod-yang-xml-doc-conventions-01.txt has been successfully submitted by Qin Wu and posted to the IETF repository. Name: draft-wu-netmod-yang-xml-doc-conventions Revision: 01 Title: Documentation Conventions for Expressing YANG in XML Document date: 2018-05-29 Group: Individual Submission Pages: 10 URL: https://www.ietf.org/internet-drafts/draft-wu-netmod-yang-xml-doc-conventions-01.txt Status: https://datatracker.ietf.org/doc/draft-wu-netmod-yang-xml-doc-conventions/ Htmlized: https://tools.ietf.org/html/draft-wu-netmod-yang-xml-doc-conventions-01 Htmlized: https://datatracker.ietf.org/doc/html/draft-wu-netmod-yang-xml-doc-conventions Diff: https://www.ietf.org/rfcdiff?url2=draft-wu-netmod-yang-xml-doc-conventions-01 Abstract: Many documents that define YANG modules also include artwork examples presented in XML/JSON. IETF documentation has specific limits on line length and some artwork examples such as XML examples have to include line wraps that would not normally be allowed according to the XML representation rules of RFC7950 and RFC7952.The same applies to JSON. This document lays out documentation conventions that allow YANG examples to be presented in IETF documentation when XML/JSON encoded YANG data instance would otherwise exceed the maximum line length and provide consistent XML/JSON encoded YANG data node instance example within an Internet-Draft or RFC. There are no implications in this document for YANG parsers: this document does not change the rules for presenting YANG models or for encoding YANG in data files or in the wire. Please note that it may take a couple of minutes from the time of submission until the htmlized version and diff are available at tools.ietf.org. The IETF Secretariat ___ netmod mailing list netmod@ietf.org https://www.ietf.org/mailman/listinfo/netmod
