Update userbase.kde.org and remove outdated information
Open, Needs TriagePublic

Description

The wiki for our end users (located at userbase.kde.org) is feeling outdated in various aspects. Current problems:

  • Most screenshots from applications are very old (> 2 years), and give a bad first impression towards a potential user
  • There are still many references to unmaintained versions ( "KDE 4" appears ~2000 times)
  • The Glossary site misses important terms (such as Breeze) but includes ancient things (e.g. aRts)
  • We assume that all our users run Linux as their operating system; this is clearly no longer correct. We therefore need to include more information targeted at Windows/Mac OS users
  • Application pages are often nearly empty (e.g. the one from KDevelop)
  • ...

The Userbase is an important part of the user experience: they can find answers and "Getting Started" pages there and expect to find correct and polished information. It is therefore also important that we as KDE can stand up to those expectations as to ensure the satisfaction of our users.
We should consider doing a general cleanup of the whole wiki content which could for example be done like this:

  • Flag every page/image that is outdated or a stub
  • Remove unnecessary pages if needed
  • Assign people who will update application screenshots when needed (maybe twice a year)
  • Make sure that prominent pages (https://userbase.kde.org/What_is_KDE, https://userbase.kde.org/Tutorials, etc...) are up-to-date, rewrite if needed
  • Coordinate effort with translators to ensure a quick rollout for other languages

I do have a lot of free time in the next month and would be willing to spearhead this effort if this is wanted.
Feedback is greatly appreciated!

ognarb added a subscriber: ognarb.Sep 26 2018, 10:11 PM
This comment was removed by ognarb.
This comment was removed by ognarb.
ognarb added a comment.EditedSep 28 2018, 10:36 PM

In the last two days, I updated a lot of screenshot (not all are yet displayed, because of some sort of cache). I found out that, the page structure differ from an application page to an other and I think it would be better if we create a template, so that the user can find more easily information.

Some think like this:

  • Section 1: Short description with main function, functionality, difference with other similar software, target user... (Shouldn't be bigger that 3 paragraphs) -1 or 2 screenshots
  • Section 2: How to install (=> link to the software installation page)
  • Section 3: A guide how to use the main functionalities. Don't need to contains all functionalities, we already have the tutorials for that. Screenshot can be useful here.
  • Section 4 (optional): Link to some specific tutorials/tip and tricks (=> existing tutorial pages) and we should then remove the page listing all tutorials.
  • Section 5: How to get help. link to forum, bug tracker, telegram user group, forum, irc, ...

It is a good idea?

It's great to hear that you've already been updating screenshots on userbase @ognarb ! I am currently on vacation, so I won't be able to help you until next week. +1 for your proposal, we really need a more clearly defined structure for the application pages. I also experienced some problems when updating screenshots, this might be related to the fact that userbase currently needs to be based upon an older version of MediaWiki. If the problem persists we should ask the Sysadmin team if they could take a look.

Hi, I still updating screenshot. Do you have an idea that we should do we article about app that are 'dead'?

yurchor added a subscriber: yurchor.Oct 3 2018, 1:38 PM

Hi, I still updating screenshot. Do you have an idea that we should do we article about app that are 'dead'?

Nothing is really "dead" in the open source world. These applications can be revived some day. So I'd like their pages to be kept as is. However, if you like, you can remove their items from the list (category) pages.

Thanks in advance for your work.

ognarb added a comment.EditedNov 18 2018, 11:58 AM

So I'm still updating screenshot, there is really a lot of them. ;) I also created a not complete list of all page where the screenshot are up to date or not.

done
https://userbase.kde.org/KSysGuard
https://userbase.kde.org/Konsole
https://userbase.kde.org/Yakuake
https://userbase.kde.org/Dolphin
https://userbase.kde.org/Krusader
https://userbase.kde.org/KWrite
https://userbase.kde.org/KDE_Partition_Manager
https://userbase.kde.org/Power_Devil
https://userbase.kde.org/KPackageKit (obsolete)
https://userbase.kde.org/KPackage (obsolete)
https://userbase.kde.org/Discover
https://userbase.kde.org/Ark
https://userbase.kde.org/Filelight
https://userbase.kde.org/KDiff3
https://userbase.kde.org/KFind
https://userbase.kde.org/KFloppy (lol)
https://userbase.kde.org/KDE_Wallet_Manager
https://userbase.kde.org/Kleopatra
https://userbase.kde.org/KGpg
https://userbase.kde.org/Klipper (but need new icon)
https://userbase.kde.org/KAlarm
https://userbase.kde.org/KCharSelect
https://userbase.kde.org/KEuroCalc
https://userbase.kde.org/Kronometero
https://userbase.kde.org/KRuler
https://userbase.kde.org/KTimer
https://userbase.kde.org/RSIBreak
https://userbase.kde.org/Falkon
https://userbase.kde.org/Rekonq (obsolete)
https://userbase.kde.org/Plasma-browser-integration (maybe add screeshot)
https://userbase.kde.org/Telepathy
https://userbase.kde.org/ChoqoK
https://userbase.kde.org/KMess (obsolete)
https://userbase.kde.org/Quassel
https://userbase.kde.org/KGet
https://userbase.kde.org/KTorrent
https://userbase.kde.org/Akregator
https://userbase.kde.org/Trojitá (maybe add screenshot)
https://userbase.kde.org/KDEConnect
https://userbase.kde.org/Krdc
https://userbase.kde.org/KNetworkManager (obsolete)
https://userbase.kde.org/Gwenview
https://userbase.kde.org/Okular
https://userbase.kde.org/KGraphviewer
https://userbase.kde.org/Koko
https://userbase.kde.org/KPhotoAlbum
https://userbase.kde.org/KIconEdit (obsolete)
https://userbase.kde.org/SymbolEditor
https://userbase.kde.org/Spectacle
https://userbase.kde.org/KSnapshot
https://userbase.kde.org/KColorChooser
https://userbase.kde.org/Juk
https://userbase.kde.org/Kio-audiocd
https://userbase.kde.org/Kdenlive
https://userbase.kde.org/Phonon
https://userbase.kde.org/Words
https://userbase.kde.org/Sheets
https://userbase.kde.org/Kexi
https://userbase.kde.org/Stage
https://userbase.kde.org/Plan
https://userbase.kde.org/KJots
https://userbase.kde.org/KMediaFactory
https://userbase.kde.org/KMid
https://userbase.kde.org/KPilot (probably obsolete)
https://userbase.kde.org/Braindump

not done
https://userbase.kde.org/Konqueror
https://userbase.kde.org/Kate
https://userbase.kde.org/KCron
https://userbase.kde.org/Printer_Config
https://userbase.kde.org/KUser
https://userbase.kde.org/Apper (should be marked obsolete)
https://userbase.kde.org/System_Settings (need lot of work)
https://userbase.kde.org/KDiskFree
https://userbase.kde.org/KRename
https://userbase.kde.org/KHelpCenter
https://userbase.kde.org/KCalc
https://userbase.kde.org/KCharSelect
https://userbase.kde.org/Krecipes (need to look if this application is still maintained)
https://userbase.kde.org/Printer_Config
https://userbase.kde.org/Smb4K
https://userbase.kde.org/KSniffer (probably unmaintained)
https://userbase.kde.org/Kopete (main page is ok, but subcategories not)
https://userbase.kde.org/Konversation
https://userbase.kde.org/KMLDonkey
https://userbase.kde.org/KMail
https://userbase.kde.org/Blogilo
https://userbase.kde.org/Krfb
https://userbase.kde.org/KVpnc (probably obsolete)
https://userbase.kde.org/KPPP (probably obsolete)
https://userbase.kde.org/Bluedevil
https://userbase.kde.org/Showfoto (tutorial)
https://userbase.kde.org/Digikam (some screenshot are already updated but not all)
https://userbase.kde.org/Karbon (need a WPG example)
https://userbase.kde.org/KolourPaint (need a scanner)
https://userbase.kde.org/KXStitch
https://userbase.kde.org/Skanlite (need a scanner)
https://userbase.kde.org/Kooka (need a scanner)
https://phabricator.kde.org/source/kcoloredit/ (probably obsolete)
https://userbase.kde.org/Kbarcode (probably obsolete)
https://userbase.kde.org/KIPI
https://userbase.kde.org/Amarok
https://userbase.kde.org/KsCD
https://userbase.kde.org/Bangarang
https://userbase.kde.org/Dragon_Player
https://userbase.kde.org/KPlayer
https://userbase.kde.org/KMPlayer
https://userbase.kde.org/Kaffeine
https://userbase.kde.org/SMPlayer
https://userbase.kde.org/K3b
https://userbase.kde.org/K9Copy
https://userbase.kde.org/Kid3
https://userbase.kde.org/KMix
https://userbase.kde.org/Kwave
https://userbase.kde.org/Kamoso
https://userbase.kde.org/Audex
https://userbase.kde.org/Calligra_Author (probably obsolete)
https://userbase.kde.org/Kivio
https://userbase.kde.org/KOrganizer
https://userbase.kde.org/KAddressBook_4.4
https://userbase.kde.org/KNotes

unknow
https://userbase.kde.org/KFTPGrabber (obsolete page but no content)
https://userbase.kde.org/KuickShow

It's not complete because I only realized yesterday, that such a list can be helpful to me and others :)

I'm also thinking about writing a blog post, about how contributing to the wiki is an easy first contribution (was for me) and how people can also help. Opinion?

neofytosk added a subscriber: neofytosk.EditedNov 18 2018, 12:02 PM

I'm also thinking about writing a blog post, about how contributing to the wiki is an easy first contribution (was for me) and how people can also help. Opinion?

Do it and let us know when it's out! =) It's a great way to publicize this task, share your experience and hopefully inspire new contributors.

So I'm still updating screenshot, there is really a lot of them. ;) I also created a not complete list of all page where the screenshot are up to date or not.

Many thanks for your work.

not done
https://userbase.kde.org/Krecipes (need to look if this application is still maintained)

Never was completely ported to KDE 4, might be dead. One of my favorite KDE applications. Still can be run on ~1.5 years old distributions.

https://userbase.kde.org/K9Copy

Unmaintained (see the homepage: http://k9copy.sourceforge.net/ ).

https://userbase.kde.org/KMediaFactory

Unmaintained.

https://userbase.kde.org/KMid

Unmaintained.

https://userbase.kde.org/Calligra_Author (probably obsolete)

It is not, but Words (its base) is not developed with the previous pace.

https://userbase.kde.org/Kivio

The application should be merged with Karbon.

https://userbase.kde.org/Braindump

Unmaintained.

https://userbase.kde.org/KPilot (probably obsolete)

Yes. No Pilot devices on market anymore.

unknow
https://userbase.kde.org/KFTPGrabber (obsolete page but no content)

Unmaintained.

https://userbase.kde.org/KuickShow

https://cgit.kde.org/kuickshow.git/

Revived some time ago.

Thanks again for your work.

@yurchor Thanks for the information, I will update the list.

@neofytosk I started writing a blog post (https://carlschwan.eu/kde/wiki/2018/11/18/contributing-to-the-kde-userbase-wiki.html). It's not finish yet, but feedback before posting it to reddit/mastodon is welcome.

afarid added a subscriber: afarid.Nov 18 2018, 3:37 PM

Here are some Kdenlive one's if you like to use.

@afarid Thanks, I just saw that kdenlive also has a rich tutorial. I see that you are a Kdenlive dev, could you quickly look if the information is up-to-date. I can add new screenshot later.

@ognarb I am not a dev but part of the team. We will look into it and give you feedback. Thanks for updating the screenshots.

Hello, I'm now working on the system settings page. I created a temporary wiki page: https://userbase.kde.org/NewSystemSettings. For the moment I only did the appearance category. I tried to use the same icon and same configuration hierarchy as in the system settings app. And I also tried adding each time link to KDE doc, Arch Linux wiki and other tutorial on userbase in a more information section.

Can someone look at this and give me some improvement suggestion, before I start doing the rest?

ognarb claimed this task.Dec 3 2018, 11:46 PM
GB_2 added a subscriber: GB_2.Dec 4 2018, 1:48 PM

Looks great to me, keep it up! =)

Nearly all screenshots are now up-to-date 😄.

I'm also maintaining a small list of remaining pages: https://userbase.kde.org/User:Ognarb. If someone wants to help :)

You are amazing, thanks for your hard work! I'll see if I can help out this weekend.