Bug 473069

Summary: user documentation is either absent or very well hidden
Product: [Applications] kasts Reporter: mo lasses <fastes.molasses>
Component: generalAssignee: bart
Status: CONFIRMED ---    
Severity: normal CC: mundolibre
Priority: NOR    
Version First Reported In: 23.04.3   
Target Milestone: ---   
Platform: Manjaro   
OS: Linux   
Latest Commit: Version Fixed/Implemented In:
Sentry Crash Report:

Description mo lasses 2023-08-06 11:15:53 UTC
Thank you for making this application. It is the best one I found for podcasts on desktop. :)

SUMMARY

I can't find any user documentation. 

OBSERVED RESULT

I can see that there *is* documentation: https://invent.kde.org/multimedia/kasts/-/blob/master/po/en_GB/kasts.po

Where does it go? 

I checked:

https://github.com/KDE/kasts
https://flathub.org/apps/org.kde.kasts
https://apps.kde.org/kasts/
https://bugs.kde.org/buglist.cgi?list_id=2437041&product=kasts&resolution=---
https://invent.kde.org/multimedia/kasts
https://binary-factory.kde.org/view/Android/job/Kasts_Nightly_android-arm64/
https://discuss.kde.org/
kasts --help , kasts --help-all
everywhere I could in the application

I found bugs where people are talking about what it says in the docs, but none included a link or any hint to where these would be found. 

EXPECTED RESULT

User documentation should be available on all the application pages (such as listed above) and from within the application.

When I was searching for information about the application, the developer oriented results like git repos, were very close to the top. Therefor the docs should be linked to from these locations. And/Or, prominently link to a user-oriented page from the developer spots. 

SOFTWARE/OS VERSIONS
Linux/KDE Plasma: Manjaro
Qt Version: 5.15.10
Xfce: 4.18
Installed from arch repo: https://archlinux.org/packages/extra/x86_64/kasts/ 
Build Date: 2023-07-04 14:14 UTC

ADDITIONAL INFORMATION

I can see there are issues about features that I can't find. The tracker does not seem to correspond to what is on my screen. Maybe they are bugs? Or maybe it is a new feature not yet included in my build? Or I am using it with incompatible system?  I can't really determine what is expected. 

thanks for all your work. :)
Comment 1 bart 2023-09-06 08:35:28 UTC
Sorry for the late reply.

Unfortunately, there is no user documentation for Kasts (yet).  So it's not surprising that you didn't find it anywhere.
And, honestly, I don't see myself finding additional time to create and maintain documentation at this point in time.  I have my hands full maintaining the app itself. :(

Feel free to help out with creating documentation (or anyone else reading this).  Even though I don't yet know myself how to do this, I'm willing to look into it and give some pointers to get you or anyone else started.