I'd like to interject a few comments. User documentation can almost always be improved, but I'd like to say that the existing user's guide is probably one of the best for an open source development project such as Struts that I've encountered...
That being said, a couple of things that would probably be nice would be both a tutorial, stepping through building a basic Struts application, including using the appropriate architectural designs that would be used in a much larger project. Also, I'd like to see a reference guide to the tags and such that would allow one to quickly find descriptions of the tags and their usage. The javadoc is lacking in this regard. -----Original Message----- From: Ted Husted [mailto:[EMAIL PROTECTED]] Sent: Saturday, October 13, 2001 12:59 PM To: [EMAIL PROTECTED] Subject: Re: userGuide is confusing to newbies Thanks, Ed. These look quite good. I'll be tied up until at least Tuesday, but expect to review and commit your patches then (unless someone beats me to it ;-) Just as Struts does not try to reinvent technology, we didn't try to rehash Model 2, MVC, the Patterns, and the rest of it in the User Guide. Rather, it just tries to point out how the current thinking has been applied to Struts. There is definately an expectation that the developer is already up to speed on Java Web applications generally, and now wants to apply what they know to Struts. I think a more introductory guide would be a good idea, especially if it were a separate document labeled for newbies. My own suggestion for a "newbie" trail of Struts prerequisites is here: http://husted.com/struts/links.htm#first Meanwhile, this is a slightly different venue, but Jonathan Aspbell had an idea for a quick-start brochure. We were thinking of doing this a PDF that could be printed and handed out to a development staff, or even the suits. Just wanted to throw that into the mix ;-) There is a ZIP with what was started here, under Struts for Everyone: http://husted.com/struts/resources.htm#articles Devon Brown once posted an outline for a training course he was developing, but I can't seem to find it in the archives (?). -- Ted Husted, Husted dot Com, Fairport NY USA. -- Custom Software ~ Technical Services. -- Tel +1 716 737-3463 -- http://www.husted.com/struts/ _________________________________________________________ Do You Yahoo!? Get your free @yahoo.com address at http://mail.yahoo.com
