Re: Using userbase for manuals

2012-07-04 Thread Chusslove Illich
>> [: Aurélien Gâteau :] >> I know at least one wiki which is git-based: [...] > > [: Ingo Malchow :] > [...] > Additionally we will loose support for quite some plugins, most notably > the translate extension, which is integral part of this entire discussion. > So we would be back at manually copy

Re: Using userbase for manuals

2012-07-03 Thread Ingo Malchow
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 04.07.2012 00:04, schrieb Aurélien Gâteau: > Le mardi 3 juillet 2012 18:24:41 Ingo Malchow a écrit : >> In an ideal world we could really work around such issues with >> some semi-automated ways. Just an idea: Those who do like the >> idea of doing

Re: Using userbase for manuals

2012-07-03 Thread Aurélien Gâteau
Le mardi 3 juillet 2012 18:24:41 Ingo Malchow a écrit : > In an ideal world we could really work around such issues with some > semi-automated ways. > Just an idea: > Those who do like the idea of doing a manual in a online wiki could > just teach their respective users how to properly format their

Re: Using userbase for manuals

2012-07-03 Thread Ingo Malchow
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 03.07.2012 18:07, schrieb Aurélien Gâteau: > Le mardi 3 juillet 2012 15:18:37 Ingo Malchow a écrit : >> -BEGIN PGP SIGNED MESSAGE- Hash: SHA1 >> >> Am 03.07.2012 14:00, schrieb Aurélien Gâteau: >>> Le lundi 2 juillet 2012 07:01:06 Inge Wall

Re: Using userbase for manuals

2012-07-03 Thread Aurélien Gâteau
Le mardi 3 juillet 2012 15:18:37 Ingo Malchow a écrit : > -BEGIN PGP SIGNED MESSAGE- > Hash: SHA1 > > Am 03.07.2012 14:00, schrieb Aurélien Gâteau: > > Le lundi 2 juillet 2012 07:01:06 Inge Wallin a écrit : > >> Now, the suggestion was to move to a wiki instead > >> > >> Advantages: 1. Ea

Re: Using userbase for manuals

2012-07-03 Thread Ingo Malchow
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 03.07.2012 14:00, schrieb Aurélien Gâteau: > Le lundi 2 juillet 2012 07:01:06 Inge Wallin a écrit : >> Now, the suggestion was to move to a wiki instead >> >> Advantages: 1. Easier to find the documentation for potential >> writers. 2. (Supposedly)

Re: Using userbase for manuals

