Code cleanup and add documentation (#367)

Signed-off-by: Clement Escoffier <clement.escoffier@gmail.com>