Slowly and surely, progress is being made. The documentation will be written with XML markup, using the "Simplified DocBook" DTD.
I have created a CSS/CSS2 stylesheet that renders the XML rather nicely. Alas, MSIE is not CSS2 compliant, so you'll have to use Opera v4 or Mozilla. Or write an alternative CSS file!
This URL will be the homepage for the documentation. I expect to be able to place a new file every day nor so, so it will slowly grow along. Check back frequently and do some bugspotting!
At this point, I need *FEEDBACK* on the structure, language and terminology.
I could also use someone who knows Zope to figure out how to get Zope to render XML as HTML, so those poor MSIE/Netscape users have a chance to view these pages nicely.
If someone were willing to write a documentation tool for me -- one that would make it easier to edit these files, by presenting fill-in-the-blanks forms and filling in the XML itself (there are only a few patterns of XML that are being used in the tables), I'd like to work with him/her. Editting these files by hand is overly time-consuming.
If someone were able to get Zope to do a nice database for this, that would render out XML, HTML, Tex, RTF, PDFs or what-have-you, that would be even better. I tried, but don't have the time to learn what I need to to do it.
Let me know what works/doesn't work for you in this structure.
Thx,
david
···
--
David Priest -- WritersBlock Technical Communications
Workplace Documentation, Manuals, Process Improvement
250 542-5208 www.sfu.ca/~priest