From owner-freebsd-doc Tue Dec 5 12: 1:48 2000 From owner-freebsd-doc@FreeBSD.ORG Tue Dec 5 12:01:45 2000 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from winston.osd.bsdi.com (winston.osd.bsdi.com [204.216.27.229]) by hub.freebsd.org (Postfix) with ESMTP id EA56037B401; Tue, 5 Dec 2000 12:01:44 -0800 (PST) Received: from winston.osd.bsdi.com (jkh@localhost [127.0.0.1]) by winston.osd.bsdi.com (8.11.1/8.11.1) with ESMTP id eB5K1UM49540; Tue, 5 Dec 2000 12:01:31 -0800 (PST) (envelope-from jkh@winston.osd.bsdi.com) To: Nik Clayton Cc: Michael Lucas , doc@freebsd.org Subject: Re: troubleshooting tree revisited In-Reply-To: Message from Nik Clayton of "Tue, 05 Dec 2000 09:48:08 GMT." <20001205094808.A1241@canyon.nothing-going-on.org> Date: Tue, 05 Dec 2000 12:01:30 -0800 Message-ID: <49536.976046490@winston.osd.bsdi.com> From: Jordan Hubbard Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > How many variants of HTML is it going to kick out? One question per > page? All questions in one page? One section per page? Probably one per page unless we simply put them all up on one page and use section tags to jump around. The point is to make it an interactive experience rather than forcing the user to have to read every question in linear fashion or even do the "jumping" by hand. Think of it as a computer-assisted binary search. > How do I specify the conversion process (i.e., the stylesheet that's > applied) to migrate from the internal document format to the HTML. That would be up to the presentation piece. The database would just be a flat decision tree with enough information to navigate it, the presenter could be anything from a CGI spitting out HTML to a Java applet which never touches HTML at all. > How do I make it easy to translate the decision tree text to other > languages? That's a good question. Maybe some sort of import/export format (that's lighter-weight than XML! :). > How do I flag certain questions as only being appropriate for specific > releases of FreeBSD? That's the beauty of a decision tree. You just have a question early on which asks which release you're running if that turns out to be a differentiator, otherwise it isn't one. Didn't you ever play "animals"? :) - Jordan To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message