Pat, Patrick Lightbody wrote:
I agree with Ken - XML really is the way to go and I think it'd be simple to edit. Each file would likely just be some document meta-data then just a series of <p>...</p> tags - pretty simple. And, Ant has XSL transforming built-in - just use that in lieu of the docbook stuff.Sitemesh can decorate HTML files, so why the jsp extension? The OSWorkflow docs are all HTML. I really do think that HTML docs are the best bet. Makes our life real simple -- plus including all the docbook crap in the CVS build is never fun.
I buy Ken's arguments tho - I'd be a shame not to use XML since it really isn't that big of a deal to edit it and transform it.
Ken - thanks so much for offering to do this! I'm excited that expert looking docs will breathe new life into the WW project.
Cheers,
--Bill
-Pat----- Original Message ----- From: "Ken Egervari [eXtremePHP]" <[EMAIL PROTECTED]> To: <[EMAIL PROTECTED]> Sent: Tuesday, December 10, 2002 8:59 AM Subject: Re: [OS-webwork] DocumentationI'll devise 2 stylesheets then. One to transform the document for local viewing and another to make them look the same way they are now with the .jsp extension for the website. This way, we can use sitemesh to decorate one version and also have a local .html version. This will ensure compatibility with the current method while still going with XML+XSLT. ----- Original Message ----- From: "Hani Suleiman" <[EMAIL PROTECTED]> To: <[EMAIL PROTECTED]> Sent: Tuesday, December 10, 2002 11:49 AM Subject: Re: [OS-webwork] DocumentationWell, they were changed to jsp, which is the worst of both worlds(requireprocessing, and single output format) Quoting Rickard Öberg <[EMAIL PROTECTED]>:Ken Egervari [eXtremePHP] wrote:Pat, You think it's overkill? I rather like the simplicty of XML. Ialsohaveused XSLT in many solutions already and I wrote about too in one ofmybooks. Needless to say, I'm really confortable with it.FWIW the docs used to be in DocBook. They changed to HTML when I"left".IMHO XML is a better way to do it, for the reasons you've mentioned.Butthat's just me. /Rickard ------------------------------------------------------- This sf.net email is sponsored by:ThinkGeek Welcome to geek heaven. http://thinkgeek.com/sf _______________________________________________ Opensymphony-webwork mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/opensymphony-webwork------------------------------------------------------- This sf.net email is sponsored by:ThinkGeek Welcome to geek heaven. http://thinkgeek.com/sf _______________________________________________ Opensymphony-webwork mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/opensymphony-webwork------------------------------------------------------- This sf.net email is sponsored by:ThinkGeek Welcome to geek heaven. http://thinkgeek.com/sf _______________________________________________ Opensymphony-webwork mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/opensymphony-webwork------------------------------------------------------- This sf.net email is sponsored by:ThinkGeek Welcome to geek heaven. http://thinkgeek.com/sf _______________________________________________ Opensymphony-webwork mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/opensymphony-webwork
-- ---------------------------------- Bill Lynch, Jive Software [EMAIL PROTECTED] ------------------------------------------------------- This sf.net email is sponsored by:ThinkGeek Welcome to geek heaven. http://thinkgeek.com/sf _______________________________________________ Opensymphony-webwork mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/opensymphony-webwork
