[MRG] Additional documentation for the Tree cython structure.

This adds docstrings for the Tree structure. This solves #2215.

Ping @arjoly @pprett - nothing controversial here, I think we can merge this very quickly.