fix event formatting
simplify readme examples
refactor readme on events and sync vs async