diff --git a/docs/en/docs/index.md b/docs/en/docs/index.md index b0acc9926..94bf7e1f2 100644 --- a/docs/en/docs/index.md +++ b/docs/en/docs/index.md @@ -178,6 +178,9 @@ def read_item(item_id: int, q: Union[str, None] = None): Or use async def... > **Tip:** Use `async def` when performing I/O-bound operations to fully benefit from FastAPI's asynchronous performance. +**Tip**: Use `async def` only when your code performs non-blocking I/O +(e.g. database calls, external APIs). For CPU-bound or blocking code, +prefer `def` to avoid performance issues. ```Python hl_lines="9 14"