fix: docstring update to fix outdated upsert_many info (#139)

Co-authored-by: Cody Fincher <cody.fincher@gmail.com>

.pre-commit-config.yaml

@@ -1,5 +1,5 @@
 default_language_version:
-  python: "3.12"
+  python: python3
 default_install_hook_types: [commit-msg, pre-commit]
 repos:
   - repo: https://github.com/compilerla/conventional-pre-commit

advanced_alchemy/repository/_async.py

@@ -1006,6 +1006,9 @@ async def upsert_many(
         Update instances with the attribute values present on `data`, or create a new instance if
         one doesn't exist.
 
+        !!! tip
+            In most cases, you will want to set `match_fields` to the combination of attributes, excluded the primary key, that define uniqueness for a row.
+
         Args:
             data: Instance to update existing, or be created. Identifier used to determine if an
                 existing instance exists is the value of an attribute on ``data`` named as value of
@@ -1017,7 +1020,7 @@ async def upsert_many(
             no_merge: Skip the usage of optimized Merge statements
                 :class:`SQLAlchemyAsyncRepository.auto_commit <SQLAlchemyAsyncRepository>`
             match_fields: a list of keys to use to match the existing model.  When
-                empty, all fields are matched.
+                empty, automatically uses ``self.id_attribute`` (`id` by default) to match .
 
         Returns:
             The updated or created instance.

advanced_alchemy/repository/_sync.py

@@ -1007,6 +1007,9 @@ def upsert_many(
         Update instances with the attribute values present on `data`, or create a new instance if
         one doesn't exist.
 
+        !!! tip
+            In most cases, you will want to set `match_fields` to the combination of attributes, excluded the primary key, that define uniqueness for a row.
+
         Args:
             data: Instance to update existing, or be created. Identifier used to determine if an
                 existing instance exists is the value of an attribute on ``data`` named as value of
@@ -1018,7 +1021,7 @@ def upsert_many(
             no_merge: Skip the usage of optimized Merge statements
                 :class:`SQLAlchemyAsyncRepository.auto_commit <SQLAlchemyAsyncRepository>`
             match_fields: a list of keys to use to match the existing model.  When
-                empty, all fields are matched.
+                empty, automatically uses ``self.id_attribute`` (`id` by default) to match .
 
         Returns:
             The updated or created instance.