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

Sun Dec 21 19:32:54 UTC 2014

El Diumenge, 21 de desembre de 2014, a les 21:15:02, Yuri Chornoivan va 
escriure:
> написане Sun, 21 Dec 2014 20:51:38 +0200, Albert Astals Cid
> 
> <aacid at kde.org>:
> > El Diumenge, 21 de desembre de 2014, a les 19:10:44, Yuri Chornoivan va
> > 
> > escriure:
> >> написане 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:
> >> >> написане Sat, 20 Dec 2014 18:33:10 +0200, Albert Astals Cid
> >> >> 
> >> >> <aacid at kde.org>:
> >> >> > docs.kde.org needs to be updated to track  Applications/14.12 +
> >> >> > Plasma/5.1
> >> >> > instead of 4.14
> >> >> > 
> >> >> > Does anyone how to do that?
> >> >> > 
> >> >> > Cheers,
> >> >> > 
> >> >> >   Albert
> >> >> 
> >> >> Hi,
> >> >> 
> >> >> This can be done via index.php and generator in docs-kde-org git
> >> 
> >> repo.
> >> 
> >> >> But... there is no "14.12" in http://websvn.kde.org/branches/KDE/ so
> >> 
> >> we
> >> 
> >> >> will lost all translations.
> >> > 
> >> > Errr what? Why would be lose translations because of that?
> >> 
> >> Oops... Dead code in the generator script:
> >> 
> >> https://projects.kde.org/projects/websites/docs-kde-org/repository/revisi
> >> ons /master/entry/generator#L91
> >> 
> >> > You'll never find 14.12 there, you can find it at
> >> > http://websvn.kde.org/branches/Applications/
> >> > 
> >> >> 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.
> > 
> > That is a "KDE app"?
> > 
> > What is a "KF5 version"?
> > 
> >> Some of them
> >> have kf5-stable versions. If I for some reasons install KF5 what docs
> >> should I choose?
> > 
> > What is installing KF5? The libraries? Or you mean Plasma 5 the desktop?
> > 
> >> KF5 (5.x?), KDE 4.14, KDE 14.12? What all those numbers
> >> about?
> > 
> > They are version numbers.
> > 
> > KF5 is the version of the libraries.
> > KDE 4.14 is some old thing we don't ship nor support anymore (except for
> > LTS
> > kdelibs and kdepim*)
> > There's no KDE 14.12, there's KDE Applications 14.12, that is the set of
> > Applications we just released, some of those have dependencies in KF5,
> > some of
> > those have dependencies on kdelibs4, but you should not care the less.
> 
> As a member of one distribution team (Mageia) I'd rather disagree. You
> cannot install both versions at the same time.

Both versions of what?

> For sure, there is a little difference now. But soon... At least some apps
> (e.g. Kalzium) will loose some of there features (e.g. molecule viewer)
> because of porting and we should remove doc parts.
> 
> >> 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.
> > 
> > That is how it should be, i advocated the simplicty of this more than
> > year
> > ago, people said i was crazy and i gave in, we're now reaping the
> > consquences
> > of having 4 branches instead of 2 as i wanted.
> 
> It would be hard to decide now what branch to choose. It needs some
> parsing of 4 subversion branches instead 2 branches that we have for now.
> 
> The other problem that we need two versions of kdoctools (4.5-based for
> KF5-based apps and 4.2-based for kdelibs4-based apps). That has been
> already pointed by Luigi.
> 
> >> 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).
> >> 
> >> As it will be hard for average user and search robot to find the right
> >> docs from 4 (or more) cases and KF5 is still not widely adopted, nobody
> >> complained so far that there are no docs for KF5 applications.
> >> 
> >> Moreover, we should redo almost all screenshots with the new default
> >> style
> >> (Breeze?) and have not enough KF5 users to do this.
> >> 
> >> So this is not an urgent task so far, imho. Sorry for the pessimistic
> >> point of view.
> > 
> > I think the thing is that you're looking at this wrong, there's no KDE4
> > apps
> > nor KF5 apps, there's just apps, and those apps have documentation.
> 
> Ok. I just look at this my way. ;)
> 
> To be honest, I do not mind if any possible way to handle the current
> situation would be implemented. For now, waiting for more apps to be
> ported on KF5 is a reasonable solution for me.

We may as well shut down the page if it's going to show old information for no 
reason.

Cheers,
  Albert

> 
> Best regards,
> Yuri
> 
> >> Best regards,
> >> Yuri
> >> 
> >> > Cheers,
> >> > 
> >> >   Albert
> >> >> 
> >> >> Just my 2 cents (usually Burkhard does all switches).
> >> >> 
> >> >> Best regards,
> >> >> Yuri
> >> 
> >> _______________________________________________
> >> kde-doc-english mailing list
> >> kde-doc-english at kde.org
> >> https://mail.kde.org/mailman/listinfo/kde-doc-english
> > 
> > _______________________________________________
> > kde-doc-english mailing list
> > kde-doc-english at kde.org
> > https://mail.kde.org/mailman/listinfo/kde-doc-english
> 
> _______________________________________________
> kde-doc-english mailing list
> kde-doc-english at kde.org
> https://mail.kde.org/mailman/listinfo/kde-doc-english