???????? 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/revisions >> /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. 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. 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
