stefanosalsano / writing-internet-drafts-in-markdown Goto Github PK

This repo contains information about creating Internet Drafts in Markdown.

Internet Drafts are the starting point for the standards process within the Internet Engineering Task Force (IETF). Also referred to as "drafts" or "IDs", anyone can create an Internet Draft and submit it through the IETF datatracker.

Internet Drafts can be created using a variety of tools and templates. The primary mechanism for the past while has been to use XML and the xml2rfc tool) (also available online).

In recent years, new tools have emerged allowing the creation of Internet Drafts using variations of Markdown syntax. Multiple tools are available, but two of the more prominent are:

• kramdown-rfc by Carsten Bormann
• mmark by Miek Gieben

This repo includes:

• Slides from a presentation I gave on June 12, 2018, at the "IETF Hub Boston" meeting in Cambridge, MA. (The slides themselves are in Markdown).
• Slides from a tutorial on March 24, 2019, at IETF 104 in Prague.
• Examples of markdown files for both the kramdown and mmark tools.

Additional examples and information about getting started with Internet Drafts can be found in Martin Thomson's i-d-template repo.