IETF Logo Mail Archive

Re: Things that used to be clear (was Re: Evolving Documents (nee "Living Documents") side meeting at IETF105.)

Eric Rescorla <ekr@rtfm.com> Wed, 10 July 2019 14:09 UTC

Return-Path: <ekr@rtfm.com>
X-Original-To: ietf@ietfa.amsl.com
Delivered-To: ietf@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id AFFE91200A1 for <ietf@ietfa.amsl.com>; Wed, 10 Jul 2019 07:09:54 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -0.601
X-Spam-Level:
X-Spam-Status: No, score=-0.601 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, HTML_MESSAGE=0.001, PDS_NO_HELO_DNS=1.295, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_NONE=0.001, URIBL_BLOCKED=0.001] autolearn=no autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=rtfm-com.20150623.gappssmtp.com
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id h-wpvFX9csKZ for <ietf@ietfa.amsl.com>; Wed, 10 Jul 2019 07:09:52 -0700 (PDT)
Received: from mail-lf1-x130.google.com (mail-lf1-x130.google.com [IPv6:2a00:1450:4864:20::130]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 840D8120044 for <ietf@ietf.org>; Wed, 10 Jul 2019 07:09:52 -0700 (PDT)
Received: by mail-lf1-x130.google.com with SMTP id r15so1680190lfm.11 for <ietf@ietf.org>; Wed, 10 Jul 2019 07:09:52 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rtfm-com.20150623.gappssmtp.com; s=20150623; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=41Hj+wqQnKwbDfTshssdo7jAbo86SLy4C6ozEHUTnbg=; b=RWpVXi9N9nSaQ+rhSo1DVIfLnsB7+hFlX/huqhTwPYgOfWvWuBROoC5BRh0jeiUHN0 yt5smaIKnbup1H2COOEnccy6ux3ymZKGBv33ymdhdC/SG9OfOYn2CeTyWHICagEI1/pc 6E/jFHF89pfr4xwxfkGMoAacWSWaLA7+92TV+VegAvdgvvqiOP9eStJoa5R2d8APIv9D 3/ZrgIrVDMlVTtyJ/oD5+O3T6JehmZ8rbBp2iGAx/Yy8QPImMc+RnUBWrT2gBOpIg074 uHJ4lS4FkYDnao2dgdRJ0NIgNUdn2/W2SzNnGdMv95UxXGzgKOTTBNcCOLBK2VbpuN2e AFBA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=41Hj+wqQnKwbDfTshssdo7jAbo86SLy4C6ozEHUTnbg=; b=F+wXjNZ7WnUSzHx5CWLZVhG/zmHlwJGb8/fQYOWeAJZZSQlbBYnMiZ5zzP1tAC6owv pPqf3HGOpKVdxVJjbSFwmPNx8ROxRaduuCCT3bKE3wc+klhsDqfI44G0F0jJCqlzwxWA cYtm7H5OhIBbnVgyMGu6gn0UTHE6UM+AKmB4PHgVZbJIMBNmkFci8huKjn3cY0AQIi0w 5nenFWa3/7VPRXcG8WouqPE8tkaXzjvFj+tNV7M6SoYpr7A1ivUvQqTnEgYdWTSU7fU3 jc8+mXrKQ8hIumCkm3oD15syTfdy8tHw7oV3BxehEh3QGxwCQx09fCUFefa6DXPsvp/I IRoQ==
X-Gm-Message-State: APjAAAXCWjdx2CW9AwcPPr7mpDBNB7evJ2HH3U+idwCXrtW4AyFX73+B jX2TcqA/V5GGDfeNudroTbeF3ohv1CQ9ebqv9O/A2g==
X-Google-Smtp-Source: APXvYqzj6Rr48ptfrJjt6GqUxuSts2ELihKZXmcBXBxnuBi/YsgUOHNyYTWC2ktcBMIAemlSLik5qDV3BQ8KE2+t7Aw=
X-Received: by 2002:ac2:4202:: with SMTP id y2mr5246368lfh.178.1562767790648; Wed, 10 Jul 2019 07:09:50 -0700 (PDT)
MIME-Version: 1.0
References: <20190704140552.GE49950@hanna.meerval.net> <b0943792-1afc-0c94-51b7-f2d393ef39c5@network-heretics.com> <20190705205723.GI55957@shrubbery.net> <20190706185415.GB14026@mit.edu> <CABcZeBPgNr5UqQ0pLwwNu5wh0g9L9wCd6YyYKCUDO37SPru-_Q@mail.gmail.com> <20190708202612.GG60909@shrubbery.net> <9ae14ad1-f8d5-befb-64e4-fff063c88e02@network-heretics.com> <CABcZeBOH9LH8Jrz-A5eu9arqUb+bx8xs_eKWi0pyoh7a3qpOPA@mail.gmail.com> <20190708223350.GO3508@localhost> <af3b25d6-af16-a96a-c149-61d01afb4d01@network-heretics.com> <20190708233438.GP3508@localhost> <ea0b9894-ae9d-55a9-a082-af7aac5be66a@huitema.net> <944332dc-bb2a-0717-8b9f-254b036fe59f@gmx.de> <m2pnmingsi.wl-randy@psg.com> <CAL02cgTBL7w02sWx4kaqGLQe8bGm4jRMyMY9v7yJw57_Sp=PgA@mail.gmail.com>
In-Reply-To: <CAL02cgTBL7w02sWx4kaqGLQe8bGm4jRMyMY9v7yJw57_Sp=PgA@mail.gmail.com>
From: Eric Rescorla <ekr@rtfm.com>
Date: Wed, 10 Jul 2019 07:09:12 -0700
Message-ID: <CABcZeBMB+4xdfiqVX1o7BddPSaaszc4fx2-xgGQJAUKCPAQWew@mail.gmail.com>
Subject: Re: Things that used to be clear (was Re: Evolving Documents (nee "Living Documents") side meeting at IETF105.)
To: Richard Barnes <rlb@ipv.sx>
Cc: Randy Bush <randy@psg.com>, Julian Reschke <julian.reschke@gmx.de>, IETF Rinse Repeat <ietf@ietf.org>
Content-Type: multipart/alternative; boundary="00000000000007472c058d543b76"
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf/uCL04mtdlTz8d8DSPRpC7wrtihw>
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF-Discussion <ietf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ietf>, <mailto:ietf-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/ietf/>
List-Post: <mailto:ietf@ietf.org>
List-Help: <mailto:ietf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 10 Jul 2019 14:09:55 -0000

On Wed, Jul 10, 2019 at 6:57 AM Richard Barnes <rlb@ipv.sx> wrote:

> I'm glad it works for you.  The non-IETF-habituated new authors I've
> worked with have found it mystifying.  Including everyone from junior
> engineers to Fellows of major engineering organizations.
>

Indeed. And even a large number of habituated authors have gravitated
towards markdown, despite the rather klunky workflow of MD -> XML -> TXT.

-Ekr


> As Christian says, our continued attachment to bespoke tools is a barrier
> to getting new work in the IETF, and thus detrimental to the long-term
> health of the organization.
>
> --RLB
>
>
> On Wed, Jul 10, 2019 at 9:47 AM Randy Bush <randy@psg.com> wrote:
>
>> >> Tooling is just one of the problems with XML2RFC. The real issue is
>> >> that XML2RFC is completely specific to the IETF. This translate into
>> >> training ...
>> > It also has been optimized for the production of RFCs. Also note that
>> > many changes in the v3 vocab just align the language with HTML (lists
>> > and tables come to mind).
>>
>> from an xml non-lover:
>>
>> xml2rfc rocks!  it produces the baroqe, designed by committee, internet
>> draft format from input which i can easily produce in my text editor.
>>
>> and the support, maintenance, and responsiveness of the tools team is
>> simply stunning.
>>
>> [ and for the poster who wished for a gooey, there is one ]
>>
>> thank you!
>>
>> randy
>>
>>

v2.23.0 | Report a Bug | By Email