link fest

[martinthomson]

Comment by @paulwouters

It seems some automated tooling was used to creating links within the document, eg for "key configuration": 7 times in Section 3, pointing to a few lines below in section 3.1, and even one time within section 3.1 itself pointing recursively back to itself, and 3 more times in section 3.2, and then I stopped counting.

The same for things like "client", Oblivious Gateway Resource", etc etc culminating in Section 5 that's more blue than black, making the blue links, uhm, oblivious :P

[martinthomson]

There are a few tooling changes that might be worth pursuing here, but I don't intend to make any changes in response to this issue.

[martinthomson]

For reference: ietf-tools/datatracker#5071 and ietf-tools/xml2rfc#963 and cabo/kramdown-rfc#185

[paulwouters]

I believe the tooling used still creates a large number of useless and distracting links in the document. I've created an agenda item to this weeks IESG's Informal meeting to discuss this.

[cabo]

Was there any outcome of the IESG discussion?

(The tooling does what it is told to do. Auto-creating links obviously needs to be applied sparingly...
We did have some discussion about making auto-created links less visible/inviting than manually created ones, but RFCXML is not very flexible here.)

[cabo]

Oh, that change actually happened:

ietf-tools/xml2rfc@dbdda51

In xml2rfc 3.17.0.

[martinthomson]

Steps have been taken. The index remains problematic, but that's (again) on xml2rfc.