From owner-freebsd-questions Mon Mar 12 6: 2:48 2001 Delivered-To: freebsd-questions@freebsd.org Received: from guru.mired.org (okc-65-26-235-186.mmcable.com [65.26.235.186]) by hub.freebsd.org (Postfix) with SMTP id 1C6C337B718 for ; Mon, 12 Mar 2001 06:02:46 -0800 (PST) (envelope-from mwm@mired.org) Received: (qmail 14415 invoked by uid 100); 12 Mar 2001 14:02:44 -0000 From: Mike Meyer MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <15020.55044.631599.345193@guru.mired.org> Date: Mon, 12 Mar 2001 08:02:44 -0600 To: "Doug Young" Cc: questions@freebsd.org Subject: Re: documentation issues generally In-Reply-To: <78818951@toto.iv> X-Mailer: VM 6.89 under 21.1 (patch 14) "Cuyahoga Valley" XEmacs Lucid X-face: "5Mnwy%?j>IIV\)A=):rjWL~NB2aH[}Yq8Z=u~vJ`"(,&SiLvbbz2W`;h9L,Yg`+vb1>RG% *h+%X^n0EZd>TM8_IB;a8F?(Fb"lw'IgCoyM.[Lg#r\ Sender: owner-freebsd-questions@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG Doug Young types: > Is there anything that can be done about improving the usability of > documentation > so that its intelligible to ALL levels of user and not only the extremely > experienced ? Yes. Improve them, then submit PRs with the improvements. > Has anyone ever considered the possibility that documentation comprehensible > to > regular users might cut down on the hundreds of questions posted to this > list daily ?? I'm sure it would, by at least a few percent. I wouldn't expect it to cut down much more than that, because that's the percentage that seems to have both read the appropriate documentation and failed to understand it. http://www.mired.org/home/mwm/ Independent WWW/Perforce/FreeBSD/Unix consultant, email for more information. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-questions" in the body of the message