In this case the docs are more for other developers.

The reason I suggested this is because it took me a few minutes while reviewing the code to grock what was actually happening, even with the comments below.  I think other developers would appreciate one comment documenting the overall flow/intent of this block of code.