I think annotations are significantly better. The integration with javadoc isn't impossible and the integration from javadoc markup to annotation is impossible.
Interestingly, the javadoc tool documentation tends to recommend an annotation *and* a javadoc tag. That does make the integration simple. On Thu, Dec 22, 2011 at 12:54 PM, Dmitriy Lyubimov <[email protected]>wrote: > just a custom javadoc tag would be easy though bit it would be visible > to javadoc tool only (and not even IDEs, so typo-prone). Maybe that's > what we need, but the trend in the rest of hadoop world seems to be to > use annotation-driven markers in this case. >
