Re: [Tools-discuss] Unversioned draft links (was Re: slow tools reaction)

Robert Sparks <rjsparks@nostrum.com> Mon, 20 September 2021 15:21 UTC

Return-Path: <rjsparks@nostrum.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 D38603A142E for <tools-discuss@ietfa.amsl.com>; Mon, 20 Sep 2021 08:21:43 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.08
X-Spam-Level:
X-Spam-Status: No, score=-2.08 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, NICE_REPLY_A=-0.001, T_SPF_HELO_PERMERROR=0.01, T_SPF_PERMERROR=0.01, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=nostrum.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 4VM4OGO9giHp for <tools-discuss@ietfa.amsl.com>; Mon, 20 Sep 2021 08:21:39 -0700 (PDT)
Received: from nostrum.com (raven-v6.nostrum.com [IPv6:2001:470:d:1130::1]) (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 2830C3A142A for <tools-discuss@ietf.org>; Mon, 20 Sep 2021 08:21:39 -0700 (PDT)
Received: from unformal.localdomain ([47.186.34.206]) (authenticated bits=0) by nostrum.com (8.17.1/8.16.1) with ESMTPSA id 18KFLZVC066528 (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384 bits=256 verify=NO); Mon, 20 Sep 2021 10:21:36 -0500 (CDT) (envelope-from rjsparks@nostrum.com)
DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=nostrum.com; s=default; t=1632151297; bh=k0TfNoul81US8JobFswVtIvoaDRtZF+TeGyuRDkC9ic=; h=To:References:From:Subject:Date:In-Reply-To; b=W9lvtMyBrEu5Aa8J3cU/tgFQ7DzHed6ijGF47D/ZMH27/PF7KvskxcfZ7GwOBMC08 d8eZIpi1m2zY5JVpQ1YUfBrmgp35foj5KixmHoU4FdsFJ3WsrneBP58Lglm/dM83bo HPpr6tdv38WL4SbKPwDeGJWv3QzKGaDCWCYzv7Qg=
X-Authentication-Warning: raven.nostrum.com: Host [47.186.34.206] claimed to be unformal.localdomain
To: Martin Thomson <mt@lowentropy.net>, tools-discuss@ietf.org
References: <BL0PR05MB56520AE3605328F120BAA8FED4DC9@BL0PR05MB5652.namprd05.prod.outlook.com> <BYAPR11MB2725C5B6FE3A2A7B95D5F976DFDC9@BYAPR11MB2725.namprd11.prod.outlook.com> <CAF4+nEFZN+RBk9Ocnc4X2Xv4sTBKPpdxxWKg_nJfaLU5TOQGOQ@mail.gmail.com> <20210916041429.GI32645@kduck.mit.edu> <BL0PR05MB565207AD632C6D7C3AFEF9EAD4DC9@BL0PR05MB5652.namprd05.prod.outlook.com> <aa99dad1-8dfb-ea76-3b68-bb5c0259ad72@nostrum.com> <ef47095d-786b-4060-8c5b-669924b71a5b@www.fastmail.com> <b6abd836-e193-70cf-5371-ae9570cc3ea8@nostrum.com> <457dc09f-e14d-139a-10b9-ddd6a4f1e3b1@nostrum.com> <1e8f8983-23c4-4f96-92d3-8a2f08ec27d9@www.fastmail.com>
From: Robert Sparks <rjsparks@nostrum.com>
Message-ID: <7331dce1-22a5-1206-e87e-08d0dcc89d35@nostrum.com>
Date: Mon, 20 Sep 2021 10:21:30 -0500
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:78.0) Gecko/20100101 Thunderbird/78.14.0
MIME-Version: 1.0
In-Reply-To: <1e8f8983-23c4-4f96-92d3-8a2f08ec27d9@www.fastmail.com>
Content-Type: text/plain; charset="utf-8"; format="flowed"
Content-Transfer-Encoding: quoted-printable
Content-Language: en-US
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/RtT1rBNO7ghXFSL-XaJbusIDrac>
Subject: Re: [Tools-discuss] Unversioned draft links (was Re: slow tools reaction)
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: Mon, 20 Sep 2021 15:21:44 -0000

On 9/19/21 8:32 PM, Martin Thomson wrote:
> Thanks Robert,
>
> (Changing the subject as we are now way off the original subject.)
>
> Is there a resource that refers to the latest text rendering of a draft regardless of version?

No, there is not a good single resource for this, but I am in the 
process of making one.

See the thread at 
<https://mailarchive.ietf.org/arch/browse/tools-discuss/?q=Getting%20the%20%22current%22%20version%20of%20things>

You are, I think, stating a preference for {versionlessname}.{extension} 
(and inferring format from extension) in whatever URL plan we end up 
with in the long run vs {versionlessname}/{format}?

Similarly, {versionlessname}-{version}.{extension} vs 
{versionlessname}/{version}/{format}

As a brief diversion, while thinking about this, consider the foot-wound 
we carry around that is heuristic extraction of version given a string 
that looks like aaaaaa-nn.txt.

Things like this 
<https://datatracker.ietf.org/doc/draft-ietf-16ng-ip-over-ethernet-over-802-dot-16> 
make for code that has to guess at what a request for 
"draft-ietf-16-ng-ip-over-ethernet-over-802-dot-16.txt" means. We 
heuristically solve this by looking for -802-dot version 16 first and if 
we don't find it, we look for -802-dot-16 version latest. There's a 
chance for harmful masking of a name here - fortunately we haven't seen 
it exercised in practice.

And then consider what horror we inflicted on ourselves with names like 
review-ietf-taps-interface-13-artart-early-sparks-2021-09-17-00 and 
charter-ietf-quic-02-06.

RjS

>   
>
> The only unversioned links I'm aware of point to the latest HTMLized version of a draft and its metadata page.  I'm in the process of converting the links I generate to use this version of rfcdiff and some of the links I used to provide I find are now broken.
>
> For example, this is a link that used to be useful.  Note the absence of a -06 in url1:
> https://tools.ietf.org/rfcdiff?url1=https://tools.ietf.org/id/draft-ietf-httpbis-message-signatures.txt&url2=https://httpwg.github.io/http-extensions/draft-ietf-httpbis-message-signatures.txt
>
> I can now fix the first part of that, but url1 remains a problem.
>
> (Maybe the fact that no one has complained about these links being broken is a sign that maybe there isn't enough use of this feature to continue supporting it, but I thought that I would at least try.)
>
> On Fri, Sep 17, 2021, at 12:44, Robert Sparks wrote:
>> Ah - I see at least one place where it leaks (in the instructions at the
>> bottom of the default form - I will be sure that is addressed. Thanks
>> for calling attention to it - if you see it anywhere else, please let me
>> know.