Fix incorrect comment
Improve code documentation: describe methods signatures in make.py