Merge 43e8a1a619 into c48539f4c6

docs/en/docs/async.md

@@ -349,6 +349,11 @@ async def read_burgers():
     return burgers
 ```
 
+**Clarification on `async def` usage**
+
+Using `async def` is beneficial primarily when the function performs I/O-bound work, such as awaiting network or disk operations (e.g. database calls, HTTP requests, or other non-blocking tasks). If a path operation function contains only blocking or CPU-bound code, defining it with `async def` does not provide performance benefits and may add unnecessary complexity. In such cases, using a regular `def` function is often simpler and clearer.
+
+
 ### More technical details { #more-technical-details }
 
 You might have noticed that `await` can only be used inside of functions defined with `async def`.