PDIO-347 Add examples to clarify special events usage