Adapt KDE Apps to FlatHub's new guidelines
Closed, ResolvedPublic

Description

Motivation

Although not obligatory, adapting to the new guidelines (read them here) will improve our apps chances of being featured on the front page and offer a more unified look to our catalogue.

Report

You can read the report on how each of KDE's apps complies with the guidelines here. Note that 0 failures or not being on the list does not mean full compliance, just that the app may no have been revised yet.

IMPORTANT NOTICE

This task is now being coordinated by the Flatpak team. Please see

https://invent.kde.org/teams/flathub/issues/-/issues/24

and

https://invent.kde.org/packaging/flatpak-kde-applications/-/issues/5

to best adapt your app.

Please see this if you need any more clarifications.

IGNORE EVERYTHING UNDER THIS LINE


TODO

Before you begin:

  • If your app already meets all of the guidelines criteria in those three categories, just tick it as done.
  • Many of these things can be corrected by submitting a MR to change the apps *.appdata.xml file in the app's root repo directory. For example here
  • When fixing the naming, description or summary, remember to only touch the original English message! Do not modify the translations or your merge request won't be able to be merged, as these are handled differently.
  • Get list of all KDE apps on FlatHub - https://invent.kde.org/-/snippets/3078
  • Inform app maintainers of the new guidelines and request they start adapting their apps
  • Adapt apps
    • org.kde.akregator
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.alligator
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.amarok
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.angelfish
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.arianna
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.ark
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.artikulate
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.atlantik
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.audiotube
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.blinken
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.bomber
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.bovo
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.cantor
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.choqok
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.digikam
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.dolphin
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.elisa
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.falkon
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.filelight
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.francis
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.gcompris
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.granatier
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.gwenview
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.haruna
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.Ikona
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.index
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.isoimagewriter
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.itinerary
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.juk
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kaffeine
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kalgebra
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kalk
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kalzium
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kamoso
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kanagram
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kapman
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kasts
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kate
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.katomic
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kbibtex
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kblackbox
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kblocks
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kbounce
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kbreakout
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kbruch
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kcachegrind
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kcalc
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kclock
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kcolorchooser
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kdenlive
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kdevelop
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kdf
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kdiamond
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kdiff3
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.keysmith
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kfind
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kfourinline
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kgeography
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kgeotag
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kget
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kgoldrunner
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kgraphviewer
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.khangman
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kid3
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kig
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kigo
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kile
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.killbots
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kimagemapeditor
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kiriki
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kiten
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kjumpingcube
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kleopatra
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.klettres
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.klickety
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.klines
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kmahjongg
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kmines
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kmplayer
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kmplot
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kmymoney
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.knavalbattle
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.knetwalk
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.knights
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.koko
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kolf
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kollision
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kolourpaint
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kommit
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kompare
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kongress
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.konquest
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.konsole
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kontact
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kontrast
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.konversation
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kopete
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kpat
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kphotoalbum
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.krdc
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.krename
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kreversi
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.krita
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kronometer
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kruler
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.krusader
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kshisen
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.ksirk
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.ksnakeduel
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.ksquares
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kst
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kstars
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.ksudoku
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kteatime
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.ktechlab
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.ktimetracker
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.ktorrent
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.ktouch
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.ktrip
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.ktuberling
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kturtle
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kubrick
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kuiviewer
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kwalletmanager5
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kweather
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kwordquiz
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kwrite
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.kxstitch
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.labplot2
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.lokalize
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.lskat
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.marble
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.marknote
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.massif-visualizer
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.minuet
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.neochat
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.nota
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.okteta
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.okular
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.palapeli
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.parley
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.peruse
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.picmi
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.pix
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.plasmatube
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.qmlkonsole
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.rocs
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.ruqola
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.skanlite
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.skanpage
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.skrooge
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.spectacle
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.subtitlecomposer
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.SymbolEditor
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.tellico
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.telly-skout
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.tokodon
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.trojita
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.umbrello
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.vvave
      • Adapt naming
      • Adapt summary
      • Attach good screenshot
    • org.kde.yakuake
      • Adapt naming
      • Adapt summary
      • Attach good screenshot .
paulb created this task.Thu, Apr 11, 10:42 AM
paulb updated the task description. (Show Details)Thu, Apr 11, 10:59 AM
duha added a subscriber: duha.Thu, Apr 11, 11:24 AM
paulb updated the task description. (Show Details)Thu, Apr 11, 7:28 PM

If you fix the naming or the summary, please remember to only touch the original English message, not the translations, which are handled differently (or your merge request won't be able to be merged).

tgilgien updated the task description. (Show Details)Fri, Apr 12, 2:29 PM
paulb updated the task description. (Show Details)Fri, Apr 12, 4:27 PM
paulb updated the task description. (Show Details)
paulb added subscribers: adam, ikloecker.

For GCompris, it listed those 5 failures:

  • "branding-has-primary-brand-colors"
  • "app-icon-footprint"
  • "app-icon-in-line-with-contemporary-styles"
  • "app-summary-not-too-long"
  • "app-summary-no-weird-formatting"

I've made commits on our master branch to fix all of them, except "app-icon-in-line-with-contemporary-styles", as that icon is part of our branding and we don't want to change its shape (as they say in the guidelines: "In some cases, it can make sense for the icon to align with the visuals of the app, rather than contemporary icon styles (especially relevant for games)"). So I've just edited it to fit the "app-icon-footprint" part.

All those changes will land in our next major release.

About the 3 points listed in the task:

  • Adapt naming: our name formatting is also part of the brand and has good reasons to be this way, we won't change it (and as they say in the guidelines: "Cases where the formatting is part of an established brand may be exempt").
  • Adapt summary: that is now done (shortened and with sentence case).
  • Attach good screenshot: that's already the case.

So I'll tick all the boxes for gcompris.

timotheegiet updated the task description. (Show Details)
paulb closed this task as Resolved.Mon, Apr 15, 6:16 PM
paulb updated the task description. (Show Details)