> I'm not in favour of the current docstring which describes the logic within the method.. (i.e. which things are compared)

It does help to explain exactly what's happening, which is useful since it's not at all clear!