Add better documentation for Path

[kneasle]

Currently there is no good documentation for how Paths are used to traverse trees. This is fairly non-trivial and for the longevity of Sapling it would be good to document any non-trivial parts of the code. This could probably be done in parallel with #45, which itself can't easily be done in parallel with #36, because it will generate merge conflicts.