:: Re: [DNG] Fwd: Re: What should an …
Top Page
Delete this message
Reply to this message
Author: Rowland Penny
Date:  
To: dng
Subject: Re: [DNG] Fwd: Re: What should an Install Guide accomplish?
On Wed, 2 Jan 2019 00:18:19 -0500
Steve Litt <slitt@???> wrote:

> On Tue, 1 Jan 2019 19:04:32 -0800
> Rick Moen <rick@???> wrote:
>
> > Quoting golinux@??? (golinux@???):
> >
> > [much concentrated wisdom]
> >
> > > The best documemntation will be useless if no one reads it.
> > [...]
> > > Even though information is already available on the site and
> > > elsewhere, quite often there will be questions that could be
> > > readily answered with a little effort on the user's part. So it
> > > is not a lack of information problem but a "you can't fix stupid"
> > > problem. Bloating the guide won't change that human behavior.
> >
> > Reminds me of a couple of things I've realised through many years
> > observing where documentation and user education works and where it
> > doesn't -- and pondering why. First of two is this:
> >
> > http://linuxmafia.com/~rick/lexicon.html#moenslaw-documentation
> >
> > Moen's Law of Documentation
> >
> > "The more you write, the less they read."
>
> Not true, if you structure the writing correctly. Especially now that
> we have hyperlinks, it's easy to write good and non-ambiguous docs.
>


The problem is, people ignore hyperlinks

Rowland