Tidied up internals of event service and added documentation on just what the hell the event scope does

Signed-off-by: Martin Evans <martindevans@gmail.com>