[Syntax] Comments syntax is not fully homogeneous in the current code base.

[jalinei]

We need a clear coding guideline for comment syntax.

In some files we do have both /* syntax and // syntax.
For me it is not fully clear why we have both.
Comments also might be either on the .h or the .c. We have to harmonize this in each module.

Action

• Decide on common coding guideline for comments
  • Proposal : all functions comments in .h files
  • Proposal : have only /* foobar */ comments as per zephyr coding guidelines.
• Make sure it is compliant with vscode javadocs tooltips.