Re: [RFC] Mandatory user doc in KDE review/incubation checklist

On 2026-01-16, Johnny Jazeix <[email protected]> wrote:
> Yes, I'm not sure if the state is bad because the website was not working
> or if we just don't care enough about the user documentation.
> If it's because we don't give enough attention to it, then yes, it
> will be useless
> to mandate this step as, even if it is done in the beginning, it will
> quickly become outdated.

I think we as developers have other fish to fry and other cats to whip
and/or skin and we don't have a dedicated documentation creating team.

For me it is mostly just "should I fix a crash or write some
documentation" - or "should I make this ui simpler or improve
documentation for the old ui"

We have quite many apps where the 'main things' shouldn't need
documentation.

Exceptions are
 - games where the rules aren't obvious or otherwise well-known
     - chess is well known
     - kblackbox is not obvious nor well-known
 - Things that actually needs some knowledge to use.

/Sune