summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--docs/model-api.txt5
1 files changed, 5 insertions, 0 deletions
diff --git a/docs/model-api.txt b/docs/model-api.txt
index 756e19c7b6..f605f77756 100644
--- a/docs/model-api.txt
+++ b/docs/model-api.txt
@@ -304,6 +304,11 @@ Field Types
many toppings on a pizza)::
meta.ForeignKey(Pizza)
+
+ .. admonition:: Note
+
+ To create a recursive relationship, use a ``ForeignKey`` that relates
+ to ``"self"`` (i.e. ``meta.ForeignKey("self")``).
``ForeignKey`` fields take a large number of extra arguments for defining how
the relationship should work. All are optional: