Feature/6 event documentation

This is a good place to review, and ultimately decide whether this belongs in the Guides or stay put. Still leaning towards the guides because of the depth.

There is a image I worked up to show the progression through the process that needs attention but I found it helpful in understanding the flow. 

Note, the PR may actually turn out be hard to work with because of the 'build' folder. It gets committed with everything else and there are always a ton of changes.