Subject: use of kramdown for RFCs experiment (was use of Git-hub)

From: "HANSEN, TONY L" <[email-masked]>
Date: Tue, 1 Nov 2016 00:40:13 +0000

Tl;dr: kramdown is supported experimentally on xml2rfc.tools.ietf.org

For a while now, we’ve had an experimental page up at xml2rfc.tools.ietf.org/experimental.html that includes a new kramdown option to generate internet drafts. On it, you can upload a kramdown markdown file to the server, it will convert to xml as an intermediate stage, then convert to the internet draft. It uses Carsten Borman’s kramdown-rfc2629 tools to do its work. There’s a separate web form that just runs kramdown and returns the XML.

It’s currently using kramdown-rfc2629 version 1.0.37 – I didn’t think it would be wise to upgrade to the newly-released 1.0.38 on RFC drop dead day.

Feedback is welcome.

                Tony Hansen

From: WGChairs <[email-masked]> on behalf of Kyle Rose <[email-masked]>
Date: Monday, October 31, 2016 at 3:56 PM
To: Lee Howard <[email-masked]>
Cc: Michael Richardson <[email-masked]>, WG Chairs <[email-masked]>
Subject: Re: use of Git-hub

On Mon, Oct 31, 2016 at 3:39 PM, Lee Howard <[email-masked]<mailto:[email-masked]>> wrote:

The rational for using github is that it's a tool that newcomers already know.

Strongly agreed. Github and markdown are at worst no barrier to participation, and at best (and likely) encourage it.

Interesting assumption.  As a network engineer, I have never used either.

Have you used XML? :-)  Markdown is much easier to read and write, even if you know XML.