From owner-freebsd-chat Wed Jun 25 17:56:32 1997 Return-Path: Received: (from root@localhost) by hub.freebsd.org (8.8.5/8.8.5) id RAA24062 for chat-outgoing; Wed, 25 Jun 1997 17:56:32 -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 RAA24045; Wed, 25 Jun 1997 17:56:24 -0700 (PDT) Received: from localhost (jfieber@localhost) by fallout.campusview.indiana.edu (8.8.5/8.8.5) with SMTP id TAA17198; Wed, 25 Jun 1997 19:56:13 -0500 (EST) Date: Wed, 25 Jun 1997 19:56:13 -0500 (EST) From: John Fieber To: Francisco Reyes cc: FreeBSD Chat List , "doc@FreeBSD.ORG" Subject: Re: FreeBSD documentation (was: OS/2 users going to FreeBSD?) In-Reply-To: <199706251908.PAA07603@federation.addy.com> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-chat@FreeBSD.ORG X-Loop: FreeBSD.org Precedence: bulk On Wed, 25 Jun 1997, Francisco Reyes wrote: > I think a template SGML document and a documented sample would go a > long way. Last time I tried I remember I downloaded some of the > existing SGML and could not make much sense of them. After your first post, I actually started sketching one out. That combined with a cookbook of common markup structures (lists, examples, computer terms, cross referneces, footnotes, etc.) would be good. > >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. > > True, but it still takes time (your time or someone's elses time). I > still think that a documented SGML template can go a long way. It takes time, but nowhere near the time it takes to fix up incoherent content. :) -john