Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 5 Dec 2000 11:22:47 -0500
From:      Michael Lucas <mwlucas@blackhelicopters.org>
To:        Nik Clayton <nik@freebsd.org>
Cc:        Jordan Hubbard <jkh@winston.osd.bsdi.com>, doc@freebsd.org
Subject:   Re: troubleshooting tree revisited
Message-ID:  <20001205112247.A60958@blackhelicopters.org>
In-Reply-To: <20001205094808.A1241@canyon.nothing-going-on.org>; from nik@freebsd.org on Tue, Dec 05, 2000 at 09:48:08AM %2B0000
References:  <nik@freebsd.org> <46729.975969901@winston.osd.bsdi.com> <20001205094808.A1241@canyon.nothing-going-on.org>

next in thread | previous in thread | raw e-mail | index | archive | help
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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20001205112247.A60958>