Improve documentation

[dariobrunelli]

Improve the documentation of clearbox-synthetic-kit.

• API references must be clear.
• Each class and method must have clear declaration and description of its parameters and attributes.
• Add clear examples for the most relevant classes and methods.