Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.txt]
Eric Rescorla <ekr@rtfm.com> Tue, 29 June 2021 17:30 UTC
Return-Path: <ekr@rtfm.com>
X-Original-To: tools-discuss@ietfa.amsl.com
Delivered-To: tools-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 4D24A3A3B95 for <tools-discuss@ietfa.amsl.com>; Tue, 29 Jun 2021 10:30:15 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.896
X-Spam-Level:
X-Spam-Status: No, score=-1.896 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, HTML_MESSAGE=0.001, SPF_HELO_NONE=0.001, SPF_NONE=0.001, URIBL_BLOCKED=0.001] autolearn=ham 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 vpEr5k5OT522 for <tools-discuss@ietfa.amsl.com>; Tue, 29 Jun 2021 10:30:10 -0700 (PDT)
Received: from mail-io1-xd2e.google.com (mail-io1-xd2e.google.com [IPv6:2607:f8b0:4864:20::d2e]) (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 9E36F3A3B93 for <tools-discuss@ietf.org>; Tue, 29 Jun 2021 10:30:10 -0700 (PDT)
Received: by mail-io1-xd2e.google.com with SMTP id a6so27501055ioe.0 for <tools-discuss@ietf.org>; Tue, 29 Jun 2021 10:30:10 -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=K9i8XadREA2pG6IaHI/ZgclVexQ8W26hcL5o629giio=; b=gf5rTkjjcpVRAUX6/w53kTVNzXQy7mPO+ppVtB2yOfxJ3bevhE+tGXO02DpuAbvh6s FSoj6lrEKBF5+XXKa9e6+GCTVhY70UqHTnw+PXk0NNE/qo8WHR56D1uqQ5wARtUzP7cv zx0kVwJSti4BQzeF+Uvr2BkB2VV6jWBQbS4zTC0YLMhw71fqh/dlMJHUr2TOEaQJSFvC 4nAJOGP5zwTLS0UiSeJl9KDF7kT9542/NpbBm0/g+ACrjCGnjRxakHmhAX+qjGnUIN5B S5Bb1X16jHYhZ5mjtRqZexVgwPFYuf0CuI1QwVDFLLEXlUyjbvsgjNsJrtuldOH0zqms FinA==
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=K9i8XadREA2pG6IaHI/ZgclVexQ8W26hcL5o629giio=; b=ALbDH09ihDk1fPeDkJvkLYAeB1jwM5O2j2W1NZNz5bhhiuWlEA30ecLrHUAkI/iMXF M6PnBd0FbSooNJcTSGO8m9lM6X1y94s3/EYiRTJYKea7hA2iQOZf0YqAIaMosINhBmHF iUFK8xqAvUa099Lh3cbMRQpBrvEcxypwSQPhn/D8TrgeT24si+quOYFY+oHzHLIOGeVq 5fwnJWnz8+0hIdsW1Ai/qqF2MQbDIgKNx0YuySgALMGY+9IlHsyeHCaf61dk16pE+vyM 0LwkG3D46v8G7SC5qRKm3X/bOZZOzmgqEy1rEKQGcuIRTfNwIpAgaWXdCuoRhilnTqrx M7Gg==
X-Gm-Message-State: AOAM531x3Dr64REvUnz40MzTSXRrdJEk7bfPcYQAa8WfBB5Ki2WAixiQ p+0quO4xtUeVSR/auUwMe4DysrAOh+83/Ke2plg+/Q==
X-Google-Smtp-Source: ABdhPJy6DGjtkjEXuGLuuI1fgqXo5BYCwpm9fWfHlDMUuo2QInAr2OHzwFHFKNPIw9yAuCMKFB5/zum7zTj3sbAH2T0=
X-Received: by 2002:a05:6638:614:: with SMTP id g20mr5287369jar.135.1624987807453; Tue, 29 Jun 2021 10:30:07 -0700 (PDT)
MIME-Version: 1.0
References: <20210627013258.1D30F188447C@ary.qy> <691b91b6-86d7-2a3d-b9dc-8c19cc507db4@gmail.com> <584d34d6-5630-bbb7-35cc-9459dabc80f0@taugh.com> <82887902-90d0-3616-656b-fc39e4febd47@gmail.com> <70fee53d-28b9-874a-6988-6c1234ca149@taugh.com> <20210628193815.GL5057@faui48e.informatik.uni-erlangen.de> <ffd86c27-82a0-8c92-d270-ab1c770acb99@gmail.com> <CAHw9_iKTh6JBpgVnVh-c4YT1hvg1S7s12xo1dcz7AJ4XCG_ywg@mail.gmail.com>
In-Reply-To: <CAHw9_iKTh6JBpgVnVh-c4YT1hvg1S7s12xo1dcz7AJ4XCG_ywg@mail.gmail.com>
From: Eric Rescorla <ekr@rtfm.com>
Date: Tue, 29 Jun 2021 10:29:31 -0700
Message-ID: <CABcZeBOaW0Gx+5NZ0chcgfW1WZvmdyt+_3pn4-x8aJjcW4W6aw@mail.gmail.com>
To: Warren Kumari <warren@kumari.net>
Cc: Brian E Carpenter <brian.e.carpenter@gmail.com>, John R Levine <johnl@taugh.com>, Tools Discussion <tools-discuss@ietf.org>
Content-Type: multipart/alternative; boundary="000000000000072d6c05c5eaf59a"
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/eI-slEDsybEyfCmY4a4MzP0AtxI>
Subject: Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.txt]
X-BeenThere: tools-discuss@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF Tools Discussion <tools-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-discuss/>
List-Post: <mailto:tools-discuss@ietf.org>
List-Help: <mailto:tools-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 29 Jun 2021 17:30:15 -0000
On Tue, Jun 29, 2021 at 6:55 AM Warren Kumari <warren@kumari.net> wrote: > On Mon, Jun 28, 2021 at 5:48 PM Brian E Carpenter > <brian.e.carpenter@gmail.com> wrote: > > > 3. SVG. Hard work to use, but well worth it. > > Again, see #1. I believe that requiring that complex things be > explainable using ASCII art was a feature - if your protocol is > sufficiently complex that it cannot be easily explained using words > and ascii art, it's probably too complex. > I'm sure I'm going to regret this, but.... Obviously things *can* be explained using words and ASCII art. The question is whether it would be easier to explain with diagrams that were better looking. I -- as I imagine you have -- have read a number of books documenting network protocols and nearly universally they use high quality diagrams, not ASCII art. I would suggest that this is a strong indication that our format reduces clarity. There are a number of cases that are particularly burdensome - State machine diagrams - Math of any kind - Ladder/swimlane diagrams in which there is nontrivial amounts of stuff happening on each step People who make the kind of argument you are making -- a related one being that engineers should have to use slow computers or tiny displays in order to keep complexity down -- usually seem to have in mind that this will result in the output being better along some axis. Is that in fact your thesis? If so, so you have any evidence that forcing people to use ASCII art reduces output complexity? -Ekr > 4. Using tools that are currently maintained. > > Tools like the XML2RFC XMLMind plugin were working just fine with the > V2 format; every few years I'd release a new version when XMLMind > updated their major version, but it was literally just a version bump. > Same thing for my "copy the last RFC, change the title and words". #4 > sounds very much like "people weren't keeping the tools maintained the > way we liked, so we made a breaking change to force them to abandon > what they were doing, and use what we think is better. > > Anyway, I realize that this ship has sailed, and I'm doing a good > impression of "Old Man Yells at Cloud"... but someone asked why more > stuff wasn't being submitted in v3 format, and this is at least one > set of reasons why... > > W > > > > > I've had no trouble at all editing XML in v3. The only real > > annoyance is that the converter can't do anything sensible with > > <vspace blankLines="1"/> which I used to use a lot. Everything > > else is trivial. > > > > (The converter insists on inserting lots of format="default" > > and toc="default" which are just noise and can be deleted.) > > > > Regards > > Brian > > > > On 29-Jun-21 07:38, Toerless Eckert wrote: > > > I only converted the last rfc i was editor for during the final > revisions to go to rfc, > > > and i only did this so i could use the only one new feature of v3 that > i felt i wanted > > > to use, name the Contributors tag. I still don't know what else i as > an author > > > would benefit from in v3. > > > > > > I did find the conversion sufficient for that last mile to RFC editor, > but not persuasive to > > > suggest it to authors if/when they want to continue doing mayor edits > to the document. This > > > is primarily beceause the v3 ended up with a tag-verbose XMLv3 than > the v2 i had > > > edited for years. This specifically included inlining the rfc/draft > references as opposed > > > to keeping the references, but also several other tags that where > written out more verbosely > > > and with a lot of default parameters (unnecessarily). Hope i remember > this all correctly. > > > > > > This v2->v3 conversion process feels a bit like attempting to have a > good idea but then > > > outsource the conversion cost. Reminds me of linux. Great new > SDK/Library, but now all > > > the third-party apps developed against an older version have to be > rewritten. In comparison, > > > in Windows i can have 10 versions of the same core SDK co-installed > and all the old but > > > still useful programs will still run. But no linux distributions do > not support such slotting > > > or do not compile all old library versions, and library developers > don't care about supporting > > > multi-slotting... *sigh* > > > > > > Chers > > > Toerless > > > > > > On Sat, Jun 26, 2021 at 10:40:40PM -0400, John R Levine wrote: > > >>>> Among the many things on the to-do list is to redo the I-D > submission page > > >>>> to make it clearer that you only need to submit one version of a > draft, > > >>>> and that we'd appreciate the XML version if you have one. > > >>> > > >>> Excellent. Is there any reason not to run the v2 to v3 converter > automatically? > > >> > > >> We really want people to stop using v2. It's obsolete and missing > some > > >> semantic features of v3. > > >> > > >> Regards, > > >> John Levine, johnl@taugh.com, Taughannock Networks, Trumansburg NY > > >> Please consider the environment before reading this e-mail. > https://jl.ly > > >> > > >> ___________________________________________________________ > > >> Tools-discuss mailing list - Tools-discuss@ietf.org > > >> This list is for discussion, not for action requests or bug reports. > > >> * Report datatracker and mailarchive bugs to: > datatracker-project@ietf.org > > >> * Report tools.ietf.org bugs to: webmaster@tools.ietf.org > > >> * Report all other bugs or issues to: ietf-action@ietf.org > > >> List info (including how to Unsubscribe): > https://www.ietf.org/mailman/listinfo/tools-discuss > > > > > > > ___________________________________________________________ > > Tools-discuss mailing list - Tools-discuss@ietf.org > > This list is for discussion, not for action requests or bug reports. > > * Report datatracker and mailarchive bugs to: > datatracker-project@ietf.org > > * Report tools.ietf.org bugs to: webmaster@tools.ietf.org > > * Report all other bugs or issues to: ietf-action@ietf.org > > List info (including how to Unsubscribe): > https://www.ietf.org/mailman/listinfo/tools-discuss > > > > -- > The computing scientist’s main challenge is not to get confused by the > complexities of his own making. > -- E. W. Dijkstra > > ___________________________________________________________ > Tools-discuss mailing list - Tools-discuss@ietf.org > This list is for discussion, not for action requests or bug reports. > * Report datatracker and mailarchive bugs to: datatracker-project@ietf.org > * Report tools.ietf.org bugs to: webmaster@tools.ietf.org > * Report all other bugs or issues to: ietf-action@ietf.org > List info (including how to Unsubscribe): > https://www.ietf.org/mailman/listinfo/tools-discuss >
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… John R Levine
- [Tools-discuss] .txt? [I-D Action: draft-xxx.txt] Brian E Carpenter
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… John Levine
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Brian E Carpenter
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Brian E Carpenter
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… John R Levine
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Brian E Carpenter
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Carsten Bormann
- [Tools-discuss] Let's not be hostile to authors Carsten Bormann
- Re: [Tools-discuss] Let's not be hostile to autho… Julian Reschke
- Re: [Tools-discuss] Let's not be hostile to autho… Carsten Bormann
- Re: [Tools-discuss] Let's not be hostile to autho… Andrew G. Malis
- Re: [Tools-discuss] Let's have better tools John R Levine
- Re: [Tools-discuss] Let's have better tools Julian Reschke
- Re: [Tools-discuss] Let's have better tools Carsten Bormann
- Re: [Tools-discuss] Let's have better tools Andrew G. Malis
- Re: [Tools-discuss] Let's have better tools Michael Richardson
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Jay Daley
- Re: [Tools-discuss] Let's have better tools John Levine
- Re: [Tools-discuss] Let's have better tools Carsten Bormann
- Re: [Tools-discuss] Let's not be hostile to autho… Warren Kumari
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Toerless Eckert
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Brian E Carpenter
- Re: [Tools-discuss] Let's not be hostile to autho… Brian E Carpenter
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Toerless Eckert
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Julian Reschke
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Carsten Bormann
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Warren Kumari
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Julian Reschke
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Carsten Bormann
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… John R Levine
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Toerless Eckert
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Toerless Eckert
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Eric Rescorla
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Julian Reschke
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Carsten Bormann
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Brian E Carpenter
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Toerless Eckert
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Toerless Eckert
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Carsten Bormann
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… John Scudder
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Eric Rescorla
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Brian E Carpenter
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Brian E Carpenter
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Toerless Eckert
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Julian Reschke
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Carsten Bormann
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Julian Reschke
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Julian Reschke
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Carsten Bormann
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Julian Reschke
- Re: [Tools-discuss] .txt? [I-D Action: draft-xxx.… Carsten Bormann