On Wed, 2 Jan 2019 00:18:19 -0500 Steve Litt <sl...@troubleshooters.com> wrote:
> On Tue, 1 Jan 2019 19:04:32 -0800 > Rick Moen <r...@linuxmafia.com> wrote: > > > Quoting goli...@dyne.org (goli...@dyne.org): > > > > [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 _______________________________________________ Dng mailing list Dng@lists.dyne.org https://mailinglists.dyne.org/cgi-bin/mailman/listinfo/dng
