Improve COllision docs

Adds practical examples to the collision features introduced in #699 .
Merge pull request #768 from mucaho/collision_docs

Improve Collision docs