From owner-freebsd-doc Tue Dec 5 8:22:51 2000 From owner-freebsd-doc@FreeBSD.ORG Tue Dec 5 08:22:49 2000 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from blackhelicopters.org (geburah.blackhelicopters.org [209.69.178.18]) by hub.freebsd.org (Postfix) with ESMTP id CCED637B401; Tue, 5 Dec 2000 08:22:48 -0800 (PST) Received: (from mwlucas@localhost) by blackhelicopters.org (8.9.3/8.9.3) id LAA60983; Tue, 5 Dec 2000 11:22:47 -0500 (EST) (envelope-from mwlucas) Date: Tue, 5 Dec 2000 11:22:47 -0500 From: Michael Lucas To: Nik Clayton Cc: Jordan Hubbard , doc@freebsd.org Subject: Re: troubleshooting tree revisited Message-ID: <20001205112247.A60958@blackhelicopters.org> References: <46729.975969901@winston.osd.bsdi.com> <20001205094808.A1241@canyon.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <20001205094808.A1241@canyon.nothing-going-on.org>; from nik@freebsd.org on Tue, Dec 05, 2000 at 09:48:08AM +0000 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Well, as much as I'd like to have Jordan writing software for me, I have to agree with Nik here. There's other issues with a custom program: base system, or ports? How to keep the system in sync with the current system? Etc. If it goes in as a regular doc, we have a lot less maintenance overhead. On Tue, Dec 05, 2000 at 09:48:08AM +0000, Nik Clayton wrote: > On Mon, Dec 04, 2000 at 02:45:01PM -0800, Jordan Hubbard wrote: > > > If the markup format is DocBook (or, at the very least, something XML > > > based) then it's relatively easy to convert to HTML, and write another > > > application that parses the XML and displays flashscreens to the end > > > user. > > > > Hmm, but what would be the other use for the XML? If the decision > > tree parser spits out HTML, I don't see much of an issue in what it's > > internal "database" format is > > How many variants of HTML is it going to kick out? One question per > page? All questions in one page? One section per page? > > How do I specify the conversion process (i.e., the stylesheet that's > applied) to migrate from the internal document format to the HTML. > > How do I make it easy to translate the decision tree text to other > languages? > > How do I flag certain questions as only being appropriate for specific > releases of FreeBSD? > > Keeping the decision tree in DocBook (whether it's DocBook/SGML or > DocBook/XML is irrelevant) makes all this possible with our existing > tool chain. > > > and an XML parser would only make it harder to write. :) > > ports/textproc/libxml2. > > N > -- > Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. > Telephone line, $24.95 a month. Software, free. USENET transmission, > hundreds if not thousands of dollars. Thinking before posting, priceless. > Somethings in life you can't buy. For everything else, there's MasterCard. > -- Graham Reed, in the Scary Devil Monastery -- Michael Lucas mwlucas@blackhelicopters.org http://www.blackhelicopters.org/~mwlucas/ Big Scary Daemons: http://www.oreillynet.com/pub/q/Big_Scary_Daemons To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message