Tagged Questions
0
votes
6answers
388 views
What information should a good (method- / class-) comment contain?
This is something that has bothering me for a while now. I guess there are a couple of obvious important things that should go into a comment, such as:
The author(s)
A description of the parameters ...
7
votes
6answers
909 views
Is it necessary to write a javadoc comment for EVERY parameter in a method's signature?
One of the devs on my team believes that it is necessary to write a javadoc comment for EVERY parameter in a method's signature. I do not think this is necessary, and in fact I think it can even be ...