Add an `@example`.

It will also be good to add some motivation for this function compared to `trianglePlaneIntersection`.