Expanding the PHPDoc comments to clarify concepts

Moved to issue https://github.com/event-centric/aggregates/issues/9