From owner-freebsd-questions Tue Apr 3 8:40:58 2001 Delivered-To: freebsd-questions@freebsd.org Received: from snarf.osdn.com (snarf.osdn.com [209.192.217.153]) by hub.freebsd.org (Postfix) with ESMTP id B848537B71C for ; Tue, 3 Apr 2001 08:40:55 -0700 (PDT) (envelope-from mij@osdn.com) Received: from guinness.osdn.com (root@localhost [127.0.0.1]) by snarf.osdn.com (8.11.3/8.11.3) with ESMTP id f33Fert56638; Tue, 3 Apr 2001 11:40:53 -0400 (EDT) (envelope-from mij@osdn.com) Received: by guinness.osdn.com (Postfix, from userid 1000) id D0D50FD; Tue, 3 Apr 2001 11:40:47 -0400 (EDT) Date: Tue, 3 Apr 2001 11:40:47 -0400 From: Jim Mock To: Dave Rideout Cc: FreeBSD Questions Subject: Re: Documentation Message-ID: <20010403114047.B1801@guinness.osdn.com> Reply-To: mij@osdn.com References: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.3.17i In-Reply-To: ; from drideout@cssnow.com on Tue, Apr 03, 2001 at 11:38:54AM -0400 Sender: owner-freebsd-questions@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG On Tue, 03 Apr 2001 at 11:38:54 -0400, Dave Rideout wrote: > I know this might be a little off topic, but I am going to ask, > because I respect the decisions of a lot of people on this list :) > > My boss wants our IT system to be thoroughly documented. Is there an > industry standard way of doing this? Or a template that I can look > at? DocBook would probably give you the most flexibility as far as generating different types of documents goes. You'd be able to generate plain text, HTML, PostScript, and PDF if you used it and did things correctly. If you do decide to use DocBook, take a look at http://www.docbook.org/ and the FreeBSD doc project's source tree. You can find it online at http://www.FreeBSD.org/cgi/cvsweb.cgi/doc/ - jim -- - jim mock - O|S|D|N - open source development network - - http://www.freebsdzine.org/ - jim@freebsdzine.org - jim@FreeBSD.org - To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-questions" in the body of the message