From kde-core-devel  Fri Mar 09 16:40:24 2001
From: Waldo Bastian <bastian () kde ! org>
Date: Fri, 09 Mar 2001 16:40:24 +0000
To: kde-core-devel
Subject: Re: User Interface.. If you ever wrote or will write a software GUI, then READ THIS!
X-MARC-Message: https://marc.info/?l=kde-core-devel&m=98415595907767

On Friday 09 March 2001 05:38, Christian A Strømmen [Number1/NumeroUno] wrote:
> On Friday  9. March 2001 06:31, Waldo Bastian wrote:
> > On Thursday 08 March 2001 17:58, Christian A Strømmen [Number1/NumeroUno]
> >
> > wrote:
> > > "Every time you provide an option, you're asking the user to make a
> > > decision. Asking the user to make a decision isn't in itself a bad
> > > thing. The problem comes when you ask them to make a choice that they
> > > don't care about."
> >
> > This is becoming a problem in KDE. Not that we really ask users a lot of
> > things, but there are a lot of configuration options. Maybe we should
> > make it a rule that if you add a configuration option you should also
> > write the user documentation for it. If you have a hard time explaining
> > in a single sentence what the option does, it's probably a bad idea to
> > add it.
>
> Documentation often doesn't help, users don't read documentation.

No, you are missing the point. It's not about the documentation. If  a 
developer has a hard time writing the documentation, there is something wrong 
with the feature.

Cheers,
Waldo
-- 
bastian@kde.org | SuSE Labs KDE Developer | bastian@suse.com