Add documentation for creating and firing custom events. See issue #982.

Here's basic documentation on creating and firing custom events.

I added narrative docs and documented the pyramid.registry.Registry.notify method.

Note this work was done at the PyCon Canada sprint.