Pat, Great =) I feel more comfortable using xbook or an extended version of xdoc just because it'll be simpler for us in the maintenance category (the situation I described earlier could turn out to be really ugly for us). If writing documentation becomes a problem for other people, I'm going to make an xmlspy sps file so that you can edit and spell-check within xmlspy without having to deal with the xml itself (like an HTML wysiwyg). I find that program to be fairly powerful and fast to write XML documents in since you just right click, insert whatever you need and it'll make a perfectly valid document according to the xml schema (which I already made yesterday).
Cool, Ken ----- Original Message ----- From: "Patrick Lightbody" <[EMAIL PROTECTED]> To: <[EMAIL PROTECTED]> Sent: Friday, December 13, 2002 3:44 AM Subject: Re: [OS-webwork] Documentation > Ken, > Do whatever you think is best. You're the guy writing the docs :) > > Based on my previous post, I personally think we can accomplish what > everyone likes in Maven by just writing some standardized ant tasks. So any > kind of doc standard you use seems good to me. > > -Pat > > ----- Original Message ----- > From: "Ken Egervari [eXtremePHP]" <[EMAIL PROTECTED]> > To: <[EMAIL PROTECTED]> > Sent: Friday, December 13, 2002 12:40 AM > Subject: Re: [OS-webwork] Documentation > > > > Despite the maven issues, no one responded to my last post to the > newsgroup > > which investigated some other concerns I had about the xdoc format itself. > > I was thinking of changing the xdoc format to support a few more tags. We > > could also create a simple 20 line stylesheet to convert that xdoc one to > > the original version if we really needed to. I don't really like how the > > maven documentation actually looks since it wastes a lot of area on the > > screen. The <section> and <subsection> titles aren't really rendered all > > that great either. it works for simple things, but remember - this is > more > > like a book and should probably be treated as such. Please refer to the > > other email for a better description of these problems. > > > > Basically, I'm limited to xdoc or can I be more free to use something > else? > > > > ----- Original Message ----- > > From: "Hani Suleiman" <[EMAIL PROTECTED]> > > To: <[EMAIL PROTECTED]> > > Sent: Thursday, December 12, 2002 11:05 PM > > Subject: Re: [OS-webwork] Documentation > > > > > > > Exactly. This documentation thread has gone on long enough, overall > > > consensus seems to be a yes to xdocs, and an no to maven. The very fact > > > that the 'simple mavenising' posted on here says that one has to get > > > maven out of cvs is a winning argument against using it ;) > > > > > > On Thursday, December 12, 2002, at 05:42 PM, Patrick Lightbody wrote: > > > > > > >> bit. I liked the xdoc format, however and was planning on using that > > > >> regardless. > > > > > > > > Ken, > > > > Not sure if we are going to use Maven (Mike likes it, Rickard doesn't, > > > > I > > > > sorta-like-it-sorta-hate-it). I'm sure everyone else out there falls > > > > somewhere in one of those three categories. BUT, since you're going to > > > > use > > > > xdoc no matter what, I think the green light has turned on, > > > > documentation > > > > can begin :) > > > > > > > > -Pat > > > > > > > > > > > > > > > > ------------------------------------------------------- > > > > This sf.net email is sponsored by: > > > > With Great Power, Comes Great Responsibility > > > > Learn to use your power at OSDN's High Performance Computing Channel > > > > http://hpc.devchannel.org/ > > > > _______________________________________________ > > > > Opensymphony-webwork mailing list > > > > [EMAIL PROTECTED] > > > > https://lists.sourceforge.net/lists/listinfo/opensymphony-webwork > > > > > > > > > > > > > > > > ------------------------------------------------------- > > > This sf.net email is sponsored by: > > > With Great Power, Comes Great Responsibility > > > Learn to use your power at OSDN's High Performance Computing Channel > > > http://hpc.devchannel.org/ > > > _______________________________________________ > > > Opensymphony-webwork mailing list > > > [EMAIL PROTECTED] > > > https://lists.sourceforge.net/lists/listinfo/opensymphony-webwork > > > > > > > > > > > ------------------------------------------------------- > > This sf.net email is sponsored by: > > With Great Power, Comes Great Responsibility > > Learn to use your power at OSDN's High Performance Computing Channel > > http://hpc.devchannel.org/ > > _______________________________________________ > > Opensymphony-webwork mailing list > > [EMAIL PROTECTED] > > https://lists.sourceforge.net/lists/listinfo/opensymphony-webwork > > > > ------------------------------------------------------- > This sf.net email is sponsored by: > With Great Power, Comes Great Responsibility > Learn to use your power at OSDN's High Performance Computing Channel > http://hpc.devchannel.org/ > _______________________________________________ > Opensymphony-webwork mailing list > [EMAIL PROTECTED] > https://lists.sourceforge.net/lists/listinfo/opensymphony-webwork > ------------------------------------------------------- This sf.net email is sponsored by: With Great Power, Comes Great Responsibility Learn to use your power at OSDN's High Performance Computing Channel http://hpc.devchannel.org/ _______________________________________________ Opensymphony-webwork mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/opensymphony-webwork