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

[Jeffrey Yasskin <[e-mail]>]

On Wed, Mar 10, 2021 at 2:15 PM Brian E Carpenter <
[e-mail]> 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 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'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
).

Jeffrey