From owner-freebsd-doc Fri Oct 4 18:30:59 2002 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id AB71537B404 for ; Fri, 4 Oct 2002 18:30:57 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1C2D943E65 for ; Fri, 4 Oct 2002 18:30:57 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from localhost ([192.168.0.5]) by pittgoth.com (8.12.6/8.12.5) with SMTP id g951Utwi048194 for ; Fri, 4 Oct 2002 21:30:55 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Fri, 4 Oct 2002 21:27:57 -0400 From: Tom Rhodes To: FreeBSD-doc@FreeBSD.org Subject: Plea to the doc team Message-Id: <20021004212757.2a7e3227.trhodes@FreeBSD.org> X-Mailer: Sylpheed version 0.8.1claws (GTK+ 1.2.10; i386-portbld-freebsd4.7) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org Fellow Doc committers and contributers, Its been said over and over the use of 'you' in technical docs looks bad. While I'm going to be at working cleaning up the doc tree of bad gammar (run-ons, incorrect use of semicolons, to many useless words and fragments) I'll try to kill the use of 'you'. My request is, if you remove the 'you' from documents you can cut down extremly on the amount you type, the amount a reader will read, and documentation size in general. This IMO is a good thing and will also cut down on grammar bogons. If you have nothing to do between classes, please print a section of the handbook and skim it. See where we use to many words, where paragraphs can be more clear or even where we make grammar mistakes. Then committers please make the changes or contributers please create a patch file for us. We could also use some 5.0 information. Currently we seem to lack documentation on ACPI, device.hints(5), mail clients (I'm working) STMP auth (I'm working) and various other features. Thanks to all who have read this far ;) -- Tom (Darklogik) Rhodes www.FreeBSD.org -The Power To Serve www.Pittgoth.com -Pittgoth Discussion Portal trhodes@{Pittgoth.com, FreeBSD.org} PGP key by www: http://www.pittgoth.com/~darklogik/darklogik.key To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message