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

"Andrew G. Malis" <agmalis@gmail.com> Wed, 10 July 2019 15:24 UTC

Return-Path: <agmalis@gmail.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 69CE7120322 for <ietf@ietfa.amsl.com>; Wed, 10 Jul 2019 08:24:22 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -0.702
X-Spam-Level:
X-Spam-Status: No, score=-0.702 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, PDS_NO_HELO_DNS=1.295, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-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=gmail.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 IkjvrxB2mOHf for <ietf@ietfa.amsl.com>; Wed, 10 Jul 2019 08:24:20 -0700 (PDT)
Received: from mail-qt1-x82d.google.com (mail-qt1-x82d.google.com [IPv6:2607:f8b0:4864:20::82d]) (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 9769D120337 for <ietf@ietf.org>; Wed, 10 Jul 2019 08:24:20 -0700 (PDT)
Received: by mail-qt1-x82d.google.com with SMTP id h18so2827525qtm.9 for <ietf@ietf.org>; Wed, 10 Jul 2019 08:24:20 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=CeKSaeysCLAvrzSc+VY8O4bEsUkigDQLT0fNZ2Nbt/I=; b=qrO9jUnhOPdRPMDXiQn8Uj7HwyMDnNHZnFyeZrgzxHvHv6Nh9OzS3SygwbPOxl8+77 gLBZYS9BfcARPVJR08wb84531ed6BXUilt8Z30+vYnGhtPmixX1QmMin9bZVNTOjEOGr DqAKpy97jQaquVUhccm7Ge9kp1vxZAMOBzANx3E/unVym73I0LJYGne0IeFmUznmqJvM GvISfaM2o0rzlLihItxGbhjTSPWQhhr0VKtqtj6/Ca33AVzIwUkAOHiyXKKAdMvHR16Z 2IXWCYLXtizgONiwfzHoTCTkkYiE5S/5P6jJwuBqCHKpB5eMl5q/shwZr7Pffo5wQtwK DK1Q==
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=CeKSaeysCLAvrzSc+VY8O4bEsUkigDQLT0fNZ2Nbt/I=; b=j3sifkrG58DbDbqQWR5nyZ2CTXlMH/XaNgsKOQVKV+Iw+qJ9ecVKT2deU+B8v8Z6GE OLAUM7d1n6zp9RYEUSoTyiH5IRD8cBq/hG66G1Riny6ORWLS9OJG1VPfmvX4C/pnGtPA bJFSJgnKY7K1KqqMQN7aK2W5/MLzncfVNH4ywyVgYt+3tj+clvOy/WFjeX6q9+i9UDV2 G2W7eq12/ax0NApySWttI0wbQxyf0HhrXyRwsqSympzzvgD8hOZJvRwqBuN5iIvkxclX 8LOyCUtgsEiwYt3qYgy2eJv7bDlzxfogbfN43XmFIxVTsh22g8+VA0G8qgz7R8Im+RkZ iyGw==
X-Gm-Message-State: APjAAAUCCedPZ2gW+LmMTSnd/XF74eBgaIAB49/35a2nv151Xeqo2Wj/ 1uFFsIXFbVHS5SoyuM1Cr0ArpvvTjhQALCG6lug/I7XL
X-Google-Smtp-Source: APXvYqwroMJif8m+JlVMGrV9jwEnup0uM4BW8EcnkESg/QsB65Fq+J5zFUijsGHdNsuI42PTYRyOEWYEkwWVWhSQi5Q=
X-Received: by 2002:a0c:995b:: with SMTP id i27mr24969307qvd.159.1562772259644; Wed, 10 Jul 2019 08:24:19 -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> <CABcZeBMB+4xdfiqVX1o7BddPSaaszc4fx2-xgGQJAUKCPAQWew@mail.gmail.com>
In-Reply-To: <CABcZeBMB+4xdfiqVX1o7BddPSaaszc4fx2-xgGQJAUKCPAQWew@mail.gmail.com>
From: "Andrew G. Malis" <agmalis@gmail.com>
Date: Wed, 10 Jul 2019 11:24:08 -0400
Message-ID: <CAA=duU1BK-8b5fggMTEndEO4eTcHVc0d-9EXxuaBygFZoTtY1A@mail.gmail.com>
Subject: Re: Things that used to be clear (was Re: Evolving Documents (nee "Living Documents") side meeting at IETF105.)
To: Eric Rescorla <ekr@rtfm.com>
Cc: IETF Rinse Repeat <ietf@ietf.org>
Content-Type: multipart/alternative; boundary="00000000000066aabe058d5545af"
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf/YH336WyB1wn7na9CKeWfnQh6kec>
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 15:24:23 -0000

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

 Like Stewart says, learning Kramdown is very easy. And
https://xml2rfc.tools.ietf.org/experimental.html really simplifies the
toolchain as well - just use the topmost blue box to choose your input
file, and then select "kramdown" rather than "xm2rfc". This will directly
convert your Kramdown source to text, HTML, or PDF without an XML
intermediate step. You can have the result in a frame (for debugging your
file) or saved to a file.

Cheers,
Andy