added documentation that describes alg. re #10689