diff --git a/doc/reference/views.rst b/doc/reference/views.rst index 67a01ff570e..841900917d2 100644 --- a/doc/reference/views.rst +++ b/doc/reference/views.rst @@ -204,6 +204,18 @@ inherited views. inheritance mode, ``extension`` by default if ``inherit_id`` is set, ``primary`` otherwise. + An example of where you would want to override ``mode`` while using + ``inherit_id`` is delegation inheritance. + In that case your derived model will be separate from its parent and views + matching with one won't match with the other. Suppose you inherit from a view + associated with the parent model and want to customize the derived view to + show data from the derived model. The ``mode`` of the derived view needs to + be set to ``primary``, because it's the base (and maybe only) view for that + derived model. Otherwise the :ref:`view matching ` + rules won't apply. + +.. _reference/views/inheritance/view-matching: + View matching -------------