From: krave1986 <krave@qq.com>
Date: Mon, 20 Oct 2025 20:06:31 +0000 (+0800)
Subject: Fix missing back_populates in Note.item relationship in example code (#12925)
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=1220858a0c5e85d4600b249dc3ae9412e01608ad;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git

Fix missing back_populates in Note.item relationship in example code (#12925)

Without back_populates, the subsequent code would not automatically populate Item.notes or generate the key, which contradicts what the documentation intends to demonstrate.
---

diff --git a/doc/build/orm/collection_api.rst b/doc/build/orm/collection_api.rst
index d1fbe8c00b..a04160edee 100644
--- a/doc/build/orm/collection_api.rst
+++ b/doc/build/orm/collection_api.rst
@@ -220,7 +220,7 @@ of the ``Note.text`` field::
         keyword: Mapped[str]
         text: Mapped[str]
 
-        item: Mapped["Item"] = relationship()
+        item: Mapped["Item"] = relationship(back_populates="notes")
 
         @property
         def note_key(self):