Whether it is a docstring or a comment doesn't matter so much. Being able to quickly understand what it's for and what I can expect it to return is what matters. Currently, I have to sit down with pen & paper to figure that out.