Date: Wed, 25 Jun 1997 19:56:13 -0500 (EST) From: John Fieber <jfieber@indiana.edu> To: Francisco Reyes <francisco@natserv.com> Cc: FreeBSD Chat List <chat@FreeBSD.ORG>, "doc@FreeBSD.ORG" <doc@FreeBSD.ORG> Subject: Re: FreeBSD documentation (was: OS/2 users going to FreeBSD?) Message-ID: <Pine.BSF.3.96.970625195300.12349I-100000@fallout.campusview.indiana.edu> In-Reply-To: <199706251908.PAA07603@federation.addy.com>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.BSF.3.96.970625195300.12349I-100000>