Re: [PATCH 00/67] docs: Fix and clean up anchor links

On Tue, May 31, 2022 at 17:26:34 +0200, Ján Tomko wrote: > On a Tuesday in 2022, Peter Krempa wrote: > > First 50 patches remove the use of raw HTML passthrough in > > formatdomain.rst, which is the only outstanding place which still does. > > > > Is cleaning those up worth breaking links from external sites which > use the old anchors? I thought that was the only reason we left them > there. Well, the main reason they were added originally was because it also prevented us from having to convert all other documents we have locally and allowed a mostly automated conversion. For all other documents which didn't have so many internal cross-links we already converted the links to the new names when doing the conversion to RST The external links case was certainly one of the selling points at that time, but IMO the value of it decreased over the last almost 2 years since the document was converted as all new links obtained from the document are of the new format. My stance (obviously since I posted the patches) is that since it's inevitable that the links will break at some point and we had a good enough intermediate period so we should just get over it and use what's generated.