Document the new debug:event-dispatcher

[weaverryan]

See symfony/symfony#10388

I think this may be useful to mention somewhere where we're talking about events and listeners.

[matthieuauger]

Wow, too fast @weaverryan ! I'll take care of the documentation of the feature.

For now if you're OK with the PR, maybe we could add the documentation about the new debug namespace (#4210)

[weaverryan]

@matthieuauger I saw the code PR got merged and didn't want to forget about this! :)

I just added a few comments to your PR, then it's definitely ready to merge. If there is an obvious spot, you could - if you want - add the debug:event-dispatcher notes on that PR.

Thanks!

[matthieuauger]

If you don't mind, I'd rather create a new PR for this documentation.

Thanks for your feedback

[matthieuauger]

Hi,

I can't find any good place to add the documentation of this feature.

The DIC and router have specific sections in the book which explain their integration in Symfony and their related debugging commands. But the Event Dispatcher is only documented as a standalone component and I don't think we should add something specific to Symfony there.

What do you think ? Any ideas about where to add this ?

Thanks

[wouterj]

@matthieuauger don't we also talk about events in the cookbook?

[weaverryan]

Yep, @matthieuauger the best place I can see is here: http://symfony.com/doc/current/cookbook/service_container/event_listener.html. I think we could mention it right away, since we currently say:

Those events are thrown by the HttpKernel component and can be viewed in the KernelEvents class.

Really, we could say that Symfony - and other bundles - dispatch events. To see a list, run this command, etc etc.