Re: [kde-community] Kubuntu documentation

2013-12-14 Thread Sayak Banerjee
FWIW, since we (webteam/sysadmin) are maintaining the wiki infrastructure
(not content, but the installation itself), as mentioned on the kde-www ML,
we have no objections against Kubuntu folks using the wiki. And this does
not add any overhead for us - as long as we don't get too many requests for
adding Mediawiki extensions!!

We always encourage different teams to collaborate under our forum
infrastructure, so I don't feel any differently for the wikis.

Regards,
*Sayak Banerjee*
KDE Sysadmin • KDE e.V. Member
say...@kde.org | m...@sayakbanerjee.com
___
kde-community mailing list
kde-community@kde.org
https://mail.kde.org/mailman/listinfo/kde-community

Re: [kde-community] HIG compliance testing via Google Code-in

2013-12-14 Thread Andreas Cord-Landwehr
On Thursday 05 December 2013 00:01:53 Thomas Pfeiffer wrote:
> So, who would like to have their application HIG-compliance-tested? Just
> reply here and I'll set a task up. It will help you identify potential
> usability problems in your applications without any effort from your side
> except for the commitment to look at the lists and see if you can fix the
> issues there after task completion.

Hey Thomas,

I would be very much interested in getting a review of Artikulate regarding the 
HIG. Since 
it is still a playground app, the easiest way to test it is probably using the 
Neon nightly 
builds. Otherwise, we have install/compile instructions here 
http://techbase.kde.org/Projects/Edu/Artikulate/BuildAndInstall

Also getting HIG information for Rocs would be nice :)

Greetings,
Andreas
___
kde-community mailing list
kde-community@kde.org
https://mail.kde.org/mailman/listinfo/kde-community

Re: [kde-community] Kubuntu documentation

