add note about deprecated events to docs