On Sunday, November 9, 2003, at 04:29 PM, Will Glass-Husain wrote:
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.
Of course. It's deprecated in 1.5. We'll fix up the docs, aim people at the tools example, and that will be that. No biggie :)
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 environmentdevelopment
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
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]
-- Geir Magnusson Jr 203-247-1713(m) [EMAIL PROTECTED]
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
