Add a more comment/docstring

Clarify some functions behavior or decisions taken.