Using userbase for manuals

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 but developers don’t use it that much, nor is there any links from
applications towards Userbase."

Well, actually we have. I replaced the offline help documentation in Krita with a link to the manual on
userbase. I have done this for two reasons:

* I couldn't maintain the offline manual anyway after the change to 2.0
* this way the user gets sent right to the place where they can contribute to the manual (and I've got users
contributing to it now)

I'm not concerned that users cannot access the help when they are off-line. That's a vanishingly rare
situation these days, the big thing is that it gets users right where they can fix the manual (Except on
windows, where the browser invocation seems broken).

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

--

-- 
Boudewijn Rempt
http://www.valdyas.org, http://www.krita.org, http://www.boudewijnrempt.nl

Re: Using userbase for manuals

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 said in his blog
> (http://blog.neverendingo.de/?p=125)
> 
> "We have a great userbase.kde.org but developers don’t use it that much, nor
> is there any links from applications towards Userbase."
> 
> Well, actually we have. I replaced the offline help documentation in Krita
> with a link to the manual on userbase. I have done this for two reasons:
> 
> * I couldn't maintain the offline manual anyway after the change to 2.0
> * this way the user gets sent right to the place where they can contribute
> to the manual (and I've got users contributing to it now)
> 
> 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 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 I 
can't read the manual.

Cheers,
  Albert

> the big thing is that it

Re: Using userbase for manuals

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 is confusing. The customs 
made its focus evolve over time, I think nowadays it's really the forum where 
the different KDE teams meet. It's really "kde-townhall" IMO. Anyway... I'm 
sidetracking a bit. 

> 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’t use it that much, nor
> is there any links from applications towards Userbase."
> 
> Well, actually we have. I replaced the offline help documentation in Krita
> with a link to the manual on userbase. I have done this for two reasons:
> 
> * I couldn't maintain the offline manual anyway after the change to 2.0
> * this way the user gets sent right to the place where they can contribute
> to the manual (and I've got users contributing to it now)

I think that would be a great improvement. The current way we deal with user 
documentation just doesn't scale. Trying to foster at this easier to 
contribute even from users documentation would help greatly with that. If we 
can get more user engagement that'd be a win for our community.

Re: Using userbase for manuals

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
> > 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 but developers don’t use it that much,
> > nor is there any links from applications towards Userbase."
> > 
> > Well, actually we have. I replaced the offline help documentation in Krita
> > with a link to the manual on userbase. I have done this for two reasons:
> > 
> > * I couldn't maintain the offline manual anyway after the change to 2.0
> > * this way the user gets sent right to the place where they can contribute
> > to the manual (and I've got users contributing to it now)
> > 
> > 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 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 I can't read the manual.

It's all very hypothetical isn't it? 

Re: Using userbase for manuals

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 I can't read the manual.

I agree with you. Another situation is when traveling or when you are in a 
country with roaming phone connection. There might also be closed down network 
with KDE application, where you don't have full internet access.

Andras

Re: Using userbase for manuals

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.
> > > 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 but developers don’t use it that much,
> > > nor is there any links from applications towards Userbase."
> > > 
> > > Well, actually we have. I replaced the offline help documentation in
> > > Krita
> > > with a link to the manual on userbase. I have done this for two reasons:
> > > 
> > > * I couldn't maintain the offline manual anyway after the change to 2.0
> > > * this way the user gets sent right to the place where they can
> > > contribute
> > > to the manual (and I've got users contributing to it now)
> > > 
> > > 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 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

Re: Using userbase for manuals

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’t use it that much,
> > nor is there any links from applications towards Userbase."
> > 
> > Well, actually we have. I replaced the offline help documentation in Krita
> > with a link to the manual on userbase. I have done this for two reasons:
> > 
> > * I couldn't maintain the offline manual anyway after the change to 2.0
> > * this way the user gets sent right to the place where they can contribute
> > to the manual (and I've got users contributing to it now)
> > 
> > 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 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 I can't read the manual.

+1

There are lot of nice places on this planet where there is no (good or cheap) 

Review Request: Do not leave dangling pointers in KToolbar when xml clients die

Re: Fwd: Re: Kontact Crashes at Startup for One User Only

James Booth wrote:

> For future reference for anyone else that has this problem, Andras's
> suggestion worked. Thanks!

Sorry, I forgot to send to the list (didn't check the To field).

Did you make a bug report?

Andras

Re: Review Request: remove KEncodingDetector from tier1/kcodecs