So what is so wrong with the WW2 docs? I was able to build the Wafer Weblog with it. While I was actively working on the Expresso framework we got hammered by user for the same reason, they said our documentation sucked. Problem was just throwing more "documentation" at the website wasn't the solution because then you ended up with all of these poor flowing documents. It is very hard to write good documentation!! After having worked with many frameworks myself I feel that the best thing that could be done to help out newbies is one, have good javadoc. That is the easiest because the issue of "flowing" is not an issue. The second would be to have a good example. When I was working with the Maverick framework I used their friendbook example as about as much as their API's. So the webwork team could go off and create an example (great!) or you could steal one that already exist from someone else (hint Wafer).
Kris Thompson -----Original Message----- From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED] On Behalf Of Bill Lynch Sent: Friday, February 20, 2004 12:34 AM To: [EMAIL PROTECTED] Subject: [OS-webwork] docs are important All, Ouch: http://www.depeupleur.com/blog/TT_blog/archives/000019.html We got zinged there -- Jason, thanks for the good followup. Let's use this as impetus to improve the docs! I recently started working on the WW2 docs and I'd be happy to help out with XWork if someone could give me cvs commit & Jira access to that proj. Anyone interested in taking this over? http://jira.opensymphony.com/secure/ViewIssue.jspa?key=WW-477 Cheers, --Bill ------------------------------------------------------- SF.Net is sponsored by: Speed Start Your Linux Apps Now. Build and deploy apps & Web services for Linux with a free DVD software kit from IBM. Click Now! http://ads.osdn.com/?ad_id=1356&alloc_id=3438&op=click _______________________________________________ Opensymphony-webwork mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/opensymphony-webwork ------------------------------------------------------- SF.Net is sponsored by: Speed Start Your Linux Apps Now. Build and deploy apps & Web services for Linux with a free DVD software kit from IBM. Click Now! http://ads.osdn.com/?ad_id56&alloc_id438&op=click _______________________________________________ Opensymphony-webwork mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/opensymphony-webwork
