added new preferred event decision docs

@roberto.depietri @stuart.anderson @leo-singer I am attaching a screen shot of the superevent decision tree. The clean up is not a part of this yet.