Initial write-up of pub/sub hooks

Initial write up for hooks.