Algorithm description

[smnorris]

This looks pretty cool! I think I can see what is happening by looking at the code but a quick description outlining the algorithm would really help a lot.

[mourner]

👍 will do. I was going to make an extensive blog post about it as well but didn't get to it yet.