Added documentation on the events subsystem

This documentation includes documentation on the new
save event that is introduced in the Respec issue 335.