Tim said: > Thread to clear up agree on naming conventions for the tools > subproject(s). > > First a quick summary of where we are now: > ---- > Tools subproject lists 5 areas: > http://jakarta.apache.org/velocity/toolsubproject.html > View -> "a standalone servlet that can be used for template > rendering in Web Applications" references the VelocityViewServlet, and > the ToolBox Manager > Struts -> "set of tools, examples and documentation" references the > View package > Tools -> "library of generic tools" > Utilities-> "library of Velocity-related utilities"
To my knowledge, there are presently no "velocity-related utilities" either proposed or under development. Unless/until someone has some sort of idea or plan for these (perhaps Gabe or Geir recall what this was meant to be), then i think this should be dropped from the documentation. > Velocimacros i have proposed that Velocimacro libraries be placed into their associated tree (struts/view/tools). at this point, only Bill Burton has addressed (and affirmed) that proposal. if no one else cares soon, i am going to move in that direction. this will affect how/where these should be documented. ... > > Other thoughts just to confuse things: ... > Saying "VelocityStruts" may not provide a clear picture to Struts folks > of using Velocity for the Struts View Layer. Velocity is designed to be a view technology. Struts is designed to be a controller technology. I think 'VelocityStruts' is pretty clear. It is certainly more descriptive than the monikers or acronyms that get attached to most projects (things like 'Velocity' or 'Struts' :-)). ... > "VelocityServlet" as mentioned here in the subproject is NOT the same as > the "VelocityServlet" in the Velocity Developer's Guide - confusing, eh? agreed, and it doesn't really address the (potential) full scope of the library. ... > Some possible changes (grab-bag, not all mutually exclusive): ... > = REMOVE tools/tools -> roll it into tools/view > +1 from Tim (the more I look at it, this would be simple and clean) +1 i suppose i should make a separate proposal for this. > = move org.apache.velocity.tools.tools.* to pkg > org.apache.velocity.tools.view.?.? > +1 it would probably be org.apache.velocity.tools.view.tools.* > = label tools/view - "VelocityView" > +1 +1 including the word 'servlet' doesn't address the hope/quasi-plan for extending/applying the toolbox management and non-servlet tools to other environments. > = label tools/struts - "StrutsView" > +1 (answers the question "What is this thing? A StrutsView tool." -1 afaic, it's no better then saying "a VelocityStruts tool" > = label tools/struts - "StrutsVelocity" -1 let's keep it as VelocityStruts Nathan Bubna [EMAIL PROTECTED] --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
