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

[owl]

Hmm, I've just realised that I think of JavaDoc comments in a slightly different way than I do about normal comments, that they're more codey or something. I'm sure our tech lead would be glad to hear that, as he tears into JavaDoc with the same persistence as he does into code, but a block comment will only get an eyeroll unless it's on a whitaker's-mom level.

[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*