Whooo, Javadoc

[afuna]

The one thing I love about JavaDoc is that it starts with two stars. Makes it look special (and, in Eclipse, blue).

The things I don't like about JavaDoc are too many to count! But the list includes annotations! Why are you letting comments define behavior? That's just freaky.

On the flip side, documentation is a good warm up to the day, so!

Comments

[afuna]

*snickers*

I do kinda see the point, though. Once processed, the JavaDocs are visible to even non-coder folks. Normal comments aren't visible in the same way.

[owl]

Yes, that is his point. However, in the middle of the code review he said thoughtfully, "You know, we really should generate this JavaDoc one of these days..." :D

[afuna]

*dies*