[TOOLS-DEVELOPMENT] Fwd: RFC format evolution and IETF documents

Russ Housley <housley@vigilsec.com> Wed, 27 January 2016 15:36 UTC

Return-Path: <housley@vigilsec.com>
X-Original-To: tools-development@ietfa.amsl.com
Delivered-To: tools-development@ietfa.amsl.com
Received: from localhost (ietfa.amsl.com [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 9FED51ACE40; Wed, 27 Jan 2016 07:36:07 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -101.9
X-Spam-Level:
X-Spam-Status: No, score=-101.9 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, USER_IN_WHITELIST=-100] autolearn=ham
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 rBSC-LZw23Yv; Wed, 27 Jan 2016 07:36:05 -0800 (PST)
Received: from odin.smetech.net (x-bolt-wan.smeinc.net [209.135.219.146]) by ietfa.amsl.com (Postfix) with ESMTP id 5E6141ACE61; Wed, 27 Jan 2016 07:36:00 -0800 (PST)
Received: from localhost (unknown [209.135.209.5]) by odin.smetech.net (Postfix) with ESMTP id E3BC89A40A8; Wed, 27 Jan 2016 10:35:58 -0500 (EST)
X-Virus-Scanned: amavisd-new at smetech.net
Received: from odin.smetech.net ([209.135.209.4]) by localhost (ronin.smeinc.net [209.135.209.5]) (amavisd-new, port 10024) with ESMTP id 0UYO+XScZO7Z; Wed, 27 Jan 2016 10:34:50 -0500 (EST)
Received: from [192.168.2.104] (pool-108-51-128-219.washdc.fios.verizon.net [108.51.128.219]) (using TLSv1 with cipher AES128-SHA (128/128 bits)) (No client certificate requested) by odin.smetech.net (Postfix) with ESMTP id 3632E9A4049; Wed, 27 Jan 2016 10:35:58 -0500 (EST)
Content-Type: text/plain; charset="windows-1252"
Mime-Version: 1.0 (Apple Message framework v1085)
From: Russ Housley <housley@vigilsec.com>
Date: Wed, 27 Jan 2016 10:35:57 -0500
Content-Transfer-Encoding: quoted-printable
Message-Id: <D0199D65-7301-4E1E-B796-6CA7EE7A3FFE@vigilsec.com>
References: <83EF08BD-EC5C-419E-88F2-2AB1EB625296@ietf.org>
To: IAOC <iaoc@ietf.org>
X-Mailer: Apple Mail (2.1085)
Archived-At: <http://mailarchive.ietf.org/arch/msg/tools-development/pmlZIhqRtMeY3a2ksBTDZxJNTmI>
Cc: IETF Tools Development <tools-development@ietf.org>
Subject: [TOOLS-DEVELOPMENT] Fwd: RFC format evolution and IETF documents
X-BeenThere: tools-development@ietf.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: Tools Development list server <tools-development.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-development>, <mailto:tools-development-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-development/>
List-Post: <mailto:tools-development@ietf.org>
List-Help: <mailto:tools-development-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-development>, <mailto:tools-development-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 27 Jan 2016 15:36:07 -0000

Just in case you do not read the ietf-announce mail list ...


> From: IETF Chair <chair@ietf.org>
> Date: January 27, 2016 10:31:43 AM EST
> To: IETF Announcement List <ietf-announce@ietf.org>
> Cc: "Heather Flanagan \(RFC Series Editor\)" <rse@rfc-editor.org>, IETF <ietf@ietf.org>
> Subject: RFC format evolution and IETF documents
> Reply-To: IETF <ietf@ietf.org>, "Heather Flanagan \(RFC Series Editor\)" <rse@rfc-editor.org>
> 
> 
> For background, the RFC Editor and the IAB have been
> working on the evolution  of the RFC format. The IAB
> will be sending a number of documents soon out
> for review. At the same time, the tools team have
> been working on what the new format requires
> from the tools. Both the documents and the tools
> requirements are available from the reading list
> below.
> 
> The IESG has discussed what this all means for
> the IETF documents. The evolution is important
> for the IETF as well, and we look forward to
> being able to use possibilities in the new format.
> 
> The IESG wanted to offer five points:
> 
> 1. Please review the documents and send
> feedback to the rfc-interest list at
> https://www.rfc-editor.org/mailman/listinfo/rfc-interest
> or the authors.
> 
> 2. We would like to see the new format be
> available as the base format for Internet
> Drafts as well, supported by the relevant
> tools, and usable by each of the RFC
> streams as needed. Each stream may
> of course have a policy on what content or
> format features they prefer.
> 
> 3. We expect the RFC Editor, the IAB, and
> the tools team (incl. IAOC support) to make
> the above possible.
> 
> 4. From an IETF stream perspective, we are
> in eager waiting mode. Once the format
> definitions and tools are in place, we
> will (among others) want to try the
> new possibilities in IETF stream
> documents. From a careful engineering
> stand point we would like to start
> small, and gather experience on
> using the new format and tools. There
> will be implications on how we review
> documents, for instance.
> 
> 5. Existing I-D submission using text
> only will likely stay on for a long time
> if not indefinitely, so old methods can
> also be used as needed or desired.
> 
> Comments appreciated, as always.
> 
> Jari Arkko for the IESG
> 
> Reading list:
> 
> 1. The big picture
> 
> - - Flanagan, H., "RFC Format Framework",
>   http://datatracker.ietf.org/doc/draft-iab-rfc-framework/
> 
> 2. The underlying vocabulary
> 
> - - Hoffman, P., "The 'XML2RFC' version 3 Vocabulary",
>    https://datatracker.ietf.org/doc/draft-iab-xml2rfc/
> 
> 3. The outputs
> 
> - - Hildebrand, J. and P. Hoffman, "HyperText Markup
>   Language Request For Comments Format”,
>   https://datatracker.ietf.org/doc/draft-iab-html-rfc/
> 
> - - Flanagan, H., "Requirements for Plain Text RFCs”,
>    https://datatracker.ietf.org/doc/draft-iab-rfc-plaintext/
> 
> - - Hansen, T., Masinter, L., and M. Hardy, "PDF for
>   an RFC Series Output Document Format”,
>   https://datatracker.ietf.org/doc/draft-hansen-rfc-use-of-pdf/
>   Note that the filename may change to an IAB document soon.
> 
> - - Brownlee, N., "SVG Drawings for RFCs: SVG 1.2 RFC",
>   https://datatracker.ietf.org/doc/draft-iab-svg-rfc/
> 
> 4. Generalized requirements
> 
> - - Flanagan, H., "The Use of Non-ASCII Characters in RFCs",
>   https://www.ietf.org/id/draft-iab-rfc-nonascii-00.pdf
> 
> - - Flanagan, H., “CSS Requirements for RFCs”,
>   https://datatracker.ietf.org/doc/draft-iab-rfc-css/
> 
> 5. Workflow and tools (note that the examples draft will
>   not become an RFC, but is necessary for the project)
> 
> - - Hildebrand, J. and P. Hoffman, "RFC v3 Prep Tool Description",
>   https://datatracker.ietf.org/doc/draft-iab-rfcv3-preptool/
> 
> - - Hoffman, P. and T. Hansen, "Examples of the ‘XML2RFC'
>   Version 2 and 3 Vocabularies”,
>   http://datatracker.ietf.org/doc/draft-hoffman-rfcexamples/
> 
> 6. The Statements of Work
> 
> - - http://www.nostrum.com/~rjsparks/rfced/