...
- #Bug reports
- #Object orientation
- #Optimization
- #Status codes
- #"Overloaded Operators"
- #Using strings to access parameters
- #Deprecation
- #JavaDoc
Bug reports
Anchor | ||||
---|---|---|---|---|
|
...
See also Sun's Guidelines on deprecation
JavaDoc
While it is true that your code should be self-documenting, this does not save you from writing proper documentation and code comments. Paraphrasing the function name is not helpful.
How Not to do it:
Code Block |
---|
// returns x
int getX() {}
|
This makes more sense, doesn't it ?
Code Block |
---|
// calculates the radiation length from the previously set parameters. NOTE: The parameter Y gets invalidated by the call.
// returns the radiation length in a range between 0 and 10
int getRadiationLength() {}
|