Nathan,

While looking at org.apache.velocity.tools.view.LinkTool in the 2.x
branch, I see that the tool says "Since VelocityTools 1.0".

I wanted to ask if you should change that to "2.0" since this class
didn't exist until the 2.x branch. On the other hand, the tool itself
"LinkTool" has existed since the beginning.

Since I usually think about java classes and not components such as a
"tool", I just want to know the policy regarding the labeling of "since"
versions. Are we documenting the class/method, or are we documenting the
tool itself?

Also, you have the "addAllParameters" method marked as "Since 2.0", but
it looks like it's in the 1.x branch, too, so it might be more correct
to say "since 1.3" if you really are going to push-out a 1.3 release.

Just a thought.

Thanks,
-chris

Attachment: signature.asc
Description: OpenPGP digital signature

Reply via email to