Maybe you could try this.

Write the base documentation in XML.  Run the XML through some XML parser, or XSL 
thing and get the output in HTML/XHTML(XHTML should be mostly compatible with NS4, 
it's mainly just a model, and it is much cleaner than generic HTML).  Copy the output 
HTML/XHTML to the help page already parsed for users of older browsers.  

The reasoning:

XML is fairly standard in the newer browsers.  Despite the efforts to support NS4, I 
seriously doubt we will still see much of it in 2 years(hopefully lots of flavors of 
gecko and other browsers will be running around by then that support XML).  At that 
time, it would be easy to just put the XML directly on the help page, and maintaining 
the documentation will be much simpler.  

In the meantime, it would still be easier to maintain a base XML doc, run it through a 
parser and save the output in HTML than redoing the entire doc each time.

As usual, these are just suggestions to get some ideas going.  I'm sure there are some 
even better ideas out there.

Christopher Strolia-Davis


-----Original Message-----
From: Doug Melvin [mailto:[EMAIL PROTECTED]]
Sent: Thursday, November 15, 2001 9:18 AM
To: [EMAIL PROTECTED]
Subject: Re: [Dynapi-Dev] Documentation Project


Question: When we talk about using XML or XHTML.. are we talking
server-side?
I certainly hope so seeing as how NS4.x does ont have an XML parser..

I will not agree to forcing someone to download a plugin just to read our
docs..



_______________________________________________
Dynapi-Dev mailing list
[EMAIL PROTECTED]
http://www.mail-archive.com/[email protected]/

_______________________________________________
Dynapi-Dev mailing list
[EMAIL PROTECTED]
http://www.mail-archive.com/[email protected]/

Reply via email to