docs: add tutorial on what is the meaning of the three params in the lineage merging code

[xulman]

a short how-to, or even a three screen shots showing what is measured where (and perhaps even why) would be also good