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