[Development] Preventing link rot in Qt docs

Topi Reiniƶ Topi.Reinio at qt.io
Sat Dec 8 02:34:11 CET 2018


Redirects are now in place. We have also plans to implement better versioning for the online docs.


\topi

________________________________
From: Development <development-bounces at lists.qt-project.org> on behalf of Richard Weickelt <richard at weickelt.de>
Sent: Friday, December 7, 2018 10:56:43 PM
To: development at lists.qt-project.org
Subject: Re: [Development] Preventing link rot in Qt docs

On 07.12.2018 18:09, Giuseppe D'Angelo via Development wrote:
> Il 07/12/18 13:46, Sze Howe Koh ha scritto:
>> This is a problem because the Qt docs are heavily cited in the forums,
>> the wiki, and external sites like StackOverflow.
>
> As an add-on, keep the documentation online, but use properly versioned
> URLs, so that these breaks never happen. (Of course one could have a big fat
> warning on top of earlier versions saying that one is reading an old version
> of the docs.)

This is already the case:

https://doc.qt.io/qt-5/android.html
https://doc.qt.io/qt-5.12/android.html
https://doc.qt.io/qt-5.11/android-support.html

https://doc.qt.io/qt-5/android-getting-started.html
https://doc.qt.io/qt-5.12/android-getting-started.html
https://doc.qt.io/qt-5.11/androidgs.html

But I agree with Sze-Howe: It would be convenient if renaming pages would
also include replacing the old URL by a 301 redirect to the new one.

Richard
_______________________________________________
Development mailing list
Development at lists.qt-project.org
https://lists.qt-project.org/listinfo/development
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.qt-project.org/pipermail/development/attachments/20181208/58615d8d/attachment.html>


More information about the Development mailing list