[Development] Harmonizing the Qt 5.x Documentation

[André Somers]

Thomas McGuire schreef op 3-4-2014 10:47:
> Hi,
>
> On Thursday 03 April 2014 08:02:16 Rutledge Shawn wrote:
>> On 2 Apr 2014, at 6:07 PM, Ariel Molina wrote:
>>> The current state of Qt docs is very sad, making online searches near to
>>> useless. All Google searches refer either to broken pages, to 4.x doc
>>> pages, to incomplete 5.0 unstables or even to 3.3 documentation. What's
>>> the point on having 5.x (or any) docs if you keep moving them around
>>> hiding it from search engines and breaking links on every site that
>>> links to you?
>>>
>>> You might point a root folder, but, let's be honest, none uses any root
>>> folder to search, everyone uses Google or another search engine.
>>>
>>> Please whatever you do, do not break this anymore, the current state is
>>> already messed up.
>> I agree.  But I think the idea was to change it one last time and then
>> never change it again, and the docs that google finds should be always the
>> latest rather than a particular version.  I hope that goal is achieved...
> Moving around is fine, but please make sure old links redirect to the new
> places. It is not just Google results affected by moving around docs, it is
> also links in other places like answers in Stackoverflow questions.
And the qt-project.org forums, not to forget.

> And yes, the fact that Google finds old versions is a problem. For example a
> search for "qprocess setreadchannel" will give the 4.8 version as the first
> result. How about adding a "Versions" box to the sidebar that gives convenient
> links to all other versions of the QProcess documentation? Then even if Google
> finds an old version first, the user can quickly jump to the newest.
> Btw, any idea why Google prefers the 4.8 version?
Probably because there are way more external links to it which makes it 
rank higher.

André