Add better documentation for `Path`

Currently there is no good documentation for how `Path`s 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.~