[Development] Harmonizing the Qt 5.x Documentation

[Pasion Jerome]

Hello all,

Thanks for the feedback.

We plan to deploy the redirects next week to avoid the Easter break; hopefully, Monday.

Some more notes:
A) The Qt 5.0, 5.1, and 5.2 documentation sets are already hosted in the archives: http://doc.qt.digia.com/archives/index.html 
There will be links to them from qt-project.org/doc/. 

B) I modified the Qt Project search filters to include the Archives, Code Review, Mailing Lists, and Bug Reports.

C) The Qt Project members who made revisions (created or edited) doc notes have already received a mail about the doc notes. The doc notes won't be removed and they are still visible from the the member's pages.

Cheers,
Jerome P.
Documentation Engineer - Digia, Qt
________________________________________
Fra: development-bounces+jerome.pasion=digia.com at qt-project.org [development-bounces+jerome.pasion=digia.com at qt-project.org] på vegne av Lisandro Damián Nicanor Pérez Meyer [perezmeyer at gmail.com]
Sendt: 14. mars 2014 03:03
To: development at qt-project.org
Emne: Re: [Development] Harmonizing the Qt 5.x Documentation

On Tuesday 11 March 2014 09:22:40 Thiago Macieira wrote:
> Em ter 11 mar 2014, às 17:17:46, Andre Somers escreveu:
> > I seriously don't see the benefit of this "harmonization". When I look
> > at the docs for a class, I often just look for method names that seem to
> > do what I need. That usually works very with Qt. Now, I will need to go
> > check for every method if it actually exists in the version of Qt I'm
> > on, by looking for a "since" tag. How is that helping me to become more
> > productive?
>
> If you want to be productive with the exact docs for the version you're
> using and full, indexed text search, you should use Qt Assistant or the
> integrated Help in Qt Creator.

As long as you are building Qt from the one-in-all tarball. If you are
building with submodules (or using Debian packages, for example) you will miss
many links between different source packages because the docs are not
available at build time.

We (Debian Qt maintainers) are doing our best to improve this situation, but
we acknowledge we are not there yet, because the doc build system wasn't
designed for this special case.

Of course, if anyone wants to implement it, we have some ideas and we welcome
patches ;-)

--
LINUX KERNEL LIBERADO
DOS SECUESTRADORES MICROSOFTIANOS CAPTURADOS
OTRO SIGUE PROFUGO
*musiquita de cronica TV*

Ok, ok, ya me voy a hacer algo util, no me peguen :D

  Matias "Angasule" D'Ambrosio,
  sobre la liberación del kernel 2.6.23
  http://linux.org.ar/pipermail/bblug/2007-October/005405.html

Lisandro Damián Nicanor Pérez Meyer
http://perezmeyer.com.ar/
http://perezmeyer.blogspot.com/

_______________________________________________
Development mailing list
Development at qt-project.org
http://lists.qt-project.org/mailman/listinfo/development