Better documentation for public methods

[arnaubennassar]

Improve documentation for Go methods that should be wrapped in the native layer. This documentation should include for each method:

• Name of the method and what it does
• list of parameters, with type description and conditions (is it optional, has constrains, ... in general information needed to validate the input of this methods)
• optionally pre and post conditions and consequences