Much of this documentation in "take 2" needs to be updated. I'd like if the general body stays (to understand the pros/cons), but mentions of that this is the current implementation should be removed.

This should also have a paragraph explicitly stating why we didn't go with this implementation.