On Wed, 2003-11-05 at 14:11, Nathan Bubna wrote: > it's not so much the dvsl-ness of it that i was asking about. it's the > end-format and the effort.
Oh. Sorry. > basically, i'm asking if the gains in information and readability (as opposed > to javadoc) of providing tool documentation in that format is worth the extra > effort. and it is a fair bit of extra effort! with javadoc, it is relatively > easy to keep the documentation in sync with the actual code, you just document > the class and methods right in the code as you go. In that case I'd probably say no, it's not worth it, and could/will lead to bit-rot in the docs. Of course, I haven't had a chance to do essentially _anything_ since I wanted to start working with Velocity, so I should keep my mouth shut anyway :/ Dave --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
