[Incentivized] Template: Improve Documentation

[thibault-martinez]

Summary

This issue is a base for improving the SDK documentation, please open a new issue referencing it.
This is about in-code documentation, not wiki related.
Feel free to use this issue to discuss ideas before opening a proposal.

Estimated complexity

Easy

Estimated duration

Few hours

Details & acceptance criteria

Proper acceptance criteria will depend on the proposal.

Pull request required?

Yes