Updated documentation on new $event

The code about events in the Controller section might could be its own section, to avoid information overload in the beginning