| Summary: | Label names for Keyboard Shortcuts KCM: "KWin" and "plasmashell" names are more developer-friendly than user-friendly | ||
|---|---|---|---|
| Product: | [Applications] systemsettings | Reporter: | Michael <kde> |
| Component: | kcm_keys | Assignee: | Plasma Bugs List <plasma-bugs> |
| Status: | RESOLVED FIXED | ||
| Severity: | minor | CC: | 4wy78uwh, fanzhuyifan, kde, nate |
| Priority: | NOR | Keywords: | usability |
| Version First Reported In: | 6.1.4 | ||
| Target Milestone: | --- | ||
| Platform: | Neon | ||
| OS: | Linux | ||
| Latest Commit: | https://invent.kde.org/plasma/plasma-desktop/-/commit/ea2d29c71b62330d3cb6b63052eb26f8d5b3332c | Version Fixed In: | 6.4.0 |
| Sentry Crash Report: | |||
|
Description
Michael
2024-08-22 04:30:51 UTC
Makes sense A possibly relevant merge request was started @ https://invent.kde.org/plasma/kwin/-/merge_requests/6299 Not sure what plasmashell should be called. @nate do you have any comments here? Here are some ideas: Plasma Desktop Plasma Desktop Manager KDE Desktop Manager KDE Desktop Maybe KDE is better than plasma -- should we expect our users to know what plasma is and how it is different from kde? "plasmashell" could stand to be replaced with "Plasma Desktop", but the word "Plasma" is a user-facing brand name we use in a zillion places; I wouldn't replace this with something more generic. "KWin" is also brand name, though admittedly a more obscure one, so I'm slightly more in support or changing that to something descriptive. "Plasma Desktop" is fine, it's consistent and is promoted heavily. "KWin" is fine to be replaced with simply "Window manager" for end-user facing labels. If we were to prefix everything with "KDE" then we could easily go overboard because *everythin*g in System Settings is KDE technology. I would like to see the HIG talk about user-facing proper nouns. It goes over what our acronyms should be [https://develop.kde.org/hig/text_and_labels/#acronyms], but we don't have a common and congruent way of relating what "KWin" is. I'm thinking of opening a bug report for the HIG for user-facing KDE proper nouns so that we're all on the same page: Akonadi = ?? Baloo = ?? Powerdevil = KDE Power Management (maybe drop the KDE part?) KWin = ? Do we need this? It's a good point. We're currently not super consistent about how we present internal technologies to users; sometimes we use brand names, sometimes we use descriptive text, and often even if we surface descriptive text in the UI, we and other users use the brand name/internal name in social media. Feel free to open an Issue about it in https://invent.kde.org/documentation/develop-kde-org/-/issues/. Thanks for the encouragement. Done. https://invent.kde.org/documentation/develop-kde-org/-/issues/175 A possibly relevant merge request was started @ https://invent.kde.org/plasma/kwin/-/merge_requests/6304 Git commit af8de6be74009a2a16f7013d52a54bf96bc8a943 by Yifan Zhu. Committed on 23/08/2024 at 14:54. Pushed by fanzhuyifan into branch 'master'. KeyboardLayout: always set componentDisplayName for shortcut Otherwise the last call uses the default, which overrides the previous calls. Test plan: - Go to system settings - shortcuts - Verify the category for layout switching is now correctly called "Keyboard Layout Switcher" M +2 -0 src/keyboard_layout.cpp https://invent.kde.org/plasma/kwin/-/commit/af8de6be74009a2a16f7013d52a54bf96bc8a943 A possibly relevant merge request was started @ https://invent.kde.org/plasma/plasma-desktop/-/merge_requests/2974 Git commit ea2d29c71b62330d3cb6b63052eb26f8d5b3332c by Nate Graham. Committed on 08/05/2025 at 19:36. Pushed by ngraham into branch 'master'. kcms/keys: use nicer names for KWin and Plasma Right now the KCM pulls the name from KAboutData, which is a user-facing name and is usually fine. However KWin and Plasma are system services that not unreasonably set rather technical names. When these names are snown in the KCM, the HIG recommendation to avoid displaying internal jargon to users is violated. Because a proposal to change the KAboutData string in KWin was rejected, do it here instead. FIXED-IN: 6.4.0 M +9 -0 kcms/keys/basemodel.cpp https://invent.kde.org/plasma/plasma-desktop/-/commit/ea2d29c71b62330d3cb6b63052eb26f8d5b3332c |