2012-07-03 Thread Aurélien Gâteau
Le lundi 2 juillet 2012 07:01:06 Inge Wallin a écrit : > Now, the suggestion was to move to a wiki instead > > Advantages: > 1. Easier to find the documentation for potential writers. > 2. (Supposedly) easier to edit [Personally I'm not sure that editing > advanced wiki markup is easier than docbo

Re: About Writing Documentation in KDE (was: Using userbase for manuals)

2012-07-03 Thread Chusslove Illich
> [: Albert Astals Cid :] > [...] I also want to note that developers that do not write documentation > in docbook and that do not translate manuals are suggesting to switch to > wiki (even if they agree they won't write documentation anyway) [...] Well, that is an elephant in the room. I too susp

Re: Using userbase for manuals

2012-07-03 Thread Kevin Ottens
On Sunday 1 July 2012 09:49:11 Kevin Ottens wrote: > [...] > My opinion is that I would love to go for it, and if over time that turns > out to be a problem, we could ship a dump of the relevant wiki content > along the application. It'd be used as fallback if the wiki cannot be > reached online.

Re: Using userbase for manuals

2012-07-02 Thread Boudewijn Rempt
On Sunday 01 July 2012 Jul, Anne Wilson wrote: > I'm not subscribed to this list, so please cc me in any replies. Sort of proves my point that Mirko is right and that we need a KDE-wide mailing list for all contributors. <...> > Boud - I'm not arguing, but is email notification essential? May

Re: Using userbase for manuals

2012-07-02 Thread Boudewijn Rempt
On Sunday 01 July 2012 Jul, Yuri Chornoivan wrote: > Hi, > > Just a minor remarks on using UserBase for documentation. > > 1. It does not matter where you *do not* write your documentation. > > New Krita manual was started 5-01-2010 [1]. For now, it is not ready even > at 1/10 level. The activ

Re: About Writing Documentation in KDE (was: Using userbase for manuals)

2012-07-02 Thread Albert Astals Cid
El Dilluns, 2 de juliol de 2012, a les 01:45:14, Dominik Haumann va escriure: > Hi everyone, > > so let's sum up and get back to arguments. > > 1. Versioning for our KDE SC Releases > It was mentioned that a wiki automatically provides versioning. However, > what is completely not covered, yet, i

Re: Using userbase for manuals

2012-07-01 Thread Inge Wallin
On Sunday, July 01, 2012 07:02:28 Boudewijn Rempt wrote: > I'm actually not sure kde-core-devel is the right list... But the e.V. > mailing list certainly isn't, and we don't seem to have any place for > discussions that affect KDE as a whole. > > In any case, Ingo Malchow said in his blog > (http

About Writing Documentation in KDE (was: Using userbase for manuals)

2012-07-01 Thread Dominik Haumann
Hi everyone, so let's sum up and get back to arguments. 1. Versioning for our KDE SC Releases It was mentioned that a wiki automatically provides versioning. However, what is completely not covered, yet, is the fact that we have different KDE SC releases. There is not 'branching' support for th

Re: Using userbase for manuals

2012-07-01 Thread Ingo Malchow
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 01.07.2012 23:19, schrieb Chusslove Illich: >>> [: Chusslove Illich :] I further argue that, if people who are >>> accustomed to version control find web-something-thingy (such >>> as wiki) optimal for their documentation writing workflow, >>> somet

Re: Using userbase for manuals

2012-07-01 Thread Chusslove Illich
>> [: Chusslove Illich :] >> I further argue that, if people who are accustomed to version control >> find web-something-thingy (such as wiki) optimal for their documentation >> writing workflow, something has gone horribly wrong; > > [: Ingo Malchow :] > Sorry, not sure i get you here. Do you mean

Re: Using userbase for manuals

2012-07-01 Thread Eike Hein
On 07/01/2012 09:56 PM, Chusslove Illich wrote: I further argue that, if people who are accustomed to version control find web-something-thingy (such as wiki) optimal for their documentation writing workflow, something has gone horribly wrong; and that efficiency of writing and maintenance, as we

Re: Using userbase for manuals

2012-07-01 Thread Ingo Malchow
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 01.07.2012 21:56, schrieb Chusslove Illich: >> [: Burkhard Lück :] That's really crazy [...] similar to Yuri I >> found it easy to write docbook markup. > > While to me Docbook is simply less bad than other things, so I use > Docbook when I want to

Re: Using userbase for manuals

2012-07-01 Thread Chusslove Illich
> [: Burkhard Lück :] > But what I really don't understand, why a devel writing C/C++ code says > "xml is just a form of binary". Hey, some devel writing Lisp code say C++ is just a form of binary. Doesn't really matter why. -- Chusslove Illich (Часлав Илић) signature.asc Description: This is

Re: Using userbase for manuals

2012-07-01 Thread Burkhard Lück
Am Sonntag, 1. Juli 2012, 21:56:16 schrieb Chusslove Illich: > > [: Burkhard Lück :] > > That's really crazy [...] similar to Yuri I found it easy to write > > docbook markup. > > While to me Docbook is simply less bad than other things, so I use Docbook > when I want to document something about s

Re: Using userbase for manuals

2012-07-01 Thread Alexander Neundorf
On Sunday, 1. July 2012 10:22:41 Friedrich W. H. Kossebau wrote: > Hi, > > Am Sonntag, 1. Juli 2012, 09:21:08 schrieb Albert Astals Cid: > > El Diumenge, 1 de juliol de 2012, a les 08:02:28, Boudewijn Rempt va > > escriure: > > > In any case, Ingo Malchow said in his blog > > > (http://blog.never

Re: Using userbase for manuals

2012-07-01 Thread Chusslove Illich
> [: Burkhard Lück :] > That's really crazy [...] similar to Yuri I found it easy to write docbook > markup. While to me Docbook is simply less bad than other things, so I use Docbook when I want to document something about software (if I didn't need HTML pages, I'd use Latex instead). And when Ma

Re: Using userbase for manuals

2012-07-01 Thread Burkhard Lück
Am Sonntag, 1. Juli 2012, 20:33:26 schrieb Martin Gräßlin: > Am 01.07.2012 17:45, schrieb Chusslove Illich: > > But, when program authors do decide that they want to have reference > > documentation, I don't see how any workflow can be technically more > > suitable > > (easier to write, easier to m

Re: Using userbase for manuals

2012-07-01 Thread Martin Gräßlin
Am 01.07.2012 17:45, schrieb Chusslove Illich: But, when program authors do decide that they want to have reference documentation, I don't see how any workflow can be technically more suitable (easier to write, easier to maintain) than the documentation source files residing right with the cod

Re: Using userbase for manuals

2012-07-01 Thread Chusslove Illich
>> [: Chusslove Illich :] >> [...] Could it be that you are simply driven away by the Docbook's >> towering hulk? :) > > [: Eike Hein :] > Yes - that's basically what I alluded to re "gives you easy preview". Right, so there are a few ways to think about this. One is that even wanting a preview w

Re: Using userbase for manuals

2012-07-01 Thread Eike Hein
On 07/01/2012 05:45 PM, Chusslove Illich wrote: _From my viewpoint, that which is on Konversation wiki is not reference documentation, which you too implied in the preceding text; and not having reference is completely fine by me, as I mentioned above. Even so, how comes this existing content on

Re: Using userbase for manuals

2012-07-01 Thread Chusslove Illich
(Many things have been already pointed out, but I'll repeat, to hopefully frame it a bit more concretely.) The way I see it, there are really three conceptually independent aspects here: 1) Documentation should be up to date, promtly reacting to changes in program features and behavior. 2) Docum

Re: Using userbase for manuals

2012-07-01 Thread Eike Hein
On 07/01/2012 03:28 PM, Anne Wilson wrote: Eike - there is a Special:RecentChangesLinked - have you explored the possibility of that working for you? Visiting a page == polling. -- Best regards, Eike Hein

Re: Using userbase for manuals

2012-07-01 Thread Ingo Malchow
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 01.07.2012 15:33, schrieb Albert Astals Cid: > El Diumenge, 1 de juliol de 2012, a les 14:37:44, Alexander Dymo va > escriure: >> 2012/7/1 Eike Hein : >>> Ultimately Albert isn't wrong with his concern, but the >>> reality seems to be that we just c

Re: Using userbase for manuals

2012-07-01 Thread Anne Wilson
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 I'm not subscribed to this list, so please cc me in any replies. This thread was pointed out to me, and I'd like to comment on some of the points raised. Off-line documentation - There is an extension, Collections, which allows users to select pages

Re: Using userbase for manuals

2012-07-01 Thread Kevin Ottens
On Sunday 1 July 2012 14:49:59 Ingo Malchow wrote: > Actually no need to. Translations can already be exported/imported as > po files. One of the benefits of the translate extension (which was > highlighted today in a talk at akademy ;) And docbook export is also > something that is being tested. I

Re: Using userbase for manuals

2012-07-01 Thread Albert Astals Cid
El Diumenge, 1 de juliol de 2012, a les 14:37:44, Alexander Dymo va escriure: > 2012/7/1 Eike Hein : > > Ultimately Albert isn't wrong with his concern, but the reality > > seems to be that we just can't get our act together on the > > offline documentation while maintaining the wiki comes a lot >

Re: Using userbase for manuals

2012-07-01 Thread Ingo Malchow
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 01.07.2012 13:14, schrieb Kevin Ottens: > On Sunday 1 July 2012 10:17:21 Albert Astals Cid wrote: >> El Diumenge, 1 de juliol de 2012, a les 09:49:11, Kevin Ottens va >> escriure: >>> More seriously, I think we shouldn't loose perspective here. >>>

Re: Using userbase for manuals

2012-07-01 Thread Yuri Chornoivan
написане Sun, 01 Jul 2012 10:49:11 +0300, Kevin Ottens : On Sunday 1 July 2012 09:21:08 Albert Astals Cid wrote: El Diumenge, 1 de juliol de 2012, a les 08:02:28, Boudewijn Rempt va escriure: > I'm actually not sure kde-core-devel is the right list... But the e.V. > mailing list certainly isn

Re: Using userbase for manuals

2012-07-01 Thread Burkhard Lück
Am Sonntag, 1. Juli 2012, 13:14:19 schrieb Kevin Ottens: > On Sunday 1 July 2012 10:17:21 Albert Astals Cid wrote: > > El Diumenge, 1 de juliol de 2012, a les 09:49:11, Kevin Ottens va escriure: > > > More seriously, I think we shouldn't loose perspective here. Yes, > > > you're right, it *can* ha

Re: Using userbase for manuals

2012-07-01 Thread Eike Hein
On 07/01/2012 01:35 PM, Boudewijn Rempt wrote: I just got that :-). I'm very happy with it, but Eike is right that it probably wouldn't scale, being a poller. It's really something that needs to be fixed in the wiki system, so we can get a mail for every change to a manual done in the wiki. I'

Re: Using userbase for manuals

2012-07-01 Thread Christoph Cullmann
> On 07/01/2012 07:02 AM, Boudewijn Rempt wrote: > > After yesterday's discussion where David said that for > > frameworks/qt5 the help center invocation is actually one of the > > trickier things, I'm giving this out for consideration for other > > app developers... > > Over at Konversation we've

Re: Using userbase for manuals

2012-07-01 Thread Dominik Haumann
Hi, On Sunday, July 01, 2012 09:21:08 AM Albert Astals Cid wrote: > El Diumenge, 1 de juliol de 2012, a les 08:02:28, Boudewijn Rempt > > I'm not concerned that users cannot access the help when they are > > off-line. That's a vanishingly rare situation these days > > I disagree, as a matter of f

Re: Using userbase for manuals

2012-07-01 Thread Alexander Dymo
2012/7/1 Eike Hein : > Ultimately Albert isn't wrong with his concern, but the reality > seems to be that we just can't get our act together on the > offline documentation while maintaining the wiki comes a lot > easier to us. And it's better to have wiki documentation than > no good documentation,

Re: Using userbase for manuals

2012-07-01 Thread Boudewijn Rempt
On Sunday 01 July 2012 Jul, Boudewijn Rempt wrote: > On Sunday 01 July 2012 Jul, Eike Hein wrote: > > On 07/01/2012 07:02 AM, Boudewijn Rempt wrote: > > > After yesterday's discussion where David said that for frameworks/qt5 the > > > help center invocation is actually one of the trickier things,

Re: Using userbase for manuals

2012-07-01 Thread Boudewijn Rempt
On Sunday 01 July 2012 Jul, Kevin Ottens wrote: > > And i'm going to be a pain here, but i do not agree userbase scale better > > either. > > Let's see Krita manual at http://userbase.kde.org/Krita it's translated to 7 > > languages only two of them being at 100% > > > > Now let's see KMail manual

Re: Using userbase for manuals

2012-07-01 Thread Kevin Ottens
On Sunday 1 July 2012 10:17:21 Albert Astals Cid wrote: > El Diumenge, 1 de juliol de 2012, a les 09:49:11, Kevin Ottens va escriure: > > More seriously, I think we shouldn't loose perspective here. Yes, you're > > right, it *can* happen, but Boudewijn is also right, it's becoming rare > > situatio

Re: Using userbase for manuals

2012-07-01 Thread Boudewijn Rempt
On Sunday 01 July 2012 Jul, Eike Hein wrote: > On 07/01/2012 07:02 AM, Boudewijn Rempt wrote: > > After yesterday's discussion where David said that for frameworks/qt5 the > > help center invocation is actually one of the trickier things, I'm giving > > this out for consideration for other app de

Re: Using userbase for manuals

2012-07-01 Thread Eike Hein
On 07/01/2012 07:02 AM, Boudewijn Rempt wrote: After yesterday's discussion where David said that for frameworks/qt5 the help center invocation is actually one of the trickier things, I'm giving this out for consideration for other app developers... Over at Konversation we've likewise struggl

Re: Using userbase for manuals

2012-07-01 Thread Friedrich W. H. Kossebau
Hi, Am Sonntag, 1. Juli 2012, 09:21:08 schrieb Albert Astals Cid: > El Diumenge, 1 de juliol de 2012, a les 08:02:28, Boudewijn Rempt va escriure: > > In any case, Ingo Malchow said in his blog > > (http://blog.neverendingo.de/?p=125) > > > > "We have a great userbase.kde.org but developers don’

Re: Using userbase for manuals

2012-07-01 Thread Albert Astals Cid
El Diumenge, 1 de juliol de 2012, a les 09:49:11, Kevin Ottens va escriure: > On Sunday 1 July 2012 09:21:08 Albert Astals Cid wrote: > > El Diumenge, 1 de juliol de 2012, a les 08:02:28, Boudewijn Rempt va > > escriure: > > > I'm actually not sure kde-core-devel is the right list... But the e.V.

Re: Using userbase for manuals

2012-07-01 Thread Andras Mantia
On Sunday, July 01, 2012 09:21:08 AM Albert Astals Cid wrote: > I disagree, as a matter of fact, I don't have internet connection in the > room in my hostel, so if i had a need to use krita I'd need to read its > manual (since my painting/drawing skills are null) and i'd be not happy to > discover

Re: Using userbase for manuals

2012-07-01 Thread Kevin Ottens
On Sunday 1 July 2012 09:21:08 Albert Astals Cid wrote: > El Diumenge, 1 de juliol de 2012, a les 08:02:28, Boudewijn Rempt va escriure: > > I'm actually not sure kde-core-devel is the right list... But the e.V. > > mailing list certainly isn't, and we don't seem to have any place for > > discussio

Re: Using userbase for manuals

2012-07-01 Thread Kevin Ottens
Hello, On Sunday 1 July 2012 08:02:28 Boudewijn Rempt wrote: > I'm actually not sure kde-core-devel is the right list... But the e.V. > mailing list certainly isn't, and we don't seem to have any place for > discussions that affect KDE as a whole. Well, I think nowadays the name of kde-core-devel

Re: Using userbase for manuals

2012-07-01 Thread Albert Astals Cid
El Diumenge, 1 de juliol de 2012, a les 08:02:28, Boudewijn Rempt va escriure: > I'm actually not sure kde-core-devel is the right list... But the e.V. > mailing list certainly isn't, and we don't seem to have any place for > discussions that affect KDE as a whole. > > In any case, Ingo Malchow sa

Using userbase for manuals

2012-06-30 Thread Boudewijn Rempt
I'm actually not sure kde-core-devel is the right list... But the e.V. mailing list certainly isn't, and we don't seem to have any place for discussions that affect KDE as a whole. In any case, Ingo Malchow said in his blog (http://blog.neverendingo.de/?p=125) "We have a great userbase.kde.org