From kde-doc-english Wed Dec 11 15:26:56 2013 From: Sayak Banerjee Date: Wed, 11 Dec 2013 15:26:56 +0000 To: kde-doc-english Subject: Re: [kde-doc-english] Kubuntu documentation Message-Id: X-MARC-Message: https://marc.info/?l=kde-doc-english&m=138677587829544 MIME-Version: 1 Content-Type: multipart/mixed; boundary="--===============8566409537906434736==" --===============8566409537906434736== Content-Type: multipart/alternative; boundary=047d7bb03a502c15b504ed43dd92 --047d7bb03a502c15b504ed43dd92 Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: quoted-printable From a webteam standpoint, I see no problems with Kubuntu team using the wiki. The only thing if at all is whether the end user will be using userbase.kde.org for their reference, because that might lead to some confusion (if not branding issues). But since the plan is to move the final docs back to docs.kubuntu.org, I don't see why that can't be done. Just a thought though - we use Mediawiki on all our wikis. It is far more powerful and popular than Moinmoin. Perhaps Canonical sysadmins can also set up a Mediawiki instance on one of the ubuntu servers? That is if you want to kee= p using a kubuntu.org domain for the wiki as well. Regards, *Sayak Banerjee* KDE Sysadmin =95 KDE e.V. Member sayakb@kde.org | mail@sayakbanerjee.com On Tue, Dec 10, 2013 at 11:58 PM, Valorie Zimmerman < valorie.zimmerman@gmail.com> wrote: > On Tue, Dec 10, 2013 at 11:17 AM, Albert Astals Cid wrote= : > > El Diumenge, 8 de desembre de 2013, a les 16:31:20, Valorie Zimmerman v= a > > escriure: > >> 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? > > > > Just to make sure I understand, Kubuntu wants to move all it's > documentation > > away from its existing *ubuntu* domain to *kde* domain? > > > > Cheers, > > Albert > > Hi Albert, > > 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. > > Valorie > -- > http://about.me/valoriez > _______________________________________________ > kde-www mailing list > kde-www@kde.org > https://mail.kde.org/mailman/listinfo/kde-www > --047d7bb03a502c15b504ed43dd92 Content-Type: text/html; charset=windows-1252 Content-Transfer-Encoding: quoted-printable
From a webteam standpoint, I see no problems with Kubuntu = team using the wiki.

The only thing if at all is whether= the end user will be using userbase.kd= e.org
for their reference, because that might lead to some confusion (if not= branding=A0
issues). But since the plan is to move the final doc= s back to docs.kubuntu.org,
I don't see why that can't be done.

Just a= thought though - we use Mediawiki on all our wikis. It is far more powerfu= l
and popular than Moinmoin. Perhaps Canonical sysadmins can also= set up a
Mediawiki instance on one of the ubuntu servers? That is if you want t= o keep
using a kubuntu.org dom= ain for the wiki as well.

Regards,
Sayak Banerjee
KDE Sysadmin=A0=95 KDE e.V. Member


On Tue, Dec 10, 2013 at 11:58 PM, Valori= e Zimmerman <valorie.zimmerman@gmail.com> wrote:
On Tue, Dec 10, 2013 at 11:17 AM, A= lbert Astals Cid <aacid@kde.org>= wrote:
> El Diumenge, 8 de desembre de 2013, a les 16:31:20, Valorie Zimmerman = va
> escriure:
>> Hi folks, I know this is a bit unusual, but I'm writing to bot= h 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 wi= lling.
>>
>> 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 e= ntry
>> 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 includ= es
>> that material.
>>
>> There are problems as well. Moinmoin has no good system for export= ing
>> docs to Docbook so they can be included in the ISO, and there is n= o
>> 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 p= art
>> of /Distributions or similar.
>>
>> After translations are done, then perhaps we can get the help of t= he
>> Doc team to get the Docbook magic done, so that we have the necess= ary
>> 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 t= o make
>> some decisions.
>>
>> What do you think?
>
> Just to make sure I understand, Kubuntu wants to move all it's doc= umentation
> away from its existing *ubuntu* domain to *kde* domain?
>
> Cheers,
> =A0 Albert

Hi Albert,

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 i= nfra, when other distros don't do this.

Valorie
--
http://about.me/valo= riez
_____________________= __________________________
kde-www mailing list
kde-www@kde.org
https://mail.kde.org/mailman/listinfo/kde-www

--047d7bb03a502c15b504ed43dd92-- --===============8566409537906434736== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline _______________________________________________ kde-doc-english mailing list kde-doc-english@kde.org https://mail.kde.org/mailman/listinfo/kde-doc-english --===============8566409537906434736==--