Moving KDE Connect out of playground

Jeremy Whiting jpwhiting at kde.org
Tue Sep 15 16:06:40 BST 2015


I see your points and actually agree. I'm completely ok with having
help go to some online documentation on userbase. I see the
requirement for offline/included help documentation to be going down
lately as you say and completely moot for kdeconnect since it
technically requires an internet connection anyway.

Thanks for explaining the reasoning.

BR,
Jeremy

On Tue, Sep 15, 2015 at 9:01 AM, Albert Vaca <albertvaka at gmail.com> wrote:
> I don't think that having "descriptive documentation" (more about this
> later) is that important nowadays, and IMO users will likely google for help
> way before they use the help button when they find issues. Since most people
> I talked to in Randa agreed with me on this, I'm a bit surprised to find
> that you want to enforce this as a strong requirement. I can of course write
> a few lines to meet this requirement, but I would like to start a discussion
> to re-think why we are doing this.
>
> IMO, the kind of documentation that users need is not a list of every button
> in the KCM with a redundant description like the one we provide (probably
> because most projects write it just to meet the requirement), but instead
> answers to questions like "I see error X, what to do?". And this kind of
> help is easier to find online, in wikis, forums, etc. than in the static
> documentation we provide.
>
> Leaving aside the utility of having docs, they are yet another moving piece
> to maintain and likely to become outdated (eg: "Activity Settings" help
> shows a screenshot from KDE 4), specially in a piece of software in change
> like KDE Connect.
>
> To put an example of a similar case, Windows 10 completely removed the "Help
> Center" and now it sends you online to the MS site if you need help.
>
> Why don't we move our docs to the userbase wiki, and make it an open and
> live thing that users can update (ala Arch Linux wiki)? If there are no
> objections, I could start a page for KDE Connect there and make the help
> button in the KCM link to it. Also, since right now we don't have any
> numbers around how many poeple uses our help, moving it to the web would
> give us some nice analytics around it for free.
>
> Albert




More information about the kde-core-devel mailing list