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 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?

Regards,
Thomas
-- 
Thomas McGuire | [email protected] | Software Engineer
KDAB (Deutschland) GmbH&Co KG, a KDAB Group company
Tel. Germany +49-30-521325470, Sweden (HQ) +46-563-540090
KDAB - Qt Experts - Platform-independent software solutions

Join us in October at Qt Developer Days 2014! - https://devdays.kdab.com

Attachment: smime.p7s
Description: S/MIME cryptographic signature

_______________________________________________
Development mailing list
[email protected]
http://lists.qt-project.org/mailman/listinfo/development

Reply via email to