doxygen comments are compulsory. You can omit the parameters if they're obvious, but you must at least say what the function's purpose is.