Re: Linux is not for consumers!
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" <mike@dakotasioux.com> 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
pecondon@peakpeak.com
Reply to: