[rfc-i] [Ietf-and-github] RFC Editor & Github

Tom Pusateri pusateri at bangj.com
Thu Feb 21 14:15:27 PST 2019



> On Feb 21, 2019, at 12:08 PM, Carsten Bormann <cabo at tzi.org> wrote:
> 
> On Feb 21, 2019, at 22:54, Tom Pusateri <pusateri at bangj.com> wrote:
>> 
>> The markdown to XML source change is a separate unfortunate problem for which I don’t have a solution.
> 
> That is indeed an interesting issue.
> 
> One would hope that the AUTH48 work is limited, so this is not a big problem (it has not been in the 8+ years I have been using kramdown-rfc now).
> 
> One mode of usage of kramdown-rfc2629 is that small snippets can be entered in markdown and translated to RFCXML by the tool.  That of course requires some basic proficiency in an XML editor to call an external tool.  (As in !}kramdown-rfc2629 in vim, IIRC.)
> (I have even used that for collaborating on documents authored in RFCXML, but I simply don’t do that any more.)
> 
> One other useful tool here can be an upconverter, but that requires some of the markdown formatting to survive the XML editing if it is not to cause massive deltas in the source code revision control.  (I have an upconverter, but haven’t found the time or need to make that foolproof.)
> 
>> I realize we can’t expect the RFC Editor to support any XML pre-processor that comes along. It makes me want to only use the same format that is supported by the RFC Editor instead of using various pre-processor tools.
> 
> I think that the advantages of using markdown in the creation and gestation phase outweigh some small discontinuity in the AUTH48 phase.  If AUTH48 becomes massive, maybe you are doing it wrong :-)
> 
> Grüße, Carsten
> 

The RFC Editor team is really good at their job and they seem to find things that no one else does, mostly with consistency. So the bigger the document, the more they seem to find.

The job of writing a technical document and editing one are quite different and the skill sets are also quite different so we both need each other. :)

Tom


More information about the rfc-interest mailing list