Subject: Re: [netmod] New Version Notification for draft-wu-netmod-yang-xml-doc-conventions-02.txt

From: Qin Wu <[email-masked]>
Date: Thu, 31 May 2018 03:06:07 +0000

Thanks Juergen's comments on draft-wu-netmod-yang-xml-doc-conventions 
The v-(02) has been posted to address his comments
In v-(02), 
a. The title is changed into "Documentation Conventions for Expressing 
b. XML and JSON encoded YANG Data Node Instance"
c. The terminologies are added to section 2, two new terms are introduced based on Juergen's suggestion.
d. The section 8 has been clarified with some additional text and terms defined.
The diff is:
https://www.ietf.org/rfcdiff?url2=draft-wu-netmod-yang-xml-doc-conventions-02

-Qin
-----邮件原件-----
发件人: [email-masked] [mailto:[email-masked]] 
发送时间: 2018年5月31日 10:58
收件人: Benoit Claise; Qin Wu; Adrian Farrel; Benoît Claise
主题: New Version Notification for draft-wu-netmod-yang-xml-doc-conventions-02.txt

A new version of I-D, draft-wu-netmod-yang-xml-doc-conventions-02.txt
has been successfully submitted by Qin Wu and posted to the IETF repository.

Name:		draft-wu-netmod-yang-xml-doc-conventions
Revision:	02
Title:		Documentation Conventions for Expressing XML and JSON encoded YANG Data Node Instance
Document date:	2018-05-30
Group:		Individual Submission
Pages:		11
URL:            https://www.ietf.org/internet-drafts/draft-wu-netmod-yang-xml-doc-conventions-02.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-02
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-02

Abstract:
   Many documents that define YANG modules also include YANG data node
   Instance examples presented in XML/JSON.

   IETF documentation has specific limits on line length and some YANG
   data node Instance 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