From c4ba47e89e9d0d9489004d32ad4271b90aaa081e Mon Sep 17 00:00:00 2001 From: Juan Riquelme Date: Tue, 26 Jul 2016 11:23:49 +0200 Subject: [PATCH 1/2] Update doctrine.rst MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Note for «see doctrine documentation» just in section where `inversedBy` and `mappedBy` were just read. I know that five sections below there is a **More Information on Associations** section where this is a reference to this (if you dig enough, because it's referenced to other page there), but that's not enough. It's too general and too late. When you're reading this (my case, as a newcomer right now) and get to this `inversedBy` and `mappedBy` here and there isn't any direct mention about it in **Relationship Mapping Metadata** section, you felt lost. Can't understand why that is really used and what it means. And you scroll and see no direct reference about that. It breaks your learning rhythm. I had to search about this, till I found the Doctrine's documentation that I linked in that note. That cleared out the doubt. So I can continue learning. Five sections away there's a general «Read more about associations». That's ok. I will read more then. But at that moment, you need, at least, to understand, at least superficially, why that parameters are there. --- book/doctrine.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/book/doctrine.rst b/book/doctrine.rst index bae62b71020..e5f0fe94f43 100644 --- a/book/doctrine.rst +++ b/book/doctrine.rst @@ -1065,6 +1065,10 @@ of relationship management capabailties. Plus, in the context of this applicatio it will likely be convenient for each ``Category`` object to automatically own a collection of its related ``Product`` objects. +.. note:: + To understand ``inversedBy`` and ``mappedBy`` usage, see Doctrine's + `Association Updates`_ documentation. + .. note:: The code in the constructor is important. Rather than being instantiated @@ -1447,6 +1451,7 @@ For more information about Doctrine, see the *Doctrine* section of the .. _`Basic Mapping Documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html .. _`Query Builder`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/query-builder.html .. _`Doctrine Query Language`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/dql-doctrine-query-language.html +.. _`Association Updates`: http://docs.doctrine-project.org/en/latest/reference/unitofwork-associations.html .. _`Association Mapping Documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/association-mapping.html .. _`Mapping Types Documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#property-mapping .. _`Property Mapping`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#property-mapping From 7734400d1be4441ac312d9a5d1bb2dbd12c4f04d Mon Sep 17 00:00:00 2001 From: Juan Riquelme Date: Tue, 26 Jul 2016 11:34:28 +0200 Subject: [PATCH 2/2] Update doctrine.rst --- book/doctrine.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/book/doctrine.rst b/book/doctrine.rst index e5f0fe94f43..82f8bab604d 100644 --- a/book/doctrine.rst +++ b/book/doctrine.rst @@ -1066,6 +1066,7 @@ it will likely be convenient for each ``Category`` object to automatically own a collection of its related ``Product`` objects. .. note:: + To understand ``inversedBy`` and ``mappedBy`` usage, see Doctrine's `Association Updates`_ documentation.