On Thu, Dec 11, 2003 at 02:15:24PM -0700, s. keeling wrote: > Incoming from Richard Kimber: > > On Thu, 11 Dec 2003 12:07:23 -0600 > > "Michael Martinell" <[EMAIL PROTECTED]> wrote: > > > > > That's why the people doing the documentation should be the power-user > > > who is not familiar with every intricate detail, and has had to struggle > > > and learn the system. That is the person who can usually explain things > > > in a > > > > This sounds like an excuse for programmers not to document their programs. > > Programmers need no excuse for this. They know how it works. If you > think it needs documentation, go ahead and write it. > > > But I feel strongly that to overcome the original point in the thread, > > many app developers need to give more attention to the documentation, and > > indeed the user interface, and a little less to adding that "nice new > > exciting" (and undocumented) feature. > > Note the smiley: Go to hell! :-) > > If I were being paid to do this kind of thing, my boss might have a > more convincing argument as to why I should document my work. > However, for something I'm giving away for nothing, there's no such > obligation that I can see. > > Go join the LDP and fix this apparent deficiency yourself if you think > it's a problem. >
I started to compose a long diatribe on the need for more action in documentation when I thought to look to see whether there is a Debian list on documentation. There is such a list. I am subscribing to it. -- Paul E Condon [EMAIL PROTECTED] -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
