Improving the documentation of the client

This format works better for Wicked generation
More cleaning of the documentation

This is for the wicked generation as well
Merge branch 'docs'