Skip to content

Updated link to Event Listeners page #10195

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Aug 17, 2018
Merged

Conversation

ThomasLandauer
Copy link
Contributor

Not sure if I got it right (preview isn't showing it) - the page I wanted to link to is https://symfony.com/doc/current/bundles/DoctrineBundle/entity-listeners.html

Not sure if I got it right (preview isn't showing it) - the page I wanted to link to is https://symfony.com/doc/current/bundles/DoctrineBundle/entity-listeners.html
It is a lifecycle listener class used for an entity. You can read
about it in `the Doctrine Documentation`_.
It is a lifecycle listener class used for an entity. See
:doc:`Entity Listeners </entity-listeners>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since the documentation for DoctrineBundle is built independently we cannot use the doc role here. I would revert the changes in this paragraph...

@@ -269,4 +270,3 @@ to the tag like so:
definitions which are described :doc:`in their own article </service_container/lazy_services>`

.. _`The Event System`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html
.. _`the Doctrine Documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html#entity-listeners
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK, done :-)

@xabbuh xabbuh added this to the 2.8 milestone Aug 17, 2018
@xabbuh
Copy link
Member

xabbuh commented Aug 17, 2018

Thank you @ThomasLandauer.

@xabbuh xabbuh merged commit 58647a0 into symfony:2.8 Aug 17, 2018
xabbuh added a commit that referenced this pull request Aug 17, 2018
…bbuh)

This PR was merged into the 2.8 branch.

Discussion
----------

Updated link to Event Listeners page

Not sure if I got it right (preview isn't showing it) - the page I wanted to link to is https://symfony.com/doc/current/bundles/DoctrineBundle/entity-listeners.html

<!--

If your pull request fixes a BUG, use the oldest maintained branch that contains
the bug (see https://symfony.com/roadmap for the list of maintained branches).

If your pull request documents a NEW FEATURE, use the same Symfony branch where
the feature was introduced (and `master` for features of unreleased versions).

-->

Commits
-------

58647a0 fix the markup
567616f Changing to absolute url, as requested
f521534 Updated link to Event Listeners page
@ThomasLandauer
Copy link
Contributor Author

@xabbuh Reading this page again, I'm wondering: Shouldn't the entity listeners be presented as the preferred way of doing it?
The note that they where introduced in Doctrine 2.4 suggests that they're a brand new feature - however, Doctrine 2.4 was released some 5 years ago ;-)

So since entity listeners have been around for some time, what's the use case for event listeners and subscribers at all anymore?

And what about merging https://symfony.com/doc/current/bundles/DoctrineBundle/entity-listeners.html and http://symfony.com/doc/current/doctrine/event_listeners_subscribers.html#creating-the-listener-class ?

@xabbuh
Copy link
Member

xabbuh commented Aug 17, 2018

Would you like to open a new issue? Comments are likely to get lost in a merged PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants