мм, если, например, какая-то заковыристая алгоримтическая задача - тоже без комментариев оставить?
написать нормальные unit тесты с edge cases в том числе, никаких проблем, максимум оставить в docstring ссылку на док алгоритма, да и часто ли у вас появляется собственная реализация тяжелого алгоритма?