Add docs explaining some parts of the code

[lubosmj]

Some parts of the code do not seem to be very straightforward. Also, the examples do not provide further explanations of what kind of datasets were used during the experiments.