improve aggregate, clock, event bus and message decorator docs

improve aggregate, clock, event bus and message decorator docs #1689