From a71077c530fc4c73390f6222bb5a590dbac1ea07 Mon Sep 17 00:00:00 2001
From: Ben Falk <falk.ben@gmail.com>
Date: Thu, 1 Sep 2022 05:59:05 -0400
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20Update=20docs=20for=20`ORJSONRes?=
 =?UTF-8?q?ponse`=20with=20details=20about=20improving=20performance=20(#2?=
 =?UTF-8?q?615)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
---
 docs/en/docs/advanced/custom-response.md | 6 ++++++
 docs_src/custom_response/tutorial001b.py | 2 +-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/advanced/custom-response.md b/docs/en/docs/advanced/custom-response.md
index 3ca47bf3b..ce2619e8d 100644
--- a/docs/en/docs/advanced/custom-response.md
+++ b/docs/en/docs/advanced/custom-response.md
@@ -21,6 +21,12 @@ For example, if you are squeezing performance, you can install and use <a href="
 
 Import the `Response` class (sub-class) you want to use and declare it in the *path operation decorator*.
 
+For large responses, returning a `Response` directly is much faster than returning a dictionary.
+
+This is because by default, FastAPI will inspect every item inside and make sure it is serializable with JSON, using the same [JSON Compatible Encoder](../tutorial/encoder.md){.internal-link target=_blank} explained in the tutorial. This is what allows you to return **arbitrary objects**, for example database models.
+
+But if you are certain that the content that you are returning is **serializable with JSON**, you can pass it directly to the response class and avoid the extra overhead that FastAPI would have by passing your return content through the `jsonable_encoder` before passing it to the response class.
+
 ```Python hl_lines="2  7"
 {!../../../docs_src/custom_response/tutorial001b.py!}
 ```
diff --git a/docs_src/custom_response/tutorial001b.py b/docs_src/custom_response/tutorial001b.py
index e98460372..95e6ca763 100644
--- a/docs_src/custom_response/tutorial001b.py
+++ b/docs_src/custom_response/tutorial001b.py
@@ -6,4 +6,4 @@ app = FastAPI()
 
 @app.get("/items/", response_class=ORJSONResponse)
 async def read_items():
-    return [{"item_id": "Foo"}]
+    return ORJSONResponse([{"item_id": "Foo"}])