From a73d3c309f0736f46dd46c99e15e1102af26dacb Mon Sep 17 00:00:00 2001 From: Hendrik <30193551+verhoek@users.noreply.github.com> Date: Mon, 18 Nov 2019 13:35:36 +0100 Subject: [PATCH] Elaborated on nested relationships (#7051) --- docs/api-guide/relations.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/api-guide/relations.md b/docs/api-guide/relations.md index 14f197b21..ef6efec5e 100644 --- a/docs/api-guide/relations.md +++ b/docs/api-guide/relations.md @@ -245,7 +245,9 @@ This field is always read-only. # Nested relationships -Nested relationships can be expressed by using serializers as fields. +As opposed to previously discussed _references_ to another entity, the referred entity can instead also be embedded or _nested_ +in the representation of the object that refers to it. +Such nested relationships can be expressed by using serializers as fields. If the field is used to represent a to-many relationship, you should add the `many=True` flag to the serializer field.