2013-12-14 Thread Martin Graesslin
On Saturday 14 December 2013 13:02:58 Albert Astals Cid wrote:
> > > Just that this "source code" will be distribution specific.
> > 
> > where's the difference to
> > https://projects.kde.org/projects/extragear/sysadmin/muon
> 
> Muon is technically not Ubuntu specific afaik.
in theory yes, in practice it doesn't compile on Debian (testing) and is not 
packaged :-(
> 
> > or all the *suse
> > branches in svn/work?
> 
> Good question, otoh they predate the time were we add a Manifesto that
> helped us make these kind of decisions.
Yes it was before the manifesto, but I think we always encouraged distros to 
work upstream.
> Nope. I was just a bit hesitant about using our wikis just as a dumping
> ground for stuff that would only end up in docs.kubuntu.org and on the
> kubuntu ISO.
> 
> But as I said if you read my emails, I'm not vetoing it, I am not sure even
> if I'm opossed, I just want the people that will take the decision to think
> about it.
my suggestion is that distros should be allowed to host their documentation on 
our infrastructure under two conditions:

1. it needs to be integrated with the existing documentation (we don't need a 
KWin general, a KWin Kubuntu and a KWin Arch wiki page)
2. it needs to be generic

If that is the case I don't see any conflict with the manifesto as it's just 
some further upstream work the distros can use - all of them, not just one.

Cheers
Martin

signature.asc
Description: This is a digitally signed message part.
___
kde-community mailing list
kde-community@kde.org
https://mail.kde.org/mailman/listinfo/kde-community

Re: [kde-community] Kubuntu documentation

2013-12-14 Thread Thomas Zander
On Saturday 14 December 2013 10.54.50 Valorie Zimmerman wrote:
> Recently I wrote to the KDE Docs team and KDE WWW team asking for
> permission to put working copies of the Kubuntu documentation on the
> Userbase wiki. Albert raised an interesting objection, which I can
> only bring to this group for discussion.

My first instinct was to say that we should have all the application 
documentation on the kde servers.
Then I went to the kubunutu website and quickly realized that this is 
already the case.  The amount of information on the kubuntu server, which 
is not specific to that distro, seems to be quite low.  Most of the good 
stuff is already on userbase.kde.org.

Other things just overlap. For instance compare;
http://userbase.kde.org/Applications/Games
http://docs.kubuntu.org/Kubuntu/KubuntuDocs/Software/Games.html


Valorie; what is the gain you are aiming for?  What content would KDE 
benefit from copying from kubuntu?


The kubuntu docs wiki seems to me to be quite elegant. A list of packages 
in the distro and links to the deeper information of the various upstreams.
For instance the office section links to the libreoffice site as well as the 
callgra site.
-- 
Thomas Zander
___
kde-community mailing list
kde-community@kde.org
https://mail.kde.org/mailman/listinfo/kde-community


Re: [kde-community] Kubuntu documentation

2013-12-14 Thread Albert Astals Cid
El Dissabte, 14 de desembre de 2013, a les 12:33:20, Martin Graesslin va 
escriure:
> On Saturday 14 December 2013 12:13:10 Albert Astals Cid wrote:
> > El Dissabte, 14 de desembre de 2013, a les 11:35:23, Martin Graesslin va
> > 
> > escriure:
> > > On Saturday 14 December 2013 01:54:50 Valorie Zimmerman wrote:
> > > > Hi folks,
> > > > 
> > > > Recently I wrote to the KDE Docs team and KDE WWW team asking for
> > > > permission to put working copies of the Kubuntu documentation on the
> > > > Userbase wiki. Albert raised an interesting objection, which I can
> > > > only bring to this group for discussion.
> > > > 
> > > > Kubuntu isn't a KDE project under the Manifesto definition. Even
> > > > though our users are by definition KDE users, it is true that all KDE
> > > > developers do not have write permissions to the Kubuntu codebase,
> > > > since our packages are hosted on Canonical servers.
> > > 
> > > I don't see the problem at the moment. Albert, could you please
> > > elaborate
> > > on your reasoning. For me it looks like KDE would just provide some more
> > > "source code" which can be packaged by the distribution.
> > 
> > Just that this "source code" will be distribution specific.
> 
> where's the difference to
> https://projects.kde.org/projects/extragear/sysadmin/muon 

Muon is technically not Ubuntu specific afaik.

> or all the *suse
> branches in svn/work?

Good question, otoh they predate the time were we add a Manifesto that helped 
us make these kind of decisions.

> I don't know the Kubuntu documentation, but apart from installation there
> should not be much which is Kubuntu specific. If it's about the applications
> it should be merged with the upstream documentation in my opinion. 

Agreed :-)

> Better
> docs for everyone :-) I just had a short look at http://docs.kubuntu.org
> and I'm quite sure that it could be reworked to not be Kubuntu specific.
> E.g. the Getting Involved could be rewritten to be generic for all
> distributions by having multiple sections:
> * Kubuntu
> * openSUSE
> * Arch
> * ...
> 
> Kubuntu could then just extract the relevant part for their documentation.
> Or am I missing something?

Nope. I was just a bit hesitant about using our wikis just as a dumping ground 
for stuff that would only end up in docs.kubuntu.org and on the kubuntu ISO.

But as I said if you read my emails, I'm not vetoing it, I am not sure even if 
I'm opossed, I just want the people that will take the decision to think about 
it.

Cheers,
  Albert

> 
> Cheers
> Martin
> 
> > You can see the original thread at
> > http://lists.kde.org/?t=13865491802&r=1&w=2
> > 
> > Cheers,
> > 
> >   Albert
> >   
> > > That our
> > > repositories are used by distributions has always been the case and is
> > > also
> > > encouraged.
> > > 
> > > Cheers
> > > Martin
> > 
> > ___
> > kde-community mailing list
> > kde-community@kde.org
> > https://mail.kde.org/mailman/listinfo/kde-community

___
kde-community mailing list
kde-community@kde.org
https://mail.kde.org/mailman/listinfo/kde-community


Re: [kde-community] Kubuntu documentation

