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

[Ján Tomko]

On a Tuesday in 2022, Peter Krempa wrote:
>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.
>

Series:
Reviewed-by: Ján Tomko <jtomko at redhat.com>

Jano
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 488 bytes
Desc: not available
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20220601/a4bb9a33/attachment-0001.sig>