RFCs in Translation
- Spanish: http://www.rfc-es.org
- French: http://abcdrfc.free.fr
- Japanese: JPNIC JP-RFC http://rfc-jp.nic.ad.jp/
Document Lifecycle (PDF)
Description: This tutorial offers an overview of producing documents in the IETF, from version 00 of an Internet-Draft to publication as an RFC. We will cover the working group process, and the required and suggested contents of an Internet-Draft, including information from IANA staff about writing IANA Considerations sections. We will walk through the lifecyle including authorship, WG draft, IETF Last Call, IESG evaluation, and what to expect during the RFC publication process. We will provide a set of helpful hints to authors about formatting rules and editorial policies that often improve the quality of the resulting documents. We will summarize the states of the RFC publication process and provide an opportunity to ask questions of RFC Editor staff.
Introduction to xml2rfc (PDF)
Description: xml2rfc is becoming increasingly popular as a way to produce Internet Drafts (and RFCs). This tutorial will introduce the markup language used in xml2rfc and describe a selection of the tools (both free and paid for) that can be used to create the marked up text and turn it into the finished document in normative ASCII, HTML for more elegant web usage or nroff as used for the RFC masters. The tutorial will start with a very brief introduction to XML markup for complete novices and will cover the usage of the ‘processing instructions’ that are available to control the appearance of the final document. The set of elements used in xml2rfc has been deliberately kept very small so that it is very easy to learn basic usage of the language. As a result there isn’t always an obvious way to achieve certain effects so a number of useful ‘tricks and tips’ will be covered that provide the ‘cliche’ needed as solutions to Frequently Asked Questions and highlight some of the pitfalls so that editors can avoid having to tear out their hair just before draft deadline time. Using xml2rfc relieves draft editors of the need to think about the overhead of getting the boilerplate and overall format right, and provides automated bibliographies that reduce the pain of generating references to existing drafts, RFCs and some other standard document series. The RFC Editor is increasingly using xml2rfc as a way to generate the source of the published RFC so that providing xml2rfc source can help reduce the turn-around time when a draft is being converted into an RFC.
RFCs and the RFC Editor (PDF)
Description: This class covers the basics required to understand the metadata related to an RFC (e.g., updates/obsoletes relationships, status changes, and errata). This session also describes the publication process and provides some tips for writing good RFCs.
Tools for Creating Internet-Drafts (PDF)
Description: This tutorial will cover various tools to produce an Internet-Draft. The focus will be on xml2rfc and NroffEdit; it will also cover ways (such as using markdown) to create an XML file for use with xml2rfc. For xml2rfc, the tutorial will include a brief introduction to XML for novices. Using xml2rfc relieves draft authors of the need to think about getting the boilerplate and overall format right, and provides citation libraries that reduce the pain of generating references to I-Ds, RFCs, and other document series. NroffEdit is a WYSIWYG nroff editor that comes with a template for quick creation of an Internet-Draft. We will cover the essential nroff commands and demo the tool.