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

Sun Dec 21 19:41:46 UTC 2014

написане 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).

>
>> 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...

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