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

Brian E Carpenter <brian.e.carpenter@gmail.com> Thu, 11 March 2021 01:14 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 D93573A0934 for <tools-discuss@ietfa.amsl.com>; Wed, 10 Mar 2021 17:14:31 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.099
X-Spam-Level:
X-Spam-Status: No, score=-2.099 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, 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 dhOtoYvSuNvD for <tools-discuss@ietfa.amsl.com>; Wed, 10 Mar 2021 17:14:30 -0800 (PST)
Received: from mail-pl1-x62d.google.com (mail-pl1-x62d.google.com [IPv6:2607:f8b0:4864:20::62d]) (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 399723A0928 for <tools-discuss@ietf.org>; Wed, 10 Mar 2021 17:14:30 -0800 (PST)
Received: by mail-pl1-x62d.google.com with SMTP id s7so9399936plg.5 for <tools-discuss@ietf.org>; Wed, 10 Mar 2021 17:14:30 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=jjiG4G86+Noe11QbYGiSc9JfoHwa0kE9wQj7gKOx5X8=; b=LOtrf+kEOSg8GqBbdKtF2Pm6KTd8byfULgJXNpgZDfuyBuXdYNW2roohZhMp2fTJ7L 68JRN9ZsjrlRArovssks1RAQYU32Ky8sHqitHMoS5+iSKsbuMuRi4fGNcZkY2ukNBAxh r6Gws/VYLLrGYrev27hNwm62TTmoZw7zsw1zn68kVR3cTiAVsHNTvrnGFswl6aowd2NP J3AF69Rz1fi3UOgP3jXuhklwQButvS4LMtwshbvXRGvD8FuIk/V/EdjcppXUi0I3HrhX IkIIQyamFjcZwYezuNF3vj1/bDXCQETIdNLC4x7Se+STSgqdBf4z5ihb7zvOV55gOrbT DWuQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:cc:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=jjiG4G86+Noe11QbYGiSc9JfoHwa0kE9wQj7gKOx5X8=; b=julvgP0RkMcTX111h2KOSNaQW8vL4xoa0XBcxkH5dTcFta0qJLXGjMrTofUS2jVFwt q9d+KbNgenAq6hSgt0/RpU5YPuAEtIe77HF5ZY9rypslDSj7VdUGrMpWhKwUFUicZ5b3 jE22KBt8yC5YvXP9HLI4xxGz/iO4kINkvvATN+63tFx9DeStJOQVlZBmAONGWa3ocVmr ErBTgpNhvRyFbLadocln5RQTPoUlH90zkQl6VEeNZ244PlIpLATJO3gpQnF10Fmu5HxU b6xNhLVw5SfBtgg83i8Cn4Vcn3ljJeldeHKXWVPR4oICFfpYZGpULtrJPJ7gFTAI5U3P ElhA==
X-Gm-Message-State: AOAM531MJWlVC89gDxtgtta1l+B9u6KJpSV73GyQCpRf1UqrvbX9Jv5T dhHgxm6aYVvbvuT2ziauOeY8ZNIUOD9IBw==
X-Google-Smtp-Source: ABdhPJznsitsd0ogTYyt1z9DJcNNUKGtwwagyz/E7jSEQ1Wk5dTKsQTRehC3dZeDl0sWY7ioACeJdw==
X-Received: by 2002:a17:902:8a91:b029:e6:3e11:b252 with SMTP id p17-20020a1709028a91b02900e63e11b252mr5580752plo.7.1615425268232; Wed, 10 Mar 2021 17:14:28 -0800 (PST)
Received: from [192.168.178.20] ([151.210.131.28]) by smtp.gmail.com with ESMTPSA id u7sm604249pfh.150.2021.03.10.17.14.25 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Wed, 10 Mar 2021 17:14:27 -0800 (PST)
To: Jeffrey Yasskin <jyasskin@google.com>
Cc: Jeffrey Yasskin <jyasskin=40google.com@dmarc.ietf.org>, Tools Discussion <tools-discuss@ietf.org>
References: <CANh-dX=C9J9NVXrJyyTfnMdSWaFxg6rkWKX6HuTF0TeyK=jOCA@mail.gmail.com> <1db89591-3852-4b6e-8c7b-0e9407409edf@gmail.com> <CANh-dXmt5gzTFMh_bMCyNv456x7=0iHtBx2oKB8XpDd6bFmHaw@mail.gmail.com>
From: Brian E Carpenter <brian.e.carpenter@gmail.com>
Message-ID: <f01b28c2-fdae-a52a-0f49-d8499c08c6c8@gmail.com>
Date: Thu, 11 Mar 2021 14:14:23 +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-dXmt5gzTFMh_bMCyNv456x7=0iHtBx2oKB8XpDd6bFmHaw@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/IOypK_7eFVjglofvT3k0p8nwmfU>
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: Thu, 11 Mar 2021 01:14:32 -0000

On 11-Mar-21 12:29, Jeffrey Yasskin wrote:
> On Wed, Mar 10, 2021 at 2:15 PM Brian E Carpenter <brian.e.carpenter@gmail.com <mailto:brian.e.carpenter@gmail.com>> wrote:
> 
>     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 <http://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.
> 
> 
> I think you might have confused the htmlized version (https://datatracker.ietf.org/doc/html/draft-yasskin-wpack-bundled-exchanges-04), which has the cross-links I want, with the native-HTML version (https://www.ietf.org/archive/id/draft-yasskin-wpack-bundled-exchanges-04.html) that has better typesetting and table of contents, but is missing the cross-links I mentioned above.

I still don't understand what you want. The htmlized version has links to
   https://datatracker.ietf.org/doc/html/draft-yasskin-wpack-use-cases-01
and
   https://tools.ietf.org/html/draft-yasskin-wpack-use-cases-01

which are essentially identical. The native HTML version links only to the second one, but I'm at a loss to see what's missing.

> I'm not sure where the mention of <xi:include> came from, as it's not in my XML version at all (https://www.ietf.org/archive/id/draft-yasskin-wpack-bundled-exchanges-04.xml).

Well, that's just the short way to encode I-D references in xml2rfcv3. It looks as if kramdown does it a more noisy way. I guess it's irrelevant.

Regards
   Brian