Re: [rfc-i] archiving outlinks in RFCs

Alexis Rossi <rsce@rfc-editor.org> Mon, 01 May 2023 19:27 UTC

Return-Path: <rsce@rfc-editor.org>
X-Original-To: rfc-interest@ietfa.amsl.com
Delivered-To: rfc-interest@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 67C0FC151993 for <rfc-interest@ietfa.amsl.com>; Mon, 1 May 2023 12:27:53 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.9
X-Spam-Level:
X-Spam-Status: No, score=-1.9 tagged_above=-999 required=5 tests=[BAYES_00=-1.9] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id LCb_Rt6mNWpd; Mon, 1 May 2023 12:27:53 -0700 (PDT)
Received: from smtpclient.apple (157-131-78-231.fiber.dynamic.sonic.net [157.131.78.231]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPSA id EDF8EC151520; Mon, 1 May 2023 12:27:52 -0700 (PDT)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3696.120.41.1.3\))
From: Alexis Rossi <rsce@rfc-editor.org>
In-Reply-To: <6c648d38-7bcb-a7b7-e2ce-44d17488160c@gmail.com>
Date: Mon, 01 May 2023 12:27:51 -0700
Cc: Michael Richardson <mcr+ietf@sandelman.ca>, rfc-interest@rfc-editor.org
Content-Transfer-Encoding: quoted-printable
Message-Id: <74214E25-F9B0-4D1E-B124-579A3A102375@rfc-editor.org>
References: <E024D9AC-2B92-4720-9713-519592D2362B@rfc-editor.org> <30c30c2f-4e96-560a-73dd-a51ba8d04714@comcast.net> <771B7586-FFBB-49E4-9B99-5578863FBD8B@rfc-editor.org> <CABcZeBOevOj8cWY7dacWxzwZS82+iAjf1p+DZWF=7WZ9JydnrQ@mail.gmail.com> <48de4d92-e279-4c26-ab3c-15dd854b56f8@betaapp.fastmail.com> <CABcZeBPqePQwPAq5pWda1pGaY_=kLkcOxCjZWmOv9yRZ_MNb7g@mail.gmail.com> <CA+9kkMBVMTG7Zku4gt_DwCNWArYTauR_O0u70zceCMtN2GNN_Q@mail.gmail.com> <796.1682529129@localhost> <CA+9kkMBiqZCqbDviOVQFmjROYJtViz=S7ZsW6T41mv4XGbZ3=g@mail.gmail.com> <04BE48FA-322D-457A-9D7B-A9DA8FCE8E50@rfc-editor.org> <31200.1682702389@localhost> <6c648d38-7bcb-a7b7-e2ce-44d17488160c@gmail.com>
To: Brian E Carpenter <brian.e.carpenter@gmail.com>
X-Mailer: Apple Mail (2.3696.120.41.1.3)
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-interest/i0O5pl6OzvNh-ew7eTjzARueiz8>
Subject: Re: [rfc-i] archiving outlinks in RFCs
X-BeenThere: rfc-interest@rfc-editor.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: "A list for discussion of the RFC series and RFC Editor functions." <rfc-interest.rfc-editor.org>
List-Unsubscribe: <https://mailman.rfc-editor.org/mailman/options/rfc-interest>, <mailto:rfc-interest-request@rfc-editor.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/rfc-interest/>
List-Post: <mailto:rfc-interest@rfc-editor.org>
List-Help: <mailto:rfc-interest-request@rfc-editor.org?subject=help>
List-Subscribe: <https://mailman.rfc-editor.org/mailman/listinfo/rfc-interest>, <mailto:rfc-interest-request@rfc-editor.org?subject=subscribe>
X-List-Received-Date: Mon, 01 May 2023 19:27:53 -0000

I’m definitely hearing a desire for humans to be involved in the process. 

The main down side, if I understand correctly, of using the errata system as the mechanism is that only one version of the RFC will have archived links when something breaks (the html with inline errata). 

If the authors are involved in verifying the correct archival link, it seems like it’s still a human/community based process to put the archived link directly into the reference right from the start.

I think it would be ideal for even the text versions going forward to have both an original link and an archived link for each reference (when it’s a link, and where possible/appropriate - up to the authors). The text version might not have anything fancy that warns you that the original link is dead, but if you follow it and it 404s there will be an archived link right there for you already. Very low barrier to access the information.

That doesn’t fix broken links going backwards, of course. Maybe that’s the best use of the errata workflow? 


> On Apr 28, 2023, at 1:18 PM, Brian E Carpenter <brian.e.carpenter@gmail.com> wrote:
> 
> On 29-Apr-23 05:19, Michael Richardson wrote:
>> Alexis Rossi <rsce@rfc-editor.org> wrote:
>>     > It seems like using the errata system would maybe be a more haphazard
>>     > method of fixing broken links over time, since it relies on humans to
>>     > notice the original link is dead, report that as an errata, and then
>>     > another human to check and approve it. Unless the proposal is to have a
>>     > bot that files errata when links die (and then there’s just one human
>>     > step to approve)?
>> I think that this says more about how antique our errata management system
>> is, than anything about the durability of the links :-)
> 
> Correct, but I think Ted's idea was to use the errata mechanism to notify the
> stream and ask for approval/disapproval, not to say that the broken link
> is an erratum as such. And yes, of course all of this should be robotic,
> including the initial archiving at the time of RFC publication.
> 
> Yes to those who say that the RFC with approved errata applied should be
> the go-to version. The "text will never change" version needs to be kept
> for the lawyers, but normal RFC users should see the fixed version.
> 
>     Brian