The usual description for a .module file is Hook implementations for the [module name] module. where [module name] is the name of the module given ...
Only a documentation comment is added per function/method/class.
@file is not used in files containing a single class definition.
This line must be removed.
That would be the description for a return value. For properties, the description is given before the @var line.
The property description is given only once, before the @var line.
The description must be more... descriptive, not repeating the property name....
The description must avoid to repeat the property name....
Since this is a public function, this change is not backward compatible. Although the new method name is correct, there could be other modules that...
Since this is an inherited method (from a parent class or an interface), the documentation comment must be different.
The documentation comment for constructors is not anymore mandatory.
The description should not repeat the class name, even when spaces are added.
FALSE is used only in PHP code; in JavaScript code, it is correct to use false.
