Skip to content

A presentation (in Markdown) for the IETF Hub Boston on June 12, 2018.

Notifications You must be signed in to change notification settings

danyork/writing-internet-drafts-in-markdown

Repository files navigation

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:

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.

About

A presentation (in Markdown) for the IETF Hub Boston on June 12, 2018.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published