We are definitely fixing the traversal docs, and they are already much improved over two weeks ago ;)
The responsiveness of Chris and Ben to actually fixing this kind of thing is amazing, and one of the major reasons we thought teaming up with them would be a good idea.