From: krave1986 Date: Fri, 23 May 2025 20:23:00 +0000 (+0800) Subject: docs: Clarify that relationship() first parameter is positional (#12621) X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=18ee6a762ce2ab00671bcce60d6baf1b31291e71;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git docs: Clarify that relationship() first parameter is positional (#12621) --- diff --git a/doc/build/orm/basic_relationships.rst b/doc/build/orm/basic_relationships.rst index a1bdb0525c..b4a3ed2b5f 100644 --- a/doc/build/orm/basic_relationships.rst +++ b/doc/build/orm/basic_relationships.rst @@ -1018,7 +1018,7 @@ within any of these string expressions:: In an example like the above, the string passed to :class:`_orm.Mapped` can be disambiguated from a specific class argument by passing the class -location string directly to :paramref:`_orm.relationship.argument` as well. +location string directly to the first positional parameter (:paramref:`_orm.relationship.argument`) as well. Below illustrates a typing-only import for ``Child``, combined with a runtime specifier for the target class that will search for the correct name within the :class:`_orm.registry`::