Better doc!

[atilag]

I need to improve documentation so for example we have a clue on how to feed the input with the json format of the gates it consumes.
I need to document public methods at least as well.