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

Albert Astals Cid aacid at kde.org
Sun Dec 21 18:52:21 UTC 2014


El Diumenge, 21 de desembre de 2014, a les 19:06:09, Luigi Toscano va 
escriure:
> 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.

Obviously is how this has to be, why would it matted if the app is kdelibs4 or 
KF5 based?

Cheers,
  Albert

> 
> Ciao



More information about the kde-doc-english mailing list