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

Qin Wu <bill.wu@huawei.com> Sat, 27 January 2018 04:00 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 0E79612D869 for <netmod@ietfa.amsl.com>; Fri, 26 Jan 2018 20:00:38 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.23
X-Spam-Level:
X-Spam-Status: No, score=-4.23 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_PASS=-0.001, T_RP_MATCHES_RCVD=-0.01, 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 80KAWMYYGgOX for <netmod@ietfa.amsl.com>; Fri, 26 Jan 2018 20:00:36 -0800 (PST)
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 D04151205D3 for <netmod@ietf.org>; Fri, 26 Jan 2018 20:00:35 -0800 (PST)
Received: from LHREML711-CAH.china.huawei.com (unknown [172.18.7.108]) by Forcepoint Email with ESMTP id C72ECBD318327 for <netmod@ietf.org>; Sat, 27 Jan 2018 04:00:31 +0000 (GMT)
Received: from NKGEML411-HUB.china.huawei.com (10.98.56.70) by LHREML711-CAH.china.huawei.com (10.201.108.34) with Microsoft SMTP Server (TLS) id 14.3.361.1; Sat, 27 Jan 2018 04:00:33 +0000
Received: from NKGEML513-MBS.china.huawei.com ([169.254.2.231]) by nkgeml411-hub.china.huawei.com ([10.98.56.70]) with mapi id 14.03.0361.001; Sat, 27 Jan 2018 12:00:25 +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-00.txt
Thread-Index: AQHTlyLTkpEv2GctDkKFlZNYmf1woKOHF23g
Date: Sat, 27 Jan 2018 04:00:24 +0000
Message-ID: <B8F9A780D330094D99AF023C5877DABA9AD45107@nkgeml513-mbs.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.136.79.67]
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/9IAKeMYeI7-q3E5_HqwKa8sJgUs>
Subject: Re: [netmod] New Version Notification for draft-wu-netmod-yang-xml-doc-conventions-00.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: Sat, 27 Jan 2018 04:00:38 -0000

Hi, Folks:
We have just posted a new v-(00) draft to discuss Documentation Conventions for Expressing YANG in XML.
You comments are welcome!

-Qin
-----邮件原件-----
发件人: internet-drafts@ietf.org [mailto:internet-drafts@ietf.org] 
发送时间: 2018年1月27日 11:56
收件人: Benoit Claise; Qin Wu; Adrian Farrel; Benoît Claise
主题: New Version Notification for draft-wu-netmod-yang-xml-doc-conventions-00.txt


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

Name:		draft-wu-netmod-yang-xml-doc-conventions
Revision:	00
Title:		Documentation Conventions for Expressing YANG in XML
Document date:	2018-01-26
Group:		Individual Submission
Pages:		9
URL:            https://www.ietf.org/internet-drafts/draft-wu-netmod-yang-xml-doc-conventions-00.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-00
Htmlized:       https://datatracker.ietf.org/doc/html/draft-wu-netmod-yang-xml-doc-conventions-00


Abstract:
   Many documents that define YANG modules also include examples
   presented in XML.

   IETF documentation has specific limits on line length and some XML
   examples have to include line wraps that would not normally be
   allowed according to the XML representation rules of RFC7950 and
   RFC7952.

   This document lays out documentation conventions that allow YANG
   examples to be presented in IETF documentation when leaf node
   encoding would otherwise exceed the maximum line length.  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