Re: [Tools-discuss] Links from HTML I-Ds to datatracker/latest versions

Brian E Carpenter <brian.e.carpenter@gmail.com> Wed, 10 March 2021 22:15 UTC

Return-Path: <brian.e.carpenter@gmail.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 D2BEB3A19D5 for <tools-discuss@ietfa.amsl.com>; Wed, 10 Mar 2021 14:15:14 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.098
X-Spam-Level:
X-Spam-Status: No, score=-2.098 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, FREEMAIL_FROM=0.001, NICE_REPLY_A=-0.001, RCVD_IN_DNSWL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-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=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 FQQqLRK_VYEG for <tools-discuss@ietfa.amsl.com>; Wed, 10 Mar 2021 14:15:13 -0800 (PST)
Received: from mail-pf1-x435.google.com (mail-pf1-x435.google.com [IPv6:2607:f8b0:4864:20::435]) (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 667243A19D3 for <tools-discuss@ietf.org>; Wed, 10 Mar 2021 14:15:13 -0800 (PST)
Received: by mail-pf1-x435.google.com with SMTP id x7so9658196pfi.7 for <tools-discuss@ietf.org>; Wed, 10 Mar 2021 14:15:13 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:references:from:message-id:date:user-agent:mime-version :in-reply-to:content-language:content-transfer-encoding; bh=NWZ2bBRpH+8e2RmQU1V0RSBmufJpGfc3rRfb+tIqaGQ=; b=WB3Ib4Y99DbLS6nRGRIMs+DxgHbmYSNTuRGL9l3pJ6p4M++lgMEBHZ9RnCtNoli5+N po2RVUU/9iiuo2cXiUlZbe3Lak4RhgdZt/CAnoX18VnHpyB4zhzmZb7YVU1Iads1dOzH PRTrUTVZ13PWKq6tGqgfnGiFdIupdPXDmWf5+fg3c5UQXZlJcCBnfr57UPpt7e3DpfSR +aQWw2tDt5KkOG7DZz1xEBJKOvswe0UqTvCDN9JbuyWsW+wnx+WLHKSYJFXD/3pOIeQn fhMG3Xp0oRodfd+EGsYG41OmDlBvewvxD2Va8TnGNl5kKek4w+pB4mZVcQ9PZdr8RAVK XcKA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=NWZ2bBRpH+8e2RmQU1V0RSBmufJpGfc3rRfb+tIqaGQ=; b=ES8q1e8Ch+uQ1Vn6fZwNXYWbRihxd/IOg3bM/oAjiBaz0EqTTqHHgqMbnU/6r/UDhW PTGADA9STgcApCWI37lz7pOG1Nu1gRgRe8WoyOre3LXe13Nkf20NbgNe1P48E5mcPu4V Pak2klhz1k4pg+PDhqP2NyQ+qIP/QekpHA8j27H8oPubyykYgB2tceqGlVTvBMsja6WE taHDpczEtERI7Wg+cBFl7N6uJjD+yQNB7eeadf+hxTBSppZSXeYZgcBU//+2wsayuXlJ gV3q5leJ54rPVnDTKPV3sPcqSQ4Gn9fNxlN74X9e2T+dwypnAYZplOXYwaITsGovVPiL wFxA==
X-Gm-Message-State: AOAM533srs3Xy6AUhIFMZbnLIp5pLjwiiWEfo6oOTCSpmRMMA55PVIsW A97VJVW08zGX5ch5YJcS9dBRdjWF7I1ggQ==
X-Google-Smtp-Source: ABdhPJz2FoWxN3kqA0HPjAZKqIwkY/G2Vdmzg+Od8bV0N3ragD2w92dBaosGwncEONOOgAwU0B2mZw==
X-Received: by 2002:a62:9284:0:b029:1ee:ec63:4851 with SMTP id o126-20020a6292840000b02901eeec634851mr4790918pfd.16.1615414511324; Wed, 10 Mar 2021 14:15:11 -0800 (PST)
Received: from [192.168.178.20] ([151.210.131.28]) by smtp.gmail.com with ESMTPSA id y9sm313217pja.50.2021.03.10.14.15.09 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Wed, 10 Mar 2021 14:15:10 -0800 (PST)
To: Jeffrey Yasskin <jyasskin=40google.com@dmarc.ietf.org>, Tools Discussion <tools-discuss@ietf.org>
References: <CANh-dX=C9J9NVXrJyyTfnMdSWaFxg6rkWKX6HuTF0TeyK=jOCA@mail.gmail.com>
From: Brian E Carpenter <brian.e.carpenter@gmail.com>
Message-ID: <1db89591-3852-4b6e-8c7b-0e9407409edf@gmail.com>
Date: Thu, 11 Mar 2021 11:15:06 +1300
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:60.0) Gecko/20100101 Thunderbird/60.9.1
MIME-Version: 1.0
In-Reply-To: <CANh-dX=C9J9NVXrJyyTfnMdSWaFxg6rkWKX6HuTF0TeyK=jOCA@mail.gmail.com>
Content-Type: text/plain; charset=utf-8
Content-Language: en-US
Content-Transfer-Encoding: quoted-printable
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/3Pp6eS7dFTjebU0yqmLDfBOU0X8>
Subject: Re: [Tools-discuss] Links from HTML I-Ds to datatracker/latest versions
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: Wed, 10 Mar 2021 22:15:15 -0000

On 11-Mar-21 09:02, Jeffrey Yasskin wrote:
> I've noticed that the native-HTML version of internet drafts, like https://www.ietf.org/archive/id/draft-yasskin-wpack-bundled-exchanges-03.html
> 
> 1) Don't link back to the datatracker's description of the draft: https://datatracker.ietf.org/doc/draft-yasskin-wpack-bundled-exchanges/
> 2) Don't link to any later versions of the draft: https://www.ietf.org/archive/id/draft-yasskin-wpack-bundled-exchanges-04.html
> 3) Don't have an easy way to find a version-independent URL, like the htmlized version provides at https://datatracker.ietf.org/doc/html/draft-yasskin-wpack-bundled-exchanges.
> 
> This makes it dangerous to link to native-HTML versions of I-Ds because readers don't have any way to realize that they're reading an old version.

Really? When I tried with your draft -03, the links to updated drafts gave 404 errors.
 
> I haven't dug into which tools would need to change to provide such links. Probably both xml2rfc and the datatracker itself? Are there issues with the /archive/ path segment that might imply these files can never change to incorporate the fact that the latest available version does change?

afaik, if your xml (v3) looks like this:

<xi:include href="https://xml2rfc.tools.ietf.org/public/rfc/bibxml3/reference.I-D.foo-bar.xml"/>

the html rendering will point to the current version at the time the xml file is converted, but via the tools server. The top bar there gives you the versions up to date. There's also a link to the tracker.

(That will have to be changed of course when tools.ietf.org goes away.)

Looking at your -04 draft, that's exactly how it is, so whatever caused the wrong links in the -03 draft seems to have been fixed already.

Regards
   Brian Carpenter