Re: [netmod] New Version Notification for draft-wu-netmod-yang-xml-doc-conventions-02.txt
Qin Wu <bill.wu@huawei.com> Thu, 31 May 2018 03:06 UTC
Return-Path: <bill.wu@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 8E0AF12ECC9 for <netmod@ietfa.amsl.com>; Wed, 30 May 2018 20:06:17 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.2
X-Spam-Level:
X-Spam-Status: No, score=-4.2 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3, SPF_PASS=-0.001, URIBL_BLOCKED=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 5mlB8U4KmMPv for <netmod@ietfa.amsl.com>; Wed, 30 May 2018 20:06:15 -0700 (PDT)
Received: from huawei.com (lhrrgout.huawei.com [194.213.3.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 2D30612FB30 for <netmod@ietf.org>; Wed, 30 May 2018 20:06:15 -0700 (PDT)
Received: from lhreml709-cah.china.huawei.com (unknown [172.18.7.107]) by Forcepoint Email with ESMTP id B0299634C1C71 for <netmod@ietf.org>; Thu, 31 May 2018 04:06:09 +0100 (IST)
Received: from NKGEML414-HUB.china.huawei.com (10.98.56.75) by lhreml709-cah.china.huawei.com (10.201.108.32) with Microsoft SMTP Server (TLS) id 14.3.382.0; Thu, 31 May 2018 04:06:11 +0100
Received: from NKGEML513-MBX.china.huawei.com ([169.254.1.193]) by nkgeml414-hub.china.huawei.com ([10.98.56.75]) with mapi id 14.03.0382.000; Thu, 31 May 2018 11:06:08 +0800
From: Qin Wu <bill.wu@huawei.com>
To: "netmod@ietf.org" <netmod@ietf.org>
Thread-Topic: New Version Notification for draft-wu-netmod-yang-xml-doc-conventions-02.txt
Thread-Index: AQHT+IsvCh1MgROGGUa2L2pDTrPwfaRJJVjw
Date: Thu, 31 May 2018 03:06:07 +0000
Message-ID: <B8F9A780D330094D99AF023C5877DABA9AE94157@nkgeml513-mbx.china.huawei.com>
Accept-Language: zh-CN, en-US
Content-Language: zh-CN
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
x-originating-ip: [10.138.33.244]
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
MIME-Version: 1.0
X-CFilter-Loop: Reflected
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/NrAl-bYYMIPHkgQk99KW-DW3zG0>
Subject: Re: [netmod] New Version Notification for draft-wu-netmod-yang-xml-doc-conventions-02.txt
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: Thu, 31 May 2018 03:06:18 -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 -----邮件原件----- 发件人: internet-drafts@ietf.org [mailto:internet-drafts@ietf.org] 发送时间: 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