From owner-freebsd-doc Wed Jun 25 11:29:23 1997 Return-Path: Received: (from root@localhost) by hub.freebsd.org (8.8.5/8.8.5) id LAA07284 for doc-outgoing; Wed, 25 Jun 1997 11:29:23 -0700 (PDT) Received: from fallout.campusview.indiana.edu (fallout.campusview.indiana.edu [149.159.1.1]) by hub.freebsd.org (8.8.5/8.8.5) with ESMTP id LAA07277; Wed, 25 Jun 1997 11:29:13 -0700 (PDT) Received: from localhost (jfieber@localhost) by fallout.campusview.indiana.edu (8.8.5/8.8.5) with SMTP id NAA15665; Wed, 25 Jun 1997 13:28:52 -0500 (EST) Date: Wed, 25 Jun 1997 13:28:51 -0500 (EST) From: John Fieber To: Francisco Reyes cc: "Jordan K. Hubbard" , FreeBSD Chat , doc@FreeBSD.ORG Subject: Re: FreeBSD documentation (was: OS/2 users going to FreeBSD?) In-Reply-To: <199706251633.MAA24988@federation.addy.com> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-doc@FreeBSD.ORG X-Loop: FreeBSD.org Precedence: bulk On Wed, 25 Jun 1997, Francisco Reyes wrote: > Now that I have a bit more knowledge I lack the time, and still don't > know how to contribute to the doc project. In particular it should be > easy to find the location of the existing documents, how changes > should be submited (including an example on using diff) and to who > they should be submited. A template SGML file would also be very > helpful (if SGML is still been used) I'll see what I can do to documenting and streamline the submission policy. The best info at the moment is http://www.freebsd.org/docproj.html, but it isn't very prominent and could use a lot more "how to" information. It may be better to de-emphasize issues of document format. If the *content* is good, I really don't care what the format is--SGML tagging is fairly mindless work. Unfortunatly, good programming skill and good technical writing skill seem to be mutually exclusive in practice. The FreeBSD crowd tends to have a lot more programmers than writers. -john