3.0 tree behavior part 2

More docs for tree behavior