I-D Action: draft-wu-netmod-yang-xml-doc-conventions-04.txt
internet-drafts@ietf.org Mon, 11 June 2018 12:12 UTC
Return-Path: <internet-drafts@ietf.org>
X-Original-To: i-d-announce@ietf.org
Delivered-To: i-d-announce@ietfa.amsl.com
Received: from ietfa.amsl.com (localhost [IPv6:::1]) by ietfa.amsl.com (Postfix) with ESMTP id AA0E6130F91 for <i-d-announce@ietf.org>; Mon, 11 Jun 2018 05:12:02 -0700 (PDT)
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 8bit
From: internet-drafts@ietf.org
To: i-d-announce@ietf.org
Subject: I-D Action: draft-wu-netmod-yang-xml-doc-conventions-04.txt
X-Test-IDTracker: no
X-IETF-IDTracker: 6.81.2
Auto-Submitted: auto-generated
Precedence: bulk
Message-ID: <152871912264.2876.16809153302581284839@ietfa.amsl.com>
Date: Mon, 11 Jun 2018 05:12:02 -0700
Archived-At: <https://mailarchive.ietf.org/arch/msg/i-d-announce/M06clAJxpGkzE8rVkmyaA7XBS04>
X-BeenThere: i-d-announce@ietf.org
X-Mailman-Version: 2.1.26
List-Id: Internet Draft Announcements only <i-d-announce.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/i-d-announce>, <mailto:i-d-announce-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/i-d-announce/>
List-Post: <mailto:i-d-announce@ietf.org>
List-Help: <mailto:i-d-announce-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/i-d-announce>, <mailto:i-d-announce-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 11 Jun 2018 12:12:03 -0000
A New Internet-Draft is available from the on-line Internet-Drafts directories. Title : Documentation Conventions for lines wrapping and indentation in authored work Authors : Qin Wu Adrian Farrel Benoît Claise Filename : draft-wu-netmod-yang-xml-doc-conventions-04.txt Pages : 15 Date : 2018-06-11 Abstract: Many documents that define YANG modules or YANG fragments also include protocol message instance data examples. IETF documentation has specific limits on line length (73 characters) and some YANG fragment example or protocol message instance data examples such as XML encoded YANG data node instance 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 authored work to be presented in IETF documentation when authored work such as YANG fragment or protocol message instance data example would otherwise exceed the maximum line length and provide consistent representation of authored work within an Internet-Draft or RFC. There are no implications in this document for YANG tools: this document does not change the rules for presenting authored work in data files or in the wire. The IETF datatracker status page for this draft is: https://datatracker.ietf.org/doc/draft-wu-netmod-yang-xml-doc-conventions/ There are also htmlized versions available at: https://tools.ietf.org/html/draft-wu-netmod-yang-xml-doc-conventions-04 https://datatracker.ietf.org/doc/html/draft-wu-netmod-yang-xml-doc-conventions-04 A diff from the previous version is available at: https://www.ietf.org/rfcdiff?url2=draft-wu-netmod-yang-xml-doc-conventions-04 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. Internet-Drafts are also available by anonymous FTP at: ftp://ftp.ietf.org/internet-drafts/
- I-D Action: draft-wu-netmod-yang-xml-doc-conventi… internet-drafts