Explain in docstring what this function aim to do

as agreed on #10776 comments