I don't know if we should link to a long discussion thread for an explanation.  I'd rather see an edited description of the algorithm right here in the docstring.