From owner-freebsd-doc Thu May 14 14:18:00 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id OAA13969 for freebsd-doc-outgoing; Thu, 14 May 1998 14:18:00 -0700 (PDT) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from localhost.my.domain (ppp6572.on.bellglobal.com [206.172.208.164]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id OAA13949 for ; Thu, 14 May 1998 14:17:54 -0700 (PDT) (envelope-from ac199@hwcn.org) Received: from localhost (tim@localhost) by localhost.my.domain (8.8.8/8.8.8) with SMTP id RAA01165; Thu, 14 May 1998 17:15:54 -0400 (EDT) (envelope-from ac199@hwcn.org) X-Authentication-Warning: localhost.my.domain: tim owned process doing -bs Date: Thu, 14 May 1998 17:15:53 -0400 (EDT) From: Tim Vanderhoek X-Sender: tim@localhost Reply-To: ac199@hwcn.org To: Studded cc: Sue Blake , freebsd-doc@FreeBSD.ORG Subject: Re: file://localhost/usr/share/doc/handbook/handbook.html In-Reply-To: <355A2690.92BFF443@dal.net> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, 13 May 1998, Studded wrote: > "good" in this context. The problem in this context (as we've discussed > before) is that there are different ways to learn and grasp concepts. > The problem with a lot of unix documentation (and especially man pages) > is that it's written by people who are extremely left-brain oriented and > therefore have a difficult time presenting information in a way that > helps non-techie's grasp the concepts. How does this manifest itself such that manpages are easy to learn from for left-brain-orientated people and difficult for others? > They are designed to document features in a quick > reference manner. It seems to me the whole problems is summed above. Actually, that's not really the problem. I want my manpages to act as a reference manual. Let a tutorial or "info" file do the teaching. -- This .sig is not innovative, witty, or profund. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message