I thought the names improved things but figured the comments would help further.  If you look at the code with fresh eyes, you realize it's a fairly complicated thing happening here.  I expect to add lots of inline comments between now and 2.0 to make the code more navigable for new developers.