From 8994f18f572a03a06da2ec0932c058173f4172af Mon Sep 17 00:00:00 2001
From: Kevin Chang <123923721+kchang50204@users.noreply.github.com>
Date: Fri, 6 Feb 2026 04:08:15 -0800
Subject: [PATCH] Docs: clarify SQLite threading and pagination limit

Add clarifying comments explaining SQLite threading configuration and the pagination limit in the SQL databases tutorial.

No behavior changes.
---
 docs_src/sql_databases/tutorial001_an_py310.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs_src/sql_databases/tutorial001_an_py310.py b/docs_src/sql_databases/tutorial001_an_py310.py
index de1fb81fa..5b69cf367 100644
--- a/docs_src/sql_databases/tutorial001_an_py310.py
+++ b/docs_src/sql_databases/tutorial001_an_py310.py
@@ -14,7 +14,7 @@ class Hero(SQLModel, table=True):
 sqlite_file_name = "database.db"
 sqlite_url = f"sqlite:///{sqlite_file_name}"
 
-connect_args = {"check_same_thread": False}
+connect_args = {"check_same_thread": False} # needed for SQLite when using the session across threads
 engine = create_engine(sqlite_url, connect_args=connect_args)
 
 
@@ -49,7 +49,7 @@ def create_hero(hero: Hero, session: SessionDep) -> Hero:
 def read_heroes(
     session: SessionDep,
     offset: int = 0,
-    limit: Annotated[int, Query(le=100)] = 100,
+    limit: Annotated[int, Query(le=100)] = 100, # safety cap to avoid returning too many rows
 ) -> list[Hero]:
     heroes = session.exec(select(Hero).offset(offset).limit(limit)).all()
     return heroes