[kde-doc-english] Updating docs.kde.org to Applications/14.12 + Plasma/5.1?
Albert Astals Cid
aacid at kde.org
Sun Dec 21 21:34:47 UTC 2014
El Diumenge, 21 de desembre de 2014, a les 21:41:46, Yuri Chornoivan va
escriure:
> написане Sun, 21 Dec 2014 21:32:54 +0200, Albert Astals Cid
>
> <aacid at kde.org>:
> > 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?
>
> Plasma 5 and KDE 4 Workspaces (do not know the exact marketing names).
Right they are the same thing, you're not able to install okular 0.15 and 0.16
at the same time, you can't install Plasma 4 and Plasma 5 at the same time
either.
That has nothing to do with what i said though, since it was speaking about
applications and not the workspace itself.
>
> >> 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.
>
> Why? The information is up-to-date now. Most distribution are not switched
> to Plasma 5. I said "for now" which means "for _now_". When Plasma 5 will
> be the main downstream proposal (since the spring of 2015) it would be
> _highly_reasonable to switch to its docs (and even then what to do with
> KDE 4 docs with non-Breeze window style for screenshots?). But _now_ it's
> just fooling around ourselves and users...
I disagree, but I can buy your argument for Plasma itself, why would you do
the same for Applications, i have no idea.
Cheers,
Albert
>
> Best regards,
> Yuri
>
> > 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
> >
> > _______________________________________________
> > 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
More information about the kde-doc-english
mailing list