2013-12-14 Thread Martin Graesslin
On Saturday 14 December 2013 12:13:10 Albert Astals Cid wrote:
> El Dissabte, 14 de desembre de 2013, a les 11:35:23, Martin Graesslin va
> 
> escriure:
> > On Saturday 14 December 2013 01:54:50 Valorie Zimmerman wrote:
> > > Hi folks,
> > > 
> > > Recently I wrote to the KDE Docs team and KDE WWW team asking for
> > > permission to put working copies of the Kubuntu documentation on the
> > > Userbase wiki. Albert raised an interesting objection, which I can
> > > only bring to this group for discussion.
> > > 
> > > Kubuntu isn't a KDE project under the Manifesto definition. Even
> > > though our users are by definition KDE users, it is true that all KDE
> > > developers do not have write permissions to the Kubuntu codebase,
> > > since our packages are hosted on Canonical servers.
> > 
> > I don't see the problem at the moment. Albert, could you please elaborate
> > on your reasoning. For me it looks like KDE would just provide some more
> > "source code" which can be packaged by the distribution.
> 
> Just that this "source code" will be distribution specific.
where's the difference to 
https://projects.kde.org/projects/extragear/sysadmin/muon or all the *suse 
branches in svn/work?

I don't know the Kubuntu documentation, but apart from installation there 
should not be much which is Kubuntu specific. If it's about the applications it 
should be merged with the upstream documentation in my opinion. Better docs 
for everyone :-) I just had a short look at http://docs.kubuntu.org and I'm 
quite sure that it could be reworked to not be Kubuntu specific. E.g. the 
Getting Involved could be rewritten to be generic for all distributions by 
having multiple sections:
* Kubuntu
* openSUSE
* Arch
* ...

Kubuntu could then just extract the relevant part for their documentation. Or 
am I missing something?

Cheers
Martin
> 
> You can see the original thread at
> http://lists.kde.org/?t=13865491802&r=1&w=2
> 
> Cheers,
>   Albert
> 
> > That our
> > repositories are used by distributions has always been the case and is
> > also
> > encouraged.
> > 
> > Cheers
> > Martin
> 
> ___
> kde-community mailing list
> kde-community@kde.org
> https://mail.kde.org/mailman/listinfo/kde-community


signature.asc
Description: This is a digitally signed message part.
___
kde-community mailing list
kde-community@kde.org
https://mail.kde.org/mailman/listinfo/kde-community

Re: [kde-community] Kubuntu documentation

2013-12-14 Thread Albert Astals Cid
El Dissabte, 14 de desembre de 2013, a les 11:35:23, Martin Graesslin va 
escriure:
> On Saturday 14 December 2013 01:54:50 Valorie Zimmerman wrote:
> > Hi folks,
> > 
> > Recently I wrote to the KDE Docs team and KDE WWW team asking for
> > permission to put working copies of the Kubuntu documentation on the
> > Userbase wiki. Albert raised an interesting objection, which I can
> > only bring to this group for discussion.
> > 
> > Kubuntu isn't a KDE project under the Manifesto definition. Even
> > though our users are by definition KDE users, it is true that all KDE
> > developers do not have write permissions to the Kubuntu codebase,
> > since our packages are hosted on Canonical servers.
> 
> I don't see the problem at the moment. Albert, could you please elaborate on
> your reasoning. For me it looks like KDE would just provide some more
> "source code" which can be packaged by the distribution. 

Just that this "source code" will be distribution specific.

You can see the original thread at 
http://lists.kde.org/?t=13865491802&r=1&w=2

Cheers,
  Albert

> That our
> repositories are used by distributions has always been the case and is also
> encouraged.
> 
> Cheers
> Martin

___
kde-community mailing list
kde-community@kde.org
https://mail.kde.org/mailman/listinfo/kde-community


Re: [kde-community] Kubuntu documentation

2013-12-14 Thread Martin Graesslin
On Saturday 14 December 2013 01:54:50 Valorie Zimmerman wrote:
> Hi folks,
> 
> Recently I wrote to the KDE Docs team and KDE WWW team asking for
> permission to put working copies of the Kubuntu documentation on the
> Userbase wiki. Albert raised an interesting objection, which I can
> only bring to this group for discussion.
> 
> Kubuntu isn't a KDE project under the Manifesto definition. Even
> though our users are by definition KDE users, it is true that all KDE
> developers do not have write permissions to the Kubuntu codebase,
> since our packages are hosted on Canonical servers.
I don't see the problem at the moment. Albert, could you please elaborate on 
your reasoning. For me it looks like KDE would just provide some more "source 
code" which can be packaged by the distribution. That our repositories are 
used by distributions has always been the case and is also encouraged.

