Bug 505116 - Write help in user-centric terms (not QStringList)
Summary: Write help in user-centric terms (not QStringList)
Status: CONFIRMED
Alias: None
Product: konsole
Classification: Applications
Component: general (other bugs)
Version First Reported In: unspecified
Platform: Other Linux
: NOR wishlist
Target Milestone: ---
Assignee: Konsole Bugs
URL:
Keywords: junior-jobs
Depends on:
Blocks:
 
Reported: 2025-06-02 06:16 UTC by Justin Zobel
Modified: 2025-12-07 10:20 UTC (History)
1 user (show)

See Also:
Latest Commit:
Version Fixed/Implemented In:
Sentry Crash Report:

Attachments
Add an attachment

Note You need to log in before you can comment on or make changes to this bug.
Description Justin Zobel 2025-06-02 06:16:09 UTC 
konsole --list-profile-properties shows the below (snipped for brevity)
Path : QString
Name : QString
UntranslatedName : QString
Icon : QString
Command : QString
Arguments : QStringList
SemanticHints : int
SemanticUpDown : bool

Most users aren't aware of what a QSTringList is, or an int/bool

This being user facing should be translated into non-jargon.

int > number
bool > true/false
etc
Comment 1 Kurt Hindenburg 2025-12-02 20:50:15 UTC 
I agree although I think these are not really meant for casual end users.  I would be curious who even uses them on a regular basis.
Comment 2 Justin Zobel 2025-12-02 23:32:15 UTC 
(In reply to Kurt Hindenburg from comment #1)
> I agree although I think these are not really meant for casual end users.  I
> would be curious who even uses them on a regular basis.

I think help in any user-facing section should be written in user-focussed terms. If it is on develop.kde.org or api.kde.org that is a different matter.
Comment 3 Taras Oleksyn 2025-12-07 10:20:00 UTC 
Hi, I can make a patch for this. 
Would sorting the output of konsole --list-profile-properties make sense too?