Hi, I was musing on a "new user" issue recently. In a recent posting on the user list, Claude said:
>finally, for your information, the VelocityServlet is know deprecated, and >should be replaced by the VelocityViewServlet (part of >the velocity-tools subproject). It may automatically solve some >ResourceNotFound problems. How do users know this is deprecated? This seems really confusing. In particular (1) There's no mention of deprecation anywhere on the web site (2) In fact, there's very little mention of Velocity tools on the web site (3) It's not all clear to me how new users wanting to build a servlet (a large percentage of them) would go about discovering the fact that velocity-tools is the way to go See the "PS" for the details. It's very puzzling to me why the project has this contradicting position. This is probably due in part to traditional difficulties with documenting open source projects, and probably due in part to the artificial separation between the velocity committers and the velocity-tools committers. Should we aim for another pass at the site pages before the 1.5 release addressing this issue? Maybe it would help to allow the the velocity-tools developers access to the general site docs. They probably have the greatest incentive to delete the out-of-date pages in the dev manual and provide a "how-to" in using the new, recommended way of developing a servlet. Just thinking... WILL P.S. I'm guessing new users (i.e. developers) would first read the "Overview" and "Getting Started" sections of the web site. Neither mentions velocity-tools. The Getting Started page says "read the dev manual". The dev manual reads: > The basic technique of using Velocity in a servlet environment > is very simple. In a nutshell, all you must do is extend the provided > VelocityServlet base class and implement a single method, handleRequest(). > That's really all that is required to use Velocity in your servlet development Finally, the javadocs for VelocityServlet make no mention of deprecation. _______________________________________ Forio Business Simulations Will Glass-Husain [EMAIL PROTECTED] www.forio.com --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
