Add Docs like comments on top of methods for nice IDE tooltips

[AlexandreHiroyuki]

Comments have to be consistent with the docs

Example:

/**
* Do something.
* @param int data.
* @returns int data multiplied by 100.
*/
int do_something(int data) {
  return data * 100;
}