Re: [Emo-dir] quick-start guides

On Tue, Feb 01, 2022 at 07:02:27PM +0100, Mirja Kuehlewind wrote:
> However, for the quick start guide for me the more important questions is what find people easier to use when they are starting as newcomers in the IETF for their very first (and in some cases even only) draft. For sure people likely don’t start by installing software on their device, so what they need is an actual template file, a (text) editor, and an online tool for conversion. 

I would add a reasonable simple number of local install options for xml2rfc and kramdown-rfc2629
to the list. In my experience user satisfaction and productivity goes up when not having to
use the web version of the tools. And xml2rfc and kramdown-rfc2629 are installable
with few lines of CLI on most systems.

Cheers
    Toerless
> 
> Mirja
> 
> 
> 
> > On 1. Feb 2022, at 18:56, Carsten Bormann <cabo@tzi.org> wrote:
> > 
> > On 2022-02-01, at 16:31, Salz, Rich <rsalz@akamai.com> wrote:
> >> 
> >> At the EMODIR call last week, Alice said that statistics show 90% is XML and under 10% is markdown, with a smattering of other things.
> > 
> > I don’t know about 90 % of what, but here’s my statistics of the last 300 days of I-D submissions:
> > 
> > $ find ~/std/id/ -name \*.xml -mtime -300 | wc
> >    3213    3213  189521
> > $ find ~/std/id/ -name \*.xml -mtime -300 | xargs grep -l kramdown | wc
> >     925     925   53698
> > 
> > More like: 29 % of the I-Ds submitted as XML show that they are kramdown-generated.
> > 
> > This simplistic method doesn’t see the drafts that are still being submitted as text (some of which are generated by kramdown-rfc, but then there is Word, nroff, …).  It also counts submissions (revisions), not distinct drafts.
> > But it is still a useful indicator (*).
> > 
> > Grüße, Carsten
> > 
> > (*) “The future is already here – it's just not evenly distributed.”
> > ― William Gibson
> > 
> > _______________________________________________
> > Emo-dir mailing list
> > Emo-dir@ietf.org
> > https://www.ietf.org/mailman/listinfo/emo-dir
> 
> _______________________________________________
> Emo-dir mailing list
> Emo-dir@ietf.org
> https://www.ietf.org/mailman/listinfo/emo-dir

-- 
---
tte@cs.fau.de