I haven't read the 40 other emails in this thread from today, so pardon me if this has already been said.
I think XML -> XSLT -> HTML on the fly is overkill. I'd like to see the docs stored as XML and converted to HTML (through whatever means) at dist time. I agree that straight HTML is better for production/distribution of the docs. --Erik On Tue, 10 Dec 2002, Patrick Lightbody wrote: > Ken, > I tend to prefer simple HTML documentation. XML -> XSLT -> HTML is overkill. > I nice batch of HTML files should suite us well. > > -Pat > > ----- Original Message ----- > From: "Ken Egervari [eXtremePHP]" <[EMAIL PROTECTED]> > To: <[EMAIL PROTECTED]> > Sent: Tuesday, December 10, 2002 12:06 AM > Subject: Re: [OS-webwork] Documentation > > > > Everyone, > > > > Actually, what I actually wanted to do was combine all the forms of > > documentation written by various people and consolidate it into a book > > fashion. That way it will be very easy for someone to download a PDF file > > or have the documentation html on their local machine. > > > > I for one never knew the 'WebWork Cookbook' existed unto boxed pointed it > > out to me. I think many others probably missed this great resource as > well. > > I truly think the goal here is make the product documentation a single > unit > > that is comprehensive, practical and easily accessible. If we can do > that, > > I think WebWork will be find it's way into more projects and will be a > > better competitor to Struts. > > > > I had talked to boxed about storing the documentation in XML and using > > various style sheets and/or parsers to make various forms of the > > documentation (like PDF and static HTML). Currently, the easiest form of > > documentation is by directly using the OS website, but sometimes that's > not > > convenient if you don't have an Internet connection available or want to > > learn more about WebWork on your laptop during a long train ride. > > > > Even further, if the documentation is updated on the server, users won't > > have access to older versions of that documentation (for their respective > > version). This way, we can version our documentation with the product > > releases better. I'm sure many people will enjoy this benefit for > projects > > already in production. > > > > Please let me know if you agree with these comments and your thoughts > about > > executing them. I have my own ideas about these plans, but with > > collaboration from all people involved, I'm sure we can make this work > > effectively. I look forward to spearheading these plans and I know they > > would help WebWork in many ways. > > > > Regards, > > Ken Egervari > > > > ----- Original Message ----- > > From: "Mike Cannon-Brookes" <[EMAIL PROTECTED]> > > To: <[EMAIL PROTECTED]> > > Sent: Monday, December 09, 2002 11:34 PM > > Subject: Re: [OS-webwork] Documentation > > > > > > > Toby, > > > > > > Great stuff - I've added a link to it from the WebWork page on the > wiki - > > > thanks! > > > > > > Cheers, > > > Mike > > > > > > On 10/12/02 2:40 PM, "Toby Hede" ([EMAIL PROTECTED]) penned > the > > > words: > > > > > > > Hi, > > > > > > > > I have been planning some documentation stuff as well, I started with > a > > > > dummies guide: > > > > > > > > http://info-architects.net/webwork/fundamentals-dummies.html > > > > > > > > And I need to get working on some other areas as well. > > > > > > > > Toby > > > > > > > > > > > > > > > >> Ken, > > > >> > > > >> Agreed - we greatfully appreciate any improvements to the > > documentation! > > > >> > > > >> Perhaps the best way you (or anyone - it's really easy!) can help out > > is > > > >> just to start documenting things on the Wiki > > > >> (http://www.opensymphony.com:8668). Anyone can sign up and write some > > > >> extra pages of information. > > > >> > > > >> This saves hassling with CVS, HTML, XML etc. > > > >> > > > >> Have a look at > http://www.opensymphony.com:8668/space/WebWork+CookBook > > > >> for examples of where people are just documenting on the fly - it's > > > >> quite refreshing! > > > >> > > > >> Welcome on board - if you need anything, just yell. > > > >> > > > >> Cheers, > > > >> Mike > > > >> > > > >> On 10/12/02 7:16 AM, "Wayland Chan" ([EMAIL PROTECTED]) penned the > > > >> words: > > > >> > > > >>> Welcome to the project and kudos on a very well > > > >>> written introduction of yourself. > > > >>> > > > >>> Looking *very* forward to your contributions. > > > >>> > > > >>> > > > >>> > > > >>> __________________________________________________ > > > >>> Do you Yahoo!? > > > >>> Yahoo! Mail Plus - Powerful. Affordable. Sign up now. > > > >>> http://mailplus.yahoo.com > > > >>> > > > >>> > > > >>> ------------------------------------------------------- > > > >>> 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 > > > > > > > > > > > > --------------------------------------------- > > > > Technoshamanistic Resistance Within Hyper-Transgressive Ontology > > > > > > > > Me Blog: http://info-architects.net/terablog/ > > > > > > > > > > > > > > > > > > > > ------------------------------------------------------- > > > > 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 > ------------------------------------------------------- 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
