From owner-freebsd-doc Mon Nov 27 05:43:51 1995 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.6.12/8.6.6) id FAA00457 for doc-outgoing; Mon, 27 Nov 1995 05:43:51 -0800 Received: from fieber-john.campusview.indiana.edu (Fieber-John.campusview.indiana.edu [149.159.1.34]) by freefall.freebsd.org (8.6.12/8.6.6) with ESMTP id FAA00436 ; Mon, 27 Nov 1995 05:43:43 -0800 Received: (from jfieber@localhost) by fieber-john.campusview.indiana.edu (8.6.12/8.6.12) id IAA07824; Mon, 27 Nov 1995 08:43:01 -0500 Date: Mon, 27 Nov 1995 08:43:01 -0500 (EST) From: John Fieber X-Sender: jfieber@fieber-john.campusview.indiana.edu To: Peter Marelas cc: hackers@freebsd.org, doc@freebsd.org Subject: Re: Documentation.. In-Reply-To: Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-doc@freebsd.org Precedence: bulk On Mon, 27 Nov 1995, Peter Marelas wrote: > Due to all the argueing about the lack of documentation, why dont > we all stop bitching, and do ourselves a favour by writing docs, on > what we have experience in, when using freebsd, lets get the handbook > growing. YES! The new handbook section: X. Compatibility with other systems X.1 BSDI (no-brainer, except I gather 2.0 binaries don't work?) X.2 SCO X.3 Linux > Where do we put docs in for review by others? Send stuff in to doc@freebsd.org. In a couple weeks I'll be diving headfirst into a handbook upgrade so if there are some new compat docs in my mailbox, they will find their way in. > PS: Im writing one on PPP Servers, using pppd, as I feel the current docs > in the handbook are inadequate. Super! I think the most common failing found in the handbook (including the ppp docs) are explicit step-by-step instructions *without* sufficient commentary text. Step-by-step procedures are exteremely fragile and fall apart in the face of varaiation among installations. With the rapid development of freebsd, variation is *guaranteed*. The process should be explained by the text, and illustrated by some examples, not the reverse! -john == jfieber@indiana.edu =========================================== == http://fieber-john.campusview.indiana.edu/~jfieber ============