Some Very Basic Code Standards
Whilst on the topic of aggravation:
/**
* Returns the url for the link
* @return the url for the link
* @param oFooUtil the foo util
* @param sSomething the something
* @param iAge the age
*/
public String getRelationPath(FooUtil oFooUtil, String sSomething, int iAge) {
...
}
- Do not name your methods deceptively and keep the correct information in the javadoc only
- Do not use hungarian notation. It is extra useless in Java as it is an object oriented language which means that many, many variables will be prefixed with o.
- Do not comment the obvious





December 7th, 2005 at 1:50
Or to sum it all up in one rule:
Don’t be stupid.
December 7th, 2005 at 7:49
Jon, my empiric evidence shows that detailed instructions sometimes are necessary