Re: [rfc-i] Evolving document sources over a long time (Re: Comments on draft-roach-bis-documents-00)

David Noveck <davenoveck@gmail.com> Mon, 13 May 2019 09:22 UTC

Return-Path: <davenoveck@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 4994B120119 for <ietf@ietfa.amsl.com>; Mon, 13 May 2019 02:22:40 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.999
X-Spam-Level:
X-Spam-Status: No, score=-1.999 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, RCVD_IN_DNSWL_NONE=-0.0001, SPF_PASS=-0.001] autolearn=ham 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 VvA_fw_oAL03 for <ietf@ietfa.amsl.com>; Mon, 13 May 2019 02:22:37 -0700 (PDT)
Received: from mail-oi1-x233.google.com (mail-oi1-x233.google.com [IPv6:2607:f8b0:4864:20::233]) (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 A61C51200FC for <ietf@ietf.org>; Mon, 13 May 2019 02:22:37 -0700 (PDT)
Received: by mail-oi1-x233.google.com with SMTP id a132so8799531oib.2 for <ietf@ietf.org>; Mon, 13 May 2019 02:22:37 -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=m4Wd24ET2l4OEVTEVzikGDkNSQkGe4VkC6ItH5oRRZA=; b=Zr6690b+flbXfR2T6GR0C+JWPxzBG0hiIZQs1oefK3mVzUBmoWZB/n/Q0cHiioQK6Q fLaMQP9XVtxX3sOBHeZOADWxB49/Zj3yB7eb//X+GiZY+43w6SbGWLVzActF6xipEZZy Jc3EZMbzR5sf3vnLdgPQT7GIrfedjFnoiP31fScCiTlDGLaBPU8Z7T2B8xzvNgp+0JW2 emZIEKKIh66Z/F4zIPw2Kpuz8/MxMSFewA11cAmGoSOItJjxXBcPVGTL2z6Fw+lclOgZ E6tuBTYachZf8C9kAtsATKL8g2fO9alsbbZ/7TyLWBptSWn6RqA4RqwTbEr9WNVUeMj4 AZOw==
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=m4Wd24ET2l4OEVTEVzikGDkNSQkGe4VkC6ItH5oRRZA=; b=lZ4g160CBRk+c4NcShxjQ9llzs4bIf+UD3U9ijccAaFf1enNyHuFoYcnPU2wmPlX07 aLXam4yya0P2IwvymL0Ii4A8Kqg3DQelaX4lJH/xPG8vV8Pb0zO5wqnI2/1D8IPOxBlB 6AFkYWx9p48pdAX6AOaSxXblgppvtIWOe1pJbO+UZvDTwQ47JmTJSwsl7loeJlU8o35m t8SsgF7jWu+rrOAEQEmIUuKw6ny0yQ6lQTnPF+NKokg+zVx5fOdi/cUeMri/iV3xIxKU JN3NsIzx8jLdWxlF0MYC6dKA94+gB8CohcQxKK+kv3lvu1cTomwm7b/jsYQ9nQtxXOaJ oByg==
X-Gm-Message-State: APjAAAX4ptGqq4jojkXnLnl1bqQScRDBShHYHlbquWDHSAz/c4gjwsGV F+8TyaUqymRWtn3qvoRjH2dE5lfF0+GFxFrA1G8=
X-Google-Smtp-Source: APXvYqxH2m6jL/Fk0ceCZwh8gzmelbxbxcQ8i25rsaKA5FTRnMD2fCSQ4BfghQB7E+HKanhyyfLdSwQ6HHGicFoChVc=
X-Received: by 2002:aca:aa8b:: with SMTP id t133mr5006958oie.101.1557739356628; Mon, 13 May 2019 02:22:36 -0700 (PDT)
MIME-Version: 1.0
References: <CADaq8jdRMUZAN3rRXoActXqvGpkgx_-kW67uwzGLtVPoh7LfAQ@mail.gmail.com> <6E787E2A-18F2-4EFE-BFBA-61B1B4300930@tzi.org> <CADaq8jc1KJwC=Ypoo9a+-=Me=GP5tgX=2kcfUd56o53Mcu05kw@mail.gmail.com> <9179590B-C513-44DC-906C-16534DA8EC51@tzi.org> <1852d84b-48cc-0129-3564-6ec9b92c4315@gmx.de> <8A7B4E94-DBCD-4EE3-8FEA-EA642F1071BF@tzi.org>
In-Reply-To: <8A7B4E94-DBCD-4EE3-8FEA-EA642F1071BF@tzi.org>
From: David Noveck <davenoveck@gmail.com>
Date: Mon, 13 May 2019 05:22:25 -0400
Message-ID: <CADaq8jeLwELxGM_zWG_OhiZ3nkm_F_a7A71B7aEv+xDdBmhYqg@mail.gmail.com>
Subject: Re: [rfc-i] Evolving document sources over a long time (Re: Comments on draft-roach-bis-documents-00)
To: Carsten Bormann <cabo@tzi.org>
Cc: Julian Reschke <julian.reschke@gmx.de>, RFC Interest <rfc-interest@rfc-editor.org>, IETF Discussion Mailing List <ietf@ietf.org>
Content-Type: multipart/alternative; boundary="000000000000012b110588c17593"
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf/gsb0GZofq23Tl9hlopihikfL4Ag>
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: Mon, 13 May 2019 09:22:40 -0000

>> For RFC5661 and documents derived from it using Adam’s procedure, that
ship has already sailed :-(.

> As the references section needs to be updated anyway (for the DOIs), I’m
not sure this is really true.  Or, if it is,
> RFC 5661 maybe isn’t really a candidate for this process, because it may
be impractical to re-generate the exact
> numbering that RFC 5661 used.

I had been assuming that you could turn off sortrefs and construct a
reference section in the exact order that the
v1 tool.   I'll try some experientsto validate that approach.

.> > > Since RFC 5661, we also got DOIs on RFCs, so it is inevitable there
are a lot of diffs.
>>
>> It is not inevitable as shown by the fact that I didn't run into that
issue.   It's kind of nice to know that there was an issue out there that I
didn't run into :-)
>>
>> For reasons I  really don't understand, the xml for rfc5661 does not
include rfc reference from external libraries.   It includes them inline,
so a new rfc derived from that xml  file will not include DOIs.

> Yes.  All these RFC references would be updated by the RFC editor into
current references.

That's not a problem for Adam's procedure :-).   The RFC candidate
considred by the IESG would still match
rfc5661.   Then, during RFC editing, the reference section could be revised
to include the DOI's.

>> That is not a problem for Adam's procedure, but it may be for the IESG
or the RFC editor.   I hope that, in processing RFC’s using Adam's
procedure, people will overlook the lack of DOIs in the same way that they
overlook other aspects of the document that would prevent a new document of
that form from being published.

>AFAICT, they can’t, as the RFC editor has committed to providing DOIs.

Please see above:

   - The IESG doesn't have to deal with the DOI diffs, since it won't see
   them.
   - The RFC editor would create DOI diffs but not be bound by Adam's
   procedure in doing so.

Where this might be a problem is in document where the existing xml uses
external reference libraries.   That avoids the need for the RFC to do
anything to provide the DOI's other that updating the libraries.   However
the IESG will see the diffs resulting from the inclusion of DOI's so I
would hope that Adam's document is clear thar they should not be considered
"spurous".


On Sun, May 12, 2019 at 12:57 PM Carsten Bormann <cabo@tzi.org> wrote:

> Hi Julian,
>
> > FWIW, I disagree (but I realize that I'm probably in a minority). The
> > problem with Markdown is that the simple things are easy, but everything
> > else gets messy. I'm looking forward to see how you kram (pun intended)
> > the V3 features into your tool…
>
> Do I have to?
>
> If an author wants to use a V3 feature that does not lend itself to
> authoring in markdown, they can always put the XML tags right into their
> markdown source.
>
> >>>> but that was the way things were done in 2010.
> >>>
> >>> I’m prepared to stick with that, unless there is something better
> about the alternatives.
> >>
> >> Right, for a minor update, digging out the v1 tools and finding a
> platform where they can still run may actually be the best way to proceed.
> >
> > All you need is a TCL processor. Works fine over here on a newly
> > installed notebook with Windows 10 and Cygwin.
>
> Haven’t tried that in a while…
> Works for me, too (macOS 10.13.6, on a small document, with the usual
> formatting differences from v2…).
> Good to know.
> (Although I have heard people have had problems on other platforms
> recently.)
>
> Grüße, Carsten
>
>