Cheers
Martin

signature.asc
Description: This is a digitally signed message part.
___
kde-community mailing list
kde-community@kde.org
https://mail.kde.org/mailman/listinfo/kde-community

[kde-community] Kubuntu documentation

2013-12-14 Thread Valorie Zimmerman
Hi folks,

Recently I wrote to the KDE Docs team and KDE WWW team asking for
permission to put working copies of the Kubuntu documentation on the
Userbase wiki. Albert raised an interesting objection, which I can
only bring to this group for discussion.

Kubuntu isn't a KDE project under the Manifesto definition. Even
though our users are by definition KDE users, it is true that all KDE
developers do not have write permissions to the Kubuntu codebase,
since our packages are hosted on Canonical servers.

I'll reproduce my original email so you can judge for yourself:


Hi folks, I know this is a bit unusual, but I'm writing to both the
Doc team and web team simultaneously because the Kubuntu Doc team has
a problem, and it is possible y'all can help us, if you are willing.

Right now, we develop our documentation on the ubuntu wiki system,
which is MoinMoin. This works well in that there is a low bar to entry
for new folks, and errors can be fixed on the fly. Of course much of
the documentation our users need is either on the Ubuntu system or the
excellent KDE system, and much of our docs merely points or includes
that material.

There are problems as well. Moinmoin has no good system for exporting
docs to Docbook so they can be included in the ISO, and there is no
easy way to let translators help us internationalize once the
documentation is complete and up-to-date.

We wonder if it would be possible to move our wiki over to the KDE
mediawiki system, with its wonderful translator helps. We could do
this either as a standalone part of the system, sort of off to the
side, or what we would prefer: be an actual part of Userbase, as part
of /Distributions or similar.

After translations are done, then perhaps we can get the help of the
Doc team to get the Docbook magic done, so that we have the necessary
packages to distribute to our users.

A few of us have brought some of these ideas to the teams in IRC, but
we're getting to the time in the release cycle where we have to make
some decisions.

What do you think?


And in another email in that conversation:

We want to move the docs *wiki* to the KDE wiki system.

We present our finished docs in two places: the most important is in
the ISO, and the other is on http://docs.kubuntu.org. So our finished
docs wouldn't change, except that we hope that we will also have
translations. Right now, we have none of those wonderful translations.

IF the web team is cool with us using the KDE userbase wiki to work on
Kubuntu docs, then we will write to the translation teams and see if
they are willing to help us out that way. There are Kubuntu
translators who are willing to help as well, but there is no easy way
for them to do that right now. The userbase translation plugin would
be really helpful to us.

I think it would be difficult for KDE to allow us to present our
finished docs on kde.org infra, when other distros don't do this.

And later yet;

Kubuntu users ARE KDE users, and most of our Kubuntu people are active
directly in KDE too. One of my ulterior goals for using KDE infra for
part of our work process is to get those who aren't working directly
for KDE used to doing so.

Well-translated docs helps us all.

It is possibly true that we could install mediawiki on our Kubuntu.org
server, and some of the guys want to do that. I think that without the
excellent support of both the web-team AND the underlying sysadmin
support, that wiki would slowly become a cesspit of spam.

The Canonical sysadmins are rather remote and unresponsive. I doubt we
could get them to do such a major install in less than months, if not
years. Probably if we can't get KDE community buy-in, then we'll
continue to limp along on moinmoin, and lack much translation.


Again, I realize that this is an unusual request, but we hope, as part
of the KDE community, that we can get permission to use a part of the
Userbase wiki, and use the talent and experience of KDE translators
working with us on our documentation.

All the best,

Valorie
-- 
http://about.me/valoriez
___
kde-community mailing list
kde-community@kde.org
https://mail.kde.org/mailman/listinfo/kde-community