[kde-doc-english] Updating docs.kde.org to Applications/14.12 + Plasma/5.1?

[Luigi Toscano]

Yuri Chornoivan ha scritto:
> написане Sun, 21 Dec 2014 18:41:18 +0200, Albert Astals Cid <aacid at kde.org>:
> 
>> El Dissabte, 20 de desembre de 2014, a les 18:47:37, Yuri Chornoivan va
>> escriure:
>>> There was also some sort of agreement that we do not generate docs for 5.x
>>> (too many branches, chaos, uncertainty where is what...).
>>
>> Too many branches? chaos? Where has that "agreement" been generated?
>>
>> I've never seen anyone complaining about chaos.
> 
> Me first, yeah! ;)
> 
> Some words about "chaos". ~20% of KDE apps have KF5 versions. Some of them
> have kf5-stable versions. If I for some reasons install KF5 what docs should I
> choose? KF5 (5.x?), KDE 4.14, KDE 14.12? What all those numbers about?
> 
> This has two solutions:
> 
> 1. Just keep two branches, stable and unstable. This way we should guess from
> SVN translation branches what version to choose to show on d.k.o. This is
> hardly reachable automatically.
> 
> 2. Keep all possible branches. It takes some time and efforts to rewrite
> scripts for two (three, more?) new branches (kf5-stable, kf5-master) and from
> kdelibs to kdoctools framework (not saying that there might be some problems
> with different versions of kdoctools).

We can support this, the complicated part is backporting some tools on the
machine which generates the scripts.

My solution, which could be implemented also when we had just two branches,
is: display an application-centric view, not a branch-centric. For each
application, the stable documentation (be it kdelibs4 or KF5, or the last
stable version of both if both supported) and the devel doc can be chosen.

Ciao
-- 
Luigi