From 6c99e90a6b808a1d819ecc45bcf25751dd30b22b Mon Sep 17 00:00:00 2001
From: Marcelo Trylesinski <marcelotryle@gmail.com>
Date: Thu, 27 Jul 2023 19:22:23 +0100
Subject: [PATCH 001/317] =?UTF-8?q?=F0=9F=90=9B=20Replace=20`MultHostUrl`?=
 =?UTF-8?q?=20to=20`AnyUrl`=20for=20compatibility=20with=20older=20version?=
 =?UTF-8?q?s=20of=20Pydantic=20v1=20(#9852)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 fastapi/_compat.py  | 4 ----
 fastapi/encoders.py | 6 +++---
 2 files changed, 3 insertions(+), 7 deletions(-)

diff --git a/fastapi/_compat.py b/fastapi/_compat.py
index 2233fe33c..9ffcaf409 100644
--- a/fastapi/_compat.py
+++ b/fastapi/_compat.py
@@ -56,7 +56,6 @@ if PYDANTIC_V2:
     from pydantic.json_schema import GenerateJsonSchema as GenerateJsonSchema
     from pydantic.json_schema import JsonSchemaValue as JsonSchemaValue
     from pydantic_core import CoreSchema as CoreSchema
-    from pydantic_core import MultiHostUrl as MultiHostUrl
     from pydantic_core import PydanticUndefined, PydanticUndefinedType
     from pydantic_core import Url as Url
     from pydantic_core.core_schema import (
@@ -294,9 +293,6 @@ else:
     from pydantic.fields import (  # type: ignore[no-redef, attr-defined]
         UndefinedType as UndefinedType,  # noqa: F401
     )
-    from pydantic.networks import (  # type: ignore[no-redef]
-        MultiHostDsn as MultiHostUrl,  # noqa: F401
-    )
     from pydantic.schema import (
         field_schema,
         get_flat_models_from_fields,
diff --git a/fastapi/encoders.py b/fastapi/encoders.py
index b542749f2..30493697e 100644
--- a/fastapi/encoders.py
+++ b/fastapi/encoders.py
@@ -20,10 +20,10 @@ from uuid import UUID
 from fastapi.types import IncEx
 from pydantic import BaseModel
 from pydantic.color import Color
-from pydantic.networks import NameEmail
+from pydantic.networks import AnyUrl, NameEmail
 from pydantic.types import SecretBytes, SecretStr
 
-from ._compat import PYDANTIC_V2, MultiHostUrl, Url, _model_dump
+from ._compat import PYDANTIC_V2, Url, _model_dump
 
 
 # Taken from Pydantic v1 as is
@@ -80,7 +80,7 @@ ENCODERS_BY_TYPE: Dict[Type[Any], Callable[[Any], Any]] = {
     set: list,
     UUID: str,
     Url: str,
-    MultiHostUrl: str,
+    AnyUrl: str,
 }
 
 

From 7cdea41431a6b2abcb07cf8507592cb39f5eade1 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 27 Jul 2023 18:23:13 +0000
Subject: [PATCH 002/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 72fa346d1..84e3c4855 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🐛 Replace `MultHostUrl` to `AnyUrl` for compatibility with older versions of Pydantic v1. PR [#9852](https://github.com/tiangolo/fastapi/pull/9852) by [@Kludex](https://github.com/Kludex).
 * 👷 Update FastAPI People token. PR [#9844](https://github.com/tiangolo/fastapi/pull/9844) by [@tiangolo](https://github.com/tiangolo).
 * 👥 Update FastAPI People. PR [#9775](https://github.com/tiangolo/fastapi/pull/9775) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Update MkDocs Material token. PR [#9843](https://github.com/tiangolo/fastapi/pull/9843) by [@tiangolo](https://github.com/tiangolo).

From 703a1f200aa2c7dbba13e52407338ec1d691c1b5 Mon Sep 17 00:00:00 2001
From: Creat55 <64245796+Creat55@users.noreply.github.com>
Date: Fri, 28 Jul 2023 02:42:48 +0800
Subject: [PATCH 003/317] =?UTF-8?q?=F0=9F=8C=90=20Update=20Chinese=20trans?=
 =?UTF-8?q?lation=20for=20`docs/zh/docs/tutorial/handling-errors.md`=20(#9?=
 =?UTF-8?q?485)?=
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/zh/docs/tutorial/handling-errors.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/zh/docs/tutorial/handling-errors.md b/docs/zh/docs/tutorial/handling-errors.md
index 9b066bc2c..a0d66e557 100644
--- a/docs/zh/docs/tutorial/handling-errors.md
+++ b/docs/zh/docs/tutorial/handling-errors.md
@@ -145,7 +145,7 @@
 
 ```
 
-访问 `/items/foo`，可以看到以下内容替换了默认 JSON 错误信息：
+访问 `/items/foo`，可以看到默认的 JSON 错误信息：
 
 ```JSON
 {
@@ -163,7 +163,7 @@
 
 ```
 
-以下是文本格式的错误信息：
+被替换为了以下文本格式的错误信息：
 
 ```
 1 validation error

From 39318a39f40bec0d4919e09b397cfb44f0f623a0 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 27 Jul 2023 18:43:30 +0000
Subject: [PATCH 004/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 84e3c4855..7219156b8 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Update Chinese translation for `docs/zh/docs/tutorial/handling-errors.md`. PR [#9485](https://github.com/tiangolo/fastapi/pull/9485) by [@Creat55](https://github.com/Creat55).
 * 🐛 Replace `MultHostUrl` to `AnyUrl` for compatibility with older versions of Pydantic v1. PR [#9852](https://github.com/tiangolo/fastapi/pull/9852) by [@Kludex](https://github.com/Kludex).
 * 👷 Update FastAPI People token. PR [#9844](https://github.com/tiangolo/fastapi/pull/9844) by [@tiangolo](https://github.com/tiangolo).
 * 👥 Update FastAPI People. PR [#9775](https://github.com/tiangolo/fastapi/pull/9775) by [@tiangolo](https://github.com/tiangolo).

From 608cc4fea31130dca45806da06dd50e4d0f007dd Mon Sep 17 00:00:00 2001
From: dedkot <dedkot01@gmail.com>
Date: Thu, 27 Jul 2023 21:47:42 +0300
Subject: [PATCH 005/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Russian=20translat?=
 =?UTF-8?q?ion=20for=20`docs/tutorial/request-forms.md`=20(#9841)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/ru/docs/tutorial/request-forms.md | 92 ++++++++++++++++++++++++++
 1 file changed, 92 insertions(+)
 create mode 100644 docs/ru/docs/tutorial/request-forms.md

diff --git a/docs/ru/docs/tutorial/request-forms.md b/docs/ru/docs/tutorial/request-forms.md
new file mode 100644
index 000000000..a20cf78e0
--- /dev/null
+++ b/docs/ru/docs/tutorial/request-forms.md
@@ -0,0 +1,92 @@
+# Данные формы
+
+Когда вам нужно получить поля формы вместо JSON, вы можете использовать `Form`.
+
+!!! info "Дополнительная информация"
+    Чтобы использовать формы, сначала установите <a href="https://andrew-d.github.io/python-multipart/" class="external-link" target="_blank">`python-multipart`</a>.
+
+    Например, выполните команду `pip install python-multipart`.
+
+## Импорт `Form`
+
+Импортируйте `Form` из `fastapi`:
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/request_forms/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/request_forms/tutorial001_an.py!}
+    ```
+
+=== "Python 3.6+ без Annotated"
+
+    !!! tip "Подсказка"
+        Рекомендуется использовать 'Annotated' версию, если это возможно.
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/request_forms/tutorial001.py!}
+    ```
+
+## Определение параметров `Form`
+
+Создайте параметры формы так же, как это делается для `Body` или `Query`:
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/request_forms/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="8"
+    {!> ../../../docs_src/request_forms/tutorial001_an.py!}
+    ```
+
+=== "Python 3.6+ без Annotated"
+
+    !!! tip "Подсказка"
+        Рекомендуется использовать 'Annotated' версию, если это возможно.
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/request_forms/tutorial001.py!}
+    ```
+
+Например, в одном из способов использования спецификации OAuth2 (называемом "потоком пароля") требуется отправить `username` и `password` в виде полей формы.
+
+Данный способ требует отправку данных для авторизации посредством формы (а не JSON) и обязательного наличия в форме строго именованных полей  `username` и `password`.
+
+Вы можете настроить `Form` точно так же, как настраиваете и  `Body` ( `Query`, `Path`, `Cookie`), включая валидации, примеры, псевдонимы (например, `user-name` вместо `username`) и т.д.
+
+!!! info "Дополнительная информация"
+    `Form` - это класс, который наследуется непосредственно от `Body`.
+
+!!! tip "Подсказка"
+   Вам необходимо явно указывать параметр `Form` при объявлении каждого поля, иначе поля будут интерпретироваться как параметры запроса или параметры тела (JSON).
+
+## О "полях формы"
+
+Обычно способ, которым HTML-формы (`<form></form>`) отправляют данные на сервер, использует "специальное" кодирование для этих данных, отличное от JSON.
+
+**FastAPI** гарантирует правильное чтение этих данных из соответствующего места, а не из JSON.
+
+!!! note "Технические детали"
+    Данные из форм обычно кодируются с использованием "типа медиа" `application/x-www-form-urlencoded`.
+
+    Но когда форма содержит файлы, она кодируется как `multipart/form-data`. Вы узнаете о работе с файлами в следующей главе.
+
+    Если вы хотите узнать больше про кодировки и поля формы, ознакомьтесь с <a href="https://developer.mozilla.org/ru/docs/Web/HTTP/Methods/POST" class="external-link" target="_blank">документацией <abbr title="Mozilla Developer Network">MDN</abbr> для `POST` на веб-сайте</a>.
+
+!!! warning "Предупреждение"
+    Вы можете объявлять несколько параметров `Form` в *операции пути*, но вы не можете одновременно с этим объявлять поля `Body`, которые вы ожидаете получить в виде JSON, так как запрос будет иметь тело, закодированное с использованием `application/x-www-form-urlencoded`, а не `application/json`.
+
+    Это не ограничение **FastAPI**, это часть протокола HTTP.
+
+## Резюме
+
+Используйте `Form` для объявления входных параметров данных формы.

From 6a95a3a8e74a9373f830246570d23f8d7d593da9 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 27 Jul 2023 18:48:28 +0000
Subject: [PATCH 006/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 7219156b8..ad01f3c5b 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Russian translation for `docs/ru/docs/tutorial/request-forms.md`. PR [#9841](https://github.com/tiangolo/fastapi/pull/9841) by [@dedkot01](https://github.com/dedkot01).
 * 🌐 Update Chinese translation for `docs/zh/docs/tutorial/handling-errors.md`. PR [#9485](https://github.com/tiangolo/fastapi/pull/9485) by [@Creat55](https://github.com/Creat55).
 * 🐛 Replace `MultHostUrl` to `AnyUrl` for compatibility with older versions of Pydantic v1. PR [#9852](https://github.com/tiangolo/fastapi/pull/9852) by [@Kludex](https://github.com/Kludex).
 * 👷 Update FastAPI People token. PR [#9844](https://github.com/tiangolo/fastapi/pull/9844) by [@tiangolo](https://github.com/tiangolo).

From 943baa387f52084f80a3db2c7417093325b19917 Mon Sep 17 00:00:00 2001
From: mahone3297 <329730566@qq.com>
Date: Fri, 28 Jul 2023 02:49:03 +0800
Subject: [PATCH 007/317] =?UTF-8?q?=F0=9F=8C=90=20Update=20Chinese=20trans?=
 =?UTF-8?q?lations=20with=20new=20source=20files=20(#9738)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: mkdir700 <mkdir700@gmail.com>
---
 docs/zh/docs/tutorial/body-fields.md          |  76 +++++++-
 docs/zh/docs/tutorial/body-multiple-params.md | 166 ++++++++++++++--
 docs/zh/docs/tutorial/body-nested-models.md   | 184 +++++++++++++++---
 docs/zh/docs/tutorial/body.md                 |  84 ++++++--
 docs/zh/docs/tutorial/cookie-params.md        |  76 +++++++-
 docs/zh/docs/tutorial/extra-data-types.md     |  76 +++++++-
 docs/zh/docs/tutorial/extra-models.md         |  70 +++++--
 docs/zh/docs/tutorial/header-params.md        | 161 +++++++++++++--
 .../path-params-numeric-validations.md        |  87 ++++++++-
 .../tutorial/query-params-str-validations.md  |  14 +-
 docs/zh/docs/tutorial/response-model.md       |  62 ++++--
 docs/zh/docs/tutorial/schema-extra-example.md |  66 ++++++-
 docs/zh/docs/tutorial/security/first-steps.md |  23 ++-
 13 files changed, 1000 insertions(+), 145 deletions(-)

diff --git a/docs/zh/docs/tutorial/body-fields.md b/docs/zh/docs/tutorial/body-fields.md
index 053cae71c..c153784dc 100644
--- a/docs/zh/docs/tutorial/body-fields.md
+++ b/docs/zh/docs/tutorial/body-fields.md
@@ -6,9 +6,41 @@
 
 首先，你必须导入它：
 
-```Python hl_lines="2"
-{!../../../docs_src/body_fields/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="4"
+    {!> ../../../docs_src/body_fields/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="4"
+    {!> ../../../docs_src/body_fields/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="4"
+    {!> ../../../docs_src/body_fields/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="2"
+    {!> ../../../docs_src/body_fields/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="4"
+    {!> ../../../docs_src/body_fields/tutorial001.py!}
+    ```
 
 !!! warning
     注意，`Field` 是直接从 `pydantic` 导入的，而不是像其他的（`Query`，`Path`，`Body` 等）都从 `fastapi` 导入。
@@ -17,9 +49,41 @@
 
 然后，你可以对模型属性使用 `Field`：
 
-```Python hl_lines="9-10"
-{!../../../docs_src/body_fields/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="11-14"
+    {!> ../../../docs_src/body_fields/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="11-14"
+    {!> ../../../docs_src/body_fields/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="12-15"
+    {!> ../../../docs_src/body_fields/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        Prefer to use the `Annotated` version if possible.
+
+    ```Python hl_lines="9-12"
+    {!> ../../../docs_src/body_fields/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        Prefer to use the `Annotated` version if possible.
+
+    ```Python hl_lines="11-14"
+    {!> ../../../docs_src/body_fields/tutorial001.py!}
+    ```
 
 `Field` 的工作方式和 `Query`、`Path` 和 `Body` 相同，包括它们的参数等等也完全相同。
 
diff --git a/docs/zh/docs/tutorial/body-multiple-params.md b/docs/zh/docs/tutorial/body-multiple-params.md
index 34fa5b638..ee2cba6df 100644
--- a/docs/zh/docs/tutorial/body-multiple-params.md
+++ b/docs/zh/docs/tutorial/body-multiple-params.md
@@ -8,9 +8,41 @@
 
 你还可以通过将默认值设置为 `None` 来将请求体参数声明为可选参数：
 
-```Python hl_lines="17-19"
-{!../../../docs_src/body_multiple_params/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="18-20"
+    {!> ../../../docs_src/body_multiple_params/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="18-20"
+    {!> ../../../docs_src/body_multiple_params/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="19-21"
+    {!> ../../../docs_src/body_multiple_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="17-19"
+    {!> ../../../docs_src/body_multiple_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="19-21"
+    {!> ../../../docs_src/body_multiple_params/tutorial001.py!}
+    ```
 
 !!! note
     请注意，在这种情况下，将从请求体获取的 `item` 是可选的。因为它的默认值为 `None`。
@@ -30,9 +62,17 @@
 
 但是你也可以声明多个请求体参数，例如 `item` 和 `user`：
 
-```Python hl_lines="20"
-{!../../../docs_src/body_multiple_params/tutorial002.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="20"
+    {!> ../../../docs_src/body_multiple_params/tutorial002_py310.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="22"
+    {!> ../../../docs_src/body_multiple_params/tutorial002.py!}
+    ```
 
 在这种情况下，**FastAPI** 将注意到该函数中有多个请求体参数（两个 Pydantic 模型参数）。
 
@@ -72,9 +112,41 @@
 但是你可以使用 `Body` 指示 **FastAPI** 将其作为请求体的另一个键进行处理。
 
 
-```Python hl_lines="22"
-{!../../../docs_src/body_multiple_params/tutorial003.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="23"
+    {!> ../../../docs_src/body_multiple_params/tutorial003_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="23"
+    {!> ../../../docs_src/body_multiple_params/tutorial003_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="24"
+    {!> ../../../docs_src/body_multiple_params/tutorial003_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="20"
+    {!> ../../../docs_src/body_multiple_params/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="22"
+    {!> ../../../docs_src/body_multiple_params/tutorial003.py!}
+    ```
 
 在这种情况下，**FastAPI** 将期望像这样的请求体：
 
@@ -109,9 +181,41 @@ q: str = None
 
 比如：
 
-```Python hl_lines="25"
-{!../../../docs_src/body_multiple_params/tutorial004.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="27"
+    {!> ../../../docs_src/body_multiple_params/tutorial004_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="27"
+    {!> ../../../docs_src/body_multiple_params/tutorial004_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="28"
+    {!> ../../../docs_src/body_multiple_params/tutorial004_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="25"
+    {!> ../../../docs_src/body_multiple_params/tutorial004_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="27"
+    {!> ../../../docs_src/body_multiple_params/tutorial004.py!}
+    ```
 
 !!! info
     `Body` 同样具有与 `Query`、`Path` 以及其他后面将看到的类完全相同的额外校验和元数据参数。
@@ -131,9 +235,41 @@ item: Item = Body(embed=True)
 
 比如：
 
-```Python hl_lines="15"
-{!../../../docs_src/body_multiple_params/tutorial005.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="17"
+    {!> ../../../docs_src/body_multiple_params/tutorial005_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="17"
+    {!> ../../../docs_src/body_multiple_params/tutorial005_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="18"
+    {!> ../../../docs_src/body_multiple_params/tutorial005_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="15"
+    {!> ../../../docs_src/body_multiple_params/tutorial005_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="17"
+    {!> ../../../docs_src/body_multiple_params/tutorial005.py!}
+    ```
 
 在这种情况下，**FastAPI** 将期望像这样的请求体：
 
diff --git a/docs/zh/docs/tutorial/body-nested-models.md b/docs/zh/docs/tutorial/body-nested-models.md
index 7649ee6fe..7704d2624 100644
--- a/docs/zh/docs/tutorial/body-nested-models.md
+++ b/docs/zh/docs/tutorial/body-nested-models.md
@@ -6,9 +6,17 @@
 
 你可以将一个属性定义为拥有子元素的类型。例如 Python `list`：
 
-```Python hl_lines="12"
-{!../../../docs_src/body_nested_models/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="12"
+    {!> ../../../docs_src/body_nested_models/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="14"
+    {!> ../../../docs_src/body_nested_models/tutorial001.py!}
+    ```
 
 这将使 `tags` 成为一个由元素组成的列表。不过它没有声明每个元素的类型。
 
@@ -21,7 +29,7 @@
 首先，从 Python 的标准库 `typing` 模块中导入 `List`：
 
 ```Python hl_lines="1"
-{!../../../docs_src/body_nested_models/tutorial002.py!}
+{!> ../../../docs_src/body_nested_models/tutorial002.py!}
 ```
 
 ### 声明具有子类型的 List
@@ -43,9 +51,23 @@ my_list: List[str]
 
 因此，在我们的示例中，我们可以将 `tags` 明确地指定为一个「字符串列表」：
 
-```Python hl_lines="14"
-{!../../../docs_src/body_nested_models/tutorial002.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="12"
+    {!> ../../../docs_src/body_nested_models/tutorial002_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="14"
+    {!> ../../../docs_src/body_nested_models/tutorial002_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="14"
+    {!> ../../../docs_src/body_nested_models/tutorial002.py!}
+    ```
 
 ## Set 类型
 
@@ -55,9 +77,23 @@ Python 具有一种特殊的数据类型来保存一组唯一的元素，即 `se
 
 然后我们可以导入 `Set` 并将 `tag` 声明为一个由 `str` 组成的 `set`：
 
-```Python hl_lines="1 14"
-{!../../../docs_src/body_nested_models/tutorial003.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="12"
+    {!> ../../../docs_src/body_nested_models/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="14"
+    {!> ../../../docs_src/body_nested_models/tutorial003_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="1  14"
+    {!> ../../../docs_src/body_nested_models/tutorial003.py!}
+    ```
 
 这样，即使你收到带有重复数据的请求，这些数据也会被转换为一组唯一项。
 
@@ -79,17 +115,45 @@ Pydantic 模型的每个属性都具有类型。
 
 例如，我们可以定义一个 `Image` 模型：
 
-```Python hl_lines="9 10 11"
-{!../../../docs_src/body_nested_models/tutorial004.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="7-9"
+    {!> ../../../docs_src/body_nested_models/tutorial004_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="9-11"
+    {!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="9-11"
+    {!> ../../../docs_src/body_nested_models/tutorial004.py!}
+    ```
 
 ### 将子模型用作类型
 
 然后我们可以将其用作一个属性的类型：
 
-```Python hl_lines="20"
-{!../../../docs_src/body_nested_models/tutorial004.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="18"
+    {!> ../../../docs_src/body_nested_models/tutorial004_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="20"
+    {!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="20"
+    {!> ../../../docs_src/body_nested_models/tutorial004.py!}
+    ```
 
 这意味着 **FastAPI** 将期望类似于以下内容的请求体：
 
@@ -122,9 +186,23 @@ Pydantic 模型的每个属性都具有类型。
 
 例如，在 `Image` 模型中我们有一个 `url` 字段，我们可以把它声明为 Pydantic 的 `HttpUrl`，而不是 `str`：
 
-```Python hl_lines="4 10"
-{!../../../docs_src/body_nested_models/tutorial005.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="2  8"
+    {!> ../../../docs_src/body_nested_models/tutorial005_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="4  10"
+    {!> ../../../docs_src/body_nested_models/tutorial005_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="4  10"
+    {!> ../../../docs_src/body_nested_models/tutorial005.py!}
+    ```
 
 该字符串将被检查是否为有效的 URL，并在 JSON Schema / OpenAPI 文档中进行记录。
 
@@ -132,9 +210,23 @@ Pydantic 模型的每个属性都具有类型。
 
 你还可以将 Pydantic 模型用作 `list`、`set` 等的子类型：
 
-```Python hl_lines="20"
-{!../../../docs_src/body_nested_models/tutorial006.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="18"
+    {!> ../../../docs_src/body_nested_models/tutorial006_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="20"
+    {!> ../../../docs_src/body_nested_models/tutorial006_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="20"
+    {!> ../../../docs_src/body_nested_models/tutorial006.py!}
+    ```
 
 这将期望（转换，校验，记录文档等）下面这样的 JSON 请求体：
 
@@ -169,9 +261,23 @@ Pydantic 模型的每个属性都具有类型。
 
 你可以定义任意深度的嵌套模型：
 
-```Python hl_lines="9 14 20 23 27"
-{!../../../docs_src/body_nested_models/tutorial007.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="7  12  18  21  25"
+    {!> ../../../docs_src/body_nested_models/tutorial007_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="9  14  20  23  27"
+    {!> ../../../docs_src/body_nested_models/tutorial007_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="9  14  20  23  27"
+    {!> ../../../docs_src/body_nested_models/tutorial007.py!}
+    ```
 
 !!! info
     请注意 `Offer` 拥有一组 `Item` 而反过来 `Item` 又是一个可选的 `Image` 列表是如何发生的。
@@ -186,9 +292,17 @@ images: List[Image]
 
 例如：
 
-```Python hl_lines="15"
-{!../../../docs_src/body_nested_models/tutorial008.py!}
-```
+=== "Python 3.9+"
+
+    ```Python hl_lines="13"
+    {!> ../../../docs_src/body_nested_models/tutorial008_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="15"
+    {!> ../../../docs_src/body_nested_models/tutorial008.py!}
+    ```
 
 ## 无处不在的编辑器支持
 
@@ -218,9 +332,17 @@ images: List[Image]
 
 在下面的例子中，你将接受任意键为 `int` 类型并且值为 `float` 类型的 `dict`：
 
-```Python hl_lines="15"
-{!../../../docs_src/body_nested_models/tutorial009.py!}
-```
+=== "Python 3.9+"
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/body_nested_models/tutorial009_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/body_nested_models/tutorial009.py!}
+    ```
 
 !!! tip
     请记住 JSON 仅支持将 `str` 作为键。
diff --git a/docs/zh/docs/tutorial/body.md b/docs/zh/docs/tutorial/body.md
index f80ab5bf5..d00c96dc3 100644
--- a/docs/zh/docs/tutorial/body.md
+++ b/docs/zh/docs/tutorial/body.md
@@ -17,9 +17,17 @@
 
 首先，你需要从 `pydantic` 中导入 `BaseModel`：
 
-```Python hl_lines="2"
-{!../../../docs_src/body/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="2"
+    {!> ../../../docs_src/body/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="4"
+    {!> ../../../docs_src/body/tutorial001.py!}
+    ```
 
 ## 创建数据模型
 
@@ -27,9 +35,17 @@
 
 使用标准的 Python 类型来声明所有属性：
 
-```Python hl_lines="5-9"
-{!../../../docs_src/body/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="5-9"
+    {!> ../../../docs_src/body/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="7-11"
+    {!> ../../../docs_src/body/tutorial001.py!}
+    ```
 
 和声明查询参数时一样，当一个模型属性具有默认值时，它不是必需的。否则它是一个必需属性。将默认值设为 `None` 可使其成为可选属性。
 
@@ -57,9 +73,17 @@
 
 使用与声明路径和查询参数的相同方式声明请求体，即可将其添加到「路径操作」中：
 
-```Python hl_lines="16"
-{!../../../docs_src/body/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="16"
+    {!> ../../../docs_src/body/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="18"
+    {!> ../../../docs_src/body/tutorial001.py!}
+    ```
 
 ...并且将它的类型声明为你创建的 `Item` 模型。
 
@@ -112,9 +136,17 @@ Pydantic 本身甚至也进行了一些更改以支持此功能。
 
 在函数内部，你可以直接访问模型对象的所有属性：
 
-```Python hl_lines="19"
-{!../../../docs_src/body/tutorial002.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="19"
+    {!> ../../../docs_src/body/tutorial002_py310.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="21"
+    {!> ../../../docs_src/body/tutorial002.py!}
+    ```
 
 ## 请求体 + 路径参数
 
@@ -122,9 +154,17 @@ Pydantic 本身甚至也进行了一些更改以支持此功能。
 
 **FastAPI** 将识别出与路径参数匹配的函数参数应**从路径中获取**，而声明为 Pydantic 模型的函数参数应**从请求体中获取**。
 
-```Python hl_lines="15-16"
-{!../../../docs_src/body/tutorial003.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="15-16"
+    {!> ../../../docs_src/body/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="17-18"
+    {!> ../../../docs_src/body/tutorial003.py!}
+    ```
 
 ## 请求体 + 路径参数 + 查询参数
 
@@ -132,9 +172,17 @@ Pydantic 本身甚至也进行了一些更改以支持此功能。
 
 **FastAPI** 会识别它们中的每一个，并从正确的位置获取数据。
 
-```Python hl_lines="16"
-{!../../../docs_src/body/tutorial004.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="16"
+    {!> ../../../docs_src/body/tutorial004_py310.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="18"
+    {!> ../../../docs_src/body/tutorial004.py!}
+    ```
 
 函数参数将依次按如下规则进行识别：
 
diff --git a/docs/zh/docs/tutorial/cookie-params.md b/docs/zh/docs/tutorial/cookie-params.md
index d67daf0f9..470fd8e82 100644
--- a/docs/zh/docs/tutorial/cookie-params.md
+++ b/docs/zh/docs/tutorial/cookie-params.md
@@ -6,9 +6,41 @@
 
 首先，导入 `Cookie`:
 
-```Python hl_lines="3"
-{!../../../docs_src/cookie_params/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001.py!}
+    ```
 
 ## 声明 `Cookie` 参数
 
@@ -17,9 +49,41 @@
 第一个值是参数的默认值，同时也可以传递所有验证参数或注释参数，来校验参数：
 
 
-```Python hl_lines="9"
-{!../../../docs_src/cookie_params/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/cookie_params/tutorial001.py!}
+    ```
 
 !!! note "技术细节"
     `Cookie` 、`Path` 、`Query`是兄弟类，它们都继承自公共的 `Param` 类
diff --git a/docs/zh/docs/tutorial/extra-data-types.md b/docs/zh/docs/tutorial/extra-data-types.md
index ac3e07654..76d606903 100644
--- a/docs/zh/docs/tutorial/extra-data-types.md
+++ b/docs/zh/docs/tutorial/extra-data-types.md
@@ -55,12 +55,76 @@
 
 下面是一个*路径操作*的示例，其中的参数使用了上面的一些类型。
 
-```Python hl_lines="1  3  12-16"
-{!../../../docs_src/extra_data_types/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="1  3  12-16"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="1  3  12-16"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="1  3  13-17"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="1  2  11-15"
+    {!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="1  2  12-16"
+    {!> ../../../docs_src/extra_data_types/tutorial001.py!}
+    ```
 
 注意，函数内的参数有原生的数据类型，你可以，例如，执行正常的日期操作，如:
 
-```Python hl_lines="18-19"
-{!../../../docs_src/extra_data_types/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="18-19"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="18-19"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="19-20"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="17-18"
+    {!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="18-19"
+    {!> ../../../docs_src/extra_data_types/tutorial001.py!}
+    ```
diff --git a/docs/zh/docs/tutorial/extra-models.md b/docs/zh/docs/tutorial/extra-models.md
index 1fbe77be8..32f8f9df1 100644
--- a/docs/zh/docs/tutorial/extra-models.md
+++ b/docs/zh/docs/tutorial/extra-models.md
@@ -17,9 +17,17 @@
 
 下面是应该如何根据它们的密码字段以及使用位置去定义模型的大概思路：
 
-```Python hl_lines="9  11  16  22  24  29-30  33-35  40-41"
-{!../../../docs_src/extra_models/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="7  9  14  20  22  27-28  31-33  38-39"
+    {!> ../../../docs_src/extra_models/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="9  11  16  22  24  29-30  33-35  40-41"
+    {!> ../../../docs_src/extra_models/tutorial001.py!}
+    ```
 
 ### 关于 `**user_in.dict()`
 
@@ -150,9 +158,17 @@ UserInDB(
 
 这样，我们可以仅声明模型之间的差异部分（具有明文的 `password`、具有 `hashed_password` 以及不包括密码）。
 
-```Python hl_lines="9  15-16  19-20  23-24"
-{!../../../docs_src/extra_models/tutorial002.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="7  13-14  17-18  21-22"
+    {!> ../../../docs_src/extra_models/tutorial002_py310.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="9  15-16  19-20  23-24"
+    {!> ../../../docs_src/extra_models/tutorial002.py!}
+    ```
 
 ## `Union` 或者 `anyOf`
 
@@ -166,9 +182,17 @@ UserInDB(
 !!! note
     定义一个 <a href="https://pydantic-docs.helpmanual.io/usage/types/#unions" class="external-link" target="_blank">`Union`</a> 类型时，首先包括最详细的类型，然后是不太详细的类型。在下面的示例中，更详细的 `PlaneItem` 位于 `Union[PlaneItem，CarItem]` 中的 `CarItem` 之前。
 
-```Python hl_lines="1  14-15  18-20  33"
-{!../../../docs_src/extra_models/tutorial003.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="1  14-15  18-20  33"
+    {!> ../../../docs_src/extra_models/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="1  14-15  18-20  33"
+    {!> ../../../docs_src/extra_models/tutorial003.py!}
+    ```
 
 ## 模型列表
 
@@ -176,9 +200,17 @@ UserInDB(
 
 为此，请使用标准的 Python `typing.List`：
 
-```Python hl_lines="1  20"
-{!../../../docs_src/extra_models/tutorial004.py!}
-```
+=== "Python 3.9+"
+
+    ```Python hl_lines="18"
+    {!> ../../../docs_src/extra_models/tutorial004_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="1  20"
+    {!> ../../../docs_src/extra_models/tutorial004.py!}
+    ```
 
 ## 任意 `dict` 构成的响应
 
@@ -188,9 +220,17 @@ UserInDB(
 
 在这种情况下，你可以使用 `typing.Dict`：
 
-```Python hl_lines="1  8"
-{!../../../docs_src/extra_models/tutorial005.py!}
-```
+=== "Python 3.9+"
+
+    ```Python hl_lines="6"
+    {!> ../../../docs_src/extra_models/tutorial005_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="1  8"
+    {!> ../../../docs_src/extra_models/tutorial005.py!}
+    ```
 
 ## 总结
 
diff --git a/docs/zh/docs/tutorial/header-params.md b/docs/zh/docs/tutorial/header-params.md
index c4b1c38ce..22ff6dc27 100644
--- a/docs/zh/docs/tutorial/header-params.md
+++ b/docs/zh/docs/tutorial/header-params.md
@@ -6,9 +6,41 @@
 
 首先导入 `Header`:
 
-```Python hl_lines="3"
-{!../../../docs_src/header_params/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/header_params/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/header_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/header_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/header_params/tutorial001.py!}
+    ```
 
 ## 声明 `Header` 参数
 
@@ -16,9 +48,41 @@
 
 第一个值是默认值，你可以传递所有的额外验证或注释参数：
 
-```Python hl_lines="9"
-{!../../../docs_src/header_params/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/header_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/header_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial001.py!}
+    ```
 
 !!! note "技术细节"
     `Header` 是 `Path`, `Query` 和 `Cookie` 的兄弟类型。它也继承自通用的 `Param` 类.
@@ -44,9 +108,41 @@
 
 如果出于某些原因，你需要禁用下划线到连字符的自动转换，设置`Header`的参数 `convert_underscores` 为 `False`:
 
-```Python hl_lines="10"
-{!../../../docs_src/header_params/tutorial002.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/header_params/tutorial002_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="11"
+    {!> ../../../docs_src/header_params/tutorial002_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="12"
+    {!> ../../../docs_src/header_params/tutorial002_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="8"
+    {!> ../../../docs_src/header_params/tutorial002_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/header_params/tutorial002.py!}
+    ```
 
 !!! warning
     在设置 `convert_underscores` 为 `False` 之前，请记住，一些HTTP代理和服务器不允许使用带有下划线的headers。
@@ -62,9 +158,50 @@
 
 比如, 为了声明一个 `X-Token` header 可以出现多次，你可以这样写：
 
-```Python hl_lines="9"
-{!../../../docs_src/header_params/tutorial003.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial003_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial003_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/header_params/tutorial003_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        Prefer to use the `Annotated` version if possible.
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/header_params/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.9+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial003_py39.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial003.py!}
+    ```
 
 如果你与*路径操作*通信时发送两个HTTP headers，就像：
 
diff --git a/docs/zh/docs/tutorial/path-params-numeric-validations.md b/docs/zh/docs/tutorial/path-params-numeric-validations.md
index 13512a08e..78fa922b4 100644
--- a/docs/zh/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/zh/docs/tutorial/path-params-numeric-validations.md
@@ -6,9 +6,41 @@
 
 首先，从 `fastapi` 导入 `Path`：
 
-```Python hl_lines="1"
-{!../../../docs_src/path_params_numeric_validations/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="1  3"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="1  3"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="3-4"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+    ```
 
 ## 声明元数据
 
@@ -16,9 +48,41 @@
 
 例如，要声明路径参数 `item_id`的 `title` 元数据值，你可以输入：
 
-```Python hl_lines="8"
-{!../../../docs_src/path_params_numeric_validations/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="11"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="8"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
+    ```
 
 !!! note
     路径参数总是必需的，因为它必须是路径的一部分。
@@ -43,9 +107,14 @@
 
 因此，你可以将函数声明为：
 
-```Python hl_lines="7"
-{!../../../docs_src/path_params_numeric_validations/tutorial002.py!}
-```
+=== "Python 3.6 non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/path_params_numeric_validations/tutorial002.py!}
+    ```
 
 ## 按需对参数排序的技巧
 
diff --git a/docs/zh/docs/tutorial/query-params-str-validations.md b/docs/zh/docs/tutorial/query-params-str-validations.md
index 070074839..7244aeade 100644
--- a/docs/zh/docs/tutorial/query-params-str-validations.md
+++ b/docs/zh/docs/tutorial/query-params-str-validations.md
@@ -4,9 +4,17 @@
 
 让我们以下面的应用程序为例：
 
-```Python hl_lines="7"
-{!../../../docs_src/query_params_str_validations/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/query_params_str_validations/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/query_params_str_validations/tutorial001.py!}
+    ```
 
 查询参数 `q` 的类型为 `str`，默认值为 `None`，因此它是可选的。
 
diff --git a/docs/zh/docs/tutorial/response-model.md b/docs/zh/docs/tutorial/response-model.md
index ea3d0666d..f529cb0d8 100644
--- a/docs/zh/docs/tutorial/response-model.md
+++ b/docs/zh/docs/tutorial/response-model.md
@@ -8,9 +8,23 @@
 * `@app.delete()`
 * 等等。
 
-```Python hl_lines="17"
-{!../../../docs_src/response_model/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="17  22  24-27"
+    {!> ../../../docs_src/response_model/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="17  22  24-27"
+    {!> ../../../docs_src/response_model/tutorial001_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="17  22  24-27"
+    {!> ../../../docs_src/response_model/tutorial001.py!}
+    ```
 
 !!! note
     注意，`response_model`是「装饰器」方法（`get`，`post` 等）的一个参数。不像之前的所有参数和请求体，它不属于*路径操作函数*。
@@ -58,21 +72,45 @@ FastAPI 将使用此 `response_model` 来：
 
 相反，我们可以创建一个有明文密码的输入模型和一个没有明文密码的输出模型：
 
-```Python hl_lines="9  11  16"
-{!../../../docs_src/response_model/tutorial003.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="9  11  16"
+    {!> ../../../docs_src/response_model/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="9  11  16"
+    {!> ../../../docs_src/response_model/tutorial003.py!}
+    ```
 
 这样，即便我们的*路径操作函数*将会返回包含密码的相同输入用户：
 
-```Python hl_lines="24"
-{!../../../docs_src/response_model/tutorial003.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="24"
+    {!> ../../../docs_src/response_model/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="24"
+    {!> ../../../docs_src/response_model/tutorial003.py!}
+    ```
 
 ...我们已经将 `response_model` 声明为了不包含密码的 `UserOut` 模型：
 
-```Python hl_lines="22"
-{!../../../docs_src/response_model/tutorial003.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="22"
+    {!> ../../../docs_src/response_model/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="22"
+    {!> ../../../docs_src/response_model/tutorial003.py!}
+    ```
 
 因此，**FastAPI** 将会负责过滤掉未在输出模型中声明的所有数据（使用 Pydantic）。
 
diff --git a/docs/zh/docs/tutorial/schema-extra-example.md b/docs/zh/docs/tutorial/schema-extra-example.md
index 8f5fbfe70..816e8f68e 100644
--- a/docs/zh/docs/tutorial/schema-extra-example.md
+++ b/docs/zh/docs/tutorial/schema-extra-example.md
@@ -10,9 +10,17 @@
 
 您可以使用 `Config` 和 `schema_extra` 为Pydantic模型声明一个示例，如<a href="https://pydantic-docs.helpmanual.io/usage/schema/#schema-customization" class="external-link" target="_blank">Pydantic 文档：定制 Schema </a>中所述:
 
-```Python hl_lines="15-23"
-{!../../../docs_src/schema_extra_example/tutorial001.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="13-21"
+    {!> ../../../docs_src/schema_extra_example/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="15-23"
+    {!> ../../../docs_src/schema_extra_example/tutorial001.py!}
+    ```
 
 这些额外的信息将按原样添加到输出的JSON模式中。
 
@@ -20,9 +28,17 @@
 
 在 `Field`, `Path`, `Query`, `Body` 和其他你之后将会看到的工厂函数，你可以为JSON 模式声明额外信息，你也可以通过给工厂函数传递其他的任意参数来给JSON 模式声明额外信息，比如增加 `example`:
 
-```Python hl_lines="4  10-13"
-{!../../../docs_src/schema_extra_example/tutorial002.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="2  8-11"
+    {!> ../../../docs_src/schema_extra_example/tutorial002_py310.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="4  10-13"
+    {!> ../../../docs_src/schema_extra_example/tutorial002.py!}
+    ```
 
 !!! warning
     请记住，传递的那些额外参数不会添加任何验证，只会添加注释，用于文档的目的。
@@ -33,9 +49,41 @@
 
 比如，你可以将请求体的一个 `example` 传递给 `Body`:
 
-```Python hl_lines="20-25"
-{!../../../docs_src/schema_extra_example/tutorial003.py!}
-```
+=== "Python 3.10+"
+
+    ```Python hl_lines="22-27"
+    {!> ../../../docs_src/schema_extra_example/tutorial003_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="22-27"
+    {!> ../../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="23-28"
+    {!> ../../../docs_src/schema_extra_example/tutorial003_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="18-23"
+    {!> ../../../docs_src/schema_extra_example/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="20-25"
+    {!> ../../../docs_src/schema_extra_example/tutorial003.py!}
+    ```
 
 ## 文档 UI 中的例子
 
diff --git a/docs/zh/docs/tutorial/security/first-steps.md b/docs/zh/docs/tutorial/security/first-steps.md
index 86c3320ce..7b1052e12 100644
--- a/docs/zh/docs/tutorial/security/first-steps.md
+++ b/docs/zh/docs/tutorial/security/first-steps.md
@@ -20,9 +20,26 @@
 
 把下面的示例代码复制到 `main.py`：
 
-```Python
-{!../../../docs_src/security/tutorial001.py!}
-```
+=== "Python 3.9+"
+
+    ```Python
+    {!> ../../../docs_src/security/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python
+    {!> ../../../docs_src/security/tutorial001_an.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        尽可能选择使用 `Annotated` 的版本。
+
+    ```Python
+    {!> ../../../docs_src/security/tutorial001.py!}
+    ```
 
 ## 运行
 

From 3ffebbcf0165faf79fe8105c7a6c878f4ba2d9f3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Cl=C3=A9ment=20Sauvage?= <cl.sauvage@yahoo.com>
Date: Thu, 27 Jul 2023 20:49:56 +0200
Subject: [PATCH 008/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20French=20translati?=
 =?UTF-8?q?on=20for=20`docs/fr/docs/benchmarks.md`=20(#2155)?=
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>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Sam Courtemanche <smlep.pro@gmail.com>
Co-authored-by: Ruidy <ruidy.nemausat@gmail.com>
---
 docs/fr/docs/benchmarks.md | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)
 create mode 100644 docs/fr/docs/benchmarks.md

diff --git a/docs/fr/docs/benchmarks.md b/docs/fr/docs/benchmarks.md
new file mode 100644
index 000000000..d33c263a2
--- /dev/null
+++ b/docs/fr/docs/benchmarks.md
@@ -0,0 +1,34 @@
+# Test de performance
+
+Les tests de performance de TechEmpower montrent que les applications **FastAPI** tournant sous Uvicorn comme <a href="https://www.techempower.com/benchmarks/#section=test&runid=7464e520-0dc2-473d-bd34-dbdfd7e85911&hw=ph&test=query&l=zijzen-7" class="external-link" target="_blank">étant l'un des frameworks Python les plus rapides disponibles</a>, seulement inférieur à Starlette et Uvicorn (tous deux utilisés au cœur de FastAPI). (*)
+
+Mais en prêtant attention aux tests de performance et aux comparaisons, il faut tenir compte de ce qu'il suit.
+
+## Tests de performance et rapidité
+
+Lorsque vous vérifiez les tests de performance, il est commun de voir plusieurs outils de différents types comparés comme équivalents.
+
+En particulier, on voit Uvicorn, Starlette et FastAPI comparés (parmi de nombreux autres outils).
+
+Plus le problème résolu par un outil est simple, mieux seront les performances obtenues. Et la plupart des tests de performance ne prennent pas en compte les fonctionnalités additionnelles fournies par les outils.
+
+La hiérarchie est la suivante :
+
+* **Uvicorn** : un serveur ASGI
+    * **Starlette** : (utilise Uvicorn) un micro-framework web
+        * **FastAPI**: (utilise Starlette) un micro-framework pour API disposant de fonctionnalités additionnelles pour la création d'API, avec la validation des données, etc.
+
+* **Uvicorn** :
+    * A les meilleures performances, étant donné qu'il n'a pas beaucoup de code mis-à-part le serveur en lui-même.
+    * On n'écrit pas une application avec uniquement Uvicorn. Cela signifie que le code devrait inclure plus ou moins, au minimum, tout le code offert par Starlette (ou **FastAPI**). Et si on fait cela, l'application finale apportera les mêmes complications que si on avait utilisé un framework et que l'on avait minimisé la quantité de code et de bugs.
+    * Si on compare Uvicorn, il faut le comparer à d'autre applications de serveurs comme Daphne, Hypercorn, uWSGI, etc.
+* **Starlette** :
+    * A les seconde meilleures performances après Uvicorn. Starlette utilise en réalité Uvicorn. De ce fait, il ne peut qu’être plus "lent" qu'Uvicorn car il requiert l'exécution de plus de code.
+    * Cependant il nous apporte les outils pour construire une application web simple, avec un routage basé sur des chemins, etc.
+    * Si on compare Starlette, il faut le comparer à d'autres frameworks web (ou micorframework) comme Sanic, Flask, Django, etc.
+* **FastAPI** :
+    * Comme Starlette, FastAPI utilise Uvicorn et ne peut donc pas être plus rapide que ce dernier.
+    * FastAPI apporte des fonctionnalités supplémentaires à Starlette. Des fonctionnalités qui sont nécessaires presque systématiquement lors de la création d'une API, comme la validation des données, la sérialisation. En utilisant FastAPI, on obtient une documentation automatiquement (qui ne requiert aucune manipulation pour être mise en place).
+    * Si on n'utilisait pas FastAPI mais directement Starlette (ou un outil équivalent comme Sanic, Flask, Responder, etc) il faudrait implémenter la validation des données et la sérialisation par nous-même. Le résultat serait donc le même dans les deux cas mais du travail supplémentaire serait à réaliser avec Starlette, surtout en considérant que la validation des données et la sérialisation représentent la plus grande quantité de code à écrire dans une application.
+    * De ce fait, en utilisant FastAPI on minimise le temps de développement, les bugs, le nombre de lignes de code, et on obtient les mêmes performances (si ce n'est de meilleurs performances) que l'on aurait pu avoir sans ce framework (en ayant à implémenter de nombreuses fonctionnalités importantes par nous-mêmes).
+    * Si on compare FastAPI, il faut le comparer à d'autres frameworks web (ou ensemble d'outils) qui fournissent la validation des données, la sérialisation et la documentation, comme Flask-apispec, NestJS, Molten, etc.

From d7c6894b8bd1584cbf29cc11fb6148c40d03a52d Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 27 Jul 2023 18:50:16 +0000
Subject: [PATCH 009/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ad01f3c5b..b203afe33 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Update Chinese translations with new source files. PR [#9738](https://github.com/tiangolo/fastapi/pull/9738) by [@mahone3297](https://github.com/mahone3297).
 * 🌐 Add Russian translation for `docs/ru/docs/tutorial/request-forms.md`. PR [#9841](https://github.com/tiangolo/fastapi/pull/9841) by [@dedkot01](https://github.com/dedkot01).
 * 🌐 Update Chinese translation for `docs/zh/docs/tutorial/handling-errors.md`. PR [#9485](https://github.com/tiangolo/fastapi/pull/9485) by [@Creat55](https://github.com/Creat55).
 * 🐛 Replace `MultHostUrl` to `AnyUrl` for compatibility with older versions of Pydantic v1. PR [#9852](https://github.com/tiangolo/fastapi/pull/9852) by [@Kludex](https://github.com/Kludex).

From 2dcf78f29526eec2d96f5312a13ea9956e62fc56 Mon Sep 17 00:00:00 2001
From: Julian Maurin <julian.maurin.perso@pm.me>
Date: Thu, 27 Jul 2023 20:51:07 +0200
Subject: [PATCH 010/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20French=20translati?=
 =?UTF-8?q?on=20for=20`docs/fr/docs/contributing.md`=20(#2132)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ruidy <ruidy.nemausat@gmail.com>
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
---
 docs/fr/docs/contributing.md | 501 +++++++++++++++++++++++++++++++++++
 1 file changed, 501 insertions(+)
 create mode 100644 docs/fr/docs/contributing.md

diff --git a/docs/fr/docs/contributing.md b/docs/fr/docs/contributing.md
new file mode 100644
index 000000000..8292f14bb
--- /dev/null
+++ b/docs/fr/docs/contributing.md
@@ -0,0 +1,501 @@
+# Développement - Contribuer
+
+Tout d'abord, vous voudrez peut-être voir les moyens de base pour [aider FastAPI et obtenir de l'aide](help-fastapi.md){.internal-link target=_blank}.
+
+## Développement
+
+Si vous avez déjà cloné le dépôt et que vous savez que vous devez vous plonger dans le code, voici quelques directives pour mettre en place votre environnement.
+
+### Environnement virtuel avec `venv`
+
+Vous pouvez créer un environnement virtuel dans un répertoire en utilisant le module `venv` de Python :
+
+<div class="termy">
+
+```console
+$ python -m venv env
+```
+
+</div>
+
+Cela va créer un répertoire `./env/` avec les binaires Python et vous pourrez alors installer des paquets pour cet environnement isolé.
+
+### Activer l'environnement
+
+Activez le nouvel environnement avec :
+
+=== "Linux, macOS"
+
+    <div class="termy">
+
+    ```console
+    $ source ./env/bin/activate
+    ```
+
+    </div>
+
+=== "Windows PowerShell"
+
+    <div class="termy">
+
+    ```console
+    $ .\env\Scripts\Activate.ps1
+    ```
+
+    </div>
+
+=== "Windows Bash"
+
+    Ou si vous utilisez Bash pour Windows (par exemple <a href="https://gitforwindows.org/" class="external-link" target="_blank">Git Bash</a>):
+
+    <div class="termy">
+
+    ```console
+    $ source ./env/Scripts/activate
+    ```
+
+    </div>
+
+Pour vérifier que cela a fonctionné, utilisez :
+
+=== "Linux, macOS, Windows Bash"
+
+    <div class="termy">
+
+    ```console
+    $ which pip
+
+    some/directory/fastapi/env/bin/pip
+    ```
+
+    </div>
+
+=== "Windows PowerShell"
+
+    <div class="termy">
+
+    ```console
+    $ Get-Command pip
+
+    some/directory/fastapi/env/bin/pip
+    ```
+
+    </div>
+
+Si celui-ci montre le binaire `pip` à `env/bin/pip`, alors ça a fonctionné. 🎉
+
+
+
+!!! tip
+    Chaque fois que vous installez un nouveau paquet avec `pip` sous cet environnement, activez à nouveau l'environnement.
+
+    Cela permet de s'assurer que si vous utilisez un programme terminal installé par ce paquet (comme `flit`), vous utilisez celui de votre environnement local et pas un autre qui pourrait être installé globalement.
+
+### Flit
+
+**FastAPI** utilise <a href="https://flit.readthedocs.io/en/latest/index.html" class="external-link" target="_blank">Flit</a> pour build, packager et publier le projet.
+
+Après avoir activé l'environnement comme décrit ci-dessus, installez `flit` :
+
+<div class="termy">
+
+```console
+$ pip install flit
+
+---> 100%
+```
+
+</div>
+
+Réactivez maintenant l'environnement pour vous assurer que vous utilisez le "flit" que vous venez d'installer (et non un environnement global).
+
+Et maintenant, utilisez `flit` pour installer les dépendances de développement :
+
+=== "Linux, macOS"
+
+    <div class="termy">
+
+    ```console
+    $ flit install --deps develop --symlink
+
+    ---> 100%
+    ```
+
+    </div>
+
+=== "Windows"
+
+    Si vous êtes sous Windows, utilisez `--pth-file` au lieu de `--symlink` :
+
+    <div class="termy">
+
+    ```console
+    $ flit install --deps develop --pth-file
+
+    ---> 100%
+    ```
+
+    </div>
+
+Il installera toutes les dépendances et votre FastAPI local dans votre environnement local.
+
+#### Utiliser votre FastAPI local
+
+Si vous créez un fichier Python qui importe et utilise FastAPI, et que vous l'exécutez avec le Python de votre environnement local, il utilisera votre code source FastAPI local.
+
+Et si vous mettez à jour le code source local de FastAPI, tel qu'il est installé avec `--symlink` (ou `--pth-file` sous Windows), lorsque vous exécutez à nouveau ce fichier Python, il utilisera la nouvelle version de FastAPI que vous venez d'éditer.
+
+De cette façon, vous n'avez pas à "installer" votre version locale pour pouvoir tester chaque changement.
+
+### Formatage
+
+Il existe un script que vous pouvez exécuter qui formatera et nettoiera tout votre code :
+
+<div class="termy">
+
+```console
+$ bash scripts/format.sh
+```
+
+</div>
+
+Il effectuera également un tri automatique de touts vos imports.
+
+Pour qu'il puisse les trier correctement, vous devez avoir FastAPI installé localement dans votre environnement, avec la commande dans la section ci-dessus en utilisant `--symlink` (ou `--pth-file` sous Windows).
+
+### Formatage des imports
+
+Il existe un autre script qui permet de formater touts les imports et de s'assurer que vous n'avez pas d'imports inutilisés :
+
+<div class="termy">
+
+```console
+$ bash scripts/format-imports.sh
+```
+
+</div>
+
+Comme il exécute une commande après l'autre et modifie et inverse de nombreux fichiers, il prend un peu plus de temps à s'exécuter, il pourrait donc être plus facile d'utiliser fréquemment `scripts/format.sh` et `scripts/format-imports.sh` seulement avant de commit.
+
+## Documentation
+
+Tout d'abord, assurez-vous que vous configurez votre environnement comme décrit ci-dessus, qui installera toutes les exigences.
+
+La documentation utilise <a href="https://www.mkdocs.org/" class="external-link" target="_blank">MkDocs</a>.
+
+Et il y a des outils/scripts supplémentaires en place pour gérer les traductions dans `./scripts/docs.py`.
+
+!!! tip
+    Vous n'avez pas besoin de voir le code dans `./scripts/docs.py`, vous l'utilisez simplement dans la ligne de commande.
+
+Toute la documentation est au format Markdown dans le répertoire `./docs/fr/`.
+
+De nombreux tutoriels comportent des blocs de code.
+
+Dans la plupart des cas, ces blocs de code sont de véritables applications complètes qui peuvent être exécutées telles quelles.
+
+En fait, ces blocs de code ne sont pas écrits à l'intérieur du Markdown, ce sont des fichiers Python dans le répertoire `./docs_src/`.
+
+Et ces fichiers Python sont inclus/injectés dans la documentation lors de la génération du site.
+
+### Documentation pour les tests
+
+La plupart des tests sont en fait effectués par rapport aux exemples de fichiers sources dans la documentation.
+
+Cela permet de s'assurer que :
+
+* La documentation est à jour.
+* Les exemples de documentation peuvent être exécutés tels quels.
+* La plupart des fonctionnalités sont couvertes par la documentation, assurées par la couverture des tests.
+
+Au cours du développement local, un script build le site et vérifie les changements éventuels, puis il est rechargé en direct :
+
+<div class="termy">
+
+```console
+$ python ./scripts/docs.py live
+
+<span style="color: green;">[INFO]</span> Serving on http://127.0.0.1:8008
+<span style="color: green;">[INFO]</span> Start watching changes
+<span style="color: green;">[INFO]</span> Start detecting changes
+```
+
+</div>
+
+Il servira la documentation sur `http://127.0.0.1:8008`.
+
+De cette façon, vous pouvez modifier la documentation/les fichiers sources et voir les changements en direct.
+
+#### Typer CLI (facultatif)
+
+Les instructions ici vous montrent comment utiliser le script à `./scripts/docs.py` avec le programme `python` directement.
+
+Mais vous pouvez également utiliser <a href="https://typer.tiangolo.com/typer-cli/" class="external-link" target="_blank">Typer CLI</a>, et vous obtiendrez l'auto-complétion dans votre terminal pour les commandes après l'achèvement de l'installation.
+
+Si vous installez Typer CLI, vous pouvez installer la complétion avec :
+
+<div class="termy">
+
+```console
+$ typer --install-completion
+
+zsh completion installed in /home/user/.bashrc.
+Completion will take effect once you restart the terminal.
+```
+
+</div>
+
+### Apps et documentation en même temps
+
+Si vous exécutez les exemples avec, par exemple :
+
+<div class="termy">
+
+```console
+$ uvicorn tutorial001:app --reload
+
+<span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+```
+
+</div>
+
+Comme Uvicorn utilisera par défaut le port `8000`, la documentation sur le port `8008` n'entrera pas en conflit.
+
+### Traductions
+
+L'aide aux traductions est TRÈS appréciée ! Et cela ne peut se faire sans l'aide de la communauté. 🌎 🚀
+
+Voici les étapes à suivre pour aider à la traduction.
+
+#### Conseils et lignes directrices
+
+* Vérifiez les <a href="https://github.com/tiangolo/fastapi/pulls" class="external-link" target="_blank">pull requests existantes</a> pour votre langue et ajouter des reviews demandant des changements ou les approuvant.
+
+!!! tip
+    Vous pouvez <a href="https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request" class="external-link" target="_blank">ajouter des commentaires avec des suggestions de changement</a> aux pull requests existantes.
+
+    Consultez les documents concernant <a href="https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/about-pull-request-reviews" class="external-link" target="_blank">l'ajout d'un review de pull request</a> pour l'approuver ou demander des modifications.
+
+* Vérifiez dans <a href="https://github.com/tiangolo/fastapi/issues" class="external-link" target="_blank">issues</a> pour voir s'il y a une personne qui coordonne les traductions pour votre langue.
+
+* Ajoutez une seule pull request par page traduite. Il sera ainsi beaucoup plus facile pour les autres de l'examiner.
+
+Pour les langues que je ne parle pas, je vais attendre plusieurs autres reviews de la traduction avant de merge.
+
+* Vous pouvez également vérifier s'il existe des traductions pour votre langue et y ajouter une review, ce qui m'aidera à savoir si la traduction est correcte et je pourrai la fusionner.
+
+* Utilisez les mêmes exemples en Python et ne traduisez que le texte des documents. Vous n'avez pas besoin de changer quoi que ce soit pour que cela fonctionne.
+
+* Utilisez les mêmes images, noms de fichiers et liens. Vous n'avez pas besoin de changer quoi que ce soit pour que cela fonctionne.
+
+* Pour vérifier le code à 2 lettres de la langue que vous souhaitez traduire, vous pouvez utiliser le tableau <a href="https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes" class="external-link" target="_blank">Liste des codes ISO 639-1</a>.
+
+#### Langue existante
+
+Disons que vous voulez traduire une page pour une langue qui a déjà des traductions pour certaines pages, comme l'espagnol.
+
+Dans le cas de l'espagnol, le code à deux lettres est `es`. Ainsi, le répertoire des traductions espagnoles se trouve à l'adresse `docs/es/`.
+
+!!! tip
+    La langue principale ("officielle") est l'anglais, qui se trouve à l'adresse "docs/en/".
+
+Maintenant, lancez le serveur en live pour les documents en espagnol :
+
+<div class="termy">
+
+```console
+// Use the command "live" and pass the language code as a CLI argument
+$ python ./scripts/docs.py live es
+
+<span style="color: green;">[INFO]</span> Serving on http://127.0.0.1:8008
+<span style="color: green;">[INFO]</span> Start watching changes
+<span style="color: green;">[INFO]</span> Start detecting changes
+```
+
+</div>
+
+Vous pouvez maintenant aller sur <a href="http://127.0.0.1:8008" class="external-link" target="_blank">http://127.0.0.1:8008</a> et voir vos changements en direct.
+
+Si vous regardez le site web FastAPI docs, vous verrez que chaque langue a toutes les pages. Mais certaines pages ne sont pas traduites et sont accompagnées d'une notification concernant la traduction manquante.
+
+Mais si vous le gérez localement de cette manière, vous ne verrez que les pages déjà traduites.
+
+Disons maintenant que vous voulez ajouter une traduction pour la section [Features](features.md){.internal-link target=_blank}.
+
+* Copiez le fichier à :
+
+```
+docs/en/docs/features.md
+```
+
+* Collez-le exactement au même endroit mais pour la langue que vous voulez traduire, par exemple :
+
+```
+docs/es/docs/features.md
+```
+
+!!! tip
+    Notez que le seul changement dans le chemin et le nom du fichier est le code de langue, qui passe de `en` à `es`.
+
+* Ouvrez maintenant le fichier de configuration de MkDocs pour l'anglais à
+
+```
+docs/en/docs/mkdocs.yml
+```
+
+* Trouvez l'endroit où cette `docs/features.md` se trouve dans le fichier de configuration. Quelque part comme :
+
+```YAML hl_lines="8"
+site_name: FastAPI
+# More stuff
+nav:
+- FastAPI: index.md
+- Languages:
+  - en: /
+  - es: /es/
+- features.md
+```
+
+* Ouvrez le fichier de configuration MkDocs pour la langue que vous éditez, par exemple :
+
+```
+docs/es/docs/mkdocs.yml
+```
+
+* Ajoutez-le à l'endroit exact où il se trouvait pour l'anglais, par exemple :
+
+```YAML hl_lines="8"
+site_name: FastAPI
+# More stuff
+nav:
+- FastAPI: index.md
+- Languages:
+  - en: /
+  - es: /es/
+- features.md
+```
+
+Assurez-vous que s'il y a d'autres entrées, la nouvelle entrée avec votre traduction est exactement dans le même ordre que dans la version anglaise.
+
+Si vous allez sur votre navigateur, vous verrez que maintenant les documents montrent votre nouvelle section. 🎉
+
+Vous pouvez maintenant tout traduire et voir à quoi cela ressemble au fur et à mesure que vous enregistrez le fichier.
+
+#### Nouvelle langue
+
+Disons que vous voulez ajouter des traductions pour une langue qui n'est pas encore traduite, pas même quelques pages.
+
+Disons que vous voulez ajouter des traductions pour le Créole, et que ce n'est pas encore dans les documents.
+
+En vérifiant le lien ci-dessus, le code pour "Créole" est `ht`.
+
+L'étape suivante consiste à exécuter le script pour générer un nouveau répertoire de traduction :
+
+<div class="termy">
+
+```console
+// Use the command new-lang, pass the language code as a CLI argument
+$ python ./scripts/docs.py new-lang ht
+
+Successfully initialized: docs/ht
+Updating ht
+Updating en
+```
+
+</div>
+
+Vous pouvez maintenant vérifier dans votre éditeur de code le répertoire nouvellement créé `docs/ht/`.
+
+!!! tip
+    Créez une première demande d'extraction à l'aide de cette fonction, afin de configurer la nouvelle langue avant d'ajouter des traductions.
+
+    Ainsi, d'autres personnes peuvent vous aider à rédiger d'autres pages pendant que vous travaillez sur la première. 🚀
+
+Commencez par traduire la page principale, `docs/ht/index.md`.
+
+Vous pouvez ensuite continuer avec les instructions précédentes, pour une "langue existante".
+
+##### Nouvelle langue non prise en charge
+
+Si, lors de l'exécution du script du serveur en direct, vous obtenez une erreur indiquant que la langue n'est pas prise en charge, quelque chose comme :
+
+```
+ raise TemplateNotFound(template)
+jinja2.exceptions.TemplateNotFound: partials/language/xx.html
+```
+
+Cela signifie que le thème ne supporte pas cette langue (dans ce cas, avec un faux code de 2 lettres de `xx`).
+
+Mais ne vous inquiétez pas, vous pouvez définir la langue du thème en anglais et ensuite traduire le contenu des documents.
+
+Si vous avez besoin de faire cela, modifiez le fichier `mkdocs.yml` pour votre nouvelle langue, il aura quelque chose comme :
+
+```YAML hl_lines="5"
+site_name: FastAPI
+# More stuff
+theme:
+  # More stuff
+  language: xx
+```
+
+Changez cette langue de `xx` (de votre code de langue) à `fr`.
+
+Vous pouvez ensuite relancer le serveur live.
+
+#### Prévisualisez le résultat
+
+Lorsque vous utilisez le script à `./scripts/docs.py` avec la commande `live`, il n'affiche que les fichiers et les traductions disponibles pour la langue courante.
+
+Mais une fois que vous avez terminé, vous pouvez tester le tout comme il le ferait en ligne.
+
+Pour ce faire, il faut d'abord construire tous les documents :
+
+<div class="termy">
+
+```console
+// Use the command "build-all", this will take a bit
+$ python ./scripts/docs.py build-all
+
+Updating es
+Updating en
+Building docs for: en
+Building docs for: es
+Successfully built docs for: es
+Copying en index.md to README.md
+```
+
+</div>
+
+Cela génère tous les documents à `./docs_build/` pour chaque langue. Cela inclut l'ajout de tout fichier dont la traduction est manquante, avec une note disant que "ce fichier n'a pas encore de traduction". Mais vous n'avez rien à faire avec ce répertoire.
+
+Ensuite, il construit tous ces sites MkDocs indépendants pour chaque langue, les combine, et génère le résultat final à `./site/`.
+
+Ensuite, vous pouvez servir cela avec le commandement `serve`:
+
+<div class="termy">
+
+```console
+// Use the command "serve" after running "build-all"
+$ python ./scripts/docs.py serve
+
+Warning: this is a very simple server. For development, use mkdocs serve instead.
+This is here only to preview a site with translations already built.
+Make sure you run the build-all command first.
+Serving at: http://127.0.0.1:8008
+```
+
+</div>
+
+## Tests
+
+Il existe un script que vous pouvez exécuter localement pour tester tout le code et générer des rapports de couverture en HTML :
+
+<div class="termy">
+
+```console
+$ bash scripts/test-cov-html.sh
+```
+
+</div>
+
+Cette commande génère un répertoire `./htmlcov/`, si vous ouvrez le fichier `./htmlcov/index.html` dans votre navigateur, vous pouvez explorer interactivement les régions de code qui sont couvertes par les tests, et remarquer s'il y a une région manquante.

From e79dc9697ceefcc88c7ac06fe564bfec9afb008b Mon Sep 17 00:00:00 2001
From: Julian Maurin <julian.maurin.perso@pm.me>
Date: Thu, 27 Jul 2023 20:51:55 +0200
Subject: [PATCH 011/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20French=20translati?=
 =?UTF-8?q?on=20for=20`docs/fr/docs/tutorial/index.md`=20(#2234)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ruidy <ruidy.nemausat@gmail.com>
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
---
 docs/fr/docs/tutorial/index.md | 80 ++++++++++++++++++++++++++++++++++
 1 file changed, 80 insertions(+)
 create mode 100644 docs/fr/docs/tutorial/index.md

diff --git a/docs/fr/docs/tutorial/index.md b/docs/fr/docs/tutorial/index.md
new file mode 100644
index 000000000..4dc202b33
--- /dev/null
+++ b/docs/fr/docs/tutorial/index.md
@@ -0,0 +1,80 @@
+# Tutoriel - Guide utilisateur - Introduction
+
+Ce tutoriel vous montre comment utiliser **FastAPI** avec la plupart de ses fonctionnalités, étape par étape.
+
+Chaque section s'appuie progressivement sur les précédentes, mais elle est structurée de manière à séparer les sujets, afin que vous puissiez aller directement à l'un d'entre eux pour résoudre vos besoins spécifiques en matière d'API.
+
+Il est également conçu pour fonctionner comme une référence future.
+
+Vous pouvez donc revenir et voir exactement ce dont vous avez besoin.
+
+## Exécuter le code
+
+Tous les blocs de code peuvent être copiés et utilisés directement (il s'agit en fait de fichiers Python testés).
+
+Pour exécuter l'un de ces exemples, copiez le code dans un fichier `main.py`, et commencez `uvicorn` avec :
+
+<div class="termy">
+
+```console
+$ uvicorn main:app --reload
+
+<span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+<span style="color: green;">INFO</span>:     Started reloader process [28720]
+<span style="color: green;">INFO</span>:     Started server process [28722]
+<span style="color: green;">INFO</span>:     Waiting for application startup.
+<span style="color: green;">INFO</span>:     Application startup complete.
+```
+
+</div>
+
+Il est **FORTEMENT encouragé** que vous écriviez ou copiez le code, l'éditiez et l'exécutiez localement.
+
+L'utiliser dans votre éditeur est ce qui vous montre vraiment les avantages de FastAPI, en voyant le peu de code que vous avez à écrire, toutes les vérifications de type, l'autocomplétion, etc.
+
+---
+
+## Installer FastAPI
+
+La première étape consiste à installer FastAPI.
+
+Pour le tutoriel, vous voudrez peut-être l'installer avec toutes les dépendances et fonctionnalités optionnelles :
+
+<div class="termy">
+
+```console
+$ pip install fastapi[all]
+
+---> 100%
+```
+
+</div>
+
+... qui comprend également `uvicorn`, que vous pouvez utiliser comme serveur pour exécuter votre code.
+
+!!! note
+    Vous pouvez également l'installer pièce par pièce.
+
+    C'est ce que vous feriez probablement une fois que vous voudrez déployer votre application en production :
+
+    ```
+    pip install fastapi
+    ```
+
+    Installez également `uvicorn` pour qu'il fonctionne comme serveur :
+
+    ```
+    pip install uvicorn
+    ```
+
+    Et la même chose pour chacune des dépendances facultatives que vous voulez utiliser.
+
+## Guide utilisateur avancé
+
+Il existe également un **Guide d'utilisation avancé** que vous pouvez lire plus tard après ce **Tutoriel - Guide d'utilisation**.
+
+Le **Guide d'utilisation avancé**, qui s'appuie sur cette base, utilise les mêmes concepts et vous apprend quelques fonctionnalités supplémentaires.
+
+Mais vous devez d'abord lire le **Tutoriel - Guide d'utilisation** (ce que vous êtes en train de lire en ce moment).
+
+Il est conçu pour que vous puissiez construire une application complète avec seulement le **Tutoriel - Guide d'utilisation**, puis l'étendre de différentes manières, en fonction de vos besoins, en utilisant certaines des idées supplémentaires du **Guide d'utilisation avancé**.

From 35707a1b2913e3f3d2f478e2752178d71357563a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 27 Jul 2023 18:51:59 +0000
Subject: [PATCH 012/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b203afe33..fda474978 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add French translation for `docs/fr/docs/benchmarks.md`. PR [#2155](https://github.com/tiangolo/fastapi/pull/2155) by [@clemsau](https://github.com/clemsau).
 * 🌐 Update Chinese translations with new source files. PR [#9738](https://github.com/tiangolo/fastapi/pull/9738) by [@mahone3297](https://github.com/mahone3297).
 * 🌐 Add Russian translation for `docs/ru/docs/tutorial/request-forms.md`. PR [#9841](https://github.com/tiangolo/fastapi/pull/9841) by [@dedkot01](https://github.com/dedkot01).
 * 🌐 Update Chinese translation for `docs/zh/docs/tutorial/handling-errors.md`. PR [#9485](https://github.com/tiangolo/fastapi/pull/9485) by [@Creat55](https://github.com/Creat55).

From 02ed00cc471862588479ffc364c1c908ef0b35f5 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 27 Jul 2023 18:53:03 +0000
Subject: [PATCH 013/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index fda474978..f8837f2d0 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add French translation for `docs/fr/docs/contributing.md`. PR [#2132](https://github.com/tiangolo/fastapi/pull/2132) by [@JulianMaurin](https://github.com/JulianMaurin).
 * 🌐 Add French translation for `docs/fr/docs/benchmarks.md`. PR [#2155](https://github.com/tiangolo/fastapi/pull/2155) by [@clemsau](https://github.com/clemsau).
 * 🌐 Update Chinese translations with new source files. PR [#9738](https://github.com/tiangolo/fastapi/pull/9738) by [@mahone3297](https://github.com/mahone3297).
 * 🌐 Add Russian translation for `docs/ru/docs/tutorial/request-forms.md`. PR [#9841](https://github.com/tiangolo/fastapi/pull/9841) by [@dedkot01](https://github.com/dedkot01).

From 04b9a67cbb12553b0011f240c4d3ef39913ab0df Mon Sep 17 00:00:00 2001
From: Sam Courtemanche <smlep.pro@gmail.com>
Date: Thu, 27 Jul 2023 20:53:21 +0200
Subject: [PATCH 014/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20French=20translati?=
 =?UTF-8?q?on=20for=20`docs/fr/docs/tutorial/query-params-str-validations.?=
 =?UTF-8?q?md`=20(#4075)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Julian Maurin <julian.maurin.perso@pm.me>
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
---
 .../tutorial/query-params-str-validations.md  | 305 ++++++++++++++++++
 1 file changed, 305 insertions(+)
 create mode 100644 docs/fr/docs/tutorial/query-params-str-validations.md

diff --git a/docs/fr/docs/tutorial/query-params-str-validations.md b/docs/fr/docs/tutorial/query-params-str-validations.md
new file mode 100644
index 000000000..f5248fe8b
--- /dev/null
+++ b/docs/fr/docs/tutorial/query-params-str-validations.md
@@ -0,0 +1,305 @@
+# Paramètres de requête et validations de chaînes de caractères
+
+**FastAPI** vous permet de déclarer des informations et des validateurs additionnels pour vos paramètres de requêtes.
+
+Commençons avec cette application pour exemple :
+
+```Python hl_lines="9"
+{!../../../docs_src/query_params_str_validations/tutorial001.py!}
+```
+
+Le paramètre de requête `q` a pour type `Union[str, None]` (ou `str | None` en Python 3.10), signifiant qu'il est de type `str` mais pourrait aussi être égal à `None`, et bien sûr, la valeur par défaut est `None`, donc **FastAPI** saura qu'il n'est pas requis.
+
+!!! note
+    **FastAPI** saura que la valeur de `q` n'est pas requise grâce à la valeur par défaut `= None`.
+
+    Le `Union` dans `Union[str, None]` permettra à votre éditeur de vous offrir un meilleur support et de détecter les erreurs.
+
+## Validation additionnelle
+
+Nous allons imposer que bien que `q` soit un paramètre optionnel, dès qu'il est fourni, **sa longueur n'excède pas 50 caractères**.
+
+## Importer `Query`
+
+Pour cela, importez d'abord `Query` depuis `fastapi` :
+
+```Python hl_lines="3"
+{!../../../docs_src/query_params_str_validations/tutorial002.py!}
+```
+
+## Utiliser `Query` comme valeur par défaut
+
+Construisez ensuite la valeur par défaut de votre paramètre avec `Query`, en choisissant 50 comme `max_length` :
+
+```Python hl_lines="9"
+{!../../../docs_src/query_params_str_validations/tutorial002.py!}
+```
+
+Comme nous devons remplacer la valeur par défaut `None` dans la fonction par `Query()`, nous pouvons maintenant définir la valeur par défaut avec le paramètre `Query(default=None)`, il sert le même objectif qui est de définir cette valeur par défaut.
+
+Donc :
+
+```Python
+q: Union[str, None] = Query(default=None)
+```
+
+... rend le paramètre optionnel, et est donc équivalent à :
+
+```Python
+q: Union[str, None] = None
+```
+
+Mais déclare explicitement `q` comme étant un paramètre de requête.
+
+!!! info
+    Gardez à l'esprit que la partie la plus importante pour rendre un paramètre optionnel est :
+
+    ```Python
+    = None
+    ```
+
+    ou :
+
+    ```Python
+    = Query(None)
+    ```
+
+    et utilisera ce `None` pour détecter que ce paramètre de requête **n'est pas requis**.
+
+    Le `Union[str, None]` est uniquement là pour permettre à votre éditeur un meilleur support.
+
+Ensuite, nous pouvons passer d'autres paramètres à `Query`. Dans cet exemple, le paramètre `max_length` qui s'applique aux chaînes de caractères :
+
+```Python
+q: Union[str, None] = Query(default=None, max_length=50)
+```
+
+Cela va valider les données, montrer une erreur claire si ces dernières ne sont pas valides, et documenter le paramètre dans le schéma `OpenAPI` de cette *path operation*.
+
+## Rajouter plus de validation
+
+Vous pouvez aussi rajouter un second paramètre `min_length` :
+
+```Python hl_lines="9"
+{!../../../docs_src/query_params_str_validations/tutorial003.py!}
+```
+
+## Ajouter des validations par expressions régulières
+
+On peut définir une <abbr title="Une expression régulière, regex ou regexp est une suite de caractères qui définit un pattern de correspondance pour les chaînes de caractères.">expression régulière</abbr> à laquelle le paramètre doit correspondre :
+
+```Python hl_lines="10"
+{!../../../docs_src/query_params_str_validations/tutorial004.py!}
+```
+
+Cette expression régulière vérifie que la valeur passée comme paramètre :
+
+* `^` : commence avec les caractères qui suivent, avec aucun caractère avant ceux-là.
+* `fixedquery` : a pour valeur exacte `fixedquery`.
+* `$` : se termine directement ensuite, n'a pas d'autres caractères après `fixedquery`.
+
+Si vous vous sentez perdu avec le concept d'**expression régulière**, pas d'inquiétudes. Il s'agit d'une notion difficile pour beaucoup, et l'on peut déjà réussir à faire beaucoup sans jamais avoir à les manipuler.
+
+Mais si vous décidez d'apprendre à les utiliser, sachez qu'ensuite vous pouvez les utiliser directement dans **FastAPI**.
+
+## Valeurs par défaut
+
+De la même façon que vous pouvez passer `None` comme premier argument pour l'utiliser comme valeur par défaut, vous pouvez passer d'autres valeurs.
+
+Disons que vous déclarez le paramètre `q` comme ayant une longueur minimale de `3`, et une valeur par défaut étant `"fixedquery"` :
+
+```Python hl_lines="7"
+{!../../../docs_src/query_params_str_validations/tutorial005.py!}
+```
+
+!!! note "Rappel"
+    Avoir une valeur par défaut rend le paramètre optionnel.
+
+## Rendre ce paramètre requis
+
+Quand on ne déclare ni validation, ni métadonnée, on peut rendre le paramètre `q` requis en ne lui déclarant juste aucune valeur par défaut :
+
+```Python
+q: str
+```
+
+à la place de :
+
+```Python
+q: Union[str, None] = None
+```
+
+Mais maintenant, on déclare `q` avec `Query`, comme ceci :
+
+```Python
+q: Union[str, None] = Query(default=None, min_length=3)
+```
+
+Donc pour déclarer une valeur comme requise tout en utilisant `Query`, il faut utiliser `...` comme premier argument :
+
+```Python hl_lines="7"
+{!../../../docs_src/query_params_str_validations/tutorial006.py!}
+```
+
+!!! info
+    Si vous n'avez jamais vu ce `...` auparavant : c'est une des constantes natives de Python <a href="https://docs.python.org/fr/3/library/constants.html#Ellipsis" class="external-link" target="_blank">appelée "Ellipsis"</a>.
+
+Cela indiquera à **FastAPI** que la présence de ce paramètre est obligatoire.
+
+## Liste de paramètres / valeurs multiples via Query
+
+Quand on définit un paramètre de requête explicitement avec `Query` on peut aussi déclarer qu'il reçoit une liste de valeur, ou des "valeurs multiples".
+
+Par exemple, pour déclarer un paramètre de requête `q` qui peut apparaître plusieurs fois dans une URL, on écrit :
+
+```Python hl_lines="9"
+{!../../../docs_src/query_params_str_validations/tutorial011.py!}
+```
+
+Ce qui fait qu'avec une URL comme :
+
+```
+http://localhost:8000/items/?q=foo&q=bar
+```
+
+vous recevriez les valeurs des multiples paramètres de requête `q` (`foo` et `bar`) dans une `list` Python au sein de votre fonction de **path operation**, dans le paramètre de fonction `q`.
+
+Donc la réponse de cette URL serait :
+
+```JSON
+{
+  "q": [
+    "foo",
+    "bar"
+  ]
+}
+```
+
+!!! tip "Astuce"
+    Pour déclarer un paramètre de requête de type `list`, comme dans l'exemple ci-dessus, il faut explicitement utiliser `Query`, sinon cela sera interprété comme faisant partie du corps de la requête.
+
+La documentation sera donc mise à jour automatiquement pour autoriser plusieurs valeurs :
+
+<img src="/img/tutorial/query-params-str-validations/image02.png">
+
+### Combiner liste de paramètres et valeurs par défaut
+
+Et l'on peut aussi définir une liste de valeurs par défaut si aucune n'est fournie :
+
+```Python hl_lines="9"
+{!../../../docs_src/query_params_str_validations/tutorial012.py!}
+```
+
+Si vous allez à :
+
+```
+http://localhost:8000/items/
+```
+
+la valeur par défaut de `q` sera : `["foo", "bar"]`
+
+et la réponse sera :
+
+```JSON
+{
+  "q": [
+    "foo",
+    "bar"
+  ]
+}
+```
+
+#### Utiliser `list`
+
+Il est aussi possible d'utiliser directement `list` plutôt que `List[str]` :
+
+```Python hl_lines="7"
+{!../../../docs_src/query_params_str_validations/tutorial013.py!}
+```
+
+!!! note
+    Dans ce cas-là, **FastAPI** ne vérifiera pas le contenu de la liste.
+
+    Par exemple, `List[int]` vérifiera (et documentera) que la liste est bien entièrement composée d'entiers. Alors qu'un simple `list` ne ferait pas cette vérification.
+
+## Déclarer des métadonnées supplémentaires
+
+On peut aussi ajouter plus d'informations sur le paramètre.
+
+Ces informations seront incluses dans le schéma `OpenAPI` généré et utilisées par la documentation interactive ou les outils externes utilisés.
+
+!!! note
+    Gardez en tête que les outils externes utilisés ne supportent pas forcément tous parfaitement OpenAPI.
+
+    Il se peut donc que certains d'entre eux n'utilisent pas toutes les métadonnées que vous avez déclarées pour le moment, bien que dans la plupart des cas, les fonctionnalités manquantes ont prévu d'être implémentées.
+
+Vous pouvez ajouter un `title` :
+
+```Python hl_lines="10"
+{!../../../docs_src/query_params_str_validations/tutorial007.py!}
+```
+
+Et une `description` :
+
+```Python hl_lines="13"
+{!../../../docs_src/query_params_str_validations/tutorial008.py!}
+```
+
+## Alias de paramètres
+
+Imaginez que vous vouliez que votre paramètre se nomme `item-query`.
+
+Comme dans la requête :
+
+```
+http://127.0.0.1:8000/items/?item-query=foobaritems
+```
+
+Mais `item-query` n'est pas un nom de variable valide en Python.
+
+Le nom le plus proche serait `item_query`.
+
+Mais vous avez vraiment envie que ce soit exactement `item-query`...
+
+Pour cela vous pouvez déclarer un `alias`, et cet alias est ce qui sera utilisé pour trouver la valeur du paramètre :
+
+```Python hl_lines="9"
+{!../../../docs_src/query_params_str_validations/tutorial009.py!}
+```
+
+## Déprécier des paramètres
+
+Disons que vous ne vouliez plus utiliser ce paramètre désormais.
+
+Il faut qu'il continue à exister pendant un certain temps car vos clients l'utilisent, mais vous voulez que la documentation mentionne clairement que ce paramètre est <abbr title="obsolète, recommandé de ne pas l'utiliser">déprécié</abbr>.
+
+On utilise alors l'argument `deprecated=True` de `Query` :
+
+```Python hl_lines="18"
+{!../../../docs_src/query_params_str_validations/tutorial010.py!}
+```
+
+La documentation le présentera comme il suit :
+
+<img src="/img/tutorial/query-params-str-validations/image01.png">
+
+## Pour résumer
+
+Il est possible d'ajouter des validateurs et métadonnées pour vos paramètres.
+
+Validateurs et métadonnées génériques:
+
+* `alias`
+* `title`
+* `description`
+* `deprecated`
+
+Validateurs spécifiques aux chaînes de caractères :
+
+* `min_length`
+* `max_length`
+* `regex`
+
+Parmi ces exemples, vous avez pu voir comment déclarer des validateurs pour les chaînes de caractères.
+
+Dans les prochains chapitres, vous verrez comment déclarer des validateurs pour d'autres types, comme les nombres.

From 570ca011f91346fa0d79bf3d9ae5ba629165f25f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 27 Jul 2023 20:53:51 +0200
Subject: [PATCH 015/317] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors,=20add?=
 =?UTF-8?q?=20Fern=20(#9956)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                                 |   1 +
 docs/en/data/sponsors.yml                 |   3 +++
 docs/en/docs/img/sponsors/fern-banner.png | Bin 0 -> 8801 bytes
 docs/en/docs/img/sponsors/fern.png        | Bin 0 -> 10924 bytes
 docs/en/overrides/main.html               |   6 ++++++
 5 files changed, 10 insertions(+)
 create mode 100644 docs/en/docs/img/sponsors/fern-banner.png
 create mode 100644 docs/en/docs/img/sponsors/fern.png

diff --git a/README.md b/README.md
index 36c71081e..f0e76c4b6 100644
--- a/README.md
+++ b/README.md
@@ -48,6 +48,7 @@ The key features are:
 
 <a href="https://cryptapi.io/" target="_blank" title="CryptAPI: Your easy to use, secure and privacy oriented payment gateway."><img src="https://fastapi.tiangolo.com/img/sponsors/cryptapi.svg"></a>
 <a href="https://platform.sh/try-it-now/?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023" target="_blank" title="Build, run and scale your apps on a modern, reliable, and secure PaaS."><img src="https://fastapi.tiangolo.com/img/sponsors/platform-sh.png"></a>
+<a href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=main-badge" target="_blank" title="Fern | SDKs and API docs"><img src="https://fastapi.tiangolo.com/img/sponsors/fern.png"></a>
 <a href="https://www.deta.sh/?ref=fastapi" target="_blank" title="The launchpad for all your (team's) ideas"><img src="https://fastapi.tiangolo.com/img/sponsors/deta.svg"></a>
 <a href="https://training.talkpython.fm/fastapi-courses" target="_blank" title="FastAPI video courses on demand from people you trust"><img src="https://fastapi.tiangolo.com/img/sponsors/talkpython.png"></a>
 <a href="https://testdriven.io/courses/tdd-fastapi/" target="_blank" title="Learn to build high-quality web apps with best practices"><img src="https://fastapi.tiangolo.com/img/sponsors/testdriven.svg"></a>
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index 1b5240b5e..33d57c873 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -5,6 +5,9 @@ gold:
   - url: https://platform.sh/try-it-now/?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023
     title: "Build, run and scale your apps on a modern, reliable, and secure PaaS."
     img: https://fastapi.tiangolo.com/img/sponsors/platform-sh.png
+  - url: https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=main-badge
+    title: Fern | SDKs and API docs
+    img: https://fastapi.tiangolo.com/img/sponsors/fern.png
 silver:
   - url: https://www.deta.sh/?ref=fastapi
     title: The launchpad for all your (team's) ideas
diff --git a/docs/en/docs/img/sponsors/fern-banner.png b/docs/en/docs/img/sponsors/fern-banner.png
new file mode 100644
index 0000000000000000000000000000000000000000..1b70ab96d9548145028a8667013843cc810a5ee4
GIT binary patch
literal 8801
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
WY&h2J+%ErnLrGp;u1Lnr_rCz~bVW`8

literal 0
HcmV?d00001

diff --git a/docs/en/docs/img/sponsors/fern.png b/docs/en/docs/img/sponsors/fern.png
new file mode 100644
index 0000000000000000000000000000000000000000..4c6e54b0d517f42d8297676a32e5558efb82785e
GIT binary patch
literal 10924
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
b+}(?p#n>V`PU%DZM^HH_CCO58!#Dp6Up`>G

literal 0
HcmV?d00001

diff --git a/docs/en/overrides/main.html b/docs/en/overrides/main.html
index 4608880f2..fcd1704b9 100644
--- a/docs/en/overrides/main.html
+++ b/docs/en/overrides/main.html
@@ -34,6 +34,12 @@
         <img class="sponsor-image" src="/img/sponsors/platform-sh-banner.png" />
       </a>
     </div>
+    <div class="item">
+      <a title="Fern | SDKs and API docs" style="display: block; position: relative;" href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=top-banner" target="_blank">
+        <span class="sponsor-badge">sponsor</span>
+        <img class="sponsor-image" src="/img/sponsors/fern-banner.png" />
+      </a>
+    </div>
   </div>
 </div>
 {% endblock %}

From a52875c6563ccf17596287170d42d27676947891 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 27 Jul 2023 18:54:32 +0000
Subject: [PATCH 016/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f8837f2d0..2f9aada99 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add French translation for `docs/fr/docs/tutorial/index.md`. PR [#2234](https://github.com/tiangolo/fastapi/pull/2234) by [@JulianMaurin](https://github.com/JulianMaurin).
 * 🌐 Add French translation for `docs/fr/docs/contributing.md`. PR [#2132](https://github.com/tiangolo/fastapi/pull/2132) by [@JulianMaurin](https://github.com/JulianMaurin).
 * 🌐 Add French translation for `docs/fr/docs/benchmarks.md`. PR [#2155](https://github.com/tiangolo/fastapi/pull/2155) by [@clemsau](https://github.com/clemsau).
 * 🌐 Update Chinese translations with new source files. PR [#9738](https://github.com/tiangolo/fastapi/pull/9738) by [@mahone3297](https://github.com/mahone3297).

From e081145c7dc1218b4fee08f61295f76549aa0156 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=90=B4=E5=AE=9A=E7=84=95?=
 <108172295+wdh99@users.noreply.github.com>
Date: Fri, 28 Jul 2023 02:55:40 +0800
Subject: [PATCH 017/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Chinese=20translat?=
 =?UTF-8?q?ion=20for=20`docs/zh/docs/tutorial/background-tasks.md`=20(#981?=
 =?UTF-8?q?2)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
 docs/zh/docs/tutorial/background-tasks.md | 126 ++++++++++++++++++++++
 1 file changed, 126 insertions(+)
 create mode 100644 docs/zh/docs/tutorial/background-tasks.md

diff --git a/docs/zh/docs/tutorial/background-tasks.md b/docs/zh/docs/tutorial/background-tasks.md
new file mode 100644
index 000000000..c8568298b
--- /dev/null
+++ b/docs/zh/docs/tutorial/background-tasks.md
@@ -0,0 +1,126 @@
+# 后台任务
+
+你可以定义在返回响应后运行的后台任务。
+
+这对需要在请求之后执行的操作很有用，但客户端不必在接收响应之前等待操作完成。
+
+包括这些例子：
+
+* 执行操作后发送的电子邮件通知：
+    * 由于连接到电子邮件服务器并发送电子邮件往往很“慢”（几秒钟），您可以立即返回响应并在后台发送电子邮件通知。
+* 处理数据：
+    * 例如，假设您收到的文件必须经过一个缓慢的过程，您可以返回一个"Accepted"(HTTP 202)响应并在后台处理它。
+
+## 使用 `BackgroundTasks`
+
+首先导入 `BackgroundTasks` 并在 *路径操作函数* 中使用类型声明 `BackgroundTasks` 定义一个参数：
+
+```Python hl_lines="1  13"
+{!../../../docs_src/background_tasks/tutorial001.py!}
+```
+
+**FastAPI** 会创建一个 `BackgroundTasks` 类型的对象并作为该参数传入。
+
+## 创建一个任务函数
+
+创建要作为后台任务运行的函数。
+
+它只是一个可以接收参数的标准函数。
+
+它可以是 `async def` 或普通的 `def` 函数，**FastAPI** 知道如何正确处理。
+
+在这种情况下，任务函数将写入一个文件（模拟发送电子邮件）。
+
+由于写操作不使用 `async` 和 `await`，我们用普通的 `def` 定义函数：
+
+```Python hl_lines="6-9"
+{!../../../docs_src/background_tasks/tutorial001.py!}
+```
+
+## 添加后台任务
+
+在你的 *路径操作函数* 里，用 `.add_task()` 方法将任务函数传到 *后台任务* 对象中：
+
+```Python hl_lines="14"
+{!../../../docs_src/background_tasks/tutorial001.py!}
+```
+
+`.add_task()` 接收以下参数：
+
+* 在后台运行的任务函数(`write_notification`)。
+* 应按顺序传递给任务函数的任意参数序列(`email`)。
+* 应传递给任务函数的任意关键字参数(`message="some notification"`)。
+
+## 依赖注入
+
+使用 `BackgroundTasks` 也适用于依赖注入系统，你可以在多个级别声明 `BackgroundTasks` 类型的参数：在 *路径操作函数* 里，在依赖中(可依赖)，在子依赖中，等等。
+
+**FastAPI** 知道在每种情况下该做什么以及如何复用同一对象，因此所有后台任务被合并在一起并且随后在后台运行：
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="13  15  22  25"
+    {!> ../../../docs_src/background_tasks/tutorial002_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="13  15  22  25"
+    {!> ../../../docs_src/background_tasks/tutorial002_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="14  16  23  26"
+    {!> ../../../docs_src/background_tasks/tutorial002_an.py!}
+    ```
+
+=== "Python 3.10+ 没Annotated"
+
+    !!! tip
+         尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="11  13  20  23"
+    {!> ../../../docs_src/background_tasks/tutorial002_py310.py!}
+    ```
+
+=== "Python 3.6+ 没Annotated"
+
+    !!! tip
+         尽可能选择使用 `Annotated` 的版本。
+
+    ```Python hl_lines="13  15  22  25"
+    {!> ../../../docs_src/background_tasks/tutorial002.py!}
+    ```
+
+该示例中，信息会在响应发出 *之后* 被写到 `log.txt` 文件。
+
+如果请求中有查询，它将在后台任务中写入日志。
+
+然后另一个在 *路径操作函数* 生成的后台任务会使用路径参数 `email` 写入一条信息。
+
+## 技术细节
+
+`BackgroundTasks` 类直接来自 <a href="https://www.starlette.io/background/" class="external-link" target="_blank">`starlette.background`</a>。
+
+它被直接导入/包含到FastAPI以便你可以从 `fastapi` 导入，并避免意外从 `starlette.background` 导入备用的 `BackgroundTask` (后面没有 `s`)。
+
+通过仅使用 `BackgroundTasks` (而不是 `BackgroundTask`)，使得能将它作为 *路径操作函数* 的参数 ，并让**FastAPI**为您处理其余部分, 就像直接使用 `Request` 对象。
+
+在FastAPI中仍然可以单独使用 `BackgroundTask`，但您必须在代码中创建对象，并返回包含它的Starlette `Response`。
+
+更多细节查看 <a href="https://www.starlette.io/background/" class="external-link" target="_blank">Starlette's official docs for Background Tasks</a>.
+
+## 告诫
+
+如果您需要执行繁重的后台计算，并且不一定需要由同一进程运行（例如，您不需要共享内存、变量等），那么使用其他更大的工具（如 <a href="https://docs.celeryq.dev" class="external-link" target="_blank">Celery</a>）可能更好。
+
+它们往往需要更复杂的配置，即消息/作业队列管理器，如RabbitMQ或Redis，但它们允许您在多个进程中运行后台任务，甚至是在多个服务器中。
+
+要查看示例，查阅 [Project Generators](../project-generation.md){.internal-link target=_blank}，它们都包括已经配置的Celery。
+
+但是，如果您需要从同一个**FastAPI**应用程序访问变量和对象，或者您需要执行小型后台任务（如发送电子邮件通知），您只需使用 `BackgroundTasks` 即可。
+
+## 回顾
+
+导入并使用 `BackgroundTasks` 通过 *路径操作函数* 中的参数和依赖项来添加后台任务。

From 5d3f51c8bc7b902204b1b55ea7044ca5f10a7256 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 27 Jul 2023 18:56:19 +0000
Subject: [PATCH 018/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2f9aada99..d295826fc 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add French translation for `docs/fr/docs/tutorial/query-params-str-validations.md`. PR [#4075](https://github.com/tiangolo/fastapi/pull/4075) by [@Smlep](https://github.com/Smlep).
 * 🌐 Add French translation for `docs/fr/docs/tutorial/index.md`. PR [#2234](https://github.com/tiangolo/fastapi/pull/2234) by [@JulianMaurin](https://github.com/JulianMaurin).
 * 🌐 Add French translation for `docs/fr/docs/contributing.md`. PR [#2132](https://github.com/tiangolo/fastapi/pull/2132) by [@JulianMaurin](https://github.com/JulianMaurin).
 * 🌐 Add French translation for `docs/fr/docs/benchmarks.md`. PR [#2155](https://github.com/tiangolo/fastapi/pull/2155) by [@clemsau](https://github.com/clemsau).

From e334065d1055e27773271c00ba8830c7176f975d Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 27 Jul 2023 18:57:37 +0000
Subject: [PATCH 019/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d295826fc..f6097bedb 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🔧 Update sponsors, add Fern. PR [#9956](https://github.com/tiangolo/fastapi/pull/9956) by [@tiangolo](https://github.com/tiangolo).
 * 🌐 Add French translation for `docs/fr/docs/tutorial/query-params-str-validations.md`. PR [#4075](https://github.com/tiangolo/fastapi/pull/4075) by [@Smlep](https://github.com/Smlep).
 * 🌐 Add French translation for `docs/fr/docs/tutorial/index.md`. PR [#2234](https://github.com/tiangolo/fastapi/pull/2234) by [@JulianMaurin](https://github.com/JulianMaurin).
 * 🌐 Add French translation for `docs/fr/docs/contributing.md`. PR [#2132](https://github.com/tiangolo/fastapi/pull/2132) by [@JulianMaurin](https://github.com/JulianMaurin).

From 55871036dbd85531f042f1e6b87a14fe8556ccd0 Mon Sep 17 00:00:00 2001
From: Nina Hwang <79563565+NinaHwang@users.noreply.github.com>
Date: Fri, 28 Jul 2023 03:59:18 +0900
Subject: [PATCH 020/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translati?=
 =?UTF-8?q?on=20for=20`docs/ko/docs/async.md`=20(#4179)?=
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>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
 docs/ko/docs/async.md | 404 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 404 insertions(+)
 create mode 100644 docs/ko/docs/async.md

diff --git a/docs/ko/docs/async.md b/docs/ko/docs/async.md
new file mode 100644
index 000000000..47dbaa1b0
--- /dev/null
+++ b/docs/ko/docs/async.md
@@ -0,0 +1,404 @@
+# 동시성과 async / await
+
+*경로 작동 함수*에서의 `async def` 문법에 대한 세부사항과 비동기 코드, 동시성 및 병렬성에 대한 배경
+
+## <a name="in-a-hurry"></a>바쁘신 경우
+
+<strong>요약</strong>
+
+다음과 같이 `await`를 사용해 호출하는 제3의 라이브러리를 사용하는 경우:
+
+```Python
+results = await some_library()
+```
+
+다음처럼 *경로 작동 함수*를 `async def`를 사용해 선언하십시오:
+
+```Python hl_lines="2"
+@app.get('/')
+async def read_results():
+    results = await some_library()
+    return results
+```
+
+!!! note "참고"
+    `async def`로 생성된 함수 내부에서만 `await`를 사용할 수 있습니다.
+
+---
+
+데이터베이스, API, 파일시스템 등과 의사소통하는 제3의 라이브러리를 사용하고, 그것이 `await`를 지원하지 않는 경우(현재 거의 모든 데이터베이스 라이브러리가 그러합니다), *경로 작동 함수*를 일반적인 `def`를 사용해 선언하십시오:
+
+```Python hl_lines="2"
+@app.get('/')
+def results():
+    results = some_library()
+    return results
+```
+
+---
+
+만약 당신의 응용프로그램이 (어째서인지) 다른 무엇과 의사소통하고 그것이 응답하기를 기다릴 필요가 없다면 `async def`를 사용하십시오.
+
+---
+
+모르겠다면, 그냥 `def`를 사용하십시오.
+
+---
+
+**참고**: *경로 작동 함수*에서 필요한만큼 `def`와 `async def`를 혼용할 수 있고, 가장 알맞은 것을 선택해서 정의할 수 있습니다. FastAPI가 자체적으로 알맞은 작업을 수행할 것입니다.
+
+어찌되었든, 상기 어떠한 경우라도, FastAPI는 여전히 비동기적으로 작동하고 매우 빠릅니다.
+
+그러나 상기 작업을 수행함으로써 어느 정도의 성능 최적화가 가능합니다.
+
+## 기술적 세부사항
+
+최신 파이썬 버전은 `async`와 `await` 문법과 함께 **“코루틴”**이라고 하는 것을 사용하는 **“비동기 코드”**를 지원합니다.
+
+아래 섹션들에서 해당 문장을 부분별로 살펴보겠습니다:
+
+* **비동기 코드**
+* **`async`와 `await`**
+* **코루틴**
+
+## 비동기 코드
+
+비동기 코드란 언어 💬 가 코드의 어느 한 부분에서, 컴퓨터 / 프로그램🤖에게 *다른 무언가*가 어딘가에서 끝날 때까지 기다려야한다고 말하는 방식입니다. *다른 무언가*가 “느린-파일" 📝 이라고 불린다고 가정해봅시다.
+
+따라서 “느린-파일” 📝이 끝날때까지 컴퓨터는 다른 작업을 수행할 수 있습니다.
+
+그 다음 컴퓨터 / 프로그램 🤖 은 다시 기다리고 있기 때문에 기회가 있을 때마다 다시 돌아오거나, 혹은 당시에 수행해야하는 작업들이 완료될 때마다 다시 돌아옵니다. 그리고 그것 🤖 은 기다리고 있던 작업 중 어느 것이 이미 완료되었는지, 그것 🤖 이 해야하는 모든 작업을 수행하면서 확인합니다.
+
+다음으로, 그것 🤖 은 완료할 첫번째 작업에 착수하고(우리의 "느린-파일" 📝 이라고 가정합시다) 그에 대해 수행해야하는 작업을 계속합니다.
+
+"다른 무언가를 기다리는 것"은 일반적으로 비교적 "느린" (프로세서와 RAM 메모리 속도에 비해) <abbr title="Input and Output">I/O</abbr> 작업을 의미합니다. 예를 들면 다음의 것들을 기다리는 것입니다:
+
+* 네트워크를 통해 클라이언트로부터 전송되는 데이터
+* 네트워크를 통해 클라이언트가 수신할, 당신의 프로그램으로부터 전송되는 데이터
+* 시스템이 읽고 프로그램에 전달할 디스크 내의 파일 내용
+* 당신의 프로그램이 시스템에 전달하는, 디스크에 작성될 내용
+* 원격 API 작업
+* 완료될 데이터베이스 작업
+* 결과를 반환하는 데이터베이스 쿼리
+* 기타
+
+수행 시간의 대부분이 <abbr title="Input and Output">I/O</abbr> 작업을 기다리는데에 소요되기 때문에, "I/O에 묶인" 작업이라고 불립니다.
+
+이것은 "비동기"라고 불리는데 컴퓨터 / 프로그램이 작업 결과를 가지고 일을 수행할 수 있도록, 느린 작업에 "동기화"되어 아무것도 하지 않으면서 작업이 완료될 정확한 시점만을 기다릴 필요가 없기 때문입니다.
+
+이 대신에, "비동기" 시스템에서는, 작업은 일단 완료되면, 컴퓨터 / 프로그램이 수행하고 있는 일을 완료하고 이후 다시 돌아와서 그것의 결과를 받아 이를 사용해 작업을 지속할 때까지 잠시 (몇 마이크로초) 대기할 수 있습니다.
+
+"동기"("비동기"의 반대)는 컴퓨터 / 프로그램이 상이한 작업들간 전환을 하기 전에 그것이 대기를 동반하게 될지라도 모든 순서를 따르기 때문에 "순차"라는 용어로도 흔히 불립니다.
+
+### 동시성과 버거
+
+위에서 설명한 **비동기** 코드에 대한 개념은 종종 **"동시성"**이라고도 불립니다. 이것은 **"병렬성"**과는 다릅니다.
+
+**동시성**과 **병렬성**은 모두 "동시에 일어나는 서로 다른 일들"과 관련이 있습니다.
+
+하지만 *동시성*과 *병렬성*의 세부적인 개념에는 꽤 차이가 있습니다.
+
+차이를 확인하기 위해, 다음의 버거에 대한 이야기를 상상해보십시오:
+
+### 동시 버거
+
+당신은 짝사랑 상대 😍 와 패스트푸드 🍔 를 먹으러 갔습니다. 당신은 점원 💁 이 당신 앞에 있는 사람들의 주문을 받을 동안 줄을 서서 기다리고 있습니다.
+
+이제 당신의 순서가 되어서, 당신은 당신과 짝사랑 상대 😍 를 위한 두 개의 고급스러운 버거 🍔 를 주문합니다.
+
+당신이 돈을 냅니다 💸.
+
+점원 💁 은 주방 👨‍🍳 에 요리를 하라고 전달하고, 따라서 그들은 당신의 버거 🍔 를 준비해야한다는 사실을 알게됩니다(그들이 지금은 당신 앞 고객들의 주문을 준비하고 있을지라도 말입니다).
+
+점원 💁 은 당신의 순서가 적힌 번호표를 줍니다.
+
+기다리는 동안, 당신은 짝사랑 상대 😍 와 함께 테이블을 고르고, 자리에 앉아 오랫동안 (당신이 주문한 버거는 꽤나 고급스럽기 때문에 준비하는데 시간이 조금 걸립니다 ✨🍔✨) 대화를 나눕니다.
+
+짝사랑 상대 😍 와 테이블에 앉아서 버거 🍔 를 기다리는 동안, 그 사람 😍 이 얼마나 멋지고, 사랑스럽고, 똑똑한지 감탄하며 시간을 보냅니다 ✨😍✨.
+
+짝사랑 상대 😍 와 기다리면서 얘기하는 동안, 때때로, 당신은 당신의 차례가 되었는지 보기 위해 카운터의 번호를 확인합니다.
+
+그러다 어느 순간, 당신의 차례가 됩니다. 카운터에 가서, 버거 🍔 를 받고, 테이블로 다시 돌아옵니다.
+
+당신과 짝사랑 상대 😍 는 버거 🍔 를 먹으며 좋은 시간을 보냅니다 ✨.
+
+---
+
+당신이 이 이야기에서 컴퓨터 / 프로그램 🤖 이라고 상상해보십시오.
+
+줄을 서서 기다리는 동안, 당신은 아무것도 하지 않고 😴 당신의 차례를 기다리며, 어떠한 "생산적인" 일도 하지 않습니다. 하지만 점원 💁 이 (음식을 준비하지는 않고) 주문을 받기만 하기 때문에 줄이 빨리 줄어들어서 괜찮습니다.
+
+그다음, 당신이 차례가 오면, 당신은 실제로 "생산적인" 일 🤓 을 합니다. 당신은 메뉴를 보고, 무엇을 먹을지 결정하고, 짝사랑 상대 😍 의 선택을 묻고, 돈을 내고 💸 , 맞는 카드를 냈는지 확인하고, 비용이 제대로 지불되었는지 확인하고, 주문이 제대로 들어갔는지 확인을 하는 작업 등등을 수행합니다.
+
+하지만 이후에는, 버거 🍔 를 아직 받지 못했음에도, 버거가 준비될 때까지 기다려야 🕙 하기 때문에 점원 💁 과의 작업은 "일시정지" ⏸  상태입니다.
+
+하지만 번호표를 받고 카운터에서 나와 테이블에 앉으면, 당신은 짝사랑 상대 😍 와 그 "작업"  ⏯ 🤓 에 번갈아가며 🔀  집중합니다. 그러면 당신은 다시 짝사랑 상대 😍 에게 작업을 거는 매우 "생산적인" 일 🤓 을 합니다.
+
+점원 💁 이 카운터 화면에 당신의 번호를 표시함으로써 "버거 🍔 가 준비되었습니다"라고 해도, 당신은 즉시 뛰쳐나가지는 않을 것입니다. 당신은 당신의 번호를 갖고있고, 다른 사람들은 그들의 번호를 갖고있기 때문에, 아무도 당신의 버거 🍔 를 훔쳐가지 않는다는 사실을 알기 때문입니다.
+
+그래서 당신은 짝사랑 상대 😍 가 이야기를 끝낼 때까지 기다린 후 (현재 작업 완료 ⏯ / 진행 중인 작업 처리 🤓 ), 정중하게 미소짓고 버거를 가지러 가겠다고 말합니다 ⏸.
+
+그다음 당신은 카운터에 가서 🔀 , 초기 작업을 이제 완료하고 ⏯ , 버거 🍔 를 받고, 감사하다고 말하고 테이블로 가져옵니다. 이로써 카운터와의 상호작용 단계 / 작업이 종료됩니다 ⏹.
+
+이전 작업인 "버거 받기"가 종료되면 ⏹ "버거 먹기"라는 새로운 작업이 생성됩니다 🔀 ⏯.
+
+### 병렬 버거
+
+이제 "동시 버거"가 아닌 "병렬 버거"를 상상해보십시오.
+
+당신은 짝사랑 상대 😍 와 함께 병렬 패스트푸드 🍔 를 먹으러 갔습니다.
+
+당신은 여러명(8명이라고 가정합니다)의 점원이 당신 앞 사람들의 주문을 받으며 동시에 요리 👩‍🍳👨‍🍳👩‍🍳👨‍🍳👩‍🍳👨‍🍳👩‍🍳👨‍🍳 도 하는 동안 줄을 서서 기다립니다.
+
+당신 앞 모든 사람들이 버거가 준비될 때까지 카운터에서 떠나지 않고 기다립니다 🕙 . 왜냐하면 8명의 직원들이 다음 주문을 받기 전에 버거를 준비하러 가기 때문입니다.
+
+마침내 당신의 차례가 왔고, 당신은 당신과 짝사랑 상대 😍 를 위한 두 개의 고급스러운 버거 🍔 를 주문합니다.
+
+당신이 비용을 지불합니다 💸 .
+
+점원이 주방에 갑니다 👨‍🍳 .
+
+당신은 번호표가 없기 때문에 누구도 당신의 버거 🍔 를 대신 가져갈 수 없도록 카운터에 서서 기다립니다 🕙 .
+
+당신과 짝사랑 상대 😍 는 다른 사람이 새치기해서 버거를 가져가지 못하게 하느라 바쁘기 때문에 🕙 , 짝사랑 상대에게 주의를 기울일 수 없습니다 😞 .
+
+이것은 "동기" 작업이고, 당신은 점원/요리사 👨‍🍳 와 "동기화" 되었습니다. 당신은 기다리고 🕙 , 점원/요리사 👨‍🍳 가 버거 🍔  준비를 완료한 후 당신에게 주거나, 누군가가 그것을 가져가는 그 순간에 그 곳에 있어야합니다.
+
+카운터 앞에서 오랫동안 기다린 후에 🕙 , 점원/요리사 👨‍🍳 가 당신의 버거 🍔 를 가지고 돌아옵니다.
+
+당신은 버거를 받고 짝사랑 상대와 함께 테이블로 돌아옵니다.
+
+단지 먹기만 하다가, 다 먹었습니다 🍔 ⏹.
+
+카운터 앞에서 기다리면서 🕙  너무 많은 시간을 허비했기 때문에 대화를 하거나 작업을 걸 시간이 거의 없었습니다 😞 .
+
+---
+
+이 병렬 버거 시나리오에서, 당신은 기다리고 🕙 , 오랜 시간동안 "카운터에서 기다리는" 🕙 데에 주의를 기울이는 ⏯ 두 개의 프로세서(당신과 짝사랑 상대😍)를 가진 컴퓨터 / 프로그램 🤖 입니다.
+
+패스트푸드점에는 8개의 프로세서(점원/요리사) 👩‍🍳👨‍🍳👩‍🍳👨‍🍳👩‍🍳👨‍🍳👩‍🍳👨‍🍳 가 있습니다. 동시 버거는 단 두 개(한 명의 직원과 한 명의 요리사) 💁 👨‍🍳 만을 가지고 있었습니다.
+
+하지만 여전히, 병렬 버거 예시가 최선은 아닙니다 😞 .
+
+---
+
+이 예시는 버거🍔 이야기와 결이 같습니다.
+
+더 "현실적인" 예시로, 은행을 상상해보십시오.
+
+최근까지, 대다수의 은행에는 다수의 은행원들 👨‍💼👨‍💼👨‍💼👨‍💼 과 긴 줄 🕙🕙🕙🕙🕙🕙🕙🕙 이 있습니다.
+
+모든 은행원들은 한 명 한 명의 고객들을 차례로 상대합니다 👨‍💼⏯ .
+
+그리고 당신은 오랫동안 줄에서 기다려야하고 🕙 , 그렇지 않으면 당신의 차례를 잃게 됩니다.
+
+아마 당신은 은행 🏦 심부름에 짝사랑 상대 😍 를 데려가고 싶지는 않을 것입니다.
+
+### 버거 예시의 결론
+
+"짝사랑 상대와의 패스트푸드점 버거" 시나리오에서, 오랜 기다림 🕙 이 있기 때문에 동시 시스템 ⏸🔀⏯ 을 사용하는 것이 더 합리적입니다.
+
+대다수의 웹 응용프로그램의 경우가 그러합니다.
+
+매우 많은 수의 유저가 있지만, 서버는 그들의 요청을 전송하기 위해 그닥-좋지-않은 연결을 기다려야 합니다 🕙 .
+
+그리고 응답이 돌아올 때까지 다시 기다려야 합니다 🕙 .
+
+이 "기다림" 🕙 은 마이크로초 단위이지만, 모두 더해지면, 결국에는 매우 긴 대기시간이 됩니다.
+
+따라서 웹 API를 위해 비동기 ⏸🔀⏯ 코드를 사용하는 것이 합리적입니다.
+
+대부분의 존재하는 유명한 파이썬 프레임워크 (Flask와 Django 등)은 새로운 비동기 기능들이 파이썬에 존재하기 전에 만들어졌습니다. 그래서, 그들의 배포 방식은 병렬 실행과 새로운 기능만큼 강력하지는 않은 예전 버전의 비동기 실행을 지원합니다.
+
+비동기 웹 파이썬(ASGI)에 대한 주요 명세가 웹소켓을 지원하기 위해 Django에서 개발 되었음에도 그렇습니다.
+
+이러한 종류의 비동기성은 (NodeJS는 병렬적이지 않음에도) NodeJS가 사랑받는 이유이고, 프로그래밍 언어로서의 Go의 강점입니다.
+
+그리고 **FastAPI**를 사용함으로써 동일한 성능을 낼 수 있습니다.
+
+또한 병렬성과 비동기성을 동시에 사용할 수 있기 때문에, 대부분의 테스트가 완료된 NodeJS 프레임워크보다 더 높은 성능을 얻고 C에 더 가까운 컴파일 언어인 Go와 동등한 성능을 얻을 수 있습니다<a href="https://www.techempower.com/benchmarks/#section=data-r17&hw=ph&test=query&l=zijmkf-1" class="external-link" target="_blank">(모두 Starlette 덕분입니다)</a>.
+
+### 동시성이 병렬성보다 더 나은가?
+
+그렇지 않습니다! 그것이 이야기의 교훈은 아닙니다.
+
+동시성은 병렬성과 다릅니다. 그리고 그것은 많은 대기를 필요로하는 **특정한** 시나리오에서는 더 낫습니다. 이로 인해, 웹 응용프로그램 개발에서 동시성이 병렬성보다 일반적으로 훨씬 낫습니다. 하지만 모든 경우에 그런 것은 아닙니다.
+
+따라서, 균형을 맞추기 위해, 다음의 짧은 이야기를 상상해보십시오:
+
+> 당신은 크고, 더러운 집을 청소해야합니다.
+
+*네, 이게 전부입니다*.
+
+---
+
+어디에도 대기 🕙 는 없고, 집안 곳곳에서 해야하는 많은 작업들만 있습니다.
+
+버거 예시처럼 처음에는 거실, 그 다음은 부엌과 같은 식으로 순서를 정할 수도 있으나, 무엇도 기다리지 🕙 않고 계속해서 청소 작업만 수행하기 때문에, 순서는 아무런 영향을 미치지 않습니다.
+
+순서가 있든 없든 동일한 시간이 소요될 것이고(동시성) 동일한 양의 작업을 하게 될 것입니다.
+
+하지만 이 경우에서, 8명의 전(前)-점원/요리사이면서-현(現)-청소부 👩‍🍳👨‍🍳👩‍🍳👨‍🍳👩‍🍳👨‍🍳👩‍🍳👨‍🍳 를 고용할 수 있고, 그들 각자(그리고 당신)가 집의 한 부분씩 맡아 청소를 한다면, 당신은 **병렬적**으로 작업을 수행할 수 있고, 조금의 도움이 있다면, 훨씬 더 빨리 끝낼 수 있습니다.
+
+이 시나리오에서, (당신을 포함한) 각각의 청소부들은 프로세서가 될 것이고, 각자의 역할을 수행합니다.
+
+실행 시간의 대부분이 대기가 아닌 실제 작업에 소요되고, 컴퓨터에서 작업은 <abbr title="Central Processing Unit">CPU</abbr>에서 이루어지므로, 이러한 문제를 "CPU에 묶였"다고 합니다.
+
+---
+
+CPU에 묶인 연산에 관한 흔한 예시는 복잡한 수학 처리를 필요로 하는 경우입니다.
+
+예를 들어:
+
+* **오디오** 또는 **이미지** 처리.
+* **컴퓨터 비전**: 하나의 이미지는 수백개의 픽셀로 구성되어있고, 각 픽셀은 3개의 값 / 색을 갖고 있으며, 일반적으로 해당 픽셀들에 대해 동시에 무언가를 계산해야하는 처리.
+* **머신러닝**: 일반적으로 많은 "행렬"과 "벡터" 곱셈이 필요합니다. 거대한 스프레드 시트에 수들이 있고 그 수들을 동시에 곱해야 한다고 생각해보십시오.
+* **딥러닝**: 머신러닝의 하위영역으로, 동일한 예시가 적용됩니다. 단지 이 경우에는 하나의 스프레드 시트에 곱해야할 수들이 있는 것이 아니라, 거대한 세트의 스프레드 시트들이 있고, 많은 경우에, 이 모델들을 만들고 사용하기 위해 특수한 프로세서를 사용합니다.
+
+### 동시성 + 병렬성: 웹 + 머신러닝
+
+**FastAPI**를 사용하면 웹 개발에서는 매우 흔한 동시성의 이점을 (NodeJS의 주된 매력만큼) 얻을 수 있습니다.
+
+뿐만 아니라 머신러닝 시스템과 같이 **CPU에 묶인** 작업을 위해 병렬성과 멀티프로세싱(다수의 프로세스를 병렬적으로 동작시키는 것)을 이용하는 것도 가능합니다.
+
+파이썬이 **데이터 사이언스**, 머신러닝과 특히 딥러닝에 의 주된 언어라는 간단한 사실에 더해서, 이것은 FastAPI를 데이터 사이언스 / 머신러닝 웹 API와 응용프로그램에 (다른 것들보다) 좋은 선택지가 되게 합니다.
+
+배포시 병렬을 어떻게 가능하게 하는지 알고싶다면, [배포](/ko/deployment){.internal-link target=_blank}문서를 참고하십시오.
+
+## `async`와  `await`
+
+최신 파이썬 버전에는 비동기 코드를 정의하는 매우 직관적인 방법이 있습니다. 이는 이것을 평범한 "순차적" 코드로 보이게 하고, 적절한 순간에 당신을 위해 "대기"합니다.
+
+연산이 결과를 전달하기 전에 대기를 해야하고 새로운 파이썬 기능들을 지원한다면, 이렇게 코드를 작성할 수 있습니다:
+
+```Python
+burgers = await get_burgers(2)
+```
+
+여기서 핵심은 `await`입니다. 이것은 파이썬에게 `burgers` 결과를 저장하기 이전에 `get_burgers(2)`의 작업이 완료되기를 🕙 기다리라고 ⏸ 말합니다. 이로 인해, 파이썬은 그동안 (다른 요청을 받는 것과 같은) 다른 작업을 수행해도 된다는 것을 🔀 ⏯ 알게될 것입니다.
+
+`await`가 동작하기 위해, 이것은 비동기를 지원하는 함수 내부에 있어야 합니다. 이를 위해서 함수를 `async def`를 사용해 정의하기만 하면 됩니다:
+
+```Python hl_lines="1"
+async def get_burgers(number: int):
+    # Do some asynchronous stuff to create the burgers
+    return burgers
+```
+
+...`def`를 사용하는 대신:
+
+```Python hl_lines="2"
+# This is not asynchronous
+def get_sequential_burgers(number: int):
+    # Do some sequential stuff to create the burgers
+    return burgers
+```
+
+`async def`를 사용하면, 파이썬은 해당 함수 내에서 `await` 표현에 주의해야한다는 사실과, 해당 함수의 실행을 "일시정지"⏸하고 다시 돌아오기 전까지 다른 작업을 수행🔀할 수 있다는 것을 알게됩니다.
+
+`async def`f 함수를 호출하고자 할 때, "대기"해야합니다. 따라서, 아래는 동작하지 않습니다.
+
+```Python
+# This won't work, because get_burgers was defined with: async def
+burgers = get_burgers(2)
+```
+
+---
+
+따라서, `await`f를 사용해서 호출할 수 있는 라이브러리를 사용한다면, 다음과 같이 `async def`를 사용하는 *경로 작동 함수*를 생성해야 합니다:
+
+```Python hl_lines="2-3"
+@app.get('/burgers')
+async def read_burgers():
+    burgers = await get_burgers(2)
+    return burgers
+```
+
+### 더 세부적인 기술적 사항
+
+`await`가 `async def`를 사용하는 함수 내부에서만 사용이 가능하다는 것을 눈치채셨을 것입니다.
+
+하지만 동시에, `async def`로 정의된 함수들은 "대기"되어야만 합니다. 따라서, `async def`를 사용한 함수들은 역시 `async def`를 사용한 함수 내부에서만 호출될 수 있습니다.
+
+그렇다면 닭이 먼저냐, 달걀이 먼저냐, 첫 `async` 함수를 어떻게 호출할 수 있겠습니까?
+
+**FastAPI**를 사용해 작업한다면 이것을 걱정하지 않아도 됩니다. 왜냐하면 그 "첫" 함수는 당신의 *경로 작동 함수*가 될 것이고, FastAPI는 어떻게 올바르게 처리할지 알고있기 때문입니다.
+
+하지만 FastAPI를 사용하지 않고 `async` / `await`를 사용하고 싶다면, 이 역시 가능합니다.
+
+### 당신만의 비동기 코드 작성하기
+
+Starlette(그리고 FastAPI)는 <a href="https://anyio.readthedocs.io/en/stable/" class="external-link" target="_blank">AnyIO</a>를 기반으로 하고있고, 따라서 파이썬 표준 라이브러리인 <a href="https://docs.python.org/3/library/asyncio-task.html" class="external-link" target="_blank">asyncio</a> 및 <a href="https://trio.readthedocs.io/en/stable/" class="external-link" target="_blank">Trio</a>와 호환됩니다.
+
+특히, 코드에서 고급 패턴이 필요한 고급 동시성을 사용하는 경우 직접적으로 <a href="https://anyio.readthedocs.io/en/stable/" class="external-link" target="_blank">AnyIO</a>를 사용할 수 있습니다.
+
+FastAPI를 사용하지 않더라도, 높은 호환성 및 <a href="https://anyio.readthedocs.io/en/stable/" class="external-link" target="_blank">AnyIO</a>의 이점(예: *구조화된 동시성*)을 취하기 위해 <a href="https://anyio.readthedocs.io/en/stable/" class="external-link" target="_blank">AnyIO</a>를 사용해 비동기 응용프로그램을 작성할 수 있습니다.
+
+### 비동기 코드의 다른 형태
+
+파이썬에서 `async`와 `await`를 사용하게 된 것은 비교적 최근의 일입니다.
+
+하지만 이로 인해 비동기 코드 작업이 훨씬 간단해졌습니다.
+
+같은 (또는 거의 유사한) 문법은 최신 버전의 자바스크립트(브라우저와 NodeJS)에도 추가되었습니다.
+
+하지만 그 이전에, 비동기 코드를 처리하는 것은 꽤 복잡하고 어려운 일이었습니다.
+
+파이썬의 예전 버전이라면, 스레드 또는 <a href="https://www.gevent.org/" class="external-link" target="_blank">Gevent</a>를 사용할 수 있을 것입니다. 하지만 코드를 이해하고, 디버깅하고, 이에 대해 생각하는게 훨씬 복잡합니다.
+
+예전 버전의 NodeJS / 브라우저 자바스크립트라면, "콜백 함수"를 사용했을 것입니다. 그리고 이로 인해 <a href="http://callbackhell.com/" class="external-link" target="_blank">콜백 지옥</a>에 빠지게 될 수 있습니다.
+
+## 코루틴
+
+**코루틴**은 `async def` 함수가 반환하는 것을 칭하는 매우 고급스러운 용어일 뿐입니다. 파이썬은 그것이 시작되고 어느 시점에서 완료되지만 내부에 `await`가 있을 때마다 내부적으로 일시정지⏸될 수도 있는 함수와 유사한 것이라는 사실을 알고있습니다.
+
+그러나 `async` 및 `await`와 함께 비동기 코드를 사용하는 이 모든 기능들은 "코루틴"으로 간단히 요약됩니다. 이것은 Go의 주된 핵심 기능인 "고루틴"에 견줄 수 있습니다.
+
+## 결론
+
+상기 문장을 다시 한 번 봅시다:
+
+> 최신 파이썬 버전은 **`async` 및 `await`** 문법과 함께 **“코루틴”**이라고 하는 것을 사용하는 **“비동기 코드”**를 지원합니다.
+
+이제 이 말을 조금 더 이해할 수 있을 것입니다. ✨
+
+이것이 (Starlette을 통해) FastAPI를 강하게 하면서 그것이 인상적인 성능을 낼 수 있게 합니다.
+
+## 매우 세부적인 기술적 사항
+
+!!! warning "경고"
+    이 부분은 넘어가도 됩니다.
+
+    이것들은 **FastAPI**가 내부적으로 어떻게 동작하는지에 대한 매우 세부적인 기술사항입니다.
+
+    만약 기술적 지식(코루틴, 스레드, 블록킹 등)이 있고 FastAPI가 어떻게 `async def` vs `def`를 다루는지 궁금하다면, 계속하십시오.
+
+### 경로 작동 함수
+
+경로 작동 함수를 `async def` 대신 일반적인 `def`로 선언하는 경우, (서버를 차단하는 것처럼) 그것을 직접 호출하는 대신 대기중인 외부 스레드풀에서 실행됩니다.
+
+만약 상기에 묘사된대로 동작하지 않는 비동기 프로그램을 사용해왔고 약간의 성능 향상 (약 100 나노초)을 위해 `def`를 사용해서 계산만을 위한 사소한 *경로 작동 함수*를 정의해왔다면, **FastAPI**는 이와는 반대라는 것에 주의하십시오. 이러한 경우에, *경로 작동 함수*가 블로킹 <abbr title="Input/Output: 디스크 읽기 또는 쓰기, 네트워크 통신.">I/O</abbr>를 수행하는 코드를 사용하지 않는 한 `async def`를 사용하는 편이 더 낫습니다.
+
+하지만 두 경우 모두, FastAPI가 당신이 전에 사용하던 프레임워크보다 [더 빠를](/#performance){.internal-link target=_blank} (최소한 비견될) 확률이 높습니다.
+
+### 의존성
+
+의존성에도 동일하게 적용됩니다. 의존성이 `async def`가 아닌 표준 `def` 함수라면, 외부 스레드풀에서 실행됩니다.
+
+### 하위-의존성
+
+함수 정의시 매개변수로 서로를 필요로하는 다수의 의존성과 하위-의존성을 가질 수 있고, 그 중 일부는 `async def`로, 다른 일부는 일반적인 `def`로 생성되었을 수 있습니다. 이것은 여전히 잘 동작하고, 일반적인 `def`로 생성된 것들은 "대기"되는 대신에 (스레드풀로부터) 외부 스레드에서 호출됩니다.
+
+### 다른 유틸리티 함수
+
+직접 호출되는 다른 모든 유틸리티 함수는 일반적인 `def`나 `async def`로 생성될 수 있고 FastAPI는 이를 호출하는 방식에 영향을 미치지 않습니다.
+
+이것은 FastAPI가 당신을 위해 호출하는 함수와는 반대입니다: *경로 작동 함수*와 의존성
+
+만약 당신의 유틸리티 함수가 `def`를 사용한 일반적인 함수라면, 스레드풀에서가 아니라 직접 호출(당신이 코드에 작성한 대로)될 것이고, `async def`로 생성된 함수라면 코드에서 호출할 때 그 함수를 `await` 해야 합니다.
+
+---
+
+다시 말하지만, 이것은 당신이 이것에 대해 찾고있던 경우에 한해 유용할 매우 세부적인 기술사항입니다.
+
+그렇지 않은 경우, 상기의 가이드라인만으로도 충분할 것입니다: [바쁘신 경우](#in-a-hurry).

From 77cfb3c822c6e58b68a8694f4b01bb1bb9c87255 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 27 Jul 2023 18:59:56 +0000
Subject: [PATCH 021/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f6097bedb..ce28cb029 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Chinese translation for `docs/zh/docs/tutorial/background-tasks.md`. PR [#9812](https://github.com/tiangolo/fastapi/pull/9812) by [@wdh99](https://github.com/wdh99).
 * 🔧 Update sponsors, add Fern. PR [#9956](https://github.com/tiangolo/fastapi/pull/9956) by [@tiangolo](https://github.com/tiangolo).
 * 🌐 Add French translation for `docs/fr/docs/tutorial/query-params-str-validations.md`. PR [#4075](https://github.com/tiangolo/fastapi/pull/4075) by [@Smlep](https://github.com/Smlep).
 * 🌐 Add French translation for `docs/fr/docs/tutorial/index.md`. PR [#2234](https://github.com/tiangolo/fastapi/pull/2234) by [@JulianMaurin](https://github.com/JulianMaurin).

From 1d088eaf18b096b0ded50c80d33aa5e603add49b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nguy=E1=BB=85n=20Kh=E1=BA=AFc=20Th=C3=A0nh?=
 <nguyenkhacthanh244@gmail.com>
Date: Fri, 28 Jul 2023 02:01:57 +0700
Subject: [PATCH 022/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Vietnamese=20trans?=
 =?UTF-8?q?lation=20for=20`docs/vi/docs/features.md`=20and=20`docs/vi/docs?=
 =?UTF-8?q?/index.md`=20(#3006)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Nguyen Khac Thanh <nkthanh@Nguyens-MacBook-Pro.local>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
---
 docs/vi/docs/features.md | 197 ++++++++++++++++
 docs/vi/docs/index.md    | 476 +++++++++++++++++++++++++++++++++++++++
 docs/vi/mkdocs.yml       |   1 +
 3 files changed, 674 insertions(+)
 create mode 100644 docs/vi/docs/features.md
 create mode 100644 docs/vi/docs/index.md
 create mode 100644 docs/vi/mkdocs.yml

diff --git a/docs/vi/docs/features.md b/docs/vi/docs/features.md
new file mode 100644
index 000000000..0599530e8
--- /dev/null
+++ b/docs/vi/docs/features.md
@@ -0,0 +1,197 @@
+# Tính năng
+
+## Tính năng của FastAPI
+
+**FastAPI** cho bạn những tính năng sau:
+
+### Dựa trên những tiêu chuẩn mở
+
+* <a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank"><strong>OpenAPI</strong></a> cho việc tạo API, bao gồm những khai báo về <abbr title="cũng được biết đến như: endpoints, routes">đường dẫn</abbr> <abbr title="cũng được biết đến như các phương thức HTTP, như POST, GET, PUT, DELETE"> các toán tử</abbr>, tham số, body requests, cơ chế bảo mật, etc.
+* Tự động tài liệu hóa data model theo <a href="https://json-schema.org/" class="external-link" target="_blank"><strong>JSON Schema</strong></a> (OpenAPI bản thân nó được dựa trên JSON Schema).
+* Được thiết kế xung quanh các tiêu chuẩn này sau khi nghiên cứu tỉ mỉ thay vì chỉ suy nghĩ đơn giản và sơ xài.
+* Điều này cho phép tự động hóa **trình sinh code client** cho nhiều ngôn ngữ lập trình khác nhau.
+
+### Tự động hóa tài liệu
+
+
+Tài liệu tương tác API và web giao diện người dùng. Là một framework được dựa trên OpenAPI do đó có nhiều tùy chọn giao diện cho tài liệu API, 2 giao diện bên dưới là mặc định.
+
+* <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank"><strong>Swagger UI</strong></a>, với giao diện khám phá, gọi và kiểm thử API trực tiếp từ trình duyệt.
+
+![Swagger UI interaction](https://fastapi.tiangolo.com/img/index/index-03-swagger-02.png)
+
+* Thay thế với tài liệu API với <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank"><strong>ReDoc</strong></a>.
+
+![ReDoc](https://fastapi.tiangolo.com/img/index/index-06-redoc-02.png)
+
+### Chỉ cần phiên bản Python hiện đại
+
+Tất cả được dựa trên khai báo kiểu dữ liệu chuẩn của **Python 3.6** (cảm ơn Pydantic). Bạn không cần học cú pháp mới, chỉ cần biết chuẩn Python hiện đại.
+
+Nếu bạn cần 2 phút để làm mới lại cách sử dụng các kiểu dữ liệu mới của Python (thậm chí nếu bạn không sử dụng FastAPI), xem hướng dẫn ngắn: [Kiểu dữ liệu Python](python-types.md){.internal-link target=_blank}.
+
+Bạn viết chuẩn Python với kiểu dữ liệu như sau:
+
+```Python
+from datetime import date
+
+from pydantic import BaseModel
+
+# Declare a variable as a str
+# and get editor support inside the function
+def main(user_id: str):
+    return user_id
+
+
+# A Pydantic model
+class User(BaseModel):
+    id: int
+    name: str
+    joined: date
+```
+
+Sau đó có thể được sử dụng:
+
+```Python
+my_user: User = User(id=3, name="John Doe", joined="2018-07-19")
+
+second_user_data = {
+    "id": 4,
+    "name": "Mary",
+    "joined": "2018-11-30",
+}
+
+my_second_user: User = User(**second_user_data)
+```
+
+!!! info
+    `**second_user_data` nghĩa là:
+
+    Truyền các khóa và giá trị của dict `second_user_data` trực tiếp như các tham số kiểu key-value, tương đương với: `User(id=4, name="Mary", joined="2018-11-30")`
+
+### Được hỗ trợ từ các trình soạn thảo
+
+
+Toàn bộ framework được thiết kế để sử dụng dễ dàng và trực quan, toàn bộ quyết định đã được kiểm thử trên nhiều trình soạn thảo thậm chí trước khi bắt đầu quá trình phát triển, để chắc chắn trải nghiệm phát triển là tốt nhất.
+
+Trong lần khảo sát cuối cùng dành cho các lập trình viên Python, đã rõ ràng <a href="https://www.jetbrains.com/research/python-developers-survey-2017/#tools-and-features" class="external-link" target="_blank">rằng đa số các lập trình viên sử dụng tính năng "autocompletion"</a>.
+
+Toàn bộ framework "FastAPI" phải đảm bảo rằng: autocompletion hoạt động ở mọi nơi. Bạn sẽ hiếm khi cần quay lại để đọc tài liệu.
+
+Đây là các trình soạn thảo có thể giúp bạn:
+
+* trong <a href="https://code.visualstudio.com/" class="external-link" target="_blank">Visual Studio Code</a>:
+
+![editor support](https://fastapi.tiangolo.com/img/vscode-completion.png)
+
+* trong <a href="https://www.jetbrains.com/pycharm/" class="external-link" target="_blank">PyCharm</a>:
+
+![editor support](https://fastapi.tiangolo.com/img/pycharm-completion.png)
+
+Bạn sẽ có được auto-completion trong code, thậm chí trước đó là không thể. Như trong ví dụ, khóa `price` bên trong một JSON (đó có thể được lồng nhau) đến từ một request.
+
+Không còn nhập sai tên khóa, quay đi quay lại giữa các tài liệu hoặc cuộn lên cuộn xuống để tìm xem cuối cùng bạn đã sử dụng `username` hay `user_name`.
+
+### Ngắn gọn
+
+FastAPI có các giá trị mặc định hợp lý cho mọi thứ, với các cấu hình tùy chọn ở mọi nơi. Tất cả các tham số có thể được tinh chỉnh để thực hiện những gì bạn cần và để định nghĩa API bạn cần.
+
+Nhưng mặc định, tất cả **đều hoạt động**.
+
+### Validation
+
+* Validation cho đa số (hoặc tất cả?) **các kiểu dữ liệu** Python, bao gồm:
+    * JSON objects (`dict`).
+    * Mảng JSON (`list`) định nghĩa kiểu dữ liệu từng phần tử.
+    * Xâu (`str`), định nghĩa độ dài lớn nhất, nhỏ nhất.
+    * Số (`int`, `float`) với các giá trị lớn nhất, nhỏ nhất, etc.
+
+* Validation cho nhiều kiểu dữ liệu bên ngoài như:
+    * URL.
+    * Email.
+    * UUID.
+    * ...và nhiều cái khác.
+
+Tất cả validation được xử lí bằng những thiết lập tốt và mạnh mẽ của **Pydantic**.
+
+### Bảo mật và xác thực
+
+Bảo mật và xác thực đã tích hợp mà không làm tổn hại tới cơ sở dữ liệu hoặc data models.
+
+Tất cả cơ chế bảo mật định nghĩa trong OpenAPI, bao gồm:
+
+* HTTP Basic.
+* **OAuth2** (với **JWT tokens**). Xem hướng dẫn [OAuth2 with JWT](tutorial/security/oauth2-jwt.md){.internal-link target=_blank}.
+* API keys in:
+    * Headers.
+    * Các tham số trong query string.
+    * Cookies, etc.
+
+Cộng với tất cả các tính năng bảo mật từ Starlette (bao gồm **session cookies**).
+
+Tất cả được xây dựng dưới dạng các công cụ và thành phần có thể tái sử dụng, dễ dàng tích hợp với hệ thống, kho lưu trữ dữ liệu, cơ sở dữ liệu quan hệ và NoSQL của bạn,...
+
+### Dependency Injection
+
+FastAPI bao gồm một hệ thống <abbr title='cũng biết đến như là "components", "resources", "services", "providers"'><strong>Dependency Injection</strong></abbr> vô cùng dễ sử dụng nhưng vô cùng mạnh mẽ.
+
+* Thậm chí, các dependency có thể có các dependency khác, tạo thành một phân cấp hoặc **"một đồ thị" của các dependency**.
+* Tất cả **được xử lí tự động** bởi framework.
+* Tất cả các dependency có thể yêu cầu dữ liệu từ request và **tăng cường các ràng buộc từ đường dẫn** và tự động tài liệu hóa.
+* **Tự động hóa validation**, thậm chí với các tham số *đường dẫn* định nghĩa trong các dependency.
+* Hỗ trợ hệ thống xác thực người dùng phức tạp, **các kết nối cơ sở dữ liệu**,...
+* **Không làm tổn hại** cơ sở dữ liệu, frontends,... Nhưng dễ dàng tích hợp với tất cả chúng.
+
+### Không giới hạn "plug-ins"
+
+Hoặc theo một cách nào khác, không cần chúng, import và sử dụng code bạn cần.
+
+Bất kì tích hợp nào được thiết kế để sử dụng đơn giản (với các dependency), đến nỗi bạn có thể tạo một "plug-in" cho ứng dụng của mình trong 2 dòng code bằng cách sử dụng cùng một cấu trúc và cú pháp được sử dụng cho *path operations* của bạn.
+
+### Đã được kiểm thử
+
+* 100% <abbr title=" Lượng code đã được kiểm thử tự động">test coverage</abbr>.
+* 100% <abbr title="Python type annotations, với điều này trình soạn thảo của bạn và các công cụ bên ngoài có thể hỗ trợ bạn tốt hơn">type annotated</abbr> code base.
+* Được sử dụng cho các ứng dụng sản phẩm.
+
+## Tính năng của Starlette
+
+`FastAPI` is thực sự là một sub-class của `Starlette`. Do đó, nếu bạn đã biết hoặc đã sử dụng Starlette, đa số các chức năng sẽ làm việc giống như vậy.
+
+Với **FastAPI**, bạn có được tất cả những tính năng của **Starlette**:
+
+* Hiệu năng thực sự ấn tượng. Nó là <a href="https://github.com/encode/starlette#performance" class="external-link" target="_blank">một trong nhưng framework Python nhanh nhất, khi so sánh với **NodeJS** và **Go**</a>.
+* Hỗ trợ **WebSocket**.
+* In-process background tasks.
+* Startup and shutdown events.
+* Client cho kiểm thử xây dựng trên HTTPX.
+* **CORS**, GZip, Static Files, Streaming responses.
+* Hỗ trợ **Session and Cookie**.
+* 100% test coverage.
+* 100% type annotated codebase.
+
+## Tính năng của Pydantic
+
+**FastAPI** tương thích đầy đủ với (và dựa trên) <a href="https://pydantic-docs.helpmanual.io" class="external-link" target="_blank"><strong>Pydantic</strong></a>. Do đó, bất kì code Pydantic nào bạn thêm vào cũng sẽ hoạt động.
+
+Bao gồm các thư viện bên ngoài cũng dựa trên Pydantic, như <abbr title="Object-Relational Mapper">ORM</abbr>s, <abbr title="Object-Document Mapper">ODM</abbr>s cho cơ sở dữ liệu.
+
+Nó cũng có nghĩa là trong nhiều trường hợp, bạn có thể truyền cùng object bạn có từ một request **trực tiếp cho cơ sở dữ liệu**, vì mọi thứ được validate tự động.
+
+Điều tương tự áp dụng cho các cách khác nhau, trong nhiều trường hợp, bạn có thể chỉ truyền object từ cơ sở dữ liêu **trực tiếp tới client**.
+
+Với **FastAPI**, bạn có tất cả những tính năng của **Pydantic** (FastAPI dựa trên Pydantic cho tất cả những xử lí về dữ liệu):
+
+* **Không gây rối não**:
+    * Không cần học ngôn ngữ mô tả cấu trúc mới.
+    * Nếu bạn biết kiểu dữ liệu Python, bạn biết cách sử dụng Pydantic.
+* Sử dụng tốt với **<abbr title="Môi trường phát triển tích hợp, tương tự như một trình soạn thảo code">IDE</abbr>/<abbr title="Một chương trình kiểm tra code lỗi">linter</abbr>/não của bạn**:
+
+    * Bởi vì các cấu trúc dữ liệu của Pydantic chỉ là các instances của class bạn định nghĩa; auto-completion, linting, mypy và trực giác của bạn nên làm việc riêng biệt với những dữ liệu mà bạn đã validate.
+* Validate **các cấu trúc phức tạp**:
+    * Sử dụng các models Pydantic phân tầng, `List` và `Dict` của Python `typing`,...
+    * Và các validators cho phép các cấu trúc dữ liệu phức tạp trở nên rõ ràng và dễ dàng để định nghĩa, kiểm tra và tài liệu hóa thành JSON Schema.
+    * Bạn có thể có các object **JSON lồng nhau** và tất cả chúng đã validate và annotated.
+* **Có khả năng mở rộng**:
+    * Pydantic cho phép bạn tùy chỉnh kiểu dữ liệu bằng việc định nghĩa hoặc bạn có thể mở rộng validation với các decorator trong model.
+* 100% test coverage.
diff --git a/docs/vi/docs/index.md b/docs/vi/docs/index.md
new file mode 100644
index 000000000..ba5d68161
--- /dev/null
+++ b/docs/vi/docs/index.md
@@ -0,0 +1,476 @@
+
+{!../../../docs/missing-translation.md!}
+
+
+<p align="center">
+  <a href="https://fastapi.tiangolo.com"><img src="https://fastapi.tiangolo.com/img/logo-margin/logo-teal.png" alt="FastAPI"></a>
+</p>
+<p align="center">
+    <em>FastAPI framework, hiệu năng cao, dễ học, dễ code, sẵn sàng để tạo ra sản phẩm</em>
+</p>
+<p align="center">
+<a href="https://github.com/tiangolo/fastapi/actions?query=workflow%3ATest+event%3Apush+branch%3Amaster" target="_blank">
+    <img src="https://github.com/tiangolo/fastapi/workflows/Test/badge.svg?event=push&branch=master" alt="Test">
+</a>
+<a href="https://coverage-badge.samuelcolvin.workers.dev/redirect/tiangolo/fastapi" target="_blank">
+    <img src="https://coverage-badge.samuelcolvin.workers.dev/tiangolo/fastapi.svg" alt="Coverage">
+</a>
+<a href="https://pypi.org/project/fastapi" target="_blank">
+    <img src="https://img.shields.io/pypi/v/fastapi?color=%2334D058&label=pypi%20package" alt="Package version">
+</a>
+<a href="https://pypi.org/project/fastapi" target="_blank">
+    <img src="https://img.shields.io/pypi/pyversions/fastapi.svg?color=%2334D058" alt="Supported Python versions">
+</a>
+</p>
+
+---
+
+**Tài liệu**: <a href="https://fastapi.tiangolo.com" target="_blank">https://fastapi.tiangolo.com</a>
+
+**Mã nguồn**: <a href="https://github.com/tiangolo/fastapi" target="_blank">https://github.com/tiangolo/fastapi</a>
+
+---
+
+FastAPI là một web framework hiện đại, hiệu năng cao để xây dựng web APIs với Python 3.7+ dựa trên tiêu chuẩn Python type hints.
+
+Những tính năng như:
+
+* **Nhanh**: Hiệu năng rất cao khi so sánh với **NodeJS** và **Go** (cảm ơn Starlette và Pydantic). [Một trong những Python framework nhanh nhất](#performance).
+* **Code nhanh**: Tăng tốc độ phát triển tính năng từ 200% tới 300%. *
+* **Ít lỗi hơn**: Giảm khoảng 40% những lỗi phát sinh bởi con người (nhà phát triển). *
+* **Trực giác tốt hơn**: Được các trình soạn thảo hỗ tuyệt vời. <abbr title="như auto-complete, autocompletion, IntelliSense">Completion</abbr> mọi nơi. Ít thời gian gỡ lỗi.
+* **Dễ dàng**: Được thiết kế để dễ dàng học và sử dụng. Ít thời gian đọc tài liệu.
+* **Ngắn**: Tối thiểu code bị trùng lặp. Nhiều tính năng được tích hợp khi định nghĩa tham số. Ít lỗi hơn.
+* **Tăng tốc**: Có được sản phẩm cùng với tài liệu (được tự động tạo) có thể tương tác.
+* **Được dựa trên các tiêu chuẩn**: Dựa trên (và hoàn toàn tương thích với) các tiêu chuẩn mở cho APIs : <a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank">OpenAPI</a> (trước đó được biết đến là Swagger) và <a href="https://json-schema.org/" class="external-link" target="_blank">JSON Schema</a>.
+
+<small>* ước tính được dựa trên những kiểm chứng trong nhóm phát triển nội bộ, xây dựng các ứng dụng sản phẩm.</small>
+
+## Nhà tài trợ
+
+<!-- sponsors -->
+
+{% if sponsors %}
+{% for sponsor in sponsors.gold -%}
+<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a>
+{% endfor -%}
+{%- for sponsor in sponsors.silver -%}
+<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a>
+{% endfor %}
+{% endif %}
+
+<!-- /sponsors -->
+
+<a href="https://fastapi.tiangolo.com/fastapi-people/#sponsors" class="external-link" target="_blank">Những nhà tài trợ khác</a>
+
+## Ý kiến đánh giá
+
+"_[...] Tôi đang sử dụng **FastAPI** vô cùng nhiều vào những ngày này. [...] Tôi thực sự đang lên kế hoạch sử dụng nó cho tất cả các nhóm **dịch vụ ML tại Microsoft**. Một vài trong số đó đang tích hợp vào sản phẩm lõi của **Window** và một vài sản phẩm cho **Office**._"
+
+<div style="text-align: right; margin-right: 10%;">Kabir Khan - <strong>Microsoft</strong> <a href="https://github.com/tiangolo/fastapi/pull/26" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Chúng tôi tích hợp thư viện **FastAPI** để sinh ra một **REST** server, nó có thể được truy vấn để thu được những **dự đoán**._ [bởi Ludwid] "
+
+<div style="text-align: right; margin-right: 10%;">Piero Molino, Yaroslav Dudin, và Sai Sumanth Miryala - <strong>Uber</strong> <a href="https://eng.uber.com/ludwig-v0-2/" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_**Netflix** vui mừng thông báo việc phát hành framework mã nguồn mở của chúng tôi cho *quản lí khủng hoảng* tập trung: **Dispatch**! [xây dựng với **FastAPI**]_"
+
+<div style="text-align: right; margin-right: 10%;">Kevin Glisson, Marc Vilanova, Forest Monsen - <strong>Netflix</strong> <a href="https://netflixtechblog.com/introducing-dispatch-da4b8a2a8072" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Tôi vô cùng hào hứng về **FastAPI**. Nó rất thú vị_"
+
+<div style="text-align: right; margin-right: 10%;">Brian Okken - <strong><a href="https://pythonbytes.fm/episodes/show/123/time-to-right-the-py-wrongs?time_in_sec=855" target="_blank">Python Bytes</a> podcast host</strong> <a href="https://twitter.com/brianokken/status/1112220079972728832" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Thành thật, những gì bạn đã xây dựng nhìn siêu chắc chắn và bóng bẩy. Theo nhiều cách, nó là những gì tôi đã muốn Hug trở thành - thật sự truyền cảm hứng để thấy ai đó xây dựng nó._"
+
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - người tạo ra <strong><a href="https://www.hug.rest/" target="_blank">Hug</a></strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Nếu bạn đang tìm kiếm một **framework hiện đại** để xây dựng một REST APIs, thử xem xét **FastAPI** [...] Nó nhanh, dễ dùng và dễ học [...]_"
+
+"_Chúng tôi đã chuyển qua **FastAPI cho **APIs** của chúng tôi [...] Tôi nghĩ bạn sẽ thích nó [...]_"
+
+<div style="text-align: right; margin-right: 10%;">Ines Montani - Matthew Honnibal - <strong><a href="https://explosion.ai" target="_blank">Explosion AI</a> founders - <a href="https://spacy.io" target="_blank">spaCy</a> creators</strong> <a href="https://twitter.com/_inesmontani/status/1144173225322143744" target="_blank"><small>(ref)</small></a> - <a href="https://twitter.com/honnibal/status/1144031421859655680" target="_blank"><small>(ref)</small></a></div>
+<div style="text-align: right; margin-right: 10%;">Ines Montani - Matthew Honnibal - <strong>nhà sáng lập <a href="https://explosion.ai" target="_blank">Explosion AI</a> - người tạo ra <a href="https://spacy.io" target="_blank">spaCy</a></strong> <a href="https://twitter.com/_inesmontani/status/1144173225322143744" target="_blank"><small>(ref)</small></a> - <a href="https://twitter.com/honnibal/status/1144031421859655680" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Nếu ai đó đang tìm cách xây dựng sản phẩm API bằng Python, tôi sẽ đề xuất **FastAPI**. Nó **được thiết kế đẹp đẽ**, **sử dụng đơn giản** và **có khả năng mở rộng cao**, nó đã trở thành một **thành phần quan trọng** trong chiến lược phát triển API của chúng tôi và đang thúc đẩy nhiều dịch vụ và mảng tự động hóa như Kỹ sư TAC ảo của chúng tôi._"
+
+<div style="text-align: right; margin-right: 10%;">Deon Pillsbury - <strong>Cisco</strong> <a href="https://www.linkedin.com/posts/deonpillsbury_cisco-cx-python-activity-6963242628536487936-trAp/" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+## **Typer**, giao diện dòng lệnh của FastAPI
+
+<a href="https://typer.tiangolo.com" target="_blank"><img src="https://typer.tiangolo.com/img/logo-margin/logo-margin-vector.svg" style="width: 20%;"></a>
+
+Nếu bạn đang xây dựng một <abbr title="Giao diện dòng lệnh">CLI</abbr> - ứng dụng được sử dụng trong giao diện dòng lệnh, xem về <a href="https://typer.tiangolo.com/" class="external-link" target="_blank">**Typer**</a>.
+
+**Typer** là một người anh em của FastAPI. Và nó được dự định trở thành **giao diện dòng lệnh cho FastAPI**. ⌨️ 🚀
+
+## Yêu cầu
+
+Python 3.7+
+
+FastAPI đứng trên vai những người khổng lồ:
+
+* <a href="https://www.starlette.io/" class="external-link" target="_blank">Starlette</a> cho phần web.
+* <a href="https://pydantic-docs.helpmanual.io/" class="external-link" target="_blank">Pydantic</a> cho phần data.
+
+## Cài đặt
+
+<div class="termy">
+
+```console
+$ pip install fastapi
+
+---> 100%
+```
+
+</div>
+
+Bạn cũng sẽ cần một ASGI server cho production như <a href="https://www.uvicorn.org" class="external-link" target="_blank">Uvicorn</a> hoặc <a href="https://github.com/pgjones/hypercorn" class="external-link" target="_blank">Hypercorn</a>.
+
+<div class="termy">
+
+```console
+$ pip install "uvicorn[standard]"
+
+---> 100%
+```
+
+</div>
+
+## Ví dụ
+
+### Khởi tạo
+
+* Tạo một tệp tin `main.py` như sau:
+
+```Python
+from typing import Union
+
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+def read_root():
+    return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+def read_item(item_id: int, q: Union[str, None] = None):
+    return {"item_id": item_id, "q": q}
+```
+
+<details markdown="1">
+<summary>Hoặc sử dụng <code>async def</code>...</summary>
+
+Nếu code của bạn sử dụng `async` / `await`, hãy sử dụng `async def`:
+
+```Python hl_lines="9  14"
+from typing import Union
+
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+async def read_root():
+    return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+async def read_item(item_id: int, q: Union[str, None] = None):
+    return {"item_id": item_id, "q": q}
+```
+
+**Lưu ý**:
+
+Nếu bạn không biết, xem phần _"In a hurry?"_ về <a href="https://fastapi.tiangolo.com/async/#in-a-hurry" target="_blank">`async` và `await` trong tài liệu này</a>.
+
+</details>
+
+### Chạy ứng dụng
+
+Chạy server như sau:
+
+<div class="termy">
+
+```console
+$ uvicorn main:app --reload
+
+INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+INFO:     Started reloader process [28720]
+INFO:     Started server process [28722]
+INFO:     Waiting for application startup.
+INFO:     Application startup complete.
+```
+
+</div>
+
+<details markdown="1">
+<summary>Về lệnh <code>uvicorn main:app --reload</code>...</summary>
+
+Lệnh `uvicorn main:app` tham chiếu tới những thành phần sau:
+
+* `main`: tệp tin `main.py` (một Python "module").
+* `app`: object được tạo trong tệp tin `main.py` tại dòng `app = FastAPI()`.
+* `--reload`: chạy lại server sau khi code thay đổi. Chỉ sử dụng trong quá trình phát triển.
+
+</details>
+
+### Kiểm tra
+
+Mở trình duyệt của bạn tại <a href="http://127.0.0.1:8000/items/5?q=somequery" class="external-link" target="_blank">http://127.0.0.1:8000/items/5?q=somequery</a>.
+
+Bạn sẽ thấy một JSON response:
+
+```JSON
+{"item_id": 5, "q": "somequery"}
+```
+
+Bạn đã sẵn sàng để tạo một API như sau:
+
+* Nhận HTTP request với _đường dẫn_ `/` và `/items/{item_id}`.
+* Cả hai _đường dẫn_ sử dụng <em>toán tử</em> `GET` (cũng đươc biết đến là _phương thức_ HTTP).
+* _Đường dẫn_ `/items/{item_id}` có một _tham số đường dẫn_ `item_id`, nó là một tham số kiểu `int`.
+* _Đường dẫn_ `/items/{item_id}`  có một _tham số query string_ `q`, nó là một tham số tùy chọn kiểu `str`.
+
+### Tài liệu tương tác API
+
+Truy cập <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>.
+
+Bạn sẽ thấy tài liệu tương tác API được tạo tự động (cung cấp bởi <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Swagger UI</a>):
+
+![Swagger UI](https://fastapi.tiangolo.com/img/index/index-01-swagger-ui-simple.png)
+
+### Tài liệu API thay thế
+
+Và bây giờ, hãy truy cập tới <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a>.
+
+Bạn sẽ thấy tài liệu được thay thế (cung cấp bởi <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a>):
+
+![ReDoc](https://fastapi.tiangolo.com/img/index/index-02-redoc-simple.png)
+
+## Nâng cấp ví dụ
+
+Bây giờ sửa tệp tin `main.py` để nhận body từ một request `PUT`.
+
+Định nghĩa của body sử dụng kiểu dữ liệu chuẩn của Python, cảm ơn Pydantic.
+
+```Python hl_lines="4  9-12  25-27"
+from typing import Union
+
+from fastapi import FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Item(BaseModel):
+    name: str
+    price: float
+    is_offer: Union[bool, None] = None
+
+
+@app.get("/")
+def read_root():
+    return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+def read_item(item_id: int, q: Union[str, None] = None):
+    return {"item_id": item_id, "q": q}
+
+
+@app.put("/items/{item_id}")
+def update_item(item_id: int, item: Item):
+    return {"item_name": item.name, "item_id": item_id}
+```
+
+Server nên tự động chạy lại (bởi vì bạn đã thêm `--reload` trong lệnh `uvicorn` ở trên).
+
+### Nâng cấp tài liệu API
+
+Bây giờ truy cập tới <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>.
+
+* Tài liệu API sẽ được tự động cập nhật, bao gồm body mới:
+
+![Swagger UI](https://fastapi.tiangolo.com/img/index/index-03-swagger-02.png)
+
+* Click vào nút "Try it out", nó cho phép bạn điền những tham số và tương tác trực tiếp với API:
+
+![Swagger UI interaction](https://fastapi.tiangolo.com/img/index/index-04-swagger-03.png)
+
+* Sau khi click vào nút "Execute", giao diện người dùng sẽ giao tiếp với API của bạn bao gồm: gửi các tham số, lấy kết quả và hiển thị chúng trên màn hình:
+
+![Swagger UI interaction](https://fastapi.tiangolo.com/img/index/index-05-swagger-04.png)
+
+### Nâng cấp tài liệu API thay thế
+
+Và bây giờ truy cập tới <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a>.
+
+* Tài liệu thay thế cũng sẽ phản ánh tham số và body mới:
+
+![ReDoc](https://fastapi.tiangolo.com/img/index/index-06-redoc-02.png)
+
+### Tóm lại
+
+Bạn khai báo **một lần** kiểu dữ liệu của các tham số, body, etc là các tham số của hàm số.
+
+Bạn định nghĩa bằng cách sử dụng các kiểu dữ liệu chuẩn của Python.
+
+Bạn không phải học một cú pháp mới, các phương thức và class của một thư viện cụ thể nào.
+
+Chỉ cần sử dụng các chuẩn của **Python 3.7+**.
+
+Ví dụ, với một tham số kiểu `int`:
+
+```Python
+item_id: int
+```
+
+hoặc với một model `Item` phức tạp hơn:
+
+```Python
+item: Item
+```
+
+...và với định nghĩa đơn giản đó, bạn có được:
+
+* Sự hỗ trợ từ các trình soạn thảo, bao gồm:
+    * Completion.
+    * Kiểm tra kiểu dữ liệu.
+* Kiểm tra kiểu dữ liệu:
+    * Tự động sinh lỗi rõ ràng khi dữ liệu không hợp lệ .
+    * Kiểm tra JSON lồng nhau .
+* <abbr title="cũng được biết tới như: serialization, parsing, marshalling">Chuyển đổi</abbr> dữ liệu đầu vào: tới từ network sang dữ liệu kiểu Python. Đọc từ:
+    * JSON.
+    * Các tham số trong đường dẫn.
+    * Các tham số trong query string.
+    * Cookies.
+    * Headers.
+    * Forms.
+    * Files.
+* <abbr title="cũng được biết tới như: serialization, parsing, marshalling">Chuyển đổi</abbr> dữ liệu đầu ra: chuyển đổi từ kiểu dữ liệu Python sang dữ liệu network (như JSON):
+    * Chuyển đổi kiểu dữ liệu Python (`str`, `int`, `float`, `bool`, `list`,...).
+    * `datetime` objects.
+    * `UUID` objects.
+    * Database models.
+    * ...và nhiều hơn thế.
+* Tự động tạo tài liệu tương tác API, bao gồm 2 giao diện người dùng:
+    * Swagger UI.
+    * ReDoc.
+
+---
+
+Quay trở lại ví dụ trước, **FastAPI** sẽ thực hiện:
+
+* Kiểm tra xem có một `item_id` trong đường dẫn với các request `GET` và `PUT` không?
+* Kiểm tra xem `item_id` có phải là kiểu `int` trong các request `GET` và `PUT` không?
+    * Nếu không, client sẽ thấy một lỗi rõ ràng và hữu ích.
+* Kiểm tra xem nếu có một tham số `q` trong query string (ví dụ như `http://127.0.0.1:8000/items/foo?q=somequery`) cho request `GET`.
+    * Tham số `q` được định nghĩa `= None`, nó là tùy chọn.
+    * Nếu không phải `None`, nó là bắt buộc (như body trong trường hợp của `PUT`).
+* Với request `PUT` tới `/items/{item_id}`, đọc body như JSON:
+    * Kiểm tra xem nó có một thuộc tính bắt buộc kiểu  `str` là `name` không?
+    * Kiểm tra xem nó có một thuộc tính bắt buộc kiểu `float` là `price` không?
+    * Kiểm tra xem nó có một thuộc tính tùy chọn là `is_offer` không? Nếu có, nó phải có kiểu `bool`.
+    * Tất cả những kiểm tra này cũng được áp dụng với các JSON lồng nhau.
+* Chuyển đổi tự động các JSON object đến và JSON object đi.
+* Tài liệu hóa mọi thứ với OpenAPI, tài liệu đó có thể được sử dụng bởi:
+
+    * Các hệ thống tài liệu có thể tương tác.
+    * Hệ thống sinh code tự động, cho nhiều ngôn ngữ lập trình.
+* Cung cấp trực tiếp 2 giao diện web cho tài liệu tương tác
+
+---
+
+Chúng tôi chỉ trình bày những thứ cơ bản bên ngoài, nhưng bạn đã hiểu cách thức hoạt động của nó.
+
+Thử thay đổi dòng này:
+
+```Python
+    return {"item_name": item.name, "item_id": item_id}
+```
+
+...từ:
+
+```Python
+        ... "item_name": item.name ...
+```
+
+...sang:
+
+```Python
+        ... "item_price": item.price ...
+```
+
+...và thấy trình soạn thảo của bạn nhận biết kiểu dữ liệu và gợi ý hoàn thiện các thuộc tính.
+
+![trình soạn thảo hỗ trợ](https://fastapi.tiangolo.com/img/vscode-completion.png)
+
+Ví dụ hoàn chỉnh bao gồm nhiều tính năng hơn, xem <a href="https://fastapi.tiangolo.com/tutorial/">Tutorial - User Guide</a>.
+
+
+**Cảnh báo tiết lỗ**: Tutorial - User Guide:
+
+* Định nghĩa **tham số** từ các nguồn khác nhau như: **headers**, **cookies**, **form fields** và **files**.
+* Cách thiết lập **các ràng buộc cho validation** như `maximum_length` hoặc `regex`.
+* Một hệ thống **<abbr title="cũng được biết đến như components, resources, providers, services, injectables">Dependency Injection</abbr> vô cùng mạnh mẽ và dễ dàng sử dụng.
+* Bảo mật và xác thực, hỗ trợ **OAuth2**(với **JWT tokens**) và **HTTP Basic**.
+* Những kĩ thuật nâng cao hơn (nhưng tương đối dễ) để định nghĩa **JSON models lồng nhau** (cảm ơn Pydantic).
+* Tích hợp **GraphQL** với <a href="https://strawberry.rocks" class="external-link" target="_blank">Strawberry</a> và các thư viện khác.
+* Nhiều tính năng mở rộng (cảm ơn Starlette) như:
+    * **WebSockets**
+    * kiểm thử vô cùng dễ dàng dựa trên HTTPX và `pytest`
+    * **CORS**
+    * **Cookie Sessions**
+    * ...và nhiều hơn thế.
+
+## Hiệu năng
+
+Independent TechEmpower benchmarks cho thấy các ứng dụng **FastAPI** chạy dưới Uvicorn là <a href="https://www.techempower.com/benchmarks/#section=test&runid=7464e520-0dc2-473d-bd34-dbdfd7e85911&hw=ph&test=query&l=zijzen-7" class="external-link" target="_blank">một trong những Python framework nhanh nhất</a>, chỉ đứng sau Starlette và Uvicorn (được sử dụng bên trong FastAPI). (*)
+
+Để hiểu rõ hơn, xem phần <a href="https://fastapi.tiangolo.com/benchmarks/" class="internal-link" target="_blank">Benchmarks</a>.
+
+## Các dependency tùy chọn
+
+Sử dụng bởi Pydantic:
+
+* <a href="https://github.com/esnme/ultrajson" target="_blank"><code>ujson</code></a> - <abbr title="chuyển dổi string từ HTTP request sang dữ liệu Python">"Parse"</abbr> JSON nhanh hơn.
+* <a href="https://github.com/JoshData/python-email-validator" target="_blank"><code>email_validator</code></a> - cho email validation.
+
+Sử dụng Starlette:
+
+* <a href="https://www.python-httpx.org" target="_blank"><code>httpx</code></a> - Bắt buộc nếu bạn muốn sử dụng `TestClient`.
+* <a href="https://jinja.palletsprojects.com" target="_blank"><code>jinja2</code></a> - Bắt buộc nếu bạn muốn sử dụng cấu hình template engine mặc định.
+* <a href="https://andrew-d.github.io/python-multipart/" target="_blank"><code>python-multipart</code></a> - Bắt buộc nếu bạn muốn hỗ trợ <abbr title="converting the string that comes from an HTTP request into Python data">"parsing"</abbr>, form với `request.form()`.
+* <a href="https://pythonhosted.org/itsdangerous/" target="_blank"><code>itsdangerous</code></a> - Bắt buộc để hỗ trợ `SessionMiddleware`.
+* <a href="https://pyyaml.org/wiki/PyYAMLDocumentation" target="_blank"><code>pyyaml</code></a> - Bắt buộc để hỗ trợ `SchemaGenerator` cho Starlette (bạn có thể không cần nó trong FastAPI).
+* <a href="https://github.com/esnme/ultrajson" target="_blank"><code>ujson</code></a> - Bắt buộc nếu bạn muốn sử dụng `UJSONResponse`.
+
+Sử dụng bởi FastAPI / Starlette:
+
+* <a href="https://www.uvicorn.org" target="_blank"><code>uvicorn</code></a> - Server để chạy ứng dụng của bạn.
+* <a href="https://github.com/ijl/orjson" target="_blank"><code>orjson</code></a> - Bắt buộc nếu bạn muốn sử dụng `ORJSONResponse`.
+
+Bạn có thể cài đặt tất cả những dependency trên với `pip install "fastapi[all]"`.
+
+## Giấy phép
+
+Dự án này được cấp phép dưới những điều lệ của giấy phép MIT.
diff --git a/docs/vi/mkdocs.yml b/docs/vi/mkdocs.yml
new file mode 100644
index 000000000..de18856f4
--- /dev/null
+++ b/docs/vi/mkdocs.yml
@@ -0,0 +1 @@
+INHERIT: ../en/mkdocs.yml

From c52c94006650dbd53f6d4bd75ef0a7459ad7e3d8 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 27 Jul 2023 19:04:24 +0000
Subject: [PATCH 023/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ce28cb029..b69b6d594 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Korean translation for `docs/ko/docs/async.md`. PR [#4179](https://github.com/tiangolo/fastapi/pull/4179) by [@NinaHwang](https://github.com/NinaHwang).
 * 🌐 Add Chinese translation for `docs/zh/docs/tutorial/background-tasks.md`. PR [#9812](https://github.com/tiangolo/fastapi/pull/9812) by [@wdh99](https://github.com/wdh99).
 * 🔧 Update sponsors, add Fern. PR [#9956](https://github.com/tiangolo/fastapi/pull/9956) by [@tiangolo](https://github.com/tiangolo).
 * 🌐 Add French translation for `docs/fr/docs/tutorial/query-params-str-validations.md`. PR [#4075](https://github.com/tiangolo/fastapi/pull/4075) by [@Smlep](https://github.com/Smlep).

From 643d8e41c498d7575e0e5947ca5bef99e0f2804e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 27 Jul 2023 19:08:23 +0000
Subject: [PATCH 024/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b69b6d594..537e57fc7 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Vietnamese translation for `docs/vi/docs/features.md` and `docs/vi/docs/index.md`. PR [#3006](https://github.com/tiangolo/fastapi/pull/3006) by [@magiskboy](https://github.com/magiskboy).
 * 🌐 Add Korean translation for `docs/ko/docs/async.md`. PR [#4179](https://github.com/tiangolo/fastapi/pull/4179) by [@NinaHwang](https://github.com/NinaHwang).
 * 🌐 Add Chinese translation for `docs/zh/docs/tutorial/background-tasks.md`. PR [#9812](https://github.com/tiangolo/fastapi/pull/9812) by [@wdh99](https://github.com/wdh99).
 * 🔧 Update sponsors, add Fern. PR [#9956](https://github.com/tiangolo/fastapi/pull/9956) by [@tiangolo](https://github.com/tiangolo).

From 7b3d770d65eeaef9720b5140c18f994d82e0bbbc Mon Sep 17 00:00:00 2001
From: Orest Furda <56111536+ss-o-furda@users.noreply.github.com>
Date: Thu, 27 Jul 2023 22:09:34 +0300
Subject: [PATCH 025/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Ukrainian=20transl?=
 =?UTF-8?q?ation=20for=20`docs/uk/docs/tutorial/body.md`=20(#4574)?=
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>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
 docs/uk/docs/tutorial/body.md | 213 ++++++++++++++++++++++++++++++++++
 1 file changed, 213 insertions(+)
 create mode 100644 docs/uk/docs/tutorial/body.md

diff --git a/docs/uk/docs/tutorial/body.md b/docs/uk/docs/tutorial/body.md
new file mode 100644
index 000000000..e78c5de0e
--- /dev/null
+++ b/docs/uk/docs/tutorial/body.md
@@ -0,0 +1,213 @@
+# Тіло запиту
+
+Коли вам потрібно надіслати дані з клієнта (скажімо, браузера) до вашого API, ви надсилаєте їх як **тіло запиту**.
+
+Тіло **запиту** — це дані, надіслані клієнтом до вашого API. Тіло **відповіді** — це дані, які ваш API надсилає клієнту.
+
+Ваш API майже завжди має надсилати тіло **відповіді**. Але клієнтам не обов’язково потрібно постійно надсилати тіла **запитів**.
+
+Щоб оголосити тіло **запиту**, ви використовуєте <a href="https://pydantic-docs.helpmanual.io/" class="external-link" target="_blank">Pydantic</a> моделі з усією їх потужністю та перевагами.
+
+!!! info
+    Щоб надіслати дані, ви повинні використовувати один із: `POST` (більш поширений), `PUT`, `DELETE` або `PATCH`.
+
+    Надсилання тіла із запитом `GET` має невизначену поведінку в специфікаціях, проте воно підтримується FastAPI лише для дуже складних/екстремальних випадків використання.
+
+    Оскільки це не рекомендується, інтерактивна документація з Swagger UI не відображатиме документацію для тіла запиту під час використання `GET`, і проксі-сервери в середині можуть не підтримувати її.
+
+## Імпортуйте `BaseModel` від Pydantic
+
+Спочатку вам потрібно імпортувати `BaseModel` з `pydantic`:
+
+=== "Python 3.6 і вище"
+
+    ```Python hl_lines="4"
+    {!> ../../../docs_src/body/tutorial001.py!}
+    ```
+
+=== "Python 3.10 і вище"
+
+    ```Python hl_lines="2"
+    {!> ../../../docs_src/body/tutorial001_py310.py!}
+    ```
+
+## Створіть свою модель даних
+
+Потім ви оголошуєте свою модель даних як клас, який успадковується від `BaseModel`.
+
+Використовуйте стандартні типи Python для всіх атрибутів:
+
+=== "Python 3.6 і вище"
+
+    ```Python hl_lines="7-11"
+    {!> ../../../docs_src/body/tutorial001.py!}
+    ```
+
+=== "Python 3.10 і вище"
+
+    ```Python hl_lines="5-9"
+    {!> ../../../docs_src/body/tutorial001_py310.py!}
+    ```
+
+Так само, як і при оголошенні параметрів запиту, коли атрибут моделі має значення за замовчуванням, він не є обов’язковим. В іншому випадку це потрібно. Використовуйте `None`, щоб зробити його необов'язковим.
+
+Наприклад, ця модель вище оголошує JSON "`об'єкт`" (або Python `dict`), як:
+
+```JSON
+{
+    "name": "Foo",
+    "description": "An optional description",
+    "price": 45.2,
+    "tax": 3.5
+}
+```
+
+...оскільки `description` і `tax` є необов'язковими (зі значенням за замовчуванням `None`), цей JSON "`об'єкт`" також буде дійсним:
+
+```JSON
+{
+    "name": "Foo",
+    "price": 45.2
+}
+```
+
+## Оголоси її як параметр
+
+Щоб додати модель даних до вашої *операції шляху*, оголосіть її так само, як ви оголосили параметри шляху та запиту:
+
+=== "Python 3.6 і вище"
+
+    ```Python hl_lines="18"
+    {!> ../../../docs_src/body/tutorial001.py!}
+    ```
+
+=== "Python 3.10 і вище"
+
+    ```Python hl_lines="16"
+    {!> ../../../docs_src/body/tutorial001_py310.py!}
+    ```
+
+...і вкажіть її тип як модель, яку ви створили, `Item`.
+
+## Результати
+
+Лише з цим оголошенням типу Python **FastAPI** буде:
+
+* Читати тіло запиту як JSON.
+* Перетворювати відповідні типи (якщо потрібно).
+* Валідувати дані.
+    * Якщо дані недійсні, він поверне гарну та чітку помилку, вказуючи, де саме і які дані були неправильними.
+* Надавати отримані дані у параметрі `item`.
+    * Оскільки ви оголосили його у функції як тип `Item`, ви також матимете всю підтримку редактора (автозаповнення, тощо) для всіх атрибутів та їх типів.
+* Генерувати <a href="https://json-schema.org" class="external-link" target="_blank">JSON Schema</a> визначення для вашої моделі, ви також можете використовувати їх де завгодно, якщо це має сенс для вашого проекту.
+* Ці схеми будуть частиною згенерованої схеми OpenAPI і використовуватимуться автоматичною документацією інтерфейсу користувача.
+
+## Автоматична документація
+
+Схеми JSON ваших моделей будуть частиною вашої схеми, згенерованої OpenAPI, і будуть показані в інтерактивній API документації:
+
+<img src="/img/tutorial/body/image01.png">
+
+А також використовуватимуться в API документації всередині кожної *операції шляху*, якій вони потрібні:
+
+<img src="/img/tutorial/body/image02.png">
+
+## Підтримка редактора
+
+У вашому редакторі, всередині вашої функції, ви будете отримувати підказки типу та завершення скрізь (це б не сталося, якби ви отримали `dict` замість моделі Pydantic):
+
+<img src="/img/tutorial/body/image03.png">
+
+Ви також отримуєте перевірку помилок на наявність операцій з неправильним типом:
+
+<img src="/img/tutorial/body/image04.png">
+
+Це не випадково, весь каркас був побудований навколо цього дизайну.
+
+І він був ретельно перевірений на етапі проектування, перед будь-яким впровадженням, щоб переконатися, що він працюватиме з усіма редакторами.
+
+Були навіть деякі зміни в самому Pydantic, щоб підтримати це.
+
+Попередні скріншоти були зроблені у <a href="https://code.visualstudio.com" class="external-link" target="_blank">Visual Studio Code</a>.
+
+Але ви отримаєте ту саму підтримку редактора у <a href="https://www.jetbrains.com/pycharm/" class="external-link" target="_blank">PyCharm</a> та більшість інших редакторів Python:
+
+<img src="/img/tutorial/body/image05.png">
+
+!!! tip
+    Якщо ви використовуєте <a href="https://www.jetbrains.com/pycharm/" class="external-link" target="_blank">PyCharm</a> як ваш редактор, ви можете використати <a href="https://github.com/koxudaxi/pydantic-pycharm-plugin/" class="external-link" target="_blank">Pydantic PyCharm Plugin</a>.
+
+    Він покращує підтримку редакторів для моделей Pydantic за допомогою:
+
+    * автозаповнення
+    * перевірки типу
+    * рефакторингу
+    * пошуку
+    * інспекції
+
+## Використовуйте модель
+
+Усередині функції ви можете отримати прямий доступ до всіх атрибутів об’єкта моделі:
+
+=== "Python 3.6 і вище"
+
+    ```Python hl_lines="21"
+    {!> ../../../docs_src/body/tutorial002.py!}
+    ```
+
+=== "Python 3.10 і вище"
+
+    ```Python hl_lines="19"
+    {!> ../../../docs_src/body/tutorial002_py310.py!}
+    ```
+
+## Тіло запиту + параметри шляху
+
+Ви можете одночасно оголошувати параметри шляху та тіло запиту.
+
+**FastAPI** розпізнає, що параметри функції, які відповідають параметрам шляху, мають бути **взяті з шляху**, а параметри функції, які оголошуються як моделі Pydantic, **взяті з тіла запиту**.
+
+=== "Python 3.6 і вище"
+
+    ```Python hl_lines="17-18"
+    {!> ../../../docs_src/body/tutorial003.py!}
+    ```
+
+=== "Python 3.10 і вище"
+
+    ```Python hl_lines="15-16"
+    {!> ../../../docs_src/body/tutorial003_py310.py!}
+    ```
+
+## Тіло запиту + шлях + параметри запиту
+
+Ви також можете оголосити параметри **тіло**, **шлях** і **запит** одночасно.
+
+**FastAPI** розпізнає кожен з них і візьме дані з потрібного місця.
+
+=== "Python 3.6 і вище"
+
+    ```Python hl_lines="18"
+    {!> ../../../docs_src/body/tutorial004.py!}
+    ```
+
+=== "Python 3.10 і вище"
+
+    ```Python hl_lines="16"
+    {!> ../../../docs_src/body/tutorial004_py310.py!}
+    ```
+
+Параметри функції будуть розпізнаватися наступним чином:
+
+* Якщо параметр також оголошено в **шляху**, він використовуватиметься як параметр шляху.
+* Якщо параметр має **сингулярний тип** (наприклад, `int`, `float`, `str`, `bool` тощо), він буде інтерпретуватися як параметр **запиту**.
+* Якщо параметр оголошується як тип **Pydantic моделі**, він інтерпретується як **тіло** запиту.
+
+!!! note
+    FastAPI буде знати, що значення "q" не є обов'язковим через значення за замовчуванням "= None".
+
+    `Optional` у `Optional[str]` не використовується FastAPI, але дозволить вашому редактору надати вам кращу підтримку та виявляти помилки.
+
+## Без Pydantic
+
+Якщо ви не хочете використовувати моделі Pydantic, ви також можете використовувати параметри **Body**. Перегляньте документацію для [Тіло – Кілька параметрів: сингулярні значення в тілі](body-multiple-params.md#singular-values-in-body){.internal-link target=_blank}.

From bec5530ac849f9c52d35d5282628333a278b6a26 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 27 Jul 2023 19:14:48 +0000
Subject: [PATCH 026/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 537e57fc7..42d240f28 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/body.md`. PR [#4574](https://github.com/tiangolo/fastapi/pull/4574) by [@ss-o-furda](https://github.com/ss-o-furda).
 * 🌐 Add Vietnamese translation for `docs/vi/docs/features.md` and `docs/vi/docs/index.md`. PR [#3006](https://github.com/tiangolo/fastapi/pull/3006) by [@magiskboy](https://github.com/magiskboy).
 * 🌐 Add Korean translation for `docs/ko/docs/async.md`. PR [#4179](https://github.com/tiangolo/fastapi/pull/4179) by [@NinaHwang](https://github.com/NinaHwang).
 * 🌐 Add Chinese translation for `docs/zh/docs/tutorial/background-tasks.md`. PR [#9812](https://github.com/tiangolo/fastapi/pull/9812) by [@wdh99](https://github.com/wdh99).

From effa578b8df27b7d4afa627a4508413811fcf72f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 27 Jul 2023 21:15:16 +0200
Subject: [PATCH 027/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 42d240f28..7211cc3fc 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,11 +2,20 @@
 
 ## Latest Changes
 
+### Fixes
+
+* 🐛 Replace `MultHostUrl` to `AnyUrl` for compatibility with older versions of Pydantic v1. PR [#9852](https://github.com/tiangolo/fastapi/pull/9852) by [@Kludex](https://github.com/Kludex).
+
+### Docs
+
+* 📝 Update links for self-hosted Swagger UI, point to v5, for OpenAPI 31.0. PR [#9834](https://github.com/tiangolo/fastapi/pull/9834) by [@tiangolo](https://github.com/tiangolo).
+
+### Translations
+
 * 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/body.md`. PR [#4574](https://github.com/tiangolo/fastapi/pull/4574) by [@ss-o-furda](https://github.com/ss-o-furda).
 * 🌐 Add Vietnamese translation for `docs/vi/docs/features.md` and `docs/vi/docs/index.md`. PR [#3006](https://github.com/tiangolo/fastapi/pull/3006) by [@magiskboy](https://github.com/magiskboy).
 * 🌐 Add Korean translation for `docs/ko/docs/async.md`. PR [#4179](https://github.com/tiangolo/fastapi/pull/4179) by [@NinaHwang](https://github.com/NinaHwang).
 * 🌐 Add Chinese translation for `docs/zh/docs/tutorial/background-tasks.md`. PR [#9812](https://github.com/tiangolo/fastapi/pull/9812) by [@wdh99](https://github.com/wdh99).
-* 🔧 Update sponsors, add Fern. PR [#9956](https://github.com/tiangolo/fastapi/pull/9956) by [@tiangolo](https://github.com/tiangolo).
 * 🌐 Add French translation for `docs/fr/docs/tutorial/query-params-str-validations.md`. PR [#4075](https://github.com/tiangolo/fastapi/pull/4075) by [@Smlep](https://github.com/Smlep).
 * 🌐 Add French translation for `docs/fr/docs/tutorial/index.md`. PR [#2234](https://github.com/tiangolo/fastapi/pull/2234) by [@JulianMaurin](https://github.com/JulianMaurin).
 * 🌐 Add French translation for `docs/fr/docs/contributing.md`. PR [#2132](https://github.com/tiangolo/fastapi/pull/2132) by [@JulianMaurin](https://github.com/JulianMaurin).
@@ -14,12 +23,14 @@
 * 🌐 Update Chinese translations with new source files. PR [#9738](https://github.com/tiangolo/fastapi/pull/9738) by [@mahone3297](https://github.com/mahone3297).
 * 🌐 Add Russian translation for `docs/ru/docs/tutorial/request-forms.md`. PR [#9841](https://github.com/tiangolo/fastapi/pull/9841) by [@dedkot01](https://github.com/dedkot01).
 * 🌐 Update Chinese translation for `docs/zh/docs/tutorial/handling-errors.md`. PR [#9485](https://github.com/tiangolo/fastapi/pull/9485) by [@Creat55](https://github.com/Creat55).
-* 🐛 Replace `MultHostUrl` to `AnyUrl` for compatibility with older versions of Pydantic v1. PR [#9852](https://github.com/tiangolo/fastapi/pull/9852) by [@Kludex](https://github.com/Kludex).
+
+### Internal
+
+* 🔧 Update sponsors, add Fern. PR [#9956](https://github.com/tiangolo/fastapi/pull/9956) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Update FastAPI People token. PR [#9844](https://github.com/tiangolo/fastapi/pull/9844) by [@tiangolo](https://github.com/tiangolo).
 * 👥 Update FastAPI People. PR [#9775](https://github.com/tiangolo/fastapi/pull/9775) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Update MkDocs Material token. PR [#9843](https://github.com/tiangolo/fastapi/pull/9843) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Update token for latest changes. PR [#9842](https://github.com/tiangolo/fastapi/pull/9842) by [@tiangolo](https://github.com/tiangolo).
-* 📝 Update links for self-hosted Swagger UI, point to v5, for OpenAPI 31.0. PR [#9834](https://github.com/tiangolo/fastapi/pull/9834) by [@tiangolo](https://github.com/tiangolo).
 
 ## 0.100.0
 

From 8d2723664801c32e6174cd87812fb92e850cfa4b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 27 Jul 2023 21:16:01 +0200
Subject: [PATCH 028/317] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.10?=
 =?UTF-8?q?0.1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 3 +++
 fastapi/__init__.py           | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 7211cc3fc..b56941ec7 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,9 @@
 
 ## Latest Changes
 
+
+## 0.100.1
+
 ### Fixes
 
 * 🐛 Replace `MultHostUrl` to `AnyUrl` for compatibility with older versions of Pydantic v1. PR [#9852](https://github.com/tiangolo/fastapi/pull/9852) by [@Kludex](https://github.com/Kludex).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index e9c3abe01..7dfeca0d4 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.100.0"
+__version__ = "0.100.1"
 
 from starlette import status as status
 

From 076bdea6716a5fbfc84d2227066dea6bd91ffb94 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 28 Jul 2023 14:15:29 +0200
Subject: [PATCH 029/317] =?UTF-8?q?=F0=9F=8C=90=20Remove=20Vietnamese=20no?=
 =?UTF-8?q?te=20about=20missing=20translation=20(#9957)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/mkdocs.yml    | 6 ++++++
 docs/uk/mkdocs.yml    | 1 +
 docs/vi/docs/index.md | 4 ----
 3 files changed, 7 insertions(+), 4 deletions(-)
 create mode 100644 docs/uk/mkdocs.yml

diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index 030bbe5d3..a18613185 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -59,6 +59,8 @@ nav:
   - pt: /pt/
   - ru: /ru/
   - tr: /tr/
+  - uk: /uk/
+  - vi: /vi/
   - zh: /zh/
 - features.md
 - fastapi-people.md
@@ -236,6 +238,10 @@ extra:
     name: ru - русский язык
   - link: /tr/
     name: tr - Türkçe
+  - link: /uk/
+    name: uk
+  - link: /vi/
+    name: vi
   - link: /zh/
     name: zh - 汉语
 extra_css:
diff --git a/docs/uk/mkdocs.yml b/docs/uk/mkdocs.yml
new file mode 100644
index 000000000..de18856f4
--- /dev/null
+++ b/docs/uk/mkdocs.yml
@@ -0,0 +1 @@
+INHERIT: ../en/mkdocs.yml
diff --git a/docs/vi/docs/index.md b/docs/vi/docs/index.md
index ba5d68161..0e773a011 100644
--- a/docs/vi/docs/index.md
+++ b/docs/vi/docs/index.md
@@ -1,7 +1,3 @@
-
-{!../../../docs/missing-translation.md!}
-
-
 <p align="center">
   <a href="https://fastapi.tiangolo.com"><img src="https://fastapi.tiangolo.com/img/logo-margin/logo-teal.png" alt="FastAPI"></a>
 </p>

From cd6d75e451cd998cb511c20a72055110035b63ed Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 28 Jul 2023 12:16:16 +0000
Subject: [PATCH 030/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b56941ec7..4addb83cc 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Remove Vietnamese note about missing translation. PR [#9957](https://github.com/tiangolo/fastapi/pull/9957) by [@tiangolo](https://github.com/tiangolo).
 
 ## 0.100.1
 

From a0b987224aa0f80689568b3d38e211b23a7d7e72 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Mon, 31 Jul 2023 21:54:07 +0200
Subject: [PATCH 031/317] =?UTF-8?q?=F0=9F=91=B7=20Update=20CI=20debug=20mo?=
 =?UTF-8?q?de=20with=20Tmate=20(#9977)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/workflows/latest-changes.yml      |  6 +++---
 .github/workflows/notify-translations.yml | 11 ++++++++++-
 .github/workflows/people.yml              |  4 ++--
 3 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/latest-changes.yml b/.github/workflows/latest-changes.yml
index 1f7ac7b28..0461f3dd3 100644
--- a/.github/workflows/latest-changes.yml
+++ b/.github/workflows/latest-changes.yml
@@ -14,7 +14,7 @@ on:
       debug_enabled:
         description: 'Run the build with tmate debugging enabled (https://github.com/marketplace/actions/debugging-with-tmate)'
         required: false
-        default: false
+        default: 'false'
 
 jobs:
   latest-changes:
@@ -22,12 +22,12 @@ jobs:
     steps:
       - uses: actions/checkout@v3
         with:
-          # To allow latest-changes to commit to master
+          # To allow latest-changes to commit to the main branch
           token: ${{ secrets.FASTAPI_LATEST_CHANGES }}
       # Allow debugging with tmate
       - name: Setup tmate session
         uses: mxschmitt/action-tmate@v3
-        if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.debug_enabled }}
+        if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.debug_enabled == 'true' }}
         with:
           limit-access-to-actor: true
       - uses: docker://tiangolo/latest-changes:0.0.3
diff --git a/.github/workflows/notify-translations.yml b/.github/workflows/notify-translations.yml
index 0926486e9..cd7affbc3 100644
--- a/.github/workflows/notify-translations.yml
+++ b/.github/workflows/notify-translations.yml
@@ -5,6 +5,15 @@ on:
     types:
       - labeled
       - closed
+  workflow_dispatch:
+    inputs:
+      number:
+        description: PR number
+        required: true
+      debug_enabled:
+        description: 'Run the build with tmate debugging enabled (https://github.com/marketplace/actions/debugging-with-tmate)'
+        required: false
+        default: 'false'
 
 jobs:
   notify-translations:
@@ -14,7 +23,7 @@ jobs:
       # Allow debugging with tmate
       - name: Setup tmate session
         uses: mxschmitt/action-tmate@v3
-        if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.debug_enabled }}
+        if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.debug_enabled == 'true' }}
         with:
           limit-access-to-actor: true
       - uses: ./.github/actions/notify-translations
diff --git a/.github/workflows/people.yml b/.github/workflows/people.yml
index dac526a6c..aa7f34464 100644
--- a/.github/workflows/people.yml
+++ b/.github/workflows/people.yml
@@ -8,7 +8,7 @@ on:
       debug_enabled:
         description: 'Run the build with tmate debugging enabled (https://github.com/marketplace/actions/debugging-with-tmate)'
         required: false
-        default: false
+        default: 'false'
 
 jobs:
   fastapi-people:
@@ -22,7 +22,7 @@ jobs:
       # Allow debugging with tmate
       - name: Setup tmate session
         uses: mxschmitt/action-tmate@v3
-        if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.debug_enabled }}
+        if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.debug_enabled == 'true' }}
         with:
           limit-access-to-actor: true
       - uses: ./.github/actions/people

From d38e86ef203f5a1c710452737b32ad63466f23d7 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 31 Jul 2023 19:54:46 +0000
Subject: [PATCH 032/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 4addb83cc..14ce41374 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 👷 Update CI debug mode with Tmate. PR [#9977](https://github.com/tiangolo/fastapi/pull/9977) by [@tiangolo](https://github.com/tiangolo).
 * 🌐 Remove Vietnamese note about missing translation. PR [#9957](https://github.com/tiangolo/fastapi/pull/9957) by [@tiangolo](https://github.com/tiangolo).
 
 ## 0.100.1

From 1da0a7afbd53c66eefddc2455501159bf50f55ef Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Mon, 31 Jul 2023 23:49:19 +0200
Subject: [PATCH 033/317] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsor=20Fern?=
 =?UTF-8?q?=20(#9979)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                                 | 2 +-
 docs/en/data/sponsors.yml                 | 2 +-
 docs/en/docs/advanced/generate-clients.md | 5 +++++
 docs/en/docs/alternatives.md              | 2 ++
 docs/en/docs/img/sponsors/fern-banner.svg | 1 +
 docs/en/docs/img/sponsors/fern.svg        | 1 +
 docs/en/overrides/main.html               | 2 +-
 7 files changed, 12 insertions(+), 3 deletions(-)
 create mode 100644 docs/en/docs/img/sponsors/fern-banner.svg
 create mode 100644 docs/en/docs/img/sponsors/fern.svg

diff --git a/README.md b/README.md
index f0e76c4b6..50f80ded6 100644
--- a/README.md
+++ b/README.md
@@ -48,7 +48,7 @@ The key features are:
 
 <a href="https://cryptapi.io/" target="_blank" title="CryptAPI: Your easy to use, secure and privacy oriented payment gateway."><img src="https://fastapi.tiangolo.com/img/sponsors/cryptapi.svg"></a>
 <a href="https://platform.sh/try-it-now/?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023" target="_blank" title="Build, run and scale your apps on a modern, reliable, and secure PaaS."><img src="https://fastapi.tiangolo.com/img/sponsors/platform-sh.png"></a>
-<a href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=main-badge" target="_blank" title="Fern | SDKs and API docs"><img src="https://fastapi.tiangolo.com/img/sponsors/fern.png"></a>
+<a href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=main-badge" target="_blank" title="Fern | SDKs and API docs"><img src="https://fastapi.tiangolo.com/img/sponsors/fern.svg"></a>
 <a href="https://www.deta.sh/?ref=fastapi" target="_blank" title="The launchpad for all your (team's) ideas"><img src="https://fastapi.tiangolo.com/img/sponsors/deta.svg"></a>
 <a href="https://training.talkpython.fm/fastapi-courses" target="_blank" title="FastAPI video courses on demand from people you trust"><img src="https://fastapi.tiangolo.com/img/sponsors/talkpython.png"></a>
 <a href="https://testdriven.io/courses/tdd-fastapi/" target="_blank" title="Learn to build high-quality web apps with best practices"><img src="https://fastapi.tiangolo.com/img/sponsors/testdriven.svg"></a>
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index 33d57c873..53cdb9bad 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -7,7 +7,7 @@ gold:
     img: https://fastapi.tiangolo.com/img/sponsors/platform-sh.png
   - url: https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=main-badge
     title: Fern | SDKs and API docs
-    img: https://fastapi.tiangolo.com/img/sponsors/fern.png
+    img: https://fastapi.tiangolo.com/img/sponsors/fern.svg
 silver:
   - url: https://www.deta.sh/?ref=fastapi
     title: The launchpad for all your (team's) ideas
diff --git a/docs/en/docs/advanced/generate-clients.md b/docs/en/docs/advanced/generate-clients.md
index f62c0b57c..3fed48b0b 100644
--- a/docs/en/docs/advanced/generate-clients.md
+++ b/docs/en/docs/advanced/generate-clients.md
@@ -12,6 +12,11 @@ A common tool is <a href="https://openapi-generator.tech/" class="external-link"
 
 If you are building a **frontend**, a very interesting alternative is <a href="https://github.com/ferdikoomen/openapi-typescript-codegen" class="external-link" target="_blank">openapi-typescript-codegen</a>.
 
+Another option you could consider for several languages is <a href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=docs-generate-clients" class="external-link" target="_blank">Fern</a>.
+
+!!! info
+    <a href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=docs-generate-clients" class="external-link" target="_blank">Fern</a> is also a FastAPI sponsor. 😎🎉
+
 ## Generate a TypeScript Frontend Client
 
 Let's start with a simple FastAPI application:
diff --git a/docs/en/docs/alternatives.md b/docs/en/docs/alternatives.md
index 0f074ccf3..a777ddb98 100644
--- a/docs/en/docs/alternatives.md
+++ b/docs/en/docs/alternatives.md
@@ -119,6 +119,8 @@ That's why when talking about version 2.0 it's common to say "Swagger", and for
 
     These two were chosen for being fairly popular and stable, but doing a quick search, you could find dozens of additional alternative user interfaces for OpenAPI (that you can use with **FastAPI**).
 
+    For example, you could try <a href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=docs-alternatives" class="external-link" target="_blank">Fern</a> which is also a FastAPI sponsor. 😎🎉
+
 ### Flask REST frameworks
 
 There are several Flask REST frameworks, but after investing the time and work into investigating them, I found that many are discontinued or abandoned, with several standing issues that made them unfit.
diff --git a/docs/en/docs/img/sponsors/fern-banner.svg b/docs/en/docs/img/sponsors/fern-banner.svg
new file mode 100644
index 000000000..bb3a389f3
--- /dev/null
+++ b/docs/en/docs/img/sponsors/fern-banner.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="300" zoomAndPan="magnify" viewBox="0 0 224.87999 30.000001" height="40" preserveAspectRatio="xMidYMid meet" version="1.0"><defs><filter x="0%" y="0%" width="100%" height="100%" id="976da2d480"><feColorMatrix values="0 0 0 0 1 0 0 0 0 1 0 0 0 0 1 0 0 0 1 0" color-interpolation-filters="sRGB"/></filter><filter x="0%" y="0%" width="100%" height="100%" id="04c6d91fa3"><feColorMatrix values="0 0 0 0 1 0 0 0 0 1 0 0 0 0 1 0.2126 0.7152 0.0722 0 0" color-interpolation-filters="sRGB"/></filter><g/><clipPath id="df2b42bfdc"><path d="M 3.570312 0 L 221.195312 0 L 221.195312 29.03125 L 3.570312 29.03125 Z M 3.570312 0 " clip-rule="nonzero"/></clipPath><clipPath id="ebcc5006ba"><path d="M 13.035156 0 L 36.988281 0 L 36.988281 29.03125 L 13.035156 29.03125 Z M 13.035156 0 " clip-rule="nonzero"/></clipPath><image x="0" y="0" width="664" xlink:href="data:image/png;base64,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" id="ce7911fcdd" height="357" preserveAspectRatio="xMidYMid meet"/><mask id="bec189cfb3"><g filter="url(#976da2d480)"><g filter="url(#04c6d91fa3)" transform="matrix(0.101657, 0, 0, 0.101654, 6.173151, -3.471745)"><image x="0" y="0" width="664" xlink:href="data:image/png;base64,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" height="357" preserveAspectRatio="xMidYMid meet"/></g></g></mask><image x="0" y="0" width="664" xlink:href="data:image/png;base64,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" id="650f1aaacd" height="357" preserveAspectRatio="xMidYMid meet"/><clipPath id="43d9dadc40"><path d="M 36.847656 6.683594 L 76.769531 6.683594 L 76.769531 22.648438 L 36.847656 22.648438 Z M 36.847656 6.683594 " clip-rule="nonzero"/></clipPath><image x="0" y="0" width="664" xlink:href="data:image/png;base64,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" id="9ca5de9e2f" height="357" preserveAspectRatio="xMidYMid meet"/><mask id="9facad5bc3"><g filter="url(#976da2d480)"><g filter="url(#04c6d91fa3)" transform="matrix(0.154125, 0, 0, 0.154513, -13.718275, -15.72553)"><image x="0" y="0" width="664" xlink:href="data:image/png;base64,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" height="357" preserveAspectRatio="xMidYMid meet"/></g></g></mask><image x="0" y="0" width="664" xlink:href="data:image/png;base64,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" id="0607fdc061" height="357" preserveAspectRatio="xMidYMid meet"/></defs><g clip-path="url(#df2b42bfdc)"><path fill="#ffffff" d="M 3.570312 0 L 221.3125 0 L 221.3125 36.289062 L 3.570312 36.289062 Z M 3.570312 0 " fill-opacity="1" fill-rule="nonzero"/><path fill="#ffffff" d="M 3.570312 0 L 221.3125 0 L 221.3125 29.03125 L 3.570312 29.03125 Z M 3.570312 0 " fill-opacity="1" fill-rule="nonzero"/><path fill="#ffffff" d="M 3.570312 0 L 221.3125 0 L 221.3125 29.03125 L 3.570312 29.03125 Z M 3.570312 0 " fill-opacity="1" fill-rule="nonzero"/></g><g clip-path="url(#ebcc5006ba)"><g mask="url(#bec189cfb3)"><g transform="matrix(0.101657, 0, 0, 0.101654, 6.173151, -3.471745)"><image x="0" y="0" width="664" xlink:href="data:image/png;base64,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" height="357" preserveAspectRatio="xMidYMid meet"/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(90.234992, 10.887099)"><g><path d="M 3.359375 0.109375 C 2.835938 0.109375 2.367188 0.046875 1.953125 -0.078125 C 1.546875 -0.210938 1.207031 -0.382812 0.9375 -0.59375 C 0.664062 -0.8125 0.457031 -1.046875 0.3125 -1.296875 L 1.125 -2.296875 L 1.265625 -2.296875 C 1.492188 -1.960938 1.78125 -1.691406 2.125 -1.484375 C 2.476562 -1.285156 2.890625 -1.1875 3.359375 -1.1875 C 3.765625 -1.1875 4.066406 -1.269531 4.265625 -1.4375 C 4.472656 -1.613281 4.578125 -1.847656 4.578125 -2.140625 C 4.578125 -2.328125 4.546875 -2.476562 4.484375 -2.59375 C 4.421875 -2.71875 4.3125 -2.820312 4.15625 -2.90625 C 4 -3 3.789062 -3.078125 3.53125 -3.140625 L 2.5625 -3.359375 C 1.875 -3.515625 1.363281 -3.769531 1.03125 -4.125 C 0.695312 -4.488281 0.53125 -4.960938 0.53125 -5.546875 C 0.53125 -5.972656 0.632812 -6.347656 0.84375 -6.671875 C 1.0625 -7.003906 1.375 -7.257812 1.78125 -7.4375 C 2.195312 -7.613281 2.691406 -7.703125 3.265625 -7.703125 C 3.847656 -7.703125 4.347656 -7.625 4.765625 -7.46875 C 5.179688 -7.320312 5.535156 -7.085938 5.828125 -6.765625 L 5.09375 -5.75 L 4.953125 -5.75 C 4.742188 -5.96875 4.5 -6.132812 4.21875 -6.25 C 3.9375 -6.363281 3.617188 -6.421875 3.265625 -6.421875 C 2.859375 -6.421875 2.546875 -6.347656 2.328125 -6.203125 C 2.109375 -6.054688 2 -5.851562 2 -5.59375 C 2 -5.363281 2.070312 -5.175781 2.21875 -5.03125 C 2.375 -4.882812 2.640625 -4.773438 3.015625 -4.703125 L 4.015625 -4.484375 C 4.753906 -4.328125 5.285156 -4.0625 5.609375 -3.6875 C 5.941406 -3.320312 6.109375 -2.835938 6.109375 -2.234375 C 6.109375 -1.765625 6.003906 -1.351562 5.796875 -1 C 5.597656 -0.644531 5.289062 -0.367188 4.875 -0.171875 C 4.46875 0.015625 3.960938 0.109375 3.359375 0.109375 Z M 3.359375 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(96.758833, 10.887099)"><g><path d="M 3.71875 -7.59375 C 4.945312 -7.59375 5.882812 -7.273438 6.53125 -6.640625 C 7.1875 -6.003906 7.515625 -5.054688 7.515625 -3.796875 C 7.515625 -2.546875 7.1875 -1.597656 6.53125 -0.953125 C 5.882812 -0.316406 4.945312 0 3.71875 0 L 0.984375 0 L 0.984375 -7.59375 Z M 3.625 -1.265625 C 4.414062 -1.265625 5.003906 -1.460938 5.390625 -1.859375 C 5.773438 -2.265625 5.96875 -2.910156 5.96875 -3.796875 C 5.96875 -4.691406 5.773438 -5.335938 5.390625 -5.734375 C 5.003906 -6.128906 4.414062 -6.328125 3.625 -6.328125 L 2.484375 -6.328125 L 2.484375 -1.265625 Z M 3.625 -1.265625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(104.877275, 10.887099)"><g><path d="M 0.984375 0 L 0.984375 -7.59375 L 2.484375 -7.59375 L 2.484375 -4.5 L 2.65625 -4.5 L 5.1875 -7.59375 L 6.734375 -7.59375 L 6.734375 -7.46875 L 3.9375 -4.015625 L 7.015625 -0.125 L 7.015625 0 L 5.328125 0 L 2.65625 -3.28125 L 2.484375 -3.28125 L 2.484375 0 Z M 0.984375 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(111.89456, 10.887099)"><g><path d="M 2.6875 0.109375 C 2.289062 0.109375 1.925781 0.0625 1.59375 -0.03125 C 1.269531 -0.125 0.992188 -0.25 0.765625 -0.40625 C 0.535156 -0.570312 0.367188 -0.757812 0.265625 -0.96875 L 1.0625 -1.828125 L 1.171875 -1.828125 C 1.359375 -1.566406 1.582031 -1.375 1.84375 -1.25 C 2.101562 -1.125 2.382812 -1.0625 2.6875 -1.0625 C 2.96875 -1.0625 3.175781 -1.109375 3.3125 -1.203125 C 3.457031 -1.304688 3.53125 -1.453125 3.53125 -1.640625 C 3.53125 -1.785156 3.476562 -1.90625 3.375 -2 C 3.28125 -2.101562 3.117188 -2.179688 2.890625 -2.234375 L 2.125 -2.421875 C 1.5625 -2.554688 1.148438 -2.757812 0.890625 -3.03125 C 0.628906 -3.3125 0.5 -3.664062 0.5 -4.09375 C 0.5 -4.457031 0.585938 -4.769531 0.765625 -5.03125 C 0.953125 -5.289062 1.207031 -5.488281 1.53125 -5.625 C 1.863281 -5.769531 2.25 -5.84375 2.6875 -5.84375 C 3.207031 -5.84375 3.632812 -5.765625 3.96875 -5.609375 C 4.3125 -5.460938 4.578125 -5.265625 4.765625 -5.015625 L 4 -4.1875 L 3.890625 -4.1875 C 3.734375 -4.363281 3.554688 -4.492188 3.359375 -4.578125 C 3.160156 -4.660156 2.9375 -4.703125 2.6875 -4.703125 C 2.125 -4.703125 1.84375 -4.523438 1.84375 -4.171875 C 1.84375 -4.023438 1.894531 -3.90625 2 -3.8125 C 2.101562 -3.71875 2.289062 -3.640625 2.5625 -3.578125 L 3.265625 -3.421875 C 3.847656 -3.296875 4.269531 -3.097656 4.53125 -2.828125 C 4.800781 -2.554688 4.9375 -2.1875 4.9375 -1.71875 C 4.9375 -1.351562 4.847656 -1.03125 4.671875 -0.75 C 4.492188 -0.476562 4.234375 -0.265625 3.890625 -0.109375 C 3.546875 0.0351562 3.144531 0.109375 2.6875 0.109375 Z M 2.6875 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(117.177001, 10.887099)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(119.685771, 10.887099)"><g><path d="M 3.109375 0.109375 C 2.554688 0.109375 2.070312 0.015625 1.65625 -0.171875 C 1.25 -0.359375 0.929688 -0.625 0.703125 -0.96875 C 0.484375 -1.320312 0.375 -1.726562 0.375 -2.1875 C 0.375 -2.6875 0.5 -3.101562 0.75 -3.4375 C 1 -3.769531 1.375 -4.039062 1.875 -4.25 L 1.890625 -4.359375 C 1.660156 -4.640625 1.492188 -4.894531 1.390625 -5.125 C 1.285156 -5.363281 1.234375 -5.628906 1.234375 -5.921875 C 1.234375 -6.265625 1.316406 -6.570312 1.484375 -6.84375 C 1.648438 -7.113281 1.890625 -7.320312 2.203125 -7.46875 C 2.523438 -7.625 2.90625 -7.703125 3.34375 -7.703125 C 3.757812 -7.703125 4.113281 -7.632812 4.40625 -7.5 C 4.707031 -7.363281 4.9375 -7.171875 5.09375 -6.921875 C 5.25 -6.671875 5.328125 -6.382812 5.328125 -6.0625 C 5.328125 -5.632812 5.195312 -5.257812 4.9375 -4.9375 C 4.675781 -4.625 4.273438 -4.363281 3.734375 -4.15625 L 3.71875 -4.046875 L 5.125 -2.1875 C 5.207031 -2.363281 5.265625 -2.566406 5.296875 -2.796875 C 5.328125 -3.035156 5.34375 -3.300781 5.34375 -3.59375 L 5.34375 -3.859375 L 6.5625 -3.859375 C 6.5625 -2.796875 6.351562 -1.9375 5.9375 -1.28125 C 6.019531 -1.207031 6.09375 -1.15625 6.15625 -1.125 C 6.21875 -1.101562 6.289062 -1.09375 6.375 -1.09375 C 6.445312 -1.09375 6.503906 -1.09375 6.546875 -1.09375 C 6.585938 -1.101562 6.640625 -1.117188 6.703125 -1.140625 L 6.78125 -1.109375 L 6.953125 -0.078125 C 6.890625 -0.0234375 6.796875 0.0078125 6.671875 0.03125 C 6.554688 0.0507812 6.421875 0.0625 6.265625 0.0625 C 6.015625 0.0625 5.789062 0.0195312 5.59375 -0.0625 C 5.40625 -0.144531 5.226562 -0.269531 5.0625 -0.4375 L 4.953125 -0.4375 C 4.515625 -0.0703125 3.898438 0.109375 3.109375 0.109375 Z M 3.109375 -4.875 C 3.421875 -5.03125 3.648438 -5.1875 3.796875 -5.34375 C 3.941406 -5.507812 4.015625 -5.71875 4.015625 -5.96875 C 4.015625 -6.1875 3.953125 -6.351562 3.828125 -6.46875 C 3.703125 -6.582031 3.535156 -6.640625 3.328125 -6.640625 C 3.117188 -6.640625 2.945312 -6.578125 2.8125 -6.453125 C 2.6875 -6.328125 2.625 -6.15625 2.625 -5.9375 C 2.625 -5.769531 2.65625 -5.613281 2.71875 -5.46875 C 2.789062 -5.320312 2.921875 -5.125 3.109375 -4.875 Z M 3.28125 -1.125 C 3.613281 -1.125 3.898438 -1.1875 4.140625 -1.3125 L 2.453125 -3.46875 C 2.253906 -3.332031 2.101562 -3.175781 2 -3 C 1.90625 -2.820312 1.859375 -2.613281 1.859375 -2.375 C 1.859375 -2.125 1.914062 -1.90625 2.03125 -1.71875 C 2.15625 -1.53125 2.320312 -1.382812 2.53125 -1.28125 C 2.75 -1.175781 3 -1.125 3.28125 -1.125 Z M 3.28125 -1.125 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(126.780968, 10.887099)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(129.289738, 10.887099)"><g><path d="M 2.828125 0.109375 C 2.378906 0.109375 1.976562 0 1.625 -0.21875 C 1.28125 -0.4375 1.007812 -0.769531 0.8125 -1.21875 C 0.613281 -1.664062 0.515625 -2.210938 0.515625 -2.859375 C 0.515625 -3.515625 0.613281 -4.066406 0.8125 -4.515625 C 1.019531 -4.960938 1.300781 -5.296875 1.65625 -5.515625 C 2.019531 -5.734375 2.4375 -5.84375 2.90625 -5.84375 C 3.257812 -5.84375 3.566406 -5.78125 3.828125 -5.65625 C 4.085938 -5.53125 4.3125 -5.335938 4.5 -5.078125 L 4.609375 -5.109375 L 4.609375 -8.03125 L 6.046875 -8.03125 L 6.046875 0 L 4.609375 0 L 4.609375 -0.75 L 4.5 -0.765625 C 4.332031 -0.492188 4.109375 -0.28125 3.828125 -0.125 C 3.554688 0.03125 3.222656 0.109375 2.828125 0.109375 Z M 3.296875 -1.109375 C 3.703125 -1.109375 4.019531 -1.253906 4.25 -1.546875 C 4.488281 -1.835938 4.609375 -2.273438 4.609375 -2.859375 C 4.609375 -3.453125 4.488281 -3.894531 4.25 -4.1875 C 4.019531 -4.476562 3.703125 -4.625 3.296875 -4.625 C 2.878906 -4.625 2.554688 -4.476562 2.328125 -4.1875 C 2.109375 -3.90625 2 -3.460938 2 -2.859375 C 2 -2.253906 2.109375 -1.8125 2.328125 -1.53125 C 2.554688 -1.25 2.878906 -1.109375 3.296875 -1.109375 Z M 3.296875 -1.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(136.156392, 10.887099)"><g><path d="M 3.328125 0.109375 C 2.765625 0.109375 2.269531 -0.00390625 1.84375 -0.234375 C 1.425781 -0.460938 1.097656 -0.800781 0.859375 -1.25 C 0.628906 -1.695312 0.515625 -2.234375 0.515625 -2.859375 C 0.515625 -3.492188 0.628906 -4.035156 0.859375 -4.484375 C 1.097656 -4.929688 1.425781 -5.269531 1.84375 -5.5 C 2.269531 -5.726562 2.765625 -5.84375 3.328125 -5.84375 C 3.890625 -5.84375 4.378906 -5.726562 4.796875 -5.5 C 5.222656 -5.269531 5.554688 -4.929688 5.796875 -4.484375 C 6.035156 -4.035156 6.15625 -3.492188 6.15625 -2.859375 C 6.15625 -2.234375 6.035156 -1.695312 5.796875 -1.25 C 5.554688 -0.800781 5.222656 -0.460938 4.796875 -0.234375 C 4.378906 -0.00390625 3.890625 0.109375 3.328125 0.109375 Z M 3.328125 -1.109375 C 4.222656 -1.109375 4.671875 -1.691406 4.671875 -2.859375 C 4.671875 -3.460938 4.554688 -3.90625 4.328125 -4.1875 C 4.097656 -4.476562 3.765625 -4.625 3.328125 -4.625 C 2.441406 -4.625 2 -4.035156 2 -2.859375 C 2 -1.691406 2.441406 -1.109375 3.328125 -1.109375 Z M 3.328125 -1.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(142.815281, 10.887099)"><g><path d="M 3.34375 0.109375 C 2.789062 0.109375 2.300781 -0.00390625 1.875 -0.234375 C 1.445312 -0.460938 1.113281 -0.800781 0.875 -1.25 C 0.632812 -1.695312 0.515625 -2.234375 0.515625 -2.859375 C 0.515625 -3.492188 0.632812 -4.035156 0.875 -4.484375 C 1.113281 -4.929688 1.441406 -5.269531 1.859375 -5.5 C 2.285156 -5.726562 2.769531 -5.84375 3.3125 -5.84375 C 4.519531 -5.84375 5.296875 -5.40625 5.640625 -4.53125 L 4.65625 -3.8125 L 4.546875 -3.8125 C 4.421875 -4.082031 4.265625 -4.285156 4.078125 -4.421875 C 3.890625 -4.554688 3.632812 -4.625 3.3125 -4.625 C 2.894531 -4.625 2.570312 -4.476562 2.34375 -4.1875 C 2.113281 -3.894531 2 -3.453125 2 -2.859375 C 2 -2.273438 2.113281 -1.835938 2.34375 -1.546875 C 2.582031 -1.253906 2.914062 -1.109375 3.34375 -1.109375 C 3.65625 -1.109375 3.914062 -1.191406 4.125 -1.359375 C 4.34375 -1.523438 4.5 -1.769531 4.59375 -2.09375 L 4.703125 -2.09375 L 5.734375 -1.53125 C 5.585938 -1.050781 5.316406 -0.65625 4.921875 -0.34375 C 4.523438 -0.0390625 4 0.109375 3.34375 0.109375 Z M 3.34375 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(148.721019, 10.887099)"><g><path d="M 2.625 0.109375 C 1.976562 0.109375 1.5 -0.0664062 1.1875 -0.421875 C 0.882812 -0.773438 0.734375 -1.28125 0.734375 -1.9375 L 0.734375 -5.734375 L 2.171875 -5.734375 L 2.171875 -2.109375 C 2.171875 -1.765625 2.242188 -1.507812 2.390625 -1.34375 C 2.546875 -1.1875 2.785156 -1.109375 3.109375 -1.109375 C 3.503906 -1.109375 3.8125 -1.238281 4.03125 -1.5 C 4.25 -1.757812 4.359375 -2.171875 4.359375 -2.734375 L 4.359375 -5.734375 L 5.796875 -5.734375 L 5.796875 0 L 4.421875 0 L 4.421875 -0.84375 L 4.3125 -0.875 C 4.125 -0.539062 3.894531 -0.289062 3.625 -0.125 C 3.363281 0.03125 3.03125 0.109375 2.625 0.109375 Z M 2.625 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(155.348743, 10.887099)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.203125 -5.734375 L 2.203125 -4.96875 L 2.3125 -4.9375 C 2.5 -5.25 2.71875 -5.476562 2.96875 -5.625 C 3.21875 -5.769531 3.539062 -5.84375 3.9375 -5.84375 C 4.375 -5.84375 4.722656 -5.753906 4.984375 -5.578125 C 5.242188 -5.410156 5.4375 -5.160156 5.5625 -4.828125 L 5.671875 -4.828125 C 5.847656 -5.171875 6.070312 -5.425781 6.34375 -5.59375 C 6.625 -5.757812 6.972656 -5.84375 7.390625 -5.84375 C 8.578125 -5.84375 9.171875 -5.179688 9.171875 -3.859375 L 9.171875 0 L 7.734375 0 L 7.734375 -3.671875 C 7.734375 -4.003906 7.664062 -4.242188 7.53125 -4.390625 C 7.40625 -4.546875 7.195312 -4.625 6.90625 -4.625 C 6.113281 -4.625 5.71875 -4.097656 5.71875 -3.046875 L 5.71875 0 L 4.28125 0 L 4.28125 -3.671875 C 4.28125 -4.003906 4.210938 -4.242188 4.078125 -4.390625 C 3.941406 -4.546875 3.726562 -4.625 3.4375 -4.625 C 3.070312 -4.625 2.785156 -4.5 2.578125 -4.25 C 2.367188 -4 2.265625 -3.609375 2.265625 -3.078125 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(165.259164, 10.887099)"><g><path d="M 5.65625 -2.546875 L 1.984375 -2.546875 C 2.023438 -2.046875 2.164062 -1.679688 2.40625 -1.453125 C 2.644531 -1.222656 2.972656 -1.109375 3.390625 -1.109375 C 3.722656 -1.109375 3.988281 -1.171875 4.1875 -1.296875 C 4.394531 -1.421875 4.5625 -1.609375 4.6875 -1.859375 L 4.796875 -1.859375 L 5.75 -1.234375 C 5.5625 -0.835938 5.28125 -0.515625 4.90625 -0.265625 C 4.53125 -0.015625 4.023438 0.109375 3.390625 0.109375 C 2.804688 0.109375 2.296875 0 1.859375 -0.21875 C 1.429688 -0.445312 1.097656 -0.785156 0.859375 -1.234375 C 0.628906 -1.679688 0.515625 -2.222656 0.515625 -2.859375 C 0.515625 -3.515625 0.632812 -4.066406 0.875 -4.515625 C 1.125 -4.960938 1.457031 -5.296875 1.875 -5.515625 C 2.300781 -5.734375 2.773438 -5.84375 3.296875 -5.84375 C 4.109375 -5.84375 4.726562 -5.625 5.15625 -5.1875 C 5.582031 -4.757812 5.796875 -4.128906 5.796875 -3.296875 C 5.796875 -3.003906 5.785156 -2.773438 5.765625 -2.609375 Z M 4.421875 -3.46875 C 4.410156 -3.90625 4.3125 -4.222656 4.125 -4.421875 C 3.9375 -4.617188 3.660156 -4.71875 3.296875 -4.71875 C 2.566406 -4.71875 2.140625 -4.300781 2.015625 -3.46875 Z M 4.421875 -3.46875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(171.486939, 10.887099)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.203125 -5.734375 L 2.203125 -4.890625 L 2.3125 -4.859375 C 2.675781 -5.515625 3.253906 -5.84375 4.046875 -5.84375 C 4.710938 -5.84375 5.195312 -5.660156 5.5 -5.296875 C 5.8125 -4.941406 5.96875 -4.414062 5.96875 -3.71875 L 5.96875 0 L 4.53125 0 L 4.53125 -3.546875 C 4.53125 -3.929688 4.453125 -4.207031 4.296875 -4.375 C 4.148438 -4.539062 3.910156 -4.625 3.578125 -4.625 C 3.160156 -4.625 2.835938 -4.488281 2.609375 -4.21875 C 2.378906 -3.957031 2.265625 -3.539062 2.265625 -2.96875 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(178.197769, 10.887099)"><g><path d="M 3.953125 -1.359375 L 4.328125 -0.296875 C 4.171875 -0.171875 3.972656 -0.0703125 3.734375 0 C 3.503906 0.0703125 3.238281 0.109375 2.9375 0.109375 C 2.320312 0.109375 1.851562 -0.0546875 1.53125 -0.390625 C 1.207031 -0.734375 1.046875 -1.226562 1.046875 -1.875 L 1.046875 -4.59375 L 0.171875 -4.59375 L 0.171875 -5.734375 L 1.046875 -5.734375 L 1.046875 -6.859375 L 2.484375 -7.09375 L 2.484375 -5.734375 L 4.109375 -5.734375 L 4.109375 -4.59375 L 2.484375 -4.59375 L 2.484375 -1.96875 C 2.484375 -1.6875 2.539062 -1.476562 2.65625 -1.34375 C 2.78125 -1.21875 2.953125 -1.15625 3.171875 -1.15625 C 3.429688 -1.15625 3.65625 -1.222656 3.84375 -1.359375 Z M 3.953125 -1.359375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(182.649148, 10.887099)"><g><path d="M 2.234375 0.109375 C 1.867188 0.109375 1.550781 0.0390625 1.28125 -0.09375 C 1.007812 -0.226562 0.800781 -0.425781 0.65625 -0.6875 C 0.507812 -0.945312 0.4375 -1.257812 0.4375 -1.625 C 0.4375 -1.96875 0.507812 -2.253906 0.65625 -2.484375 C 0.800781 -2.710938 1.023438 -2.898438 1.328125 -3.046875 C 1.628906 -3.191406 2.03125 -3.304688 2.53125 -3.390625 C 2.875 -3.441406 3.132812 -3.5 3.3125 -3.5625 C 3.488281 -3.632812 3.609375 -3.710938 3.671875 -3.796875 C 3.734375 -3.878906 3.765625 -3.984375 3.765625 -4.109375 C 3.765625 -4.296875 3.695312 -4.4375 3.5625 -4.53125 C 3.4375 -4.632812 3.226562 -4.6875 2.9375 -4.6875 C 2.613281 -4.6875 2.304688 -4.613281 2.015625 -4.46875 C 1.734375 -4.320312 1.484375 -4.132812 1.265625 -3.90625 L 1.171875 -3.90625 L 0.5625 -4.8125 C 0.851562 -5.132812 1.207031 -5.382812 1.625 -5.5625 C 2.050781 -5.75 2.507812 -5.84375 3 -5.84375 C 3.757812 -5.84375 4.304688 -5.679688 4.640625 -5.359375 C 4.984375 -5.035156 5.15625 -4.578125 5.15625 -3.984375 L 5.15625 -1.5 C 5.15625 -1.238281 5.269531 -1.109375 5.5 -1.109375 C 5.582031 -1.109375 5.664062 -1.125 5.75 -1.15625 L 5.828125 -1.140625 L 5.921875 -0.140625 C 5.847656 -0.0859375 5.738281 -0.0390625 5.59375 0 C 5.445312 0.03125 5.289062 0.046875 5.125 0.046875 C 4.78125 0.046875 4.507812 -0.0195312 4.3125 -0.15625 C 4.125 -0.289062 3.988281 -0.5 3.90625 -0.78125 L 3.796875 -0.78125 C 3.515625 -0.1875 2.992188 0.109375 2.234375 0.109375 Z M 2.6875 -0.96875 C 3.019531 -0.96875 3.285156 -1.078125 3.484375 -1.296875 C 3.679688 -1.523438 3.78125 -1.835938 3.78125 -2.234375 L 3.78125 -2.8125 L 3.6875 -2.84375 C 3.601562 -2.769531 3.488281 -2.707031 3.34375 -2.65625 C 3.207031 -2.613281 3.007812 -2.570312 2.75 -2.53125 C 2.4375 -2.476562 2.207031 -2.382812 2.0625 -2.25 C 1.925781 -2.125 1.859375 -1.945312 1.859375 -1.71875 C 1.859375 -1.46875 1.929688 -1.28125 2.078125 -1.15625 C 2.222656 -1.03125 2.425781 -0.96875 2.6875 -0.96875 Z M 2.6875 -0.96875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(188.689934, 10.887099)"><g><path d="M 3.953125 -1.359375 L 4.328125 -0.296875 C 4.171875 -0.171875 3.972656 -0.0703125 3.734375 0 C 3.503906 0.0703125 3.238281 0.109375 2.9375 0.109375 C 2.320312 0.109375 1.851562 -0.0546875 1.53125 -0.390625 C 1.207031 -0.734375 1.046875 -1.226562 1.046875 -1.875 L 1.046875 -4.59375 L 0.171875 -4.59375 L 0.171875 -5.734375 L 1.046875 -5.734375 L 1.046875 -6.859375 L 2.484375 -7.09375 L 2.484375 -5.734375 L 4.109375 -5.734375 L 4.109375 -4.59375 L 2.484375 -4.59375 L 2.484375 -1.96875 C 2.484375 -1.6875 2.539062 -1.476562 2.65625 -1.34375 C 2.78125 -1.21875 2.953125 -1.15625 3.171875 -1.15625 C 3.429688 -1.15625 3.65625 -1.222656 3.84375 -1.359375 Z M 3.953125 -1.359375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(193.141313, 10.887099)"><g><path d="M 1.546875 -6.421875 C 1.285156 -6.421875 1.070312 -6.5 0.90625 -6.65625 C 0.75 -6.8125 0.671875 -7.015625 0.671875 -7.265625 C 0.671875 -7.503906 0.75 -7.703125 0.90625 -7.859375 C 1.070312 -8.023438 1.285156 -8.109375 1.546875 -8.109375 C 1.710938 -8.109375 1.863281 -8.070312 2 -8 C 2.132812 -7.925781 2.238281 -7.820312 2.3125 -7.6875 C 2.394531 -7.5625 2.4375 -7.421875 2.4375 -7.265625 C 2.4375 -7.097656 2.394531 -6.953125 2.3125 -6.828125 C 2.238281 -6.703125 2.132812 -6.601562 2 -6.53125 C 1.863281 -6.457031 1.710938 -6.421875 1.546875 -6.421875 Z M 0.828125 0 L 0.828125 -5.734375 L 2.265625 -5.734375 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(196.226632, 10.887099)"><g><path d="M 3.328125 0.109375 C 2.765625 0.109375 2.269531 -0.00390625 1.84375 -0.234375 C 1.425781 -0.460938 1.097656 -0.800781 0.859375 -1.25 C 0.628906 -1.695312 0.515625 -2.234375 0.515625 -2.859375 C 0.515625 -3.492188 0.628906 -4.035156 0.859375 -4.484375 C 1.097656 -4.929688 1.425781 -5.269531 1.84375 -5.5 C 2.269531 -5.726562 2.765625 -5.84375 3.328125 -5.84375 C 3.890625 -5.84375 4.378906 -5.726562 4.796875 -5.5 C 5.222656 -5.269531 5.554688 -4.929688 5.796875 -4.484375 C 6.035156 -4.035156 6.15625 -3.492188 6.15625 -2.859375 C 6.15625 -2.234375 6.035156 -1.695312 5.796875 -1.25 C 5.554688 -0.800781 5.222656 -0.460938 4.796875 -0.234375 C 4.378906 -0.00390625 3.890625 0.109375 3.328125 0.109375 Z M 3.328125 -1.109375 C 4.222656 -1.109375 4.671875 -1.691406 4.671875 -2.859375 C 4.671875 -3.460938 4.554688 -3.90625 4.328125 -4.1875 C 4.097656 -4.476562 3.765625 -4.625 3.328125 -4.625 C 2.441406 -4.625 2 -4.035156 2 -2.859375 C 2 -1.691406 2.441406 -1.109375 3.328125 -1.109375 Z M 3.328125 -1.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(202.885521, 10.887099)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.203125 -5.734375 L 2.203125 -4.890625 L 2.3125 -4.859375 C 2.675781 -5.515625 3.253906 -5.84375 4.046875 -5.84375 C 4.710938 -5.84375 5.195312 -5.660156 5.5 -5.296875 C 5.8125 -4.941406 5.96875 -4.414062 5.96875 -3.71875 L 5.96875 0 L 4.53125 0 L 4.53125 -3.546875 C 4.53125 -3.929688 4.453125 -4.207031 4.296875 -4.375 C 4.148438 -4.539062 3.910156 -4.625 3.578125 -4.625 C 3.160156 -4.625 2.835938 -4.488281 2.609375 -4.21875 C 2.378906 -3.957031 2.265625 -3.539062 2.265625 -2.96875 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(118.893006, 25.403228)"><g><path d="M 1 0 L 1 -4.59375 L 0.1875 -4.59375 L 0.1875 -5.734375 L 1 -5.734375 C 0.945312 -5.972656 0.921875 -6.203125 0.921875 -6.421875 C 0.921875 -6.785156 1 -7.09375 1.15625 -7.34375 C 1.320312 -7.601562 1.5625 -7.800781 1.875 -7.9375 C 2.1875 -8.070312 2.5625 -8.140625 3 -8.140625 C 3.625 -8.140625 4.09375 -8.03125 4.40625 -7.8125 L 4.078125 -6.75 L 3.96875 -6.734375 C 3.75 -6.890625 3.472656 -6.96875 3.140625 -6.96875 C 2.878906 -6.96875 2.679688 -6.898438 2.546875 -6.765625 C 2.421875 -6.640625 2.359375 -6.46875 2.359375 -6.25 C 2.359375 -6.15625 2.363281 -6.066406 2.375 -5.984375 C 2.382812 -5.910156 2.40625 -5.828125 2.4375 -5.734375 L 4.078125 -5.734375 L 4.078125 -4.59375 L 2.4375 -4.59375 L 2.4375 0 Z M 1 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(123.027542, 25.403228)"><g><path d="M 3.328125 0.109375 C 2.765625 0.109375 2.269531 -0.00390625 1.84375 -0.234375 C 1.425781 -0.460938 1.097656 -0.800781 0.859375 -1.25 C 0.628906 -1.695312 0.515625 -2.234375 0.515625 -2.859375 C 0.515625 -3.492188 0.628906 -4.035156 0.859375 -4.484375 C 1.097656 -4.929688 1.425781 -5.269531 1.84375 -5.5 C 2.269531 -5.726562 2.765625 -5.84375 3.328125 -5.84375 C 3.890625 -5.84375 4.378906 -5.726562 4.796875 -5.5 C 5.222656 -5.269531 5.554688 -4.929688 5.796875 -4.484375 C 6.035156 -4.035156 6.15625 -3.492188 6.15625 -2.859375 C 6.15625 -2.234375 6.035156 -1.695312 5.796875 -1.25 C 5.554688 -0.800781 5.222656 -0.460938 4.796875 -0.234375 C 4.378906 -0.00390625 3.890625 0.109375 3.328125 0.109375 Z M 3.328125 -1.109375 C 4.222656 -1.109375 4.671875 -1.691406 4.671875 -2.859375 C 4.671875 -3.460938 4.554688 -3.90625 4.328125 -4.1875 C 4.097656 -4.476562 3.765625 -4.625 3.328125 -4.625 C 2.441406 -4.625 2 -4.035156 2 -2.859375 C 2 -1.691406 2.441406 -1.109375 3.328125 -1.109375 Z M 3.328125 -1.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(129.686431, 25.403228)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.21875 -5.734375 L 2.21875 -4.875 L 2.328125 -4.859375 C 2.472656 -5.171875 2.65625 -5.398438 2.875 -5.546875 C 3.101562 -5.703125 3.378906 -5.78125 3.703125 -5.78125 C 4.023438 -5.78125 4.269531 -5.722656 4.4375 -5.609375 L 4.203125 -4.375 L 4.09375 -4.359375 C 4 -4.390625 3.90625 -4.414062 3.8125 -4.4375 C 3.726562 -4.457031 3.625 -4.46875 3.5 -4.46875 C 3.101562 -4.46875 2.796875 -4.320312 2.578125 -4.03125 C 2.367188 -3.75 2.265625 -3.300781 2.265625 -2.6875 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(134.179363, 25.403228)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(136.688133, 25.403228)"><g><path d="M 1.265625 2.4375 C 1.023438 2.4375 0.800781 2.414062 0.59375 2.375 C 0.394531 2.332031 0.234375 2.28125 0.109375 2.21875 L 0.34375 1.0625 L 0.4375 1.03125 C 0.519531 1.070312 0.625 1.101562 0.75 1.125 C 0.882812 1.15625 1.019531 1.171875 1.15625 1.171875 C 1.382812 1.171875 1.578125 1.140625 1.734375 1.078125 C 1.890625 1.023438 2.019531 0.925781 2.125 0.78125 C 2.226562 0.644531 2.320312 0.453125 2.40625 0.203125 L 0.125 -5.734375 L 1.625 -5.734375 L 3.0625 -1.75 L 3.1875 -1.75 L 4.5625 -5.734375 L 6.03125 -5.734375 L 3.734375 0.359375 C 3.546875 0.847656 3.34375 1.242188 3.125 1.546875 C 2.90625 1.847656 2.644531 2.070312 2.34375 2.21875 C 2.039062 2.363281 1.679688 2.4375 1.265625 2.4375 Z M 1.265625 2.4375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(142.837996, 25.403228)"><g><path d="M 3.328125 0.109375 C 2.765625 0.109375 2.269531 -0.00390625 1.84375 -0.234375 C 1.425781 -0.460938 1.097656 -0.800781 0.859375 -1.25 C 0.628906 -1.695312 0.515625 -2.234375 0.515625 -2.859375 C 0.515625 -3.492188 0.628906 -4.035156 0.859375 -4.484375 C 1.097656 -4.929688 1.425781 -5.269531 1.84375 -5.5 C 2.269531 -5.726562 2.765625 -5.84375 3.328125 -5.84375 C 3.890625 -5.84375 4.378906 -5.726562 4.796875 -5.5 C 5.222656 -5.269531 5.554688 -4.929688 5.796875 -4.484375 C 6.035156 -4.035156 6.15625 -3.492188 6.15625 -2.859375 C 6.15625 -2.234375 6.035156 -1.695312 5.796875 -1.25 C 5.554688 -0.800781 5.222656 -0.460938 4.796875 -0.234375 C 4.378906 -0.00390625 3.890625 0.109375 3.328125 0.109375 Z M 3.328125 -1.109375 C 4.222656 -1.109375 4.671875 -1.691406 4.671875 -2.859375 C 4.671875 -3.460938 4.554688 -3.90625 4.328125 -4.1875 C 4.097656 -4.476562 3.765625 -4.625 3.328125 -4.625 C 2.441406 -4.625 2 -4.035156 2 -2.859375 C 2 -1.691406 2.441406 -1.109375 3.328125 -1.109375 Z M 3.328125 -1.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(149.496884, 25.403228)"><g><path d="M 2.625 0.109375 C 1.976562 0.109375 1.5 -0.0664062 1.1875 -0.421875 C 0.882812 -0.773438 0.734375 -1.28125 0.734375 -1.9375 L 0.734375 -5.734375 L 2.171875 -5.734375 L 2.171875 -2.109375 C 2.171875 -1.765625 2.242188 -1.507812 2.390625 -1.34375 C 2.546875 -1.1875 2.785156 -1.109375 3.109375 -1.109375 C 3.503906 -1.109375 3.8125 -1.238281 4.03125 -1.5 C 4.25 -1.757812 4.359375 -2.171875 4.359375 -2.734375 L 4.359375 -5.734375 L 5.796875 -5.734375 L 5.796875 0 L 4.421875 0 L 4.421875 -0.84375 L 4.3125 -0.875 C 4.125 -0.539062 3.894531 -0.289062 3.625 -0.125 C 3.363281 0.03125 3.03125 0.109375 2.625 0.109375 Z M 2.625 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(156.124608, 25.403228)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.21875 -5.734375 L 2.21875 -4.875 L 2.328125 -4.859375 C 2.472656 -5.171875 2.65625 -5.398438 2.875 -5.546875 C 3.101562 -5.703125 3.378906 -5.78125 3.703125 -5.78125 C 4.023438 -5.78125 4.269531 -5.722656 4.4375 -5.609375 L 4.203125 -4.375 L 4.09375 -4.359375 C 4 -4.390625 3.90625 -4.414062 3.8125 -4.4375 C 3.726562 -4.457031 3.625 -4.46875 3.5 -4.46875 C 3.101562 -4.46875 2.796875 -4.320312 2.578125 -4.03125 C 2.367188 -3.75 2.265625 -3.300781 2.265625 -2.6875 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(160.61754, 25.403228)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(163.12631, 25.403228)"><g><path d="M 7.296875 0 L 5.703125 0 L 5.140625 -1.75 L 2.234375 -1.75 L 1.65625 0 L 0.109375 0 L 2.734375 -7.59375 L 4.671875 -7.59375 Z M 3.609375 -6.015625 L 2.640625 -3.015625 L 4.71875 -3.015625 L 3.734375 -6.015625 Z M 3.609375 -6.015625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(170.527961, 25.403228)"><g><path d="M 3.921875 -7.59375 C 4.460938 -7.59375 4.925781 -7.492188 5.3125 -7.296875 C 5.695312 -7.097656 5.988281 -6.816406 6.1875 -6.453125 C 6.382812 -6.097656 6.484375 -5.6875 6.484375 -5.21875 C 6.484375 -4.738281 6.382812 -4.316406 6.1875 -3.953125 C 5.988281 -3.597656 5.695312 -3.320312 5.3125 -3.125 C 4.925781 -2.925781 4.460938 -2.828125 3.921875 -2.828125 L 2.484375 -2.828125 L 2.484375 0 L 0.984375 0 L 0.984375 -7.59375 Z M 3.71875 -4.015625 C 4.5625 -4.015625 4.984375 -4.414062 4.984375 -5.21875 C 4.984375 -6.007812 4.5625 -6.40625 3.71875 -6.40625 L 2.484375 -6.40625 L 2.484375 -4.015625 Z M 3.71875 -4.015625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(177.467333, 25.403228)"><g><path d="M 2.484375 0 L 0.984375 0 L 0.984375 -7.59375 L 2.484375 -7.59375 Z M 2.484375 0 "/></g></g></g><g clip-path="url(#43d9dadc40)"><g mask="url(#9facad5bc3)"><g transform="matrix(0.154125, 0, 0, 0.154513, -13.718275, -15.72553)"><image x="0" y="0" width="664" xlink:href="data:image/png;base64,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" height="357" preserveAspectRatio="xMidYMid meet"/></g></g></g></svg>
diff --git a/docs/en/docs/img/sponsors/fern.svg b/docs/en/docs/img/sponsors/fern.svg
new file mode 100644
index 000000000..ad3842fe0
--- /dev/null
+++ b/docs/en/docs/img/sponsors/fern.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="240" zoomAndPan="magnify" viewBox="0 0 180 74.999997" height="100" preserveAspectRatio="xMidYMid meet" version="1.0"><defs><filter x="0%" y="0%" width="100%" height="100%" id="5cb88468f9"><feColorMatrix values="0 0 0 0 1 0 0 0 0 1 0 0 0 0 1 0 0 0 1 0" color-interpolation-filters="sRGB"/></filter><filter x="0%" y="0%" width="100%" height="100%" id="08b06b2c0b"><feColorMatrix values="0 0 0 0 1 0 0 0 0 1 0 0 0 0 1 0.2126 0.7152 0.0722 0 0" color-interpolation-filters="sRGB"/></filter><g/><clipPath id="294e9b1262"><path d="M 36.867188 0 L 78.117188 0 L 78.117188 56 L 36.867188 56 Z M 36.867188 0 " clip-rule="nonzero"/></clipPath><image x="0" y="0" width="930" xlink:href="data:image/png;base64,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" id="0ee6f724df" height="500" preserveAspectRatio="xMidYMid meet"/><mask id="124efb07be"><g filter="url(#5cb88468f9)"><g filter="url(#08b06b2c0b)" transform="matrix(0.125, 0, 0, 0.1245, 25.065686, -5.884486)"><image x="0" y="0" width="930" xlink:href="data:image/png;base64,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" height="500" preserveAspectRatio="xMidYMid meet"/></g></g></mask><image x="0" y="0" width="930" xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA6IAAAH0CAIAAACo0gcTAAAABmJLR0QA/wD/AP+gvaeTAAAgAElEQVR4nOzdaZBbWXYn9v+972FHIlckmRvJWrgUUF3qTe2q1oyI0sgqy1KMNFIlPZ6xHTVqR9gz/dExYTsUngTDDsdEjJcIjUeSx5LcsmzFBNktjUZbL5Ia1Ki7q/fu6gJqZ3HJ5JJg7iuWd48/3PceXnKp4pLIjf8fo5NJJPAWANV5cN655wBERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERLSV2u0DoD1KROw3CqpUKeXreQD1fL1SqvBdQ0RERHuf3u0DoL1IBEAZwPlKebJSqJQqxVqxWCtWSpVCtVB4vVD6agmyywdJRERE9AGc3T4A2nPKUgZwDL/71R9d+84X/7fhY5898XZ+eaC+cqg+vDjwjY9/97O/8dnPvfI5AKVSKf1P08XJ4qXPXcLZ3T1qIiIioi0Y5tIWtlThAkqbC0VJfvqqm97YuJEyKu0iruXwWt8z7z958dRbn37rVEbUX3/8ezbkLVQLxcniK0+8UqlUdvkEiIiIiACwNpeiylI+jUoJlT+b/0cLK6ecNXVrcfZy/aJWGoACREFrJVDttvT01q810rPZtU23/cX/4Gvls+XK6UqlVPG3xXcWERER7SoGI+QTQQWlCyj9+Pwl0zi2VHeVchTU2zNvrDVWtHIkqMZVSomIEkBDObqF9qJubWpvQ7f/4Ke/DKBQLRRrRQDnz5zfzVMiIiKix5i72wdAe4KtVSihcnO6b3r9ZGrTcZQDEaV1f25wtb4CQCkFAAIRKAAKIpC2cZUzZFyBuZFbeOm1T6wmN1JrOQCTheo5AQDFD1NERES04xjmEgBUUCqh8qWbpTffXXyiP+1oFwCUEkhPKpdwE812UymlxP6B2JhXJPhiFHB4aWBkaUBpbHrSisvCWg+A89VC4XUAqBVrvHhAREREO4ZL0AhlKWew9nmcSd5ERn8s7sTgp2shkLiT2Gitr22uONqxN/lVC4Dy2dDX/gwAXKXijkm55rvXjs5tZJoXj10oXShVSlyjRkRERDuG6bXH3blz5+qFer1YH7gqqbpJxVIqeFcopYwYRzlrjdV3rr1ljKeVjuZz/RESSsEPev2hEnaxGgAorKj4Qm5RGrFnvvaxcKflcnmnz5OIiIgeM8zmPtZsVLpeW3fbi4m1RiqWVqKg/DStiGiljTHJeGqzub7eWLelCuFXC4Lg7lBKKSgBVDA8IiFef9OVfF6y10x8LbbUB6BUKjGtS0RERF3FbO5jzYa5f/Sd35qRN3LJAQ0HnZIEhN9rpRfXFt6/+W70xrA6VymB2FjXljJAQfnL1GwZg4IAjmBu7P2+N55Nv/dEeABM6xIREVGXcNjv40ukDFS+e+W3rtRfy8b6tXIB8QsQwr4KAAAjJpPMJmMpIyYozw3qE2wRr1JKwV+YJjYIFtuSQeD/ZYD+a0/KwHrj1Hvtw3UA514+BwGHBhMREVE3sGjhMRVM9L387ekFZHOOdoPaAz9cDaJYP9iNObFmu7mysRwuRFN39gmztQx+lS5s/YItYwCUjZ61QGItlW1OH738lU9/DQCXphEREVE3sGjhcRROgnjmkllbMDE3paERViMg2jFMwrqFzdbmO9febHlNOxTttjh46w7sMjSBUhDAlu369bo2eauUY946NNNsuZ/68k+PP/+N3PjVyWKNHXb3GQGCaSB2IEhUtVCtFqq1Ys3/N19cIiLaWeyb+ziyXXKnZ49fu5of6k1viXGVEohtthDGuLblQiqe6s301RdvwAlqXe4VuAStGoIYV9kaBgVAlEAAEU8dnxnPOLGVExe/tJw7V6whCIxpj4oEtQDq+XoFFQC1Yu3M58/cefdirXh+sjMGr/TVUr6e9x9YqjDqJSKibuOvmsdOWcoFVGsonnrvZmPlsOvE7e13FioAgCDsHaaVXlxfvHTjHfmA+98pKOT1s7lKFDpL3AAIdG/fypHBuf+8+K3z1cL5WpEjgvcEQalSms3Pwo72iCifLQMoT5V/8s2PZBvJ5Ep66NZwvj4MEf9jjIJSmBu+VR+qz+bryc2e1dTmN45/P3xguKktQTNjXyIi2lb8rfJ4EZEKKhdwof9KO1M3qXjW74wAhTCLe8dDwnVpnvHeu/72emNNax386L7fQoKw566tYAiWuokxsjQ++ETj/e/N9OXr+eH6MDsw7BpBoVqw39aKtfLZso1KS9VC/1puI95Mrvbk63kFINUebQ83WnUdcz3X8dotLXGl26aFtjaJmBaNrBdbbhvt6DU9uK5nnHUHQCuzEc8uN+ON//uT30QkaH7pSy899d5TfPWJiGi7MMx9vHxVvlpC6fdv/ebq5bdS8bwLHcx1CNJwd4StYemCiLiOe21+enruSsyJRUsaHugYwnBXiS3g9ds1tNWmt9Lb9/bT9m6MdXZOUI0wXB8GUClVJs9Pzh+7enhhYC29DmAjtzK60H90tn8tZSDQ0ICB0gBgBNq22xATGYWnBHBEifZ7zGlAIEaJVlo8HTMfXXa+cOxqo5HM1/Mtg5Xkhl5P2cxu5XRlNj/rp5D5f1FERPSw2GnhMSKCNRz7DVwYvpnULcdRfpdcP/AM07p3E8SyKubEltYWPPGCLmL4gEfdfVORQWp+k10oiGhxnTgk1nSWe8AREjuiXC4XJgsD8wPvPf1efbj+yu++sjRx/dSN8Xi68dStQ32I51fTg82e0cW+TCvVcqA7TeQ0JKg9EUAgdzaGE7+9hhKIsfGvKIGIMp66FlP9632DG6m0ozMaS5uxQ16i2b/sin7yzZO2qPelL7300gsv/dynfo7vBCIieghMlTxGbMzxv3zp57ODz2XjGdswodNdQd21ZiF8rCiljDGOdq/UL84u3XQdFw9at9DZXKRgNyiY8IsZoJ1bvfErY5XTlUqpAvBN2h2CUqWUr+eLtWK1UK2fvNi3mu1b6Tm02N/ObcYEMCLR4LVTZxKkbO/7hbdT8SR8YNAqOSyGsR+2lJa2ijkrsdnehYWelcXsav7tJ4u1YqFQzefrpVKFyxOJiOiBsNPC46Is5Qoqr/4x/vu/+yf/zw+f11pH5zJ8QIwbXS5mGzDk0n3zK3N24tnD1S3YdmN+bO23YLA7g8C08/Mm0fR61gBMAufYfmH7hKUglUqlUqqUz5ZXxq9NSOLJ2SfRVDBGUhtuG2I/ekQfaYtLBLZnMmTrQsJO7Bu2k4sUMCDyEsPvqSzRd5YIAPG0ozxJeflWYmQutbE6LBJfnrhWqxWnpsrnq4XJc0UAXKFIRET3ieHD48LOg1j8N5d/7MRRNxbXQYSK+8vKRUMaz3jvXntzo7mhtFJhVvYh3kvBaOCwXBf26reChvrBkfe+9GPfE6AMnAXfqttg8tykXeEH4N0XvhUT7Rg11EoaFfTBEIkEqP6Eu5BdjBi0iINNyH/4R5CtWVwb5N75lrGBrupkeu1fpu3ExvWGq1rt7Mo3ro2Ex8/SbSIi+lCMHR4LNsZNzXt9dSe1GXP01ka595eOjY6KmJm/en1+xnVcf/DDI7yRRKLlughzf6LgHLk4PXb194bq/l35bn04wScU271rYqkvHvdUfsW0bUC7JS3bKSNB+L/gR5HPRQ+19DAIkINE/taN2ztFZ4gEY/W0OIIVZ800k878wMCVifBRDHaJiOgD6A+/C+1zIjiNCoDcTa1XGlrfHp08aDYXQH920NU2xlVKbrt8/WCUH1iFq+AkWJSmvMtPZV9/7j96owBgCndb5EQfZvLcZNgg7MT88IgrZmDODCx7nogApjPNzhIl/igPgbLzn4MfhnfDA9TldoQPU8HSw2C7yq6D9Etn7IBoOyoaSgRi0DZIt7MZ5aTTzdYzV8z4HAB5+dyUAHxXEBHRPbA29+CzM8+u3TzRvDnqDmRVEG8El57vS5jJA2AnouXSvfOrc3Yhml+58NAltDan2MnpSrjeKbfc9yv1gRLw3z5TKyO4Ak73QwCgWq0Wa8VhL9nbih+fO6RdT0Qr4ydNpVNv63+MsEULdhae/2R3+wkPth8MDgkqF8Lx0LaWQQAFL70BtRkbNvkjl/9JsaaAUqVUKpeY1iUiojsxZDj4viqlCyg9e+n6yuJI3IkDKnjd5UGzcuHgX0e5cyv1y/WLtl3DQ/fQ3br1sNozMpJCQUOe7llUH3ntM4P1KeAs37MfKhhgVivWfuHrLx5bGEon295GDMbz+8f5i8g6n062vHa7OHM5DLxVEHrbQdHK9iYLw19lHHEPzzgtx/3ST4ePZrBLRERR7Jt7wInIJRwbXEjNrjTjnhu5AG0vDT9AdrQTy0IB0NpZXl9sm7Z/sfsRY1yEiUQ/exfZmpprpZe099eHrleqhReHP8suqh/AhnqVUuWzv/HZY42eidaw67XQclRwcV/5z7H9SBGkzYNoEsCuxbjhrpUf70pQK2zfGMp+8T+oKbPcI5sDXnYFntKbSbDXMhERbcXM2AFnKw2+d6Py7et/0eNmEKlYwINXWG5ZgQR1efbi3Erdcdztyeb6+0DYaDVIPQJKlJJxtzH3zU/O5mfr+Tq7St1V2EvhynOv6dTmUCvpwfHzt/A7gtkKWP/FCvOme/P/CYLDixS0+AF50LpXDJSznnSXcu714XMvn+PsNCIiCjGbe5CF1bRv3frOenNRa3/smQ1xHjoktZWbWmml9fzqnPJ7kz3wOLR7bB1Q/no0u+ze36aoRYlt9Czf6FnO1/OcjHUn+2p/ez2THFxK5xYzjazYfH2YEw2+Cz9CILhxj4occ6dqWCIzqW15ecJDz+rMkStf+fTXAZQqpVeeeIVvDyIiYqeFg6yCCoDKrT+5NFd1tLNlTfpDrU+30YVN5Rox2VQum8yKGLvFR2y5sGVHtutCkM/1yyRE4j1rE63EcH24crrCJfYdAgjKwGSx9qnhhWS27TR6t9Sy2udQlL+wLKwN2C+CGNevJ/dz0f5HNTHiGZVvp37hey/87Df/dulCCazTJSIidlo48M7i7JH5nBt3OplWv0f/B432vZdocYKIOEr3ZfpXN1cR7cL7UFu+XXAlXYLl9/bIRbnJ5PrVT37HnwNM6Hxi8WbG/8/LT9VX+mE8e4tNgwo6VQq7uLrsUdmcPjpnYvPTtnRXoCByamZMp9PNo9fjl0dOnz69PVU0RES0b7Fo4cAqS/kyLnsXV1/9/uunBoeVcvzZvJAwDfagojEugqTg8vqiEe/hB//ec2c2geenH+FPGobn6KGN2JErx/pnxnht2uYsLx279BPvFpzpY81bg0GiVoWzlFWk0Hm/R31B312IPZ2w33IQ7Jt2W6XWDh8dPvPTrwA4e/bsbh4uERHtqn3+S4/u7avy1Qu4MPFOn7My57hJ2/nLHzGmHinhGq1MEJH3rr+1srniaGc7F6J1dhBNRcK2VdVKnNV07O2n7F0e28vT4Ym//+lvHVYZ2RRbvdApa/ZrnLclwb77tn7Egr9OMTi38G1pR1A/MVDo3Zh482+m8Ri/Q4iIHnOszT3IpjCVdbVyY8HiM9un61Fjns4cLIHruL2ZfhHxF/Nv+5r9IMa116WDK9fK5DYbR2YAPLZFumHotnH0aq4t2AAMVJjgFPt5Bn5Trl091Edk49fwa9DAzq8RD2NcgVhtz2t73uXFN67PfxdAPj+7q4dPRES7hrW5B1NZygC+cO23bs6+M5AaCebk3j4H4KH57VYVjEhfduDm4vW2afsJ4+2PdO2kCBXODhCBMaaZX/zeM7XK81/b1p3tD5PnJmfrs8P14c2j15pDyymTDXKZnc5bKnjC9p2wABfRBnbRM5HOakhjjMAopWNOLObGE7FEMpZKJVPaccy0FArV5eXCbp0IERHtLoa5B9YFXOhvef3xfNjyfxuDHr+bLZSISbiJXLpvbrkODfGHDWxzqNsZ1AW71kiJqBgk7noACtXCmfKZx+fCdLlcnq3P1vP15MCy9DdibSgvmJHrD+ndx5W4QX0KwuVyW4phxH7METFijHG0k05ksqlsJpFNxJIxN+46Ma0VgGa72R7z8P4kCtXdPiciItodDHMPMke7t0Wb2xXpBu1L/ZU/vZm+hdVbfhltZDX8Nuwp4Ac5dg/BnKxnro0PfvHnj33zk37pwj6M6h6YoFKplC6UMoPzmcTaRsu1Bct2jV74SWAfPRvRitsttwD29Q7fSJ7xRMTVbiKWSMXT6UQmncik4mnXiSmlRIwRA4gxBlDKcZqpWG2ylrvauzsnRkREu41h7gFkKxbS815i3dHajcwAkG2LPCPlsCKSiqfjbqLRamzb4N87RKbABouqIFAYaqVaP/OVygtfmwIek0X1lVLFDM7/1NzA+vIQwqLoMIcrYVuK/eG2N0zQ4hdKQZQy4v9xtZtN5nLpXCaZTcaSrhPTWsPWLYgXzqAOy3a9xmbP0NxN5McnvrGbp0dERLuHS9AOoDzyAHo3M87Kpu0sFbFt3b7ChK5AEm4ilUgbGAQJ4+2aE3HnfreG2HBETMwTANXCga9bKEu5gAKAv/7Ia2urQ0DwZATN14D9UaggwR8Rf6iZ/12wXs6I8YwnxsScWG+6b3zwyNMjJ4+PnBwdmMil+1wnBsAzxhhjH6WVDgJlOxJDvLgelBtTKBfAogUioscUs7kH0FN4Ko+8UovLznpQ4tiNKgI/KDEwWjt9mYHFtXmJrHXbxn1F2X4R9o9N6LZvHPm1Lw6qb/74wS5dKJfLqOBM6cwP3/rqibfztmbED/zFz4AGN+xR0foEURLt+WF7Jtj1ZBDE3Hg21ZNL92WT2ZgbtzP8BKbttTqNPgC/siF8N4YbBza89VhjCUARtd05WyIi2m0Mcw+gcYwXUfzDjX/tKB3tJbW9kW6ngymUMV5vui8ZS282N+yl5O6xRQsqLAQWAPL+Zmzp2dcrpUqpUrIjjg+aoCS32Zg52RyWIKSN9Mfd071x/VIEFXkTCsLJHyJixEBU3I2lEumeZC6X7k0nMgBsvtYYO1AafqGCH9nb0hVbp7D1g5Vgbml2NcPxN0REj7W9+3uRHpqIfPni71dvfmc4M6CUi7u2ZNqmHdmN29LJ6VuXbyxcdxxHbP8vdG3Uql3mFjSdsu/iurt55FuflJfPlYu1fXHh/sEIAPyDL//sSDvlesoOurUTM/zuWnsvjX3n2rItka5AIHbRmFZOT6qnLzuYSWQTsYTWjm2lEJ1rET4k2JYtQ1bheXd2p2CMl4n196dGS8d+kfN+iYgeW8zmHjQ2qmh6m/3ZXtXlYc5bErpicune+vLsbe2fuhJ7dYIlEbH9F9DrpVovfeV/KtbKXdjh7po8N1mtVkfXet1UM7aUMbb6dI/HuLjnSDz7bjHGuI6bTWSzyZ6+zEAmmYWCGBGIMZ69p9+JGWENb6djLhAZAb11Mp8CjJjD2SMvTPx8V8+RiIj2OC5BO2jsJftm2rgqhqCKUYJCzu11WxOoZDyViCWNGMA2txJ7Sb0r/OG//uBiAZKiPNdTOHBr0QTVQrVYKxauj48uDYooBaWic273TowbLCOzQ/HCDyLh8jK7sMwzXsyJH+obeerwiScPnxgbPJJJZm3gaztoRN+3naVpfifgu5+qUiqYZA0RaZl2Kt6zcydORER7ErO5B00d9bM4e9I9BGOgOh9julG6GU6issFWzE1kk9m1zVV0Rs52rV40CGnCGwyMmZ74lda4+vKzON2dne6SWrF2YjGfWBo2bQN0ntuw4HXXReeW3ZbBteGpJx4EMSeWTmRy6d6+zEAilhARI+IZz/ahs1uyC8rumgn+gPKDIKT2B0okkonF+ls4dLDeB0RE9IAY5h5QAr01JuheyOkHuxAF9GUGbi3f6sxIC6+qd4mf0hUlSkSUNocWejGFarW6h3Kcj6BcLlcqlYF2IhtvK890rtPvnQj3HnPL/B/Bz8Wm4umBnqFcKpeIJx3lCowXViYE7W/tP4MFhg/5thFBy3iXvvDP+ib/RRXVIoqPfoJERLRPcSXygSICoDCJ8o9mXzWbTaU7wxq6FxL5AYqCiCRiyZWN5UZrU2uNoIS0S/sNor2gs5h/mXvze8nX/uj4F4H9Py5CAKB0odSX9HokBlFA5AXdvTjeLxaJFMv6kW4wYdhWx4pI3E3kUr2jA2NjgxO5VK/rugBEDOyZ3Jb0tV+DPw9wPP6R2EeJEYkXPhZ/9tkaap9Sn9recycion2E2dyDpoizr928/PaV9JMDo+GN3WizEAoWgvljuHozvSsbS35r1O50eIjs2/+702RMqfgtD0ftrfs7oTsFnC1V/lai7dXHFSQMLrv+rH6gzkhnvy660zlBKRi/A5j0pHIDPUPZZDYRS2qljRgjfvpW6c7Csui5PPQZqbDphgCAKG8oX6ih9jye34YTJiKifYtL0A6Uq1fHAdycuzHe26/DwQE7GA+JMdlEj+vEEPT5smPSurdH/wq3v3uIoHjj6Is/+ASAQrXQvf12naAGCODFPQ0Tpsyh7Jy5XYhx/WOwa8tEBaUi/pPvieeZdsyJ9WUGnho58fTIyXzvoWQ8DcBsTd+GC8u2JV4P6yKCf6pmSxxxpjCVQOJRtkxERPvdfk520R2+fmVy+lUkfmzo+tpAxkk7WkvQi6Dbuw4vYRsxF6+/s7K5rLWjdibOFr9kIizrvN6zvHmr9xvPf2N6Ynq/vscFAH7lypPDtU+ZVvv2VX07mKjupG8R9POSoF+YHU0mRkTSicxAdiiXziXjKUc7nvH8lz4oQYgOKtv2gXxhbztPzHqiPTr8TE9/voQSm+YSET3OmM09UKbxPCYnVzCRiae01sGKoC2dv7ohuv2YE8umeoyYcKGU2P5S3aOCIBs2DsOhVsbtWZ+emC5VSl3cb9eUy2Wbip6vH5KWp4L1fOGqvh2IccPWYH41iKiwRAEKSinPeMbzHO3kUr3Hhp86MfrMyMBYKpEGYJeXaa39mHhr+4VtDT0lGuMK0Go32tr7Xn/tAi4wxiUieswxzD1Qlid6ATR7U17b8/N/NkDp8u/76BI3gfRm+uNO3Ijxb7QJ5e7xU4x2b0qgnJabVap8ttzFnXbZmc+f+c++/B8XbkxAxO9EHGSsdyaPG1lY5qfJw2YdxngtrxV3EyMDY08ePv7k4eNDubyjnbZpdRomBF1vo3W3XXgfbm0nAllXm4eyR04fsJZyRET0UBjmHijjGK+h1oucX5gbdCPYgV37JbIKxphMIpNN9fgJtrDHa/eEAbZ/YV0gGGup8RdenfK7T+wndrZFu39pYmHQM5690g9/tO1OxLjRoQxhIl5BQeB5HoB0IjM+OHF89NTY0NFssgeAZzyBaKXDcNZvB9Gt6LZzsJ1vFcSYfP+Rl0c+A6Csyl3bKRER7Q8Mcw+UBBJTmFJt48TdSKC7E2y+Nuy30JPK+SWkQazd9QNAp8WWGFlFYjHRKJUq5/fnQjQ5fLOd3bAn5F+TV138wBJ8PuhU0EYbfolI22sLpC878MShp54aOTk6MJGIJdrtlhGjlNJB67rw/tF/duuY/e37by8RaUuzP1E/i7N5VLq6ayIi2hfYUOxAKaH0x9/945bTEm2UDpoi70ygG8SyCsqIySSzro6ZYATADghLV+1XV6TRjp05Pzn+/Df2UWcxm8o1YzOx4Wvt1bwI/DZZ0Sh+u9kabtuSC1uLImxaN+bGetN9g7l8b7oPwcxebO19e2f17Q6UynRqsgEY0/La9djsFH6rglJXd01ERPsCs7kHilLqW/N//pff+oGJJtJ26qp90FfBnxORiiVtqq9z+burew+CHlsgIdAz872NgYX/fWJ633UWM/2Lm0t5Mf6ADZvPxXZ3JwDCxWG26lfsMjObg/eM1/bacTd+eGD0qZGTTxx6ui/db4wxYvyKa6WC4b5b1oHtzMIv8Ref2XOBAsSRvsGFd4fGqyiUmM0lIiKGuQdPJpt89qcSUNpP/e1o5ynlD6MCXMfNpnqMsYungB2IfiRIeYoffmXjSGiZPD/Z3f1uH5vK9cZn3MG6aKAz6M1Pt27jvu5SPmsnqwk88QxMOp4eHZg4MVYYHzySTqQF4hnP9lgIJ5+FHXx3Jn275fglbMssAAykYTaGc8NTKNcxzBYLREQEFi0cPIOHkjGdcB2nM1BgpwQlpH46sDfdP7t004jR0J1GVN07IBVWBvsBoXJkdGVwPa6LtWINtW7td7ut96zqtSEVlIAELWq3IZsbjisLi3yj+VcRMcZAoSeVG8oNZ5M9iVjCGNP22n4Uqzvtb3c+fXv7uWyZC4K28XJ946WBf1wFSvt+yjMREW0PhrkHTdLJeNJWXV2vdC9iyxYEgBGTTmR6krmFtXnt+BcNdqgVVodKxGKXDr3/Rx//+j4ozxVUKpXBzZReyT5ptqRubab00ffQyeBChU+ILTnwjOdqtyedG8rl+zKDWikJCnB1ZDZvdCPYpQAXCOpw/A80ImJ1YegAACAASURBVIDS0paNszh7GiWlGOYSERHAooWDx1WxjJvrbgOve1Gdi9cC0Vr3pHKRZUk7cgiRIEyMqHajvz4IYO/PiZgCKqXKscM3n0p7fibX5nAfecvRMtzwG5sLFRFjPEAN5fJPHj7+1OETA9khQIytC1YqbH/btfkOD2Pr21sJzPtzf3XFvQrgAi7s1lEREdFewzD3oMkgDUDtfCoXQGSdme23kE5mXccVMban7g4kmINpWBLMRMNYZrl8tnw6P9vtXT+KcrmMakGAuBc3xomUmzx8rYKEf4Iagy2VuCJtabuOO5jLHx89dezQU7l0r1LKiEFQqout0S32QICL4LzCkgmjpGnaJ459cnO8D2yXS0REEQxzD5q2tPPtfunq1LF789OoAAARScaTyVjSn90liFaFdu8AgtII/+vgSm5qqlysFe0Cr72pcrqiPn/mf/jmT3j1CQVRYVEuHrL7rH3Owxl4flAYVOS2223HiY31Tzw9cvLo8JPZZNYYY6TTI0zEX/fmP4mRxmG7y55R518AjHmyb/g/PZZ9GfusnwYREXUbw9yDZtNbu4TLuzv7y89DirjazSZzRoyfyu321F+730gDXQXc9Nzf+MpLtVoRRy91e9cPSTCbny1PlW8sDKi2/1EgnGD3oPGliASL1vxRvRJkc40Yz2vHnPjIwOjJsWdGBseS8ZSIBBlcjU6LsaBL796Ibi0JZ+pFBmY0vfZodgKYKiLPVC4REUVxCdpBU1+/pJMp14xoHQQoO7z6KlIdCyCX7r25dF3E2BjXVlV2dS1adEiEArRyWqJxurJnc32lSqlSqvzsqz+Rb8c9G3D6w5Mf8HnyU53BkIegkbASMSKe104l0kO5fG+6PxlPAfA8767zHWzWd4+kb6OUdP74HwLEZHoHTwz+fBXVIkdCEBHRVszmHjSN5vL89I9g2v6/dzyrqyKJZIGkE5lMImvEhPnJrvdbUJ3IXgTGKJNqTpUq1UJ1lyqWP5BN5Z4tj8wPmE49bpi6vM9tiL2/32XX72krSinjGU9MIpYYHZh4euTU4f6xRDzpiTFitNK3rTAT6fqHkEfhJ7qDjnUGZm551s1mz+JsHfU9GJcTEdHuYjb3QBGRyqXPLaYXV9ur/vDdrraqvSulgnFoSsS4jptL965urEBFk6zdPiQVueyPG42Bz1x98ncmLnZ5pw+jUC3UirU3Ln1ncC2FVDjWVxRwn89TZ9WdvX8Q4nvGE5FMMjvUk8+l+5LxpBG/Ca5WSiDRtVy73CDsw3SOsLOQUdpGegYHzXAmjzwbLBAR0Z2YzT1QKqiUjr2Cnp6YGwtv7PaU3TtFihaUQDKJrKMdP2rbmThKIRynIBA08VYjuSM7fhiT5ydjiWYmafzKjjDr/WHC7Ka/bkyJQATwjGfEpOLpscEjx0dODfcdjrtxG/VqrYMVZv4wM8jejW5DnVg8iOM9Mc32lVafW0c9z6pcIiK6G4a5B0oDjbM4K65uNFq7uAgtvBQOQERS8VQ8Fo/2WOh25L21rSoUANPVHT4sAQDv0OzTC73BFAZ/iptSdw90tzTBDddkBcUGxhjPtNKJzET+6NOjJ0cGRh3ttL12dOxZsMIs+Ciy10Pc8Ji3tP5teY1YKn9jpFVH/Yw6s9vHSEREexHD3ANlGtMFFJawFBbIPsRS/W3RmRMh4rqxTCITBig7kT68bfOC4XoeQKG6t9ahTQG1Yu2ZnpX1RBCIh2N979GSwrYYCxK4sIUKSsEznme8ZDw1NnDk+Mip4d7Dro4Z49k5Hfb+iLQG2/sZXCvyBu4ccLvdGsHRJ2Zje7Z5BhER7QUMcw+U3NUlAPHlTSfpwk/VKQkG8O6kTvoQoqB6M/3hj8KlTt3lN/BVAMQzBUH5bHmy63t9EIKaXUzlxYMhycEStK1VuVuml9n6ZuXfXxSMMW3PS8XTE0PHjo+cHBkc19ppe217+n5mHVsWme0ffufg6JF7YtLvPvOzH/tMofDysUucB0FERPfEMPdAWcYyzp/fRGNtY8OIUcGa9J1P3YVhmh2Hlkn2JNykMWbHIi2FMC0KQB1ezU5NlUv14R3Y9X0qVAvngX/6g4+rGxPB+qowwt3SraLTGsxP4cIOfTBijPESscRo//iJ0WcO9R2OOXHPtAGxJRBhSevemdP7QPyRxJEnxMCsrd06dNIAGB4uvvhieTePj4iI9jaGuQfKOF6tTRbTjYsx5fgrkrCbObxwvzEnlkvnOoNku1+ea+NCGx2JQjvd+PN3PlIqVbq60wcgWM4tT56fvLmQ9+wLFWn3u2Uog/ixr5/CDfoqeKbtOu7IwPjTIydHBye01p5p+/cMXvEtbcL2VYAL/+D9acfBe0Vanjjp2M23vlCtnt/VoyMion2AYe6BkphoTKE8ODA2e+VKGFPuVozbqQEVACqbyjnaue2n3d0/OpUTF9cO/R/LPZ1JxHvA9MT07PGLw2sDxlN+lKsUZEsttd9eQACFsImuZzxHO0M9wydGC2MD4/FYIpjTqzujeiMFuPsuwEUkQA/GFAsgbeP1Dh2+9mPpeiFfq53fj+dFREQ7iWHugVJCpYqp/3D0fz76zEejY3V3JSCwK6XsjF+BScXTMTdu50QEsUsX9x6Mg/WLJ+LN5mB9EECpUuriXh9QQsNVLRU2OLYdFvyGthLNyNp/e8ZTwHDv4adHTh4dfjLhJtpeO0zW3jboYf9GgXfEuABU23hP9bd+afwzL0PqxeEzZ5jNJSKiD8Ew90BRCjUUz+Ks6YlBC7YsPNrpNKbt5OqXDYjEY4lELOnXEgAA7nfG10MRvymsn8pWGsmNZPlsOV/Pd2+n90sA4NTV8ZGFvttemE63L7+kVtk1WJ5pa6X7swNPj56aGDqaSqSNGPFrcFX4wHA7ByfGBaAAZfKZWfQYQBXBZWdERHRfGOYeUMr2p4qWeO5GWzEJ2opBHOX0JHsQthVTUN08pMi4NaWUirmqdzkHYHx6vHs7vR8CTJXHAXzijadGZwfgQdkByAIohTDCs58BBEY8ERnoGXrq8IknDj2dSfbY6Q8I5s0BEq4xi64224/uEuMCnpibK7feT/b8Rb9bQQk4u6vHSERE+waH/R40eeSnMPWH7d82thA2XLyjdmDE7h2C8lgbdOYyvTcWXT/G7fLUX39ugp9OVtKWRrJxuVDNLee6tMcPP6Tgm/LZaaUm64XF1gBUQxkIRLQXPCNBhOeJp5RKJ7KH+0d7M/0KMGJETBjLRssV9nV0CyAIcW+PcQFprSyp0Ux93AVwAaUXVWX3DpKIiPYThrkHTQklAPGGs4q2Iw6ibUd3MRBSEDGpeDqTyCyvLzva6fbBqK2NuYyWRnwTbbWcW+7uju/h3ORktVot1moAKi9+7NR7C/2xnrU+oxtKlGwMqI1BCKDbgIZAjDGZZHa491Bvut91XCPGANpvO7YlwMV+LlEIdd6kkVoFEdPyzPp4aumof4IsVyAiovvHMPegsRHPr7/2q2vSGFUDaudrcu84nk69KVRPqm95Y7lTntu9hK7fi8rOg+vkdXdFuVyuz87WisWVXGoj5V5+esRpO7mLkvNEewLAi8vKCGaLupEVtEw8Hh/qG873HYo5sbBEQSuIBH2AD1CAi06tQuS8AIGI01obUHNjjHGJiOhhMMw9gMpSXrjZ7F/KeBsm2sNrVy5t39bOLJPMONq1V94R5ly7tGsVzhXbtQi3XC7bb+rDw/HWykrPcS0teOIpgQGUMjEA0J70X0JiybvxE/H02FA+NZRMZASmbdr+QAj4Vc1hZHsQAtygrzMiVbn2GwN4Hlb79a0xOwSZMS4RET0whrkHU+tQ3Gsqs+45cMJoaFcCo2gVqUASsWTCTaw31xzl2KG13RvSpmxDMyi76q0bu/hgYYybXl/Mrcwl2qtGadstzJ57MPYMolU7ieScOfb9WPz4GBLaeG0opZWWSOs1FbZJOxDC2SWdN4nATndbXFky4+mFMf+ejHGJiOghsNPCAVRAFUBWTxsRowSRZT27Mioi3KmIibvxVDzlR25BXUG3dmqjSEABWqsdXoF3bnIyPzsLILc0m1u+lWisGXQqDWzLMNvnzZYiKANJOjKz2q7NigbuWFu2f2c93Cnyltj6zlSAMivLuj2aXjjq35kxLhERPRyGuQdQHvUplOG2rixd0gbRmtRdTOgqpewV92y617ZZuGNN/Tbv1C5ogj9hTCeacQA702mhXC7X8/l8vT46/W5mrZ7c3FBhwUEw6kyUKOUPa1OilJ1tC8jMqt9cLHhi9nubsDsESdzbpvQpeDDvfOFX13ouLz3h38YYl4iIHhrD3AOohMp5TF4+dKz/yLiBiYaRuzX41yZSFZQRk0vl4rF4V7uJIZImhNhl/M3lnuVirTg9Pt29ncK2sQVePneuPjy8nEskG2uJpgflZ3FFxEbfdkScfYhN7sKullOQtRb2wkvWBSL2dMIJdZGmCpBmu7W8OZ18+R+t/dhhe3/GuERE9CgY5h5AdhYaAB2LwfgzGHa5tWqw2MiIibuJbLJHTPcbnPmhFAQwba21V54qNxKN7u2wXC5XSiUAxVrt2de/7Xib4iqxaVmBCvoIB0nc2w9X2bsl3INSfHsbG+oHDXKVRKtZNtubq4Ny68cPbRb9YgXGuERE9Ii4BO0gU21Z99pZ18VuL1sKG/faZrY9qdz86nxXpxsohaA6FwBctBaG6gAqpcr27ihkF5xdKJUGj4577Y21pFJiTFiB7JcL2+PqvBoq/AAiEA0I1HDaP26NcFTyfp8BEayc808imqI2aK+uzjdHswsT/o0McImIaFswm3sw2UBhMyEq54ZjY63dWoWmggVYAqQSaddx0WmO1YU9+l/8Tc/0rs71LHdpX4gsODvZE//I537vtZgRY0RsDbK/xioMccNDsPUU8BekKWkb5OL6eL/9of+QIPOJoKAZwC72AH5Q0XlmtydxIU2v2Ru/cujorYWjfuc7xrhERLRdGOYeWKdRWR1VA8lpz/Oit+9KPtBfceX3fzVxN5GIJezUg2gEvJ1ERb5VaiP970++VaqUtnkvdvtAoVrN1+vjM++g+urvfuaXRCl/yIHNVitlayei6Vi/1Vk4lBhQApV1zeGUtDx0emxJcJUfSoIWs1DRRmN7U7Sdgl1H12n1oaQtrY3WxmYW+tDi3xv9vdOogDEuERFtK4a5B9kUygPJw82NDVHGr4kEpGvNDT5EZJ8xJ5aKp7tatBAtC1DKLGZXymfLs/nZ7d2JBKdVrNXS63PKa24iJn7Q6kewndFlWx/oN82VoG5ZBI5O/4tW7sv15eaSZ5oiRoIHihix4W0nuesndcMc+R5hj9nWqAQBeliooAAxYjbbrff/8J8txW7efFoyfXUAJVQY4xIR0fZimHtglVCpYurFfLnv0IQfeAFhN6udP56ghZY/wiub6vFnH3SnrZgdHQsRJRCloFCeKm/vLqJH/PVPf7Se73VgEPQQUH4Mq5Sfxo7mcSUoU4UEPcUgynFc9x/0/8JC7sX4T4z1nFhZu9Xy2m1pe/D8h4tIJ7lr65w7zbn2Qk+GMNOsoIJhyxK2xRUxLdNeba6tNmYSv/zK6kdGAVxAybZZIyIi2l5cgnZgKYXXZfIszn468czG0gI0wkVQkdVgO8fWn/rRmjG5VG88Fm+2mlp35bNWkC6FUnAVbuXrAGrF2nZt/9zkZLVaLdZqNw4Pvf/kxDunjnUyt2GgZ7/bWoyrwjoFqHBdFgBPm5V07uL46IlCofjc3z0FoKc2t35lfnPMLK6lYtlYLKaUFhEdGTMRZky3VggEYfaOvMSdxWWR3Lzg9loUz3jrzfW+oVG3x313KB7eziQuERF1CcPcg6yO+hSmft/9zeZ6PZnJR5O4aodCoA670sqf5mpM3I1nkj2NZr3blxRsSL+9ic5yuVyfna0VizMj+UbSmR/uD+pPEXTHDcPMLWnK4CnwI10IbL8xgVnLDs4PjAGo5/MAgPM/lf8fz6L8sbkTY9nhxcat2tIPe3VSazeoYwibzt5e9aGi/Wi7nLyXaDo5ksFFZJ2cEdM0jbXGwvDhU//J0X9yFmf9p5EBLhERdRPD3IOshFIV5Xfy6pnVzY3ldkzH4Ac/nQVhOykMgGzg1ZPMLazMoQs9ff35Z7Z+VamNNZxMbH5tmzZ+bnKyPjtbHx6ObywvY9jt8cJwE0Egjy053OCo7JegSloFhbdKq5X00PzguL3biy++CEAEFZROo4LB059ACcDijXXTamnjNeZn2jqplaMVbCSLsGJBbal1lnDi8fa/3EF7tDDSDQ4l+onCQIzxUuvzxvS72cNvHq2fx/nTOH0BFxjjEhFRt7E29yBTStVxYQrlfO5QSxkJOhv4oc+ulnIaY1KJlOu4W2Ky7aOCbKJWamJ4/rePXZyazT/iNu2Cs+e/8Y18vT5+9d1Eey2W9fyUpVLK9g8LUrqIVONGk5u2iiFsOaB1s+Uk54IY1zbftRt4UVVeVJUSSvaWwcNP1Cau//LRf6wnjiz2ee85Ta9tRHsGxkCgIi+rQqeEN1zkFtbIhk3JHvT0g3g6bJgQVgn7m7XnqCAQTzwor9VeyeRm4oOt1LVT4vYBqKH2onqRMS4REe0Arvs44ERQxVQR5c9f/s3N5TkF584Cyp09nk4hqWe89268vb65prXezoSu3y3XTzcqVw6764ux9QJw5sXKo2w19Gc/91Pz+QFPmfDGoOJZqWi33sjh2ODW9hCzSU8lqhFvKWT7Ftr1fL4+PBzGuHdVlvJpnK6jXkMNwKmbx6TdGnL7Fxv1pcWbCcS049hxuuFsZbv7257YoAOvLXzwG53d45QjSeewyuL2rQU1FOGDNLxWs5nRnjYbGVk8rKZQrlYna7XJM2fOfMAJEhERbS9mcw84pVBH6SzO5rMTpm2UP3A2qKeUnf6cE4ZNCNqKGfHb+m5XI1jbZcvvm6sg2vmRNrhQql069tDbDKf43jg89PVPf+zmcL+njNgnM0hndqY4bDkYv8Ot33nBJlkBpXQj3tpI5a+Nnqzn8/l6/YNjXABlVX5RvWhjXACHDh39+2P/5dcOvf7ykf86PTY61+e9g802Gp5pixL/aQ5yrlFBC2M//SuIpnq38FudQXUmWAS9b6P9EwAYKGh44km7iTXXWevzNrPXn8LiYXUalQpKxeJ5xrhERLTDWJt78F3AhZfxcnGw+NcrG9MrbwPaX++PbpRsfogwIyhilFKZZLa+FKSWZXsOJwg6/aFh87Lx23/ni5PzPcVa8eE2GE7xXerNOKYxN9SrO50cgtA2jHSjJ4sgYxqJfjUgCgNzc56TfO25IwDqw8Of/fVfv9+DCS73i0gFlZfx8nmcf3vwGgZxavbo4dblPndocaP+zs2Gm0g40Npx7WeL8KD8HhD2Fgk+dfgT2m6npFNCHPlU1GlPZwSe57Vl4+mBRF9yCFJYqW9eu7zc7qvb+7yoKvd5akRERNuLRQuPBZt1e/vWd7/+/h/Ekll7pVrh7pehu3wo/vJ/AFrpzdbmO9feaLWbWjt+0TAerdOZP2uh02rg7f76R//yxXMvn6s9+zDdxMIk69Cta7mlDRNbg19rGzx/95hvYdOf/oCzznQEUaKHb8yeevPisUszlVLpQqn0oXncDzlC8R9+GqdLKNnQ+htv//MZM7vQOLS5udmbiSlPQUOJUUrbqHdr7N2pOQjS7WHFQ3C7KEGQxoUREa1dY0x7dVlG+gZyN/7e0K/ZrVSr1VqtBoDpWyIi2l0Mcx8LIgKcByYvXDp7ecl1tYNohe7ODoyILjXTSr934+2F1XnXcRFkGh/tXSkS6WmlHH3TXf/cS39SqpQqD16YG4lxp3NLcxJz7IBi2GYRwRN39+LWTn8Df1EYAA2dXd74pS/8aXivbXzeRQQoA0XgPHD+/Plztcna3771ib5WztE1AHXUv3bIPPF6U9px142JgdbKCJQorWCi2VwRaBX+LQIPnhjTlOZaY+6J/ucOZW6l3LwYs+kevzq8WEPtZUgRRWAS2NkPTkRERPfAooXHglJKZAo4g56yWm4D2paM7nyMi0h4bYxRWmeTPYurC5EfP9LGI526oJQS3V7I3wJQKVUeeFNApVK5UCoNzs3k1haMq0WMQhi6yr1mMPj1uGG2FwqA0kqJLGf63j/67MDcWqlS2fYnPXwdRVCtTuae/9LzVyd/auIlAMBP2ixvdu2r15M/TK0atOeavSvff+JfDv/Nf5dxsl663Wq1PA9GeUpp0xaBceM6ZnRLb17/k//1I7/035jDg0lzq08Wn0lePjH4z8OFZ0v4Uh75z6P+rGL6loiI9hAmXR4Xtg/rBZQOvyXZdkyJg6CDrUR62e7UwXQi7NWNlfduvB0ewyOG3Z0tA0pjw2BdZLGpz585/wAbiXz/hZd/biWbUsr4KVsF3LtUwQ9qOwllv+JVQSkHLZ2aHn3a3vMRCxXu90Q6CVp7+lWgDOD8+TP5fLFUwteX/ur9jZy0j9zSeYEY2/c2LGBQGFazun71Cb3y6Y/89HkUaqhNoQxMAQBsrTPTt0REtEfxl9NjxBZxZq97+tJqPjOklcYulS5I0LsXQNtrvXP9rUZr0x7Pwx+G3ycraF0rYoCZnoXWrYFqoXr/hblhYHjp2Nibzzx5YzTvF6XangpBye1d/9ORcDQERJQSEdvKJKaxodO5xcb9NA7rKhGpVs83GstAdWCg99ixClA5iw86nimUgVIVk9NoANUE3iuhwrCWiIj2Pv6yerzYSLdwZWZz6YgTlKzsVqQbVtBeuvnewtqco10b/j5sca7f8gBBYji1iemB+d/6O39ZqBbuM8w9NzlZqFaLtdqrz39yZmx4NZcK1pspREoR/BkP0X0HVSCwY28ji+AyMb2KxJXRp/Ozs/l6/cz5B8grd5vN8deRr+HubSgKqOZRZ1xLRET7EWtzHzsvQ4pH/q+vvv+rMyvpaAL1jpavXbRlFZp20snM3Oot51G36Td19TuJacwNLP/M/MDrV8dfLd5XjFsul+uzs7Vi8d1nnvzBRz75xOUfhrMWIjNt/VVyd8S4QeMw28FAAEArlVrRa7lkdnkz784+UOOwnaEUgAqAoKqBiIjo4OB4iMdLWZWLACAm69XXfhDmKYGw9+tOTADekjMWySR6XB1M/X24KcRBL4PO1C5PNbR3ZvL8xHLufqL3c5OT+dnZ+vDwymCieSj1xOUfmaAWVwVjfu2x37FnW6IgNgK2UxkUREH9F7/zhUM3r12eeOo+B0AQERHRNnrEDBrtP+VypYLKv8/M9MshtWmcIFkZ5CJ37uK0Ctrkuo6zvL7UbDfDcuGH2JYfpwdNFlYbWNRmaGbszz71bZz9kEfbADRfr8dbS45e8zZhbMbWTjizpQh+t+G71yoEwbUK8rjyXPON2Ej7mb96B0CtWNxreVwiIqIDjwV3j6OylPPI55FvvndV1taVclQn0t25Il2/rZiYmBO7PPv+zcXrYfdcPFCwK/6X8MC1FnMrl7p0BPfR0yC8w/j0O7Hmmjga8DO04WSwe/RV8BO9ym+tYPv+AkqfyLz3wq99vzNb4X7PhIiIiLYNixYeR2VVziNfQOHY4LODiRE/TIzMD+ssoOqa6PZFkE74hcLWgwXZtlTA9qiFANJot9rtD39v21KE05UKgMH56ZhZE0cLIDaxHVRy+OvP7oxxJZLNhfgThqHzNxde+Jffxxm/7xZjXCIiol3BMPcxdUadKaL4E30/0+qJYaNpQzRbF9uJdNHFSDeMGhWUES8ZS7uOayfJPnCQHRT1hv/GZvZKbmkpt/RBDwq+WcvED9282LO+IHDCwgN/tkNQnnvnY4OuC/6B2q+OlpabXEsPVAsFnIc6yxiXiIho1zDMfaxVUPn+6PuLI6rhNUUZACLSiXSlu5EugpyuiMRj8Zib8KPtB96EP2zMftU6ZgTFWrGRaNyrYqFcLldKJQCXjo053kaysQoPYuCPf/CXlNly5Tt2iGC4mY10gyZiEL2pMtNjT9fz+VqxyACXiIhod7Gh2ONLKWXb6N46Iv1KGjeXcsleBQ0E1QuR2LGrhyFiXMdNJVLrm6t40AkRfu43mHOrsaqXbg3KD07PlC6U7voIG/teKJUW+pOOt7k40K/Elj0Eq9iUstHubY3DYAdAQEn4xz9aaCUNnexdbDRje7FxGBER0WOIKafHnY10AYxciTmzK4lEj4a2kZ6691Tb7RJmjh3tzC7duDR7MebEgiEM9xdeR7v+KgUxr09c/dOPfQu4+7s7zO8OzF1ONG4lmnGoyJK3sFzjjn1Lp3tuEOdCiUArEae1khqeG5jYgwMgiIiIHlssWnjclVUZQB75/iPHzXBus7XiwdgArtsr0sJRDvb7dCIbds+9z2KJ29r8CrCS067Tvtf9bXNcAIO3rvYtziTbMQnKEmxeNjIAYuuO/KYKdvwDREH845emTiynD80NTACoDw8zxiUiItojGOaS33ihjvq1I82NfNzzNkVMkNsMYlzbS2Bb9xvki2H3lIglUvG0EeP/9ENTuX4v26Ajgq0gwNI/fOup56+O3+U0y2U7pmFs5r2elVXPzRoJ+qgF0bySu3R5kCAIVvA76AKiRCkgodoDi8vz/ePhLh7pGSEiIqLtwzCXAOCMOlNHHcD8hPZ0pt3aCGPaIP4Tvzut/bNNlAQ1tZCYE8smsyKCoNnCh+zGb1QbpIS1KKgbfbfuOvnMBqD14eGl/oSr1pVuIex6Gy18uCO0Dtrihn1xlW295gjSq05qof1Ln/9T25KMMS4REdGewtpc6ihLOV/N52v5pZPvam8x7vR2etn6pauQ+y6avV9+5wI42q0v37w8e9FRGvdREBytkhWI0vqNkSv/7hOvBgccOa9OPe5Mz8qCcgwMjE3jdspx79E4DNHZD/68CA21uqoPNTZe//gnT1cqpUqF/yERERHtNczmUkdZveqecgAAIABJREFUlfO1fL1Qn3muudIbW5i5YVRQ5+p3GrMVux+eab1/YdQsYpKxpKvdzuCxD3qYAJ1uBwpoQpqtYHh1EHXaARAvnzsHYNDGuMqIgQkrFe5deewPgLgjxlWiNrR7eHPtl//dn5yuVC6USoxxiYiI9iDnw+9Cj5Pz589/6l99CsBmvzO2+qP3/u2/7j1egqN0ZyiYnZ6A+0m43hcJM8VQCkvrC23TtpElwr5edzzExp7+YjUF7Wh3vvfYdz6Wr+drxRrO+veyhuv1uaGM0i3bB3fLXGPYphL3qMdVtkTYj3GD+8wPLTRe+/gLAEqVyouVyqM+A0RERNQFzObS7WzvhdOo/MOP/flLv/xKtmU80zTRhlpKCe7akOAh+UMiYFwdi7sJBOncu8e48CsJopMk2p4zm10GUKwV7SOi6dkffPSZlVzCNkpAp20ClMidC846d/DjWpEg3SuQgbmFj/5g+hf/7V8wj0tERLTH8dc03V1wGX8KKP/Za//vbOt9N641dJAMhb2kHy4Xe5S0blg5oJWemb96fWHG7yx2r+65NlpVnTltb4xN//EnXi1UC2c+f6ZcLpfLZVsye+Pw0PtPTLxz8gnbAiwMaj+wHteuaesE9RAoCDTSy87JN19/7kdv2HvyPx4iIqK9jL+p6YOISLVardVqC0++05i90Ts27Co3Ur0giDTWfehItxPmar2wOn/x+juO43zAZiWcRQZRSrUT5iunvvfakfcBQHUWnP34j76uvcZs32Anxg2KcO+5ZT+Pa7vjIlKrIOvJvr/1tVc/8hpjXCIiov2BRQv0QZRStVqtXqhf/0Sr+LF3J9I/8EwjHOggW2aQAUH5wUMTQSqedhzHiLn7MLKgnZkf5SooyDuDM36MGxkAMbJyVY06NwcGjY1x4Ufl9rRwl/a40d5hNsb1c9qi8Mrv/EH/wgpjXCIion2Ev6/pw5WlfBqVEioA/uDqf7V4ayTuxLVWYQGsXZf20JOBo7GyQN699ubK5oqr3XCbW+9rR0fYHcHA+fJz3/7h0YsAzp2ZtHdaHkzmUptri56twQ17JSBosntnIUQwAQPKhrt24ZndWnYgX1/8+//m8/7JPtC5ERER0S5xd/sA9j8BgEK1MDE9UagVaoVaI9GolCofEA2VpTxbnW0sN1DD9Pj0h95/15VV2WZpqyj8aGIkm1arg80nfqgd5SilEY6QwJa07v0Hu53RDAJHO+lEZmVjBQhWiqFTQ+tXKwQTKkThrcOXbYw7eb5g79NICFqb600PiNYqhD127zJfTTp9I6RTcwyltDr+xntPXPzrwzdu+Yf6UE8gERER7TyGuY8gcn2+Vqyd+fyZaqH6wqsvlKfKn/juJ0q/f8JNSiqx6Sl4LQ9p0W33rdFrdWe1gkqpWKqeryIHe/9SpVQql6qFaj1f35shrw1Zy3IGwOqgDKxmWoPGW9iII6bgR7oIh0g8YLWu/9ggz5pKZJTqBLeCzla2zINQCmJabQdAoVooVUpAvZEwbVfHPDG2E1hwHAhzuXfu3a/H9ffvF+8CSnD8jYsvfP37nSfh4Z47IiIi2g38xf0IBACOXx0fWusZvjXct9Kbnx2u528qbVqxVua9Y6Oj15FNYrG1GWsZz0mPCS4my5PnX/nhz/cv9Lc9wS2s9i17sfaG9ooXXgBgQ167+b0Z75alDCCPfB75pZuXsbyZ3NBKq3BsLzoLvBCZpPshm/XHq0G00isby+/deDvSDCHoACadeRCiAKXnnc3xb328crqSr+eLteLYzDuOt6EkOIagZdgH9FUAEIw5Cw/BVkTg8I36R39QYx6XiIhon+Lv7ociAHDy2vip6+O9q5nB2QGd8WIqro1pe6JgRAGilROM4YIR/+I+tF2+pSBKuYDEkEygWU+qlWS9f2E9s7auvee+9uk9Hu+ek3N11OuoZxZVdl5h1aThutqJVuv6pbb3bmuwRbi2TKlGc/Pd6281vaZWKjpcOKzU9bO/2nltaObPn/+bVz73yrHLxwbnp3Mbc6YNQMOPVoNWCffYdaeBrh9Dh/Gzem6z9tH/743wnnvs6SciIqIPx1/fD0UA4Be/9+mTM2NhpWjQkBVB19W7Nx1QQccqf5mTEiVaAUbEAcQxai1zPbfYUGZDex/9+vPlqXKhWhiuD++1YNemda2fnPuEWm1eWX7Tgfr/2XvX4MjO877z/7zn9B1oXBsDzBVDDm8N0bqSoi4Omo69ciwldhRiEiu7FSVOJVVRKh92a1P7JTU9+2Evqdr9sGs7lWzsyCmvvBnQluKLLNty2ONYIiXRIimym+RwhoMZYC5A49q4dvc577Mf3vecPsBgZgAMZgbAPD+Kw0bj9Ln2qP/9nP/zf6K+gNDDYJvGbjfuoaVyAUBrffHmheW1RUc5sEG2iET0AgRSasZZ+/c///tf+oMvferHn+qdnWhfnoMGw/gOwlyFSAjuLVukoNobreOSwqEnq1/4l39hXrOXTrkgCIIgCNtAPsS3TZGLJZSOz3R3Xqa2aqLZqCtFiHRfGTbrdLINVRy0Vm2EQESK4Gn42omtxie7ZtVK6vhPhqx/93wBaOXC7gWKXBzGcAEFAN+69KvNH/9F48mfIuWEsj+cDxy4AWxB9tb3XngCCXR56uLc0qyjnKDUalcUOoA16WpDDb49BKBn9lrXyoynWw1qQQ3XJohtch1C97D5key3EiJ+8r2xk8fH+/1p5IGz8jdEEARBEPYr0oK2bYYxDODZtaOz3gXVl7w5d2NuadpR7obZtNHyZAs7QSwaHRAJA2CwZp9AgEseZ7x+L+0neOLTf/X3//QXVpUPoDRcCmbhPoBjvTtFKppDKKP81uMzPepkamlZ61haJRFUdq3ABbFp8QorqLccAxFp1opUwk3ap9jGewVlXPMcx+ZoOQUAHQuTmaUFL9TBtjBrzvJt9HTUR2F3CQAIfOjG9Ge+/wa+b34UBEEQBGEfI+MhdsIZnKmvLiEeTyXSJw491t2e87RnZKoNf2Xj9DSVTCKQeQAmYjATBxBRKLksEaWsfa187vXjR+uZp6b7GifHe7xE+NtNK8IPHrPXL+NlADMn0xPPJjNHJ+Pt11eby5o0YHeVmYmY2OaO0S31b7s2EIBkPGVeGEQrWPOB8STEFTu11MgoOhYudNZuKvbMimwYGAVa2qxvPXYZDky+1qvAivHk+2Mfe+NdCIIgCIJwIBCZuz2MIXX06v8zOTGWjCWZNQHHc4O5jj4zuAvhDfEgzAoUaC0Ckf3TLGkWCG+gMzMTWyVItm+KNbFWDOj0KnfV2mL+Z98bMjuTL+dHzo08lPNwK0UqFqloHn/Qc3hk8Nc6ctWVelOzF85ZiBwghd8HNl1bMpZUpBhs9S3ZoWREYHL85aQz83itM969uGqtuIhWaIkJm3ad2Z6z4JtE2CPHRE9cuPyZ779hchVISrmCIAiCsP8Rmbs9hjF8Hue132zPZBQ5xjhKRMd7T/Zm+zzfC2/TUyvHanMlFyrddQ8YZJSgSbkK5ncZPajBhxa6P/feR/7W6y8U3vzkUGWonC/vnbIuAKN0h1EaxUjl2OGVw1hN+qCap32QdRLYowmFfETs2jHC4Jgbdx034lMw9gMwiPRaalIdunkp5q2yVjYooXW6eRObQoCNN7Pbss9Aof9G9eSH41s6Qt7sf+eAM7dZ/gxw7javEgRBEAThfiJFq23AjDLODKH4Ox/+amNpLkYxAATSMLMIcH1mfKo2qSKDwVqV3W2d6siLbfGxNfgLpKCJFGNVc2Vg4rvPv5Yv54cqQ6OnR+/HUe+MaA7DUzP9sSW9sjDnOMQaKmgNi3aVhYTPfHD9vaXVmuO4gPU8GINvYl4felunZkxsWDjG9y6DhiPZYfb0hrL5Y29Uol6FTV9eLGIMg2ksV/IojVQ3WYLwhV/5Qn4oB1Q7anUgl89Xy+Wps2crmypac8mytfFEvdZXreylrkJBEARBOCCIzN0Gr3ChgNKfTf2rNz6oH8l2mOlfUaGmSE3MXJ2cv+4otzVf9i4C7DbYTLLAkmqCGyJ9bab2e6NzbkH5seu5kXx5ZKgCbH6z/mER5jCcxdkXZ5+jpbUr828TYkQtX0CrphvJDFPkjE1dnK5VXccN3bYEMNyBN73uy2bIWShvQ6PI5m/o4FyGojh4qVJPvnvps8Gcs01svAGFEgrnUUKhgNL3/tqRuY64p7W9GgyuIDeV++nVv1nOl4cqoQgunDlT/Mp/OFYGMEQUXBpHgYD2lZ7em6cADFVGS8MIIpI33Q9BEARBEHaCfKJug+/wr7yGY09dm1uZyiacJJG1fLTSYQECXZu9Ojl/M5L5StHK7nY32hrjZebRBmLXrkgpKF5tcn5g4p8+/1qpVDh/vrCnEseYuYRSDrkhDAH4/cn/OFW74ixzzHEIal3Irv1SAACOcq7PjF+fnXAc1xZyAUWUvNk89ho5pq5tR1AEXyRuUzI3s9A44puGHVzBAzenP/bGe/03q8EO2Bfky3nzsDJUMQ/+7jcHO6726OaKdjPdPd21VW8NPnytAF9rgNiqbmYNAlgBrIiM00SBQA4pn52YYu1nU7G5BjWdWMJbJuLpQ9Xf/8UPwh3Ol/O1bC1by1aGKvIXVBAEQRB2jHyKboNf41/LITd39ZKaXk3FUrS+lEtEzNqUWa/NWKUbzQvbgcY1tKbc2rAsM1kiELsEBh3pnE2vJa59/3nzkj2ldBF8Byij/DJe/tR82RunN9/jE08MxZwYWYN4kLALMLNSzvTC1JXqh45yjCgl0A/+VvUf/sMurWxKmEkos2ljd6rjhtN8W3VcDWqvrX7yr946OXbNLGlOaKGEqRwqQxgZHZnqv7yYmWHNPbPJz1/v/9BznGbd12AdXPPAB3wXny0Zc0TrB1PMJoJy4JBb68nd6Hx3saOWWUmuZRo/fm5sZHRkdGR0b44FEQRBEIT9guTmboMccrXxcXdZK6io8AiirhA6Pw93HwPU1MINRSr0lYaSd7vbJavpyAqm0MZgNK8GCBMLna6jcOJ64sphm627l7SROWpj2M10VgudJbXyD27WsNbZzFBMMZGiIHQMAMDsOq6iIHqMwDH841/uaqaNxg2dtVbl3s76vMGrwMyKAMLVY89+4Tt/GGrcs8ViYbg0VZ4qFSrFs/jJhZ9aTV478X5n2u1trK00Pf8SedDNJm+Sh3znry+BDo502Vl5zARoDY+ayZs3Tt7sJOp0yXFjsaNjhya73/3bL//MR8t/rXimCKDwCgAUzmOPfXkRBEEQhD3NXpJCexujU/7k4m9Xqj/uTfcYT0K0TBt9AIZSanzm6tTcDcdxwkkEQdnxHkSovUsPIKztgoMaYcPBrFr9rZ//w9bye+8KG8FXLo9UKiPOx9ea7vLCzGQ6FgszgxnskLO4unjx5vvQTAQ/RkPf9Mm3r424cfl2ZuRQXyJi+gBAhOzK2sDY1AuvvQ6gVCicBXK53NDQUPFMcfjPBw5N9fa6Ty9XJ0HQvmbfZuuGF+2W+XbrmuiiMQ4IL/atO7nZ+BAiIhfEiojcRLOWcNhRl05deeO5K8WzrcVE7AqCIAjCVpBAsa1TBJCKvdeRTJNSaKkoIBKNECS3QrM+0n0013HI175xjpqRBVu80X1b7PDa0MHQqmQyc8znQ43UF976ZGv5vRdcZQZmVCoj+Xz+y6f+u/cGJ9tO3Ei032g2Vn3SocVWKXJIgaAdOvZDqDVTvLXTNCJJFLfZilG4vFHj9mVWn/rg4guvvT46gtPn8LVfnSoUCqOjo6X0H7z0jeGTl55KzXXVbt7wfd9reNqz+xPO7SCiyHCP1gU3UtZ21tloZNiuONr4AjY16mCtYagcM+sma0/7nl9fUekFbp/l5944OfLbz7yRP7GSyJlDK7yCwit78coKgiAIwp5i79X69irv8JkhnP3Tm2euTXLCSYE3cdy20hWopWSuVMemFyZd5XLoNUBY3L2HHQpbq2Ctu0GdFKTUm8cvvXv46tXeoOt/T17noDutNISzZ1EcngEtYmzBdyjhKHetsXrxxoWGbg68w73vsXaASPn8zl5n26IWzP0130cU0+Wv/27+r78w8uevFc+gVMD5AgAM/+tP5hba2k+5XPe8pse6VYq1EzpCg7U55cFQ4e1mxNkBxAj3KJyBHHGzBFVe+9WFQCCKqRhcVZ+Px7xUc6F94WrxDPJl9FVRKuzRiysIgiAIDx35hNwq7/CZl0GfvYlrN1XciSHSf7ZBb0WDsQAw89Xq2OzStEOObZqyYmnjze+dEG1PAwU39UFQV3omfzx46f3DE3bJvXqpmVFCIYfhIRQBOv9OcXrt0Fpitu41Ppz8oPPNtdx70MoMNwvnbtwpNy1a6o0kVCjVTLlXL1948WeZv362OAbgqcrAwETnifF+XvWZmdkPjLz2dLUuJcylCx0Qu3Dhwpp+oMdtvRk2TKN1u8DMsNBQrnJ6+hpVrjle7eQH48UzNulMbAyCIAiCcCt7VfvsPV7hVwoofOPt/9ljx6WNxtyQVtJtCwJ4bPLS7NJM1NF7uzVsj0AnIRB1waoBoreOX6ocGR/v2dM1XQMzA0WUgELx7NmzjefG/5df+I1/+9//nfickbTBqF/YiLXbHUoYrWC0qZW44Hqst3t2+qWXf+/rXy1cGSy98tP95Hc9eXmg3mz6WrOGkZSkKFSWHFqe738/ny31sm2vC7oN7RehlvmX4CgC0WN9A+/r99ibefri9XAlInYFQRAEIYp4c7dKAYU/KhU/+L0zBG08opsqVGPhbLk1YZJU6XhusDPT5Wsz1sD6MXehLki2JcpOFgvrnAxi/uj44+M91ePTuXvaxAOBiEBn8esVEH0mvhJPH/v6P/o7iVk2B2jtrswUpo5thjUVhGo/EPz1WGLm5jiTc7ZYbD81EHv67528+vSxCz2r9Ybn+eyz9dMqG+xAbK9RWF29/4dvT4J93zCxHftsD8d4fcHwPda+vjR5PT7TEdMfud7z0eVkDkBpWNy6giAIgrAO52HvwP6AGcDZt696qRO/opKkyAm11qaia4N/lJkd5XRmulbry6uNFSIV5lDdzvmw/V205ctQlpnV/fSFvKd4YKH7am8VZ+/w+oeMVWiVytjg0bF2lX57lsGsEOha5tAde/s1hGecA3VKIOVppdf6OX16dPTzhce+9q/+43/4/q/5K5729TrTbWAksfYPipzEBwnZP4O3R1jzB+ypIAaYoTWj3uB4poH4xcdif/LFWqGEr55EoYBS6YHvtiAIgiDsPfbwbey9hLlpXLr4s2/PPNOZOeSwc1d5GlW6pianlGp4jcs3Ly7XlxQ5wRiv3TB63rJhhM1SgUya9zHrAcDo6dHd3NxuEFYhxwaPvPfM45P9fSaYIhC4xrSwNY0bxi8wE8iF16CVpjv7FseWOpXzhOM3WXs6yF2AHbcRKuQ9ljcMtEYVbzr2mYigSMX0fK4RU/PPvnWxnEc1J61pgiAIgiCmha1RRh7AYiLV8DX81vN3UKgbMgGISLNOuInH+p9IxzOafUSk8KYpqjshGPdFodsTrFkrQkIxgFw1t+cGpAUPxk4eee+ZxyYHegE23wGIYYY6BOPebruGYOCvTWszLmWfdIMaTXd2bDCd+LljOOE017RuajOPl4JYNrB1Ne9FjYugNm8zhQMnA9lRaswMX+s6Oq4njzc/Ptf59FAFpQIKJbHqCoIgCI86e/BTfS9yjkcqGDo+MbE60d2eyt46G+J23FrTdZSzUl++PHmx3lyjaE13N3IXzCaDG/BBUxPs/XtvMZW98LhZao+I3ajGff+Zx24O9EKrdblrdzvFYa2zFY3LbHTuUk9zLrs43d5cTDpeU8Pn1mmhqEnBFnb3xV+HyF5zK3XMhPs65Cheyk7HsPDUpZtm+b1xnQVBEAThISDV3C1RwRCAGTrEzvbE6K01XZ/9dCJz8tATcTfBrO3Ndlukwy60EVHQ4hY0LxEITMQUz6ytHR8HMDxc4t2oHd8jEY17+P1nHps8nIOmIMHLlCvvbukgBKI1bFPTDKVq2ebVwytzH8FizPHqPvuawVAgamWSESI23P2gcRHYcwHjtCBisv+Cta89D+mFXLL5xHT2FMK+tD1wrQVBEAThwSMydxsQKEmO1URbttVuVLogX/uZZOZ4btBVjmbfhgkEJoNd2dFwGoG5wQ0zYYuw3H/92S/8SaFQ2o3N7A43B3rfe+bxmwM97EfnJQQTNu4IR4b5mtYsAnRMzfR74ycaCxk9e83zmn6rWG40X2jo2F1X9IOEbL3bVHVNPZpArOF72lvWy6nD1zueTdd6ATEwCIIgCI8oInN3SCTo9O7cWtP1fK8j03mi7zFHOczGiho2j211tXfZJLUcnVaaM6ebmeWYD6CMfJGL97qV3eDyyWOTh/ugVfRmvC1R3rF03vIaAKGE1eAbR+pLH41PJ+urqw0/mNZrRjC0ghSAfaxxAygIiTBTR8wRAtA+NxveWqyTVo/+4rnjhfOYyuVHzo087P0VBEEQhAfKvv+kfzAYRZieaGYmmoE3d9sxCbf6dF3HrS5MXp0es2J0t8LFWpu0CQXr52w5x06sTP/UJ0solVB6KG8B4wx+7offd/TaZH+OFQeBYfa/dzbKtmq4rVFiAECaxo4uXz/eWG022GfWHPZvcTgfjoNhywcGbt0I4Mj0YBApItdRildrfYNm2T2YsyEIgiAI9wmp5m6JPMoAevRU0zczCnZy03vTmm5v9tDh7mNsxnBFRqPtzn7bFK5A51rl6E+Mt//gyndLKO3OVrYJA8OlEoCrx/sn+3M6kKu2C6wV/3tbwlkRxp5qXqy0uji4dPXo2mq9oT3NzKTMaW7ZRSiYpfFADvRBEXiLQ4u3OWpo1lo3tW5Qyl1cwJ7M2RAEQRCE+4f7sHdgf5BHeQSjf8B/c95vV5GOnu2m3kYXNo81+/2dA57fnJy7rlRrWseu5ekGQwbCnWYAuhmf9nEi+PkBqr5zIyPlcrlQKs30ZmrtKU227mgspkFv2J3W0IpWIJvCxoS4Vq/9tYXa2qpucPglwViSsYPC+34k7KPjII3BjCbxNZhj9ZX0WrKv2lcaLu2TSAlBEARBuFfk425LGOH0X9578b2bz3R0DxC5O04Ba2XlRl0KwFj1w5la1XViG5bctSPgoATKTAo+0TvPXv/Oie8BD+5dUCwWc1NTuWo1szozfaiLdXDwsPL27gFtgf/C3pongBH31PeeW6ipVXiabQk7HGjG275C+58wuyPiVCE34dTa+fe+8l9byz1yJ0YQBEF4tBDTwjZYnU/7q44OJhCAaAczHTavLJI63nuys63b9+3YCJsuFvnznjDDFtiORWCGYn7hxM/9nXd/IV9+QM1J50ZGclNT1b6+hc7EzKEu1taFS2xcFbh7ehij5cAIbMcO0fc+PrtAK2hqe5rItrBZlfvoQXYMno1lIxBr9up+2zz/3DefPXGx92HvoCAIgiA8CMS0sCVMDELa+fX+pVKd+oMWKOxMRFkVEtG7mn2l1IncYxe991fWlpVS4QK7U9MlRAMHjGBc/f3Kse4+dSNzryvfAudGRgDkqtV4o+Z6q5pakhUAcPe6q+0bYzaWBSYoDc/lHz0zV4vVlWe7r8xvI8Gyj2I113z54rCeG/Sl+R76b3QC6JxNv/X81VZIhSAIgiAcRKSau1VKKL343D9zPvpZZk0cRAHcQ5k1GrmgSGnWrhN77NCpVCK1qbHhXuFQ9bEpRoMYM8tzJybK+fJ9nSBQLBaruRyARoJdb81O77VjLNi0TuGOddeggtuyIiiNelz/+NTcQqzueMEQDATfCjj4LvFoijiyGh9koupgxT4ze3rgesdP/fDYiUtS0xUEQRAOOCJzt0oV1bM4W88mNsixHWvQsKZrfwQx+4lY8kTuMUc5WmvzbKuh6t7ErhE7jCBYCwAh4dKnOz9eGaqcwZl7WfkdCL0Ktc4ExwDSRry3fAqIZvveZueDai+BNLHS5Ct++/j8TLru+hTUqhHOgDjg3WZbhIIvM9yaJ8fM2tfkqIGrnQDyZZkcIQiCIBxYROZunVEAGmUCRyXZPSqq9RFjSrPOJNsGDz3uKAc2OWv3ggLIZi7YMp9m1r6/uMbgCir3o6Br6ri5avXotQ9ietUnjdasitAwfDfY6PNAzjKY8O7x2nS2HvOJlXEcBwFjj2oBd3NsTdcMHrHTR5jhN/XT7w58+RunTr8skyMEQRCEA4vI3K2SQ/UMiu5ave7poDNsFxwF0TBd84zPfmem60jvMW2duYEUNgFZ96ZGbfU0kinVnJz/H976J6MYzZfz97LmWwnruPNd8YReZA7O2Lpjvpt4D7IVgsnFcDRdOFwb715xfRU4e23ZktlshO/JTXLAML6FoHoe2DvY83S2dvRq7rlqbkjydAVBEIQDicjcrVJACUBHY2ahtsjsA9gtLbWhI41AvvZ72vsOdx1h1uFG7Piue4sOCLJmza19AORq9W7jJyOjI7Vs7Z4PpUVYxz187SKj4WuXWzkJLV1/54OJJiuYInRM03jvypW+lZivbKICgrwLDl5jXhZ8FTF2D14PgiwL7NYkjr2MdSnb7kNr0NbsNZoNN5md9vqqfUBJhK4gCIJwwBCZu1WIcBbFN+JPp/syWu++Noq6FwBo7Q90H8l1HNLaN7W41sjeeyOIFiOrCDVyi9nRkdGhytBulfTMeqp9fbWsm1xbTjQ9K1gp8CrYwu6dI3JtNK7JBtPErk/Xu1YrxxbIKlgOkyg2EAliM6vYuIyZnRZOkti1sXN7GTtXAzAdacb2XQfiK4uP/yEe0kg8QRAEQbh/iMzdBrlyrjGYiHkZc1vcajbsJD33VqJ38o0U06wP9xzrauv2fd9aToNsh3uSZZHdNaNvj662/co3X/rMa5+596NAoHEB5KbGk2vzfoxCZ0LkfN0tIdfkhtnqM2l/K1WbAAAgAElEQVRi18NCpvn+8UVNAENDa61Zs9Za+/Z/rJn1JsIXoA0FXWIOtW+oicNSb/jT+ufXPbkr5+qBQhSt49tSutb1tZX2//b11VM/BRTEuiAIgiAcJJy7LyIE/Iv/6V9k/zSbPKwa3pJSqjVna5eyWaPSzzxWUNlM50p9ea2xppTaUPHd6WYikhoAGMrNznQ6C1kApVLpXg7BqL8rg4NHJq50zy6upR1i2D66MM/MBC3cOVoh1PwgJnZ81Nsx/gKp3kRbOp1sS6bSyWQqEU8m4vGY47qO4yhlrLpWjGrNEbeC3btog1owBRm31ILXGRluVypGOKJ4H8WWEYiDQzB+D2Yw1/7qOFKpzOzPTOWmBr86WBmtPOwdFQRBEIRdQMZDbIOjtaNDI0Pfv/BnbzQ+7Ey1I5rAv0shVtF2NAJp1o5yj/UOXrp5odFcU8phDuqh97JFDst6BAZr+G0NPjobn+i+90MolEprSTe55o091oMwzAq2A8p2k91RF5oUrHA2mmJ4MVz/JDVzTqrhcgJkCpMwB8FaW13LWrNm3xZ4mU2V1/yk2fzLDG1eYO2+ZnZGkP9AxvC7MTQOEe0b/rZV06V1npOWDt6D8ykICGwjNmIM8H0sL6i13jdqubgNUd5LuywIgiAIO0M+zbYBM5dRHsLQucv/plGbVSbza7fSvqIbClSsKUU6yllcq12+edHTniKFQA3bFIKdXsSWMlPkx5NO0//fv/SNe9ntYrE4XCqtpOOuv3b9SG+gRG1o2LpS6p32CtY7HCbr+rj2PM0PEnmbv2GNmgQ2lGqtmm95DwI1rH1fa/Z93/d886f2tXnSiN/oSij4T2tzkckdrd2O/LuJDo68cHffKjsk7OsLDkY55KjYfO/kt06/Wyih9OLD3kNBEARBuGf2wCfuvuIVfuU8zj87MbA0M+mqGG4jeu4VXlcgZGbXcWcWp69MfRgaT5n5XkJirfIM1hPT7qW+qf/vM/8F2OGbIrR19t+8lFpb1kF1FEEamrUr3Hmv0LLkGoWoPEx+hKY+QqrZshlEjmLb3mhaP5XDOhu01p72tdae7/taa983wrdVBmZTA0YgXilS9N300jPzht9srPU+bNVrDibcJVep5c7pj3z43qsvHM3WPjN6evRh7ZggCIIg7ApiWtge53F+GMPzsTHfqccQN9W/UIzummRZfxMcgKe9nvbepteYmL5qLaG2hnkPCjscVsyoOz7qCkC+nK9g29bMUOP2zEwkV5e1AkciHUIf8N01brSnj6AamHsM00+TapodplZ51j4R/BQdfmbcCJGSKtmxCLzhTyOriQiK3LjrtvYkVM6stakEayN8vabveZ7veX5T+9pnHfSlBSaK9QbrcBZHazfW7Rha35GiDx6I9mXrkg7eaT7r1HLu2qFstnZCrAuCIAjCAUA+x7bNK/xKAYXfvfpvVhdmFe6XbwHYxO6pSI1PX5lauGlmpIVybAebDsaJ2VUz0ZX0As92jB8df+2zr21rVVGN27ky7WvHxIetU1FbeatFDhhg8rE4QBPPE7tB25qxyAbqedOXAjY/YkPRFHequW4BgjJHQQRjf/DZ933P87WvjfnBOB98X9sKsGYruG2ghVW5iEje6D6EWtw6j0Oxb8U47ofubJ1yEIOVg2w29eNTN179bAWQ/3sQBEEQ9jdSzd02OZTO4vxnXH+FYxqkSEU11i6K3egNboNmPdB9pN5cm1+ecx23JVO3b9K1YyaCEQ3E3LGQnQeOTRx7DduQuVGN27Y475My4yeiJcwtjYGIxukCDFKap/PQcVJexKm7mcbFLVaE8Mlolf12ivau186cYW3KwEGZlxTFnFgsHjMCtJU9pu0QZd/zvabvNT2v6fmeaYXTwbHaUioCF8ZG/4O5JoG4RVgtjrTB7co3q9C1YlaufSzWGsmlYDNS0BUEQRD2MyJzt00V58+g9P+6/2hxNtnZczT6q10v6EYrfEaKOco5njvZ9Jsr9WUnErxg6pdb3wHbs8Wt5q1axwJmO8aPjm9991oad3YiuzLF5Aa37m03VujKvcthmtlciHxbAOBybJ6cLGsFmMO0XVNbkl63Ct87n5xbv1RseGH09G50PkSWJJcUg2KuNTAwjMA1qtf3fN/zPGP89YzrQbNmexWI1keemSK2fWbDDuyOzyHsdDSSmqG1Hrzc+2Sl/0L+5k5WKAiCIAh7BsnN3TZfL46Vkf/LzGdP6EWvkQ1uRbe0ye4GSG0QNFrrmBtLJzLzS7Naa6uL1o+W2MpqCWT8vQAIIEUr8bXf+dIfAKj9nzWc3cKOAQCuDA72zE5k1xbYV61khciDu54NY7e1RVwiBhRAgNNc8J369Vw64dgzvK6VbVe/UISaeAO4xTW74VV3OtuRzF5S5LpuLB5LJOPJdDKVSabbUqm2VLotlcqkEsm46zpBuBuzjsT9rtfQCLV14EUO9iqoxwbO5q2+Gcw3DAoSdQEmMEi7/pVTM/kyvtaHe0tSFgRBEISHhtyS3AmvcKGA0u/M/NP6+ICrYibk6/41D91aulOk5pZnTfCCWWYnWw9btWzAQf1PP/6TN4+NAXd/X4Tq63e+8tl6vA8m5iwcObDl/Qjye+2rYN23qv/G1M//8V+cPjfS7aA7qbSv11UugdZMr4fBpsXU6LVA1FkR6WiL0jpJZDWx9rXnedbq4Pm+52lfG9fvhha3qORtlXjRcna0fmui3O4cdBF5J5ikY9dVy51TQx9cACCT0QRBEIR9igz73QkFlMrIX+gZaO+a1uxRYHM1ofu7vrlb779r1l1tPYe7j2qtzTN3daDeSjCTzIRFINaWODlxAkC+nN/iGl57IXfhye+TUmRKwqHGbUUP3HEHbDGx9SojuHqrM0+/++GrLxx94dXxWR/1hQR0eOMeRGbkxMP8jhat/mL9BbIeACNcTVGWmIJKcXQlHKJt0ddxnUQykWlPd3Rnu3Odvf09uf6e3ECud6C3s7cj3Z6KxV0AdsSx5gi2kktBaZ/D4LlAvLLtiNtUc7ei5QCwhq+pf+bxt585WRrGFq6kIAiCIOxFpJq7Q0xB9y9mzl674Wo2jfitOuaDCV4goqvVsenalA1eWL/M1lZqXb2kyE/EFta8wz/Ol/PlO2em2jEQmfhqsrqUfZyhgfVVzS1sPqzgtkqIzASQzx0Lq7/4n78D4PS5kVw111ftG/v0631eCjqYmhE16O7ht3DrYtlWss2dD+HCm6yCWv8YYet7vtf0mo2m6WzzPW1ifsPyceDvDd+HsOfINvrZZsWNvl5mjuweEcWUah+a/L9evADs6ZMsCIIgCLdDvLk75OvFsTLOPJc+c2G13KivKLR8C7gPvWi4jYzMpjvXGqurjRUFFbZwbWfrHBYhNan4bHtiLpuoJ177k9uGLZi2syuDg77bYCezLsJ2O5uPVHAR2BUArZuxzAdPfRTA4NjY6dHKF5//4rmXzv3ZZ7/Xu9iRW+6wmzIvCf7YsyKsVfSNVHM31ICjC6+3BUd+q1vJcY7rxOKxRCqRSqdSbalUWyqVSaVSyXgiphQZ5wNHs8wi629Npg42F9XW4dUzmpwV/bu/+8ba9zpiH9a/elIcuoIgCML+Y68KhP2AmYj25Mzh5sR1R8U3qK37oXTRMlzaghyB6l790o3315prNniByCy1lR0IjRZExISVpcSkU8/Wsr/xj39j0+XPjYxUc7lqX1/P7ETb8jRpxdb8uT2JbY2mQbHRjjxTfmqZlZ8wmwhjHMzSf+O1z3905jhzE7oVQHafzNAPmA3W3lu5U8U3yOQFYMq6ftNvNmy51/NMlpnRtSBF4buU10/Ra605KO0SkXLcZweuL7/9AcShKwiCIOxDpJq7c04WTwKYSS/Ga+zWoYxzwBTi7qcCM3ftzQPNOu7GM8n2heU5n33TDMe81R0Ib2gTiDQvKW+NqZ6oV0Y3GYRmdGeuWk00a6lGjbRNPDASmaKTx+56CLaGa++Vm0r4wLXpjoXmwI0b9WTya7/+65ENo1AqfP7Pf2alfV4l1shkARjrQqCxdzl54cESrfKuL+jeteJr0VqDAUWKyI25iVQimU6mM6lUJpXKpOLJmOM4AGvfjCxuXXdEi7i2wGt9Dwwm5rbBzrUVdlcWCgUp6AqCIAj7DGlB2zlFKpoHy1k95dRM9Cmi423vTztaVL8Ska/9tmTb4Z5jYYJVdJm7toKF43U90ndY1Gjcal/fYjae8OusWw1k4CAjd2vNSq2UVgCAAhjoqc6euHKjUCp1z82dHl3vDCYUzhemclPjzlqzltGKocLdDgKxDiK3mhx4PeFvlVKkCEGar3HxguC4TiKdyHZlew515wZyvf09Xbmuto5MPBVXjjIpudrX3Jo/Yd9EwS7wlff9KwNxAKXhh3AGBEEQBOFeEJl7Txilu9zvpNrSvm5EY/zvazUX64twvvZ623O5jkO+9qOJXoGe3Npq9W3fDAwMl0oAumYnUys1n30AIFOPJabwSLcW2WvjFVorVz77KvH0excBDI6N3fqSYrFYzVVz1VzHhVPOYpupIQPc+j5x0NMANkje8DEH0jaqeoNiLwFgzb7nM7NyVDKdbO9ssxkOh3t7+7uzXdlEKqFIaV+HqW2wKRzQDL+J5qpbPPNwjloQBEEQ7gUxLdwrhWJhGKU2WknV9ZrOrksACJrr79OmN1Rts+nO1cbKanNVKWVakLaktilI53KxplHXBGCDaaEIDI6NzfR0LrV3uXrVRoHZtdvpZFvR05F0BQrvnCtFtfbuy4/lAQyOjd1uLZXRyhef/yIAaEWJJscadg32NjsOhE13S2wQu1j/zefWJdc5HIL3pFIqnoil0sl0WzqZSsYSccdV5vqYDjbrXSC4id7Bi349PS+NaIIgCML+Qqq590qRigWUfqFz1MvWmytNDoJsKRBh9yl2NOpPsFskHO09kYglfe0TRxTfbcYT3LJCSjaSALK1bPT5cyMj5Xz+Lz//guuvtS/fCCqxxhIbDBreosZFWOhmBhOYFdUyXTM9RwGcLxTuvBZjnHDnOpyF9pSbbMUVt2bW3nUvDiwb9K55MupwuFXyas2+rwHEk/H2jrauXFfvQG9uoLertzOVSTmu0po9T+v5VddPFM6Lb0EQBEHYZ7gPewcOCCUU3uw/8WzjyMrsJDnA+szUrdU6t0e0dGk2pLVOxVPHegfHJi9q1lbxhEJ0s4EK4RAyEJRyEmuJobFTC9mFcIFzIyMAKkNDaynNyoQyRGMS7jBZa7MNBQKZggzXxczabPezZpnilpv5neu5pfalWNbTnuZW7ittSNR9NLm1d+1Wp3i0GBwaHgAoRSoeiyfjbZ1tXsOrrzXqa3Xt+zOdzeIZ5MsP8DAEQRAE4Z6Rau4uQITzKLwE/vLxf3ws6/laR026wQyq+1JpjPqAicjzvc5M50DPUc3BjCyCcesyb6L+TNcSAQqgpp+sJwF01Ew8rXHE5gA0Eppd1mRuZhMxAqPANjUutYQ1ga8c/+ZyOh1uayvHaxabyk1dcVbqCwlNgIItDZtsAJNC8QiXdW/lzq1s4a/CBVgza3Zjblt7pjvX1dnbefVkE0Bl6KEehiAIgiBsE5G5u0ORikMAQNymm0sLNtrVmGbR0ha7vl2KpDpE2tH6utt7tfbJJP23LKybrCB8pGKq2lcFUM6XEYlWqHXGOGb3XQUvsPXhrdVNycpxYxe2eWcUc9uXXqonP4Lt1HERaUfLXnisGlslJlYIxnsFA4wf7YLuHYhK3k1Vb/grZjtUONE7U3lifORh77kgCIIgbBeRubvI2RIK5/uUbuvy/VWbDRskut7viDEECf9GVh/rOd6WyvratxIzmMCwGbYpScfjU4emimeK5Xw5jFbILUzEedGPVGGBaEX27rAdIwtmcNC05mhaTHYutn1kZ4c8enq0r9p37qVzX//5Pyz3XQ++TwSTi01FVwq6W6ClehFYXDjIxQOIKfPms04jxkAeMkxGEARB2GeIzN01jHUhV851XHjcU21esxnmmFIY73XflG6oVxQpzdp1Ykd6jrmOqzmsK28i/diad8FgXy9N5iYBVIYqAAql0ife+UEOC1onODIfdtuW3CCLwRZyAQKlF1enu4+YZbZVyg0pFotmP8d6p+ZvdLEZzWEj1DjodxOpuzXMdSKE86LN1zNfodkz6/zlT5dKheLD3kdBEARB2C4ic3eTIhVzlVw1X514drWeJWaTusAblO792HRUQ5OZGZFqP9x9bF0V19bpgmxUbnlzobnur7U3FIAXXj1azuf/8vOfVl59ed43xVjb5RUaJLa2T2TGT1jLLANQwInLV7/8u3/00rlz2KnGjfLOqQ9WD08pxGFLzibGNwguE6G7NZiByNAOUiBQfLorNtMN4Pz5wiMS1iYIgiAcJOSza/cpcnEYw6vz0+7M2o2lMddxw7DSSPgXbfWu/5aJrtw8VkpdnbpcXZhSjoPwjn5LsKxLJ0i1Vz/QKnk5ll1Y+Mxrx+pJ33c5aDZbbwHe4v4ACEq/ZmsEkM9PvT/26R+8gV05ekahVCicLyw8eYnSNZdiQS0X65SuvM1vRzi0L4w/ZjBBKVAtnfjgpFnq3r+NCIIgCMKDRz7/7wtGZY7Nn70wMz65POiQDW673zVdu+kgXYGIPM+7ePO9lfqKo5yoUg1qtPYn5VBzxWkrP808NVSpNhOsXfbJCmeKKqGtvWdakyAC9U0AHN1EpmOhkS+XhyqVXTkFxWJxKjdVzVV7Xe6JO57WOihpMzhMhJB3+m1hY1kIUyoA8LXc0uoyZt164XxBNK4gCIKwT5EP//sCMwNF4OyV+aH3Z164uXjSdTYOnIt6DHZxu9EqpoZ2lbu4Wrt044KvfUUqdKyu07sEIkULqUvxlaHK0NGJi0m/7sEPxeEO6rimCyxyjFDgTK3+9keez01N5arV06Oju3XUI+dsDEBvjNNKO6SgQRTELty36OL9TRDz1hqWZ8wohPnD3QuLN/9T4fcB+X8IQRAEYR8j3tz7AhEBZwGc6Cw/2fOD/vbLnvasZAw6xu5HTXfdUAAwwZh0swPdRxitNIZoOAMZVwHreqL+s3NdiF91vKVmoHGZgtaxbWnc6J+B4fPE5etffvnbL507V+3r20WNC2D0tF3bdJP8pbTWRIoQhOgSEUVcp4KFAs+4eSfC3gSgFHW97zxz/hOFUuFh76IgCIIg3BMic+8XoSoc7HznyZ7XBtqumGYuRevm9G6IA9ulTbdidAFo7fdm+zozXT77oVgNsxnsLAWl4sB3u+bQOK6Ug0DjUmRXt7p1MAdzI0ztWAMZcszIvaFK5X7cBDdKN1fNdX5wKpbo0ipwmZob8eEENsEQpK/Zai7ABAZUDM2ZZOqDQwAK5wtyxgRBEIR9jcjc+0hE6ZbTPYRMsqEb2sYvYIPS3d2sMeNMDQrGDNCx3sFkLKW1Dv3Btt5qNuozrfjPvZ4YvPITe5MfrYIzb9lZEWTkIrgNTib7oKYSrwz/XKlQ2K0DvBUTplt+qZz4+cPVYytmLkaodDlMXXjEa7ombQOtWRrEbH4E3Pk6xtXaVG4K0nYmCIIg7H9E5t5fQnHY2TmfePxorLtrudEM82tDE+19UbqtWhwx67ibONxz9FZvrl2I0XND5+bXTIauLfQZv8K27AotbWzkMStSj1+6np2v56amzhcK97U+WCwWq0PVIoqXDt8c75lWUAgkHaz0BuhRnxwReJXDLwAAkXZR0/50EwCquapoXEEQBOEAIHclHxDn+Jx5MDvxgb9wrc077DpOqLdMzTQqce/dvMuRBDE2sajkTEyPTc7fdJVrb+aTHRpWb6MXfrW52q0QatugArqNXYjEN8DOOMY/+M3fA/AnX/hCLZvdXUvubfbB/vf4dO6Za8c+duUxK3FtE5o9K3gEO9JM8MR6jWueB7k17c807YKh11kQBEEQ9jWP2kf9w+Qcn6uiWkW1fbKZqTmxJTfuKEU2gYGi5dfIsNp70bsbfREgDX3x+ntLa0uOcuw0Bc2s0FGlo+c9doKOJGPM3da2TDHXtjNZmUuxxpEPF/7y8399uFR6sVTawSHshMi3hS+89YmPXn0MwSQ4tlMuTG7xtiT8PicyrNlqXFPYJlp1l9R893W3YRYUjSsIgiAcGMS08OA4TaerqAJYPBS7+YRa7GjOXZv0taehYawCIcY0GQQyAK3fbWuLGxIVGNohZ6DriCLFdgYaE4EYfW9p2LatSPPZljdkh/oGI9VgNC6hiexsV7+xK2xrz++JiHZ988SHbx7/MBwFF5SwgyPnR8Cqy606LhOH1WxzwZprmAd1XXgiV81BNK4gCIJwsHhkqll7iSIXzYP2q15yVvs3FruP9xMr1qxUOJLBVuBMjddoVfOqHYwkixp/Famr1bGphZuu40JrP0Y9F7j/LYYCWm1n26ggW78r8bp74cSZJb+S/8QLr776gOwKt+5WwBfe+sTHrpxiaKxPAj7g1dywydB+dTEeZfMbdhRda5u9eOjG95+pmEly4scVBEEQDhgH+mN+DxMqXQDt4156QcUWVTxDRA7BufWqRFrFrN61cWDrc3A3VaabhpddvPHe8uoSJ1T7dT72KisfrAAObmxv37FgI2qNJYCZ0RFvrHzlG+dKhcKDsyvcsluGn379uc9fGOL2FYYOvyygpcsPrk83tJKYQWfmCwgIDq52Tb0xeOm9wxN2yYN6BgRBEIRHGPlwe5hExe4T1YHEKs3VbzpLWhG5Km7SXjcIToJVuOFQ3/Ax0BJ2G2q9G5SuUqq2NHexejG2zIP/lROL8F1SHM0Q2yp2qK8pG5q+NSDGetXNThx9bLhUKpRKD/NNxgBgqpXNY9d0z6xWYLYDI0ztGXYs8AESu2Fx3V4UBHZpIqDpqWtdM/+p8N3W8gfmwAVBEAQhgnhzHyZFKhapCGAYw1/J/ZN3jl8f6H27q38s1TG53JzX3NTa16xBDGW1CAc+XZNEFj4mBtmJEERY7+iNzD8zaN9vz3R2Z3tzb/nJRfJdUKt/jLbhVmUOvBV2nJaZw6B9lV1YfQAJYneHAELhfAFAbPwIzXT7UKaQG0hBkzVBvM4Ysm+JxuKaGXZs3jIEEGs01uCvJHS1K1/OA/b8CIIgCMKBRD7i9gTMXEIJAHC2gNJZFJ+Y7o83HUXvfbn///jNN4oOxVzXSFWlbJwBwmxcCvXZekdvsPZAIoe+Bc2UcJr/9ao+P4GEG6xhe35fhA4KO3DChHVxPZ5iJH0nmatWH4Il9zaExtPVo9cXs3NtSQ7iF2zMGILb+ub7wz77m8HGbxK2l5m5ZsbnbQy55MSd3p6VeCMx/d2hqdxUNVeVhjNBEAThYCPV3D0BEb1IL75ILxZQKqHwEvgrvf+0PHDN7//0Txb/9eeOHf5o/+cPpY9dmvmut9ZoeGsampVmaLDWWmsO5usGg744CgX/DTQukq7/wZx+7SZijjXkctiUtQ2Na1/AzMwaTICGXkllbw4cr/b17R2Ni4jMTU0cnm1bvt4+p6CCgjiIKXTpthwg+wXbYsZkDiIo7duwZIBIKd+7ObBUe+4TX/vc6PBwqa/aJxpXEARBOPDsr8/zRwVT3K2jfgmXhjE8hCHz/GtXv/WhfynR6Kwt1fqgfLVy5eaN2OFsDLE4E0M5rgNiYhVYFKx0bVUnmeEq1BrNc+/yzCpcJ3TsmsW3t5dB+pgZJaE0pxfr7zz7vPn9HuzcLxaLpeFSqVD68p994anqgN++StCBtTlSzA4GwGEvV3a5VbyPRiNzZMwbERH86+nF8e6ZVz7+4zPIF9BXQOlgJ0wIgiAIgkE+7vY6t8bXnsXZ/GgewMhI5YdXL3zoJbx0SmGoD9OYrn7vd3/12N/7l7qeTqiUbq4qx4XWALmO42kvloj7dc/73Q/4w3kkXdKRUWnb3a1AFdp+fnDbUuOl0T8aHRmpDA3tQY1riTSlrR2/sdy/lGqskVLB5DaKGDwCR8ZejR5b5zNZN8jYPvH4za7vnxxbme8YHQlqt3vxOARBEAThviAfevsJW+Udr09MTOSBbLY+NDQKlM6iCOAMzgD0R6899eHC0Kkn21diqbrr1mpHk0gkakCiqa/M+zcXvDcnacknR5EdB2Z9ndtScsaVa/vVmAlQHrueuvDUsw904NlOCVX47KkxtC2nlGYogKM6MSjp3tPI5V0mkk8culSCnDg71NhUpVfcgcTK/LXOG7/z1797dPxotpatDFXkr7sgCILwSCGfe/sbZpRQqCIHjORRHgKAs8G0XRj5mx/NYwQYraz96JJfXQEYqhUwtRMZZ7vNwhxWEKFtYe3tPWxXuBWzk6YZa4AyayfjPTdmfK3IaHjrx0AYW7FORT7Y8m4kOYGiVeegfmtzlBmkgCa5c259hdlfcsv5cmWoAshfdEEQBOFRRD79Diah/J0Y/0ziZqL67eqxvmX1kw+o4UQGTIT3u7fxRmhJq9ANCjpxebzwyg/L+fzLp0/vC40bMnJuJFfN9VX7ZvLjOr0cX/FjaUWmqS+cewwgiOpqWTwegGd33RgzDjzQYayFCVG2lgpSlMxUF5a6eL6j89Jg8UwxX84PVYak1UwQBEF4ZBGZe8AxojO9vNCxOJWor5grbrTSunarrWGHQQT1TGNgbSrv8UvVF195Ffvz/RQt6zrptTSpLp122bffBlpj0xCUdGmDYTpyPuxPWz8T0el0FA7+WLd2mMK5uXKt/jKACETkMzIzmRt908uOV6+156q5Sr4CoFQo7cvrIQiCIAi7hPOwd0C4j4SF1e7Za8n6KkDR0cA7cCzYcqKZNsBmIhtnFxqvPz8MYHBs7OzuH8R9p1QqlUqlwa8OlvPlVz73vV/8xi+bUi35yo81FRFC2RpMSqP1tHItyA6CM+M2cLeSb+hDIATrIYDWr99KW7tTka1DO9TvrPWy35NZ0a9/6v/6lX8PILOS+faXvj32Wz6A1HsAACAASURBVGPYjxdDEARBEHYPkbkHFqO8rgwOdk5NtK3OByXblrPUDE3b3gpNYhWIgvv5Jz689gvfLuWmpv74i1/c+51nd6AyWqn+WrVQKowNjj3+zpA727mQXm4k6gyKO3EircHKnrEwoNhiJs+F3x7sQAYgXDJ6ljnyfPhyDr6AmBnEG9dvFiFbS3aVOuwcupSemvX99h9+6n/8J/924frh3xocGxwb/NHzP6p8pHI/zo8gCIIg7DvkpuaBxQil3/ubf+Nmsi3T5tloLDPrKyg2bnONkRAxO9fXGRy7Xih9DwfrnRS1McyduPbpzoUq0LPY7k0ec4jhsYayqp8C9R8Rp2Q9s6Z6TtH5dGjNbF53wiJdbq2FwtFsjgNiQFGlb3y6rRYjN76a7rhwbHRk9Ew5X6j2FQoShSsIgiAIG5HPxoPJuZGRfLk815Odzabn+zp12E3FQQzYdsMVwoFngVhWjEyt/s6zzw2XSoVS6eC9k0bOjQAwYQXmhP39P/uFE9eOgHw/vegntEMuKxB86KAZD2iZeSNE7Qu3VnMB474FwETMpACtyNGslPa9hWTMTyjQlSPXfvvnvh2+RGLCBEEQBOHOuA97B4Tdp1gsVqemKkND9ST7MbadVLB9TNs15FpbaDgswdyZ13R8bLxQ+uHT715++fTpfW1XuB02o4BxBjgNnAHOx1aeuHIEwNWhd5ymys30TOeqyKwcjq8sLg2w33RjDrFWULDTlc0KQBwMnQAUgQCfFLGZxEvaZ1YAtCa3bUVjZOj698qY4ly1Z6p72k/Wj1ceBzAx+EF09yaOTYjAFQRBEIQ7oB72Dgj3hWpf30pXjEHQCFyfxGSstdu7v23zYoMqMAME8lXTGLuHKpX9lSC2bQhnCaOEs4TC+QKAcr78my+9fOSdofiNvsM/Gfp3/8233+pavJ67OpOoz9W1e71vtqln1VpqDck2rLU1lYOkA8Wu4oZyiZppphj8tlRb5n/90qjqmJrzMdfkC13T7xy5eOnZlfL4q//uc6OHfzIUu5E7Un7mN0fOlfNlAIXzBdOg1vqfIAiCIAi3Rz4qDxrnRkaquVxG1/piM5NL6aBrzBpyIzmwWyVqVzARCyCsJdKTh04dVLvCXWAUSoVcNTdUGSrny9VctVQomd8UzxbtgzPFkR+/kPDi0+1LS7FV0oqYtX29YjjZZupTyTWVnT/bN2ZeVTxTDLewyfofubMsCIIgCPeKfHgeKIrFYm5qKleteplmE4oJGmFUFXYwtJYjRgUmUswE6pqeU9rNLDfOFwoHvJS7dW6vfe+MeRUCEzAgfykFQRAEYXeQT9QDhRGdRyY+cL1VGwIQ9o0B2Ob1tkO4ArtCkK5AnfMrv/StP97u2h5Fbm1G24CcQUEQBEG4b4g39+BgNG7H/E3XW7ZxCOvzv7arqVoal9n2SzGlV7y3Pvbpcj5/H47gwEF3+58gCIIgCPcNkbkHhNA8kF6phYlhtpgYlmO3S2TOranmrsV7XA9nisVqX5+INEEQBEEQ9jIyBe0gEA4865meSK8sMKlgcpbJDjP/bG+FFHSrMREDCmCQVk6ioQE8/6MfyShZQRAEQRD2MpKbexAoFQqFUunGQE8zpuE4GkxhPu42U3IN1q5g9LEJaABnlpuVoZPHr75aGRr6SOU+TJRlAMiXMVTB0G1WX86jnEdlKNhLQRAEQRCE2yBKYd9TLBbz5XJlaChf/tFye6IVG2YHyO5kCuz6mWdMBNZOvF77yu/8SalQ2IVhEIxCCbkqAFRzKBXWzQUr3rFQXDwTPCIACJMeRAELgiAIghBF5MD+hoFSoXC+UOiemehYnmETjmsV6natCq11Agg1LgBSaCr/2pGF4dJYoTR2L28ao0pLwygVrJwtnsHjF3Mnr+YSq/G5jpXMYj03yUYBW28wtf6o9qGao+X2ROdC+rGlzkSM2hc/xJUxu/IzADAyaovBknUmCIIgCI8yInP3N68UCoVS6RtfeameICIf5ooGI313oHPZCFxTBTb1YFBmSSXrE+21G+cLg8Viadt7ySiUMFVC33kAKBTwo08eitfT6WVmrady+O4Xr/6zXy80OuCtOlRvaEexr40h2GcQaSICiECKSEO5ivyEjjfcw0961ffmsbTkcGO6j6qH0Ew0Cn9xI9xyaRhTOSnxCoIgCMKjiHzy72NadoXK6yuZGEDaiEEm3v60M4SdZ0Ep1zxQPrXX1v72t/4I23+7FIvF0nBpKjdVGaoUz6JYxC/988FDT2Q1XJ3JobnqM/s+g0EEBkOD7T+A3R4Btq5L0X+DxjiAWQHkQnuJZMxzkZq76bDPKpbQq9nFy1LiFQRBEIRHE0la2K8YIfj68893z15z2WeYEmww2BfE2y/lRjWuidpVTOnVxjvPfio3NdVXrW4jXYFRKGA5M/X8618cHRkt/PmhazPdn/zU4a788TrHPTh+s+n5WmsNzczMmplb4xQIRETg0LFLQS9csHpmsAGswazB8H3WDb/ppJtOO6c7Gz5fPp45OtF5bLzt+b+qASjn0ffP8NWTuHd3sSAIgiAIexyRufuVQqFQKJWuHenVqu6yNoVYIlMYxQ4MC3bOGVl3LwACYqkke+qf/9+/XhkaOjk2tpX1FIsoFACgVMDpl6vvP1575u3HD1ezbarbbU/7DU/72mjUsDZLt8BkS7zhE0ybLEa2ZG2P1ChlZmhm3/d9J5ZYbc8sZnuWT9XhXDvi/KdfXvrqb6E0jMGvYvCroncFQRAE4SAjpoV9SWhXeObd11cycbCNxmUGdmhYALjl6WWQAiutVtNtN/oGh0ulQql091UGiWCnX8Z3fvaXEitebvJSRz3XrDN72ipbbmlxADDT2hCkQoAD40RQT2YED4mD6q5ZAOBAjXPrndwqCYdyHQApRU5C1VJTcLSONb/50uXiWZTzkZwHQRAEQRAOFlLN3ZcUCoVqX19vdYJ4lUgBNl0BtpC7bcOCTSEz+pIIzIpQjydr7b3NePLK4OBdQsQYhQLSy6j2odoH9r70vcJ//pnv/IaqJ/y6NuVbs48EslllhIiUtXbbYJHgISjycOMTgEn1NasGYA0boKAMbPrxADCYWXscW8skGu0d9f6T78Znu9z8haWvfxWFEr56EoWCVHYFQRAE4UAhVaz9h5nr2zMzdehmdandN7IRzLARtzu8qhtduYqzs6tvfvQFRCYJ32Z/WgFhr3xugP2uk2P9ut4w5llTaSUiuwE7e8L8DA4HE987warNBo14ZlAw3gJBfdeoX3JSWE5Vj/fPx9KrqT+tnXtJAhkEQRAE4UChHvYOCNuDgeFSCUCysbDWriMazhRid6xxGbYYbAuvJz689ovf/M5L587d+WWFVwrlfL5wHr/82/3vnHr6xMVnBi/1+I26Zs22Yks2K8G4KTgYImzF7+7JSrOeiF+X2eQHG19vUEs27W5a+6ucns/Nfvj4//aZWu3z/VbjAuDWoApBEARBEPYvYlrYZxSBwbExqMZCXwy+MtbVYK4vdpCuAARl1cDrqggJ8trnVk+MTfRVq7ezK4ycGwHwo+d/dPrlr01nfcS6nKU27TW1BgKBa/fOOBVsU1ywi/e1aGpMEAg2Dw7tDa2+NQZrwMO3fnS8vpTrmE7F6+5sbglAvpwvFAqV0fsw0FgQBEEQhAeF+7B3QNgGxWKxfO7cUKUCeE7d1YErNRjtu7PGM9PbxWBrV3CgVpz2Vwqf0EgUbqNxi0VMVctDlaGn3z9SfuKVdA3+CuD7QRnU9MPxunFskZFmD4hAT1tlHQwwBgITBaAZ8Fmv+Mc/6D051n90oqfepo5ce/rVF159CDssCIIgCMLuIdXcfYMRXX/8xS9OHcrMHurRgcg1AWChOWC76wwrwbaLizi16Mx3dq+mM5t2noV5YZmVatPJZp12nl3RHrNm279Ggbo1hmEKghMerl7k0B9sRXdQvzZdcdbJ0DmbOrV4tNp24/XnK5CyriAIgiDsZ6Sau28oFQqFUmn8WO+1w+neeW09BhzJyd0+rUpw0CKmFBa6kjM9fdis8yx8YrZ9cCXW7enE2uy89m2fmR1KZl2x1Cov76TKvNtsqOxSuJNM1tgA1uwTzy5Vu1diw995eq2Njt8YKufL0bwyQRAEQRD2C1LN3R8wsJxO/5uvfa2vejXmO0GKVlAp3ZGONDYHCv4DQAHd0wvZ2soTFz68MjhYipRywyIugGr2iYXcKb8B7WszmCKMAeOg3cukeu1RqGVgCE5ASwGb0RXdC5m+yba57PT3h9+SxDFBEARB2I/sWSUirMM4FkovfvbKqQF44QCxDY6D7a0wTN8i46MFmJ2PvfnOx958F+tXGBZxl+K9teRAPZ7VIO1p86QZMGxWGmrHezjWB4v1bUT2nO2ICeUoRTR7ZCXmzP3Ujz80i98xWk0QBEEQhD2EBIrtA86NjIwfPQoA5MO3gVehY2Fnd9SNxiXrVzVZC8gsr37szXfL+Xx0yahRYS5zfDXW5WtoTyMI6WJiYpuqsM80LkLfhq1DczCGjQD2te/rzmttR9ynZnufAlAalqwxQRAEQdg3iGlhHzAyNDRx7NjYyf7rxwdIaxiByRROLdvBOsOxZEa2KSLWlF71zv29v5+rVk+OjZnFAnvuWLXjyYXex/06afYR3ORnYjNnmInDIWX3frwPGmvWpZZV2R6JaU3Ta/NNL9N+tT/+x1+aNQYGcS8IgiAIwt5Hqrl7nWKxWM3l5jtT1VzWJHa1Kqi8Q1cuYK2oHMxNA+BoeG46NzV13phwGWCUhktAYbrtp1dShzC/zOxDG11rdyDwtD7sIIVdwRTHmYgZYDszmcG+9pZ12+zhv/2NU4XzQU1XyrqCIAiCsLcRmbunMcXUal+fVj4pBy19xQAx8Q60FsO0WdmV2BlhTV1PZKq5XK5aLRaLxSIKJQBI1/T17OuLaTQbfpiowGbLbOTubh3rHqA1vcKk6hLbScrQvta+l50duJ59Nl3rtcuL0hUEQRCEPYzI3D2Nmev7xIV3XG+1NcQraJjaWZgBtabtmrIlESG12rh25LF8pXJ6dNT4FArn8Yu/e4LqtXp8zm9o1sEoYYKJ37J21gMJ2b48O8ANAIh99rVeS3Q0/f4TF3vskqJ0BUEQBGGvckBlyoGAgXI+P1SpjJ7+4kp7wkzviqa97nC1bFWqzVkAYvV6eoV/6VvfLhUK500VF5jOPrHUdYSXPd/TzKG+tTMgGEYC7tKh7kGCKAqELmhTSFdwXFrspOsnaj/43E/swgf4PAiCIAjCvkU+n/cuplB44anBH3z249oOO7PDancWIhauNpxRZvRu3PPd1dj40Vdf+8xEOY/TL6Pafmq57bBf11ozrDuBCa3IrUfljWPkvLUhB1ljBHLo1PTP/fHPfvMHn3sLeGTOhiAIgiDsK8S0sEcpFosm2Ov6QJ9J62olu96TxmU7OI1tdbLHbQxMzowffXV0BKMjqAzhrSdOLaaOeHVf+5pCjcuPnsZFECdh/jECF4AG+3yp97uHx7InLvYCYl0QBEH4/9u71yC57jK/489zTvfcZzTSXHS1LYwvuFu2WcCsMJvSMWHXFIZsljBKFVW5bCqv9m1e5U3cqqRqU6nKi1Tt5l1YqFSWrMawS2zCAkVxBAs2OBh86Ta+YsuyLtO6zYzm0t3nnCcv/uec6dEFS+qei0bfD1gazbTOnOmxSz89/fyfB9iMGCi2GbnU9N0nnrgwPnh651iaKvM2hQ6mdmVttaoiqup7su303D/+7rHpqZGnDp+457U7yr++c+f74+l6s5URW26bsIraTfUD38pcL3JeznaDx0xErLepfUuFtx6YYcoYAACb0G0WWW4RPwqCIAz/5itf9vp1IYnFRcuOdy+4EQ1Z94Go6sC8l3jnz45Fx4LJucGTIwt7ButnWlEkiWTbem/LIu6VTCQN+24nR9rXXCz6c6OnHnrjTfcodqQBALB50LSwSR2pVIqt5pJbBiEm2cqzDl8ed1HNTFTEkuT0SOIlO44Fkz1L8zvP9vXVT2UZV0VVVhoV7LbOuJKe/ZN0uIRJuktCoijZNr/73PA9IjIzUZo6OrXRNwoAAFK3eXjZjNys3NEL9fGzF6OeJdeVmzfU3vyABRFpP3xm0ugZfz8+9+M7zt0z2GPbo+ZyM4mSdK2ausNWcl1THSyb/nC1D2YTuT4on+tVHpLeR/t7NnafcH58Ty39m4eIetrXX/TipQs77qyWqrVyjf+qAADYDAobfQNYJVuuK/1Ls63epTQvrQwRu8nLmpha2vvgVvX6po3F2Vcb3qTvNQcathglSdp/a1m2VPcbJU2wecS8SqC9dvY0ccN1r+PWr3hI2hK8+vPkP676rW13ddkd5qfIupA+823ApupquiaWWGO5NTIytDBwslaudfw5AABAd3AEbdPZv3//3Ouv7PQbvmUDFiQ95H/TSc3tK3NtpaLiq9e34B3ftjx372zvjiiOY0vSRQiqbjdCOs8h/c2q+UIJ9+NViMgVATTdS3zVUu0Vt3iVau5lgfXa2j+ah/L0l93KuNl9rlRzRfKlcq1mor177n6juef0eY6jAQCwGRBzNxETeWdg4Mj09B89cPdYT4+rg6bjw9Lz/jd5WXHlR01fZ0/85N19rTP7lqOhZhxHZnmAXimISp4Us3mxV4myJpZLrP1XjnuAXFZ8zRKtu+CqZNz+wCsul45Dy97OH5xeR1b2xF1+5bSfdlVZeuV2VhohruucXVvgt3RfmoiJFZcXRuYLD9dOikgQkHQBANhgNC1sLpVabfSjD4wO9KbpNAu5ecfBTXCvtK8cI/Pknd3Rqw/29c+cS2IxWykT5/0JSZKsuoS5KqZlg8hE3E+u9OulW9VUPfXU87I6qpf+o55qXhJuK/1mheqVXgT3Zpab07eTJLHEkiRJEpMkSbKgK+lPl3UytIVbF0izry1/T/sbl/121d/Rf7H6Kcn6N9LRFYlZbElfT3343on5N8JD15mZAQDAWiHmbhaVSiUMw6XBnnv96JwvSSIm4nV88kzaG3PNRKW/Vfzxx87fefxCnFVbTU1crFUREc/zPN9LpW+o+p6nnvrqqed5aYRNE623UvpNP2UWmqW9kGuXdyZoOn/2aje9cqWsUzh7WJ5zLUnSEBy7EJwkcRInSRzFSRTHWThOY29b04dqesJO27qN8wLwqlrvtRt7NRuylj/AEosb3nzvnefGL4XBqSCU8Aa/UwAAoIsoN20W7vDZ5Nl3ty3NthLJS4vpqaebvWz6Qr7LmyqFpv3o0blm0pDYVNXlV9/3/YLv+55f8AuFgud76nl5UfZaZcn8fFjWLbBmrvj8v+P5yKrCliSWJBZHUdSMWq0oaraiKLYkMRO3wTi/rKd6zWe4/WvLOx/aD8alz2+6JU5UvR5vcejsg2+/Wi1JucYkXQAANgzV3E3BZdyBhdlCq9lMLN1T5l6Z1+zo2I2zLIClK3tjOfcRf3jPkCz2ewXf8/MeA0/k8lLrZZ0A17j+Vd5//Zk8axr+oMdnbcP5p7vG7LJVv8f3Pd+XYrEgAyIi5mq7cRJHSRzFURTFrShqxVHLncBL5GqH2NKhE+kEirRzw92SZQvRVNzOjXQkhbWS4Us7Z0alXHv1Op8HAACwFoi5m8i9b/xmdtuQ+OqOV2UTFm6+mpu9JC+morE0RuVUWXq9ojfUs3KKLOt01Sui47VGO1w5risbQOZqmtdb2nW9Dtf/+PYgrqsniF1xi203mf3seb7v+cViNikta/yNW3Gr2Wwst1rNVhzFK8fd1FY6MSyds7bqcFva+pC1VqRdGhYnUX3PAd9aY7NvVioUdAEA2BjE3I3nSrkfee2Vf/p33/36n37JlWDTpbLXO3L2qmxVJdgTvyVRn+c3kkRWtppddVBZWsq9RjdCezOrrE7DNzH07MYyvK56O2sWuHpQvuzKK49ry8qFQqFQLPQN9A2ZJXESR3Gr1YpaUdSMms1WqxUlcaIief+xS7P5dIX80F76Gdx2uTgZrJ9e7huT2Tc5iwYAwEZh2e/GOxSGIrLr9Mn/+W//JD2SlQ7+6qjl1Syt5pqZC7sjNf+/fq6kflsW1SvHdlkeYfUa5Eaz6drIAvo17/DyeWQi+fwvN/RBXPbNTqqpp4WewsDQwMj2ke2T2yf2jE/uHh8dG+kb7PN8X0ySxCxpe5aycrmqmhuH4Uq6JnESF0bG37hnbxhIEG7gkwQAwO1r48PKba5SqZSq1anp6el//sTiYG/7XNcuREmzvCvAMzl9d9/M/QW/r6kSp427YpruOssrtFut9pgNeFj524NeOTf38rqs+0CaipPE4ihuNVvNRqvZaLYarSiKRMTzvLRrN9uKJulpP1NV3/eWdpwvvV49+mWplbfYkwoAwC2ApoWNVyuXvx3NLw4XLRaRrAPVzcq92Wump7uyaVwq4vXIx14/ceEjO9+N5Xwxic3LHpDOy11ZRLG1aPpjOkssfWfbKLG8Q2PV3ytclVvSNt1CsVAoFvoH+80sasWNpeWlxeVmo2VJ0r5ATvJOhsRiseHFidfu3l0rM1wMAIANwBa0jeSKhxP190/tGe+JYpdrr7rC4EYvq9kV3MEyT73+ucYXvvGDd/bvH9zdc0bFCm7JWlqBzGKf3D5Vx/bui2s91ZrvPs7P2Yn4Rb+3r7d/sL9vsK+nt+j7vlkSx0mSJGkrhKZn0iyS5oAd/tv6Lx6R+l+KHFm3Lw4AANw2mWZzcrnpVx/9yK9/735P/HQfmZt70FlVNVsrkf7kxVps6ev3Hzj43rPPPj5SE/Enz981t13yY1P5YbWt1rPQAVs1G3jVjAUn+ybFcdxYaiwtLDeXG1EUpwMZVDzP6xkYPL/txN9+uVqqlmoHahvydQAAcHviCNqGqVQq1VJJRGa3j6gVsniZ/tzZ4TPLMq6IiIr2LzVfv/9AqVp97o5P1USqper/PvTD42P1/HO57tR0rtj1T/ja0txAMVPLW5fTjml3ys09xWZm5nnewPDg2M4d47vHt0+MDgwPeL5nsSVxEjcXYxuZmp6aG5lb2yUaAABgNQp3G+ZHQXAsCA4d+/7xe3Za5JskWevAjQ/lapPF5PxUVJJIz9B8Y+qpvwuD4LEwTB8kcv/JfY+8ee+eizvcC+35pF5RoaZ7LatnBqcNua6BV8TESwc4RK1oYX5h8dJSkiR9SV/tkTM/e/SV7PcAAID1QDV3Y5jIxMzMk5VKfXKHRZ5Jki+T7XB1rjvp72qNIqbitYrb/NjCIAhcxpU0bL2258Sbu04uFRfNk7SY62aPmeUTzXAZV8dNGxjaTrCpp+n3zswS84v+6Njo5J6J0fHR3vFiNNjY6BsHAOC2Q8zdGGEQlGu18LFHF7b1pvvH0lNLpp3UcsXyxWdp66gv2y/WX3749+RqlcTn7nvtomhrSUXV0p26bs2wqHYWt7eu/Hhfvp8un9uQ8lRMkjjxC/7QyMDg8Ojo/PjG3jMAALchYu6GOVKpzOzcrnG+uCBd8GsddSykPaPpKDETf6mv2IyevHLhrIqIBGHw4V98snd+NPZjF9k0W56W7a696XvZ+lRWZdy2RRSWz9NNRGZ6Fx794eNBGGz0/QIAcHsh5m6Ao1NTtVJp96k3L454loi40mC6lbfTCQtus4SZqUjiqXmNVrGvWiqtdCzkVIJjgYj0vbc3mR8s+JJuOhAxEzdBy6jpXgfN/naSBl9zf0sQ8+U3u9772uNPH/3y0eBYQGMuAADribm5682FxsXBQfOiHlPLSqh50u1kJUS24SE9HNVnsSTqR159cvJA7SrTrMIwDIJgZmLm9NCcZ9KrnnpmK8sURM39bwuujeiyNOia5kt/PTHTt0fPvrvrVH2yHj4WbvQtAgBweyG7rDcXc587+Eit9KBvs9kL3N3Z7pu/ei4iohoVe5f7h8+N7q5c2bTQZurolHtjX9RfGGqoJa5xQdxQLeuoWfi2kE3YtXyNhKpq8s7wxWRmR7VUrZVrPIcAAKwzmhY2Rt/yYkEupqE3K+N2NCvXZVzJDp+JeBKPzc+eG9196Mp2hdWmD0+LyER9Ytvrd9eLCyKJZPMeNO9eoHfhWkzcXwXywrfz6p6Tf3Poh88efLZcK5NxAQBYf8TcdZVnoIujg3nZL/9QJ1kom+Fq2fJer//OYm/P1Q6fXc304enJ+uTRLx/92ueeefGu33quTze9qWyOLkH3qvKEm46EE/U06e1rtgoicuKOE+5vEQAAYJ1RZVpXPwqCIAzD4NF39u/O5ohlB/U7u3I66zYdsyAi3mTzQv+9celodbJWv96Lm4jInecmPv1a6a6zOxNJsiFjbnuE8C/MKpaPKZb2XhGLvWi5b9trHwoPhWEQ8pwBALAhqOauH7cS4kilcnZyzPdF2jNjZ8sY0vaClV9arIWJXWeDSrg4OXijKev4WP2e/W/tGzmnKqZuFbCaSt6+AJFsl7L7SbPvoIqpHR89d8JfnJmYYboCAAAbiD+E14/Lh8eCT5/60B0NbaXbs7pRzHWLZtNNwWJqetfg+8FfPCeHRaZv8Hts8qRIReQ/vFryXylf6jcvSccuZK/MZyN1b2dpy7JqdkrPTRBT1V/d9db3HnqhVC2Va2XaFQAA2EBUc9fbaE9hWRvZC93atrTs5qlI/gq6ivi+t+P8+Wwm2A1fqyJSEfmPD9ROeDL0ywOeuJpuGudWzrndtiwbHSaWZ1xRUdHz91W/99ALUyK1co2MCwDAxiLmrhMXC0///icefvSxfCqtmEm6yqGT/b5umtXKJ+qdq8fvF0REbipoqcoRkSAM9r1SPv7gy4k01W2ukMuqubdr1M0aoC3bzywinmf/+Z9ML43VTaQkvEwCAMDGI+aukzAIROQ3d+//+m9fXvUB7Xhcbno+LG1ZENXl8fHZz0yGU0En1wyOBeGh8Ktf+uaJQvx2w4Xc9ppuOtTh9sq6lv5o1DMZ4QAAEqJJREFU7ePDVDxPXtvz7kdO7V0er4tIZSNvEQAApCg6rQcTqZZKTx0+XKr9v8XBHhF3osutcuhov1hWDU7P+XsiBdOFsZGTw3fdJe/8aeVrHd53EAbBseD1R57fF/miRRVNuy3cqF9bmTZ2O8hTvohL+ZbObhuaeWn77Lce/pXI7fJUAACw+VHNXQ9hEJRrtfveeGVptD+bP2uaBtSOruyilqbtopKovLH/wW3vzx8Kw3dlf6f3ndV0//rz33m/t5lc6nefTM3MVMzMvWafzxnY2rJGXBXVPOOaXNhz6aXtc7/ZfWKj7w8AAKxC6Wk9/CgIjgXBg9XnF0Z740jEDVhoH0d7s0zyqrBbFqzD80tfmv6OdPFbm9V0qx//5eDZsckdl0RFk/TeXVrPkvZW/NcpL5i3DVUQSXsV+p448NLJn31rz/fdewAAwOZBNXfNuTrnIz9/9tyO0aQlksUhtU5f7U8zbvYpVNQvJB9+6+2ObvdKWU13+gtPL4yfi+cHRcSyZQhiZlnI3oI13bRiraJpLXdlP7Mnu0bljl9WH9xDHRcAgM2IAtSac5vPvv3Hn58dGUwKcdbZah0fPRNJS43pIl412XF+7ovf/kG1VDpQq3Xh1ld/JlfTfenTP+vpb9x5bmJl4IDkS8BUt0yrrntW09FhLuBKXscVFb++vff43iefrIhszSo2AAC3Oqq56+FIpdIcLEoxH5Xb+XJfkbTUuNIlK4mNXJybnpoamZvr/OKXy2q63/rs9+/50Ft3j9fddgSXadOhaJrtBrv1pb0JujIZN18AYb62LvX3Ht9bKlXDMNjoOwUAAFe3JSLJJlapVERk2/LZ0b5Lenw+MdHsrL522pfb1jVqpp41/ML42aUvfeuZNanm5p9S0jVpf/H3X3iv2a/pAmBXxjVVzVsobklpEdc03/qWNYeIp6I6MDQzP7P7uEYT9YnJ+qT7/gIAgE2Iau7aOhSGInLH8Xft3VlXeM2mI0gXyp7tvbCJ1+oZfvmhT0xPTZXXKONK+np9RSQMg3M//0Th7HaNC5Yuusi2JajbPWzpDuJbSrrRzE0IlryImw6YmNl+5q24OPzq/RP1ifpEnYwLAMBmRsxdQyYyMTPzZKUisXniu3fmzasdhtx0kFd+8Es19jwRqZXLa11IVZVjxwIR6Xlvj50dudgQUU+ysbL5NAJbybqbPOyauGVm5hbKuaaS9JCdiqjnR+a/O3Txa58+9p7fEpHJ+iS7fAEA2OT8jb6BrSwIgk8+//xPPvPp+Tt3RHFi2Ukt7bhfIT31JSKqoiqizWKz0Tfa6B0SkTAMu3L/v0MYhkEQiEhxfrj40Rdt20W5NKpq+cwHdTeWL8DYtOfSXIuxuG+KZvdtln8VkuwsNIe85omLwyLy/CefDx8L1+EZBgAAHaKau4YmZmaOVCrNYmF5OWkvaKZbeTugIm5OrZqJmKfa6hmfG9klWTfwOnCf6NCh8M8f/el/eeS5mZ7F2CVadbVRVxzNxo2ttDFsAiu34zZ1WLoqWc3MLHHFXDGR/mGJlgbnfvGxf/f5p6dK1XKtvEnDOgAAuAJ/aK8hN0rsqakvLgwVs1UQ2pUxC6sOn4mop4VleePeB0vV6uHpdX0x3UwqIlIt6VOHXz/4C7+/sWt+zEsSlyTTerNkh7pENnjiWPbESTYmQkTSBRd5a4WKJxL1xrMSLZo15/ofH5n7cG8jCEIGhwEAcAuhmrtWXLHz//zxE83isGZnmiSbcdspW/nRxJI43vP+qScrlYl6vfNr3xBVOaKiTx0OD4V//fj/vdQsFOb6PU1f8zdRV9ZVSZfkZnuCRVzFd+WLWTMmrvE2a8FVVbc3Tt3aXjPL2odNffEKhbM9jfML/t5nP/6/Hn+mWqp+b27kscfIuAAA3GL4o3utuJg7fvbk0OJ5sZXG3M63QqSBLDvppeoNXFqeOvpMtVQq12ob9h01EUlXSPz88R8Ui/F9p+7wRSTJG3Yl3x9h+bQuV9tei0XB2UwL9xypSTrGrb2imz1WVUUt8pKeXSf9VqHw95+tPFkpVUuT9ckwCPmvBACAW1Fho29gazKR6Wq1Vi6rLbuMm+v8NJYLt+lPqr6aH9uRSuVQGOrajRL74NsSEQkqQXgoDA/+VES+8v0dd14Yk/4l9SSxvILr8r6bSyuWdnFI9rGVU3o3fycuRrtCskrWM6FprHaPyDKu50ls0oxbkyMLd42d+8rDL6hIaeh8EAZhENZ0455PAADQGepUa8J15X7jK3/S6Lmg3na3IqwrbbnpuamVlCga2ba55W0Xl44FwaaY5GoiIqVq6fBTh+PRWdt1prDz5OL8DhP1xBOz1aFf0y6O7LnJz+eZZGXeq7Xztq3hzR/Zflmx7NImkj5Z+UdVRSwx8Uz7m9JcGF6O/Pe2XTw6NT0tUhU5IvyXAQDALY8/zNfE0ampWrl835svJgOFqJWsvG4uXT9/pnf99kQQ/lw22feyPXDf8Qf/8PbOM0ljUE/flYglceLibZZM3XjaNIi6aWvilpGl59faf5FK67Mu8V/R9JCG4PTK2XK2bLCC7xeT3vhctJwk1tLkw7/4pIjsO/jsyL73pso1enABANgaOIK2JmrlsoiI+EmUiGZhqysZ1/IW03QrxOjsfIfXXAuVSiVPunf70X868PKff/y5M82kcH50wNshxbRhQdRUViKppF+gadtRNZffs2cuHVTm8q+6sJwOLTNL55i5I2V5iDZRTUR9318qLrw/PNva9c5kvLzv5x//6uefea9/0T3sxHOfOnyAjAsAwNbBn+prolKpfOL5nz3xne9//d98OTsE5WZqdfyM592tZp6J9Pn3v/jW7z/7gmzi72X70DEReevRF+q7TptFOy9u3zk3qiKeeiKJJZ609TSkXbX51K/sjaylQdp/XjlPpibieSrmeZpEFmvDhub2XTg/MmuS/Lbv+Et3vjM1PXV0arpSLR3jhBkAAFsXf8J3n8tbv/7oA7/62APu2JMbH9u1ibnuDTPxdHDO+8jr1QdfrMmm/17mxd3wUBgGoYjcf3Lvx195aHBhcGJ2uw4tF8eXW7N+VIwtUvESETET3/dFE0lETJL0+F0i4qmYpyKeZ5ZYJOp7iSQqcdEKl+LWo63i+aHG8nLvmQs73tlz8hufe7oilYpURGTfe/umRD41N0J/AgAAWxt/znefO3/2zX/2xMLIQCKxSD5LrNNhYvlRrXQogejY2fkvPP39aql0YANnLNyo1XNyK0cqIlI99OyZfScmZibGzkxM1CdEZGZipjWw3Nh26UOyv+fgfpmuzoo0JtLfFV1a3jM031za9s7oxd7Z4eJS/0R9XEXOjM8U+5b37X/735dePXKkIiLhoVACmZEZEalJTYR/6wEAuC3Qm7smjlQqsV8Qi0SyF9RVOhwNe9mwAVchHp6bm56aGpmb6+TK602z/4sEYVAtVUWkLo0f31P95qPhnpfKxVOTxVOTe1868LXHn/nGwbDn4H6pzrT2jXi94jVERJIoHuhL5ps9Pf2zf/2pY3/1uWf2vFQuntpZOLVz78sP/vfPf6dRejUMg1KpKiLBsSDUsKa1mtbyzwsAALY8/szvMvfS/Mjs+cGF5d6obqZu/UE6CqCjabAi6VIDFTFPraWF7ReWvvStZ26xau5VZWPIyrVyuVYWkWqpWp+of3DvrEkQBhP1iRv7XQAAYKsjC3TZX/7Zn9UnJ3e//05Paz4deJVtQOh801c+SkzNfLG5gdH6xF2lanVqeppvJAAAQDuaFrrsw2+9VapWxy6cWzUHS9VNcu2EiaV7vdI5W54VfBGplctkXAAAgMsQc7vJRFxttdha9v10g4PIyoqvTqikA3Pd6/utPis0Fzu+ZQAAgK2JOmA3uRECr933oWcffVg930xU3QqvLjzTbguui86eiEaXkp6ef/0/nun4rgEAALYgqrndtzTQp1YUsXTprMunXbGy/MyW+8dmB3e279QFAABArrDRN7A1WSGWRKRtmFinF1z9S5VCs2/owo69HV8YAABga6Ka231z20bEVuVSu9ZDr5u2XVBVRZLt586LSKla7fjaAAAAWxAxt2tcDn354QfOTN6p5snKKLEu7JTNB5O5pcEtafUvLj1ZqUzU6x1fGwAAYAsi5nZNGAQi8taH714ei9rfb9Z5MTe9krrFEJ70tApRYfDZgweDMOzSxQEAALYUYm73TMiRSkUHEmmISHZcTLuwXtbcZgkTcxt+TUYvzrsPMSkDAADgqoi53XRIQjMx9dNVDqpq1oWWBckSs5mKtMQ8Saamp0fm5jq/NAAAwJZEzO0OtxgiqIS9USO2RLIBC13pV1h1/kysr7df7ZKIlGu1blweAABgCyLmdkcYBJO1+k8+8+lL28Y8cY0KedNCp9wKNRd1Y7NL8Wv9jWWhYwEAAODaiLndMTEzc6RSafUUIklEJd1W1o0ZCyKSdyyISEH03jeS4AcvduXCAAAAWxUxt2uerFTMLEra3tW9IQu5RL2oOCIi1VKp29cGAADYOoi53eHaZMdn6pKsCrddmJi7ejGEiqrKEXb8AgAA/E7E3G6amZiIu3PqbIWq5iuDVcQrxMVm9GSlUp+c7O4nAgAA2Eo4xdQdJvL0Fz77wif+4EPHX0xEVVTcQLHOr+wuY2ainsq//Oo3X37oAS/Scq3GNw8AAOBaCht9A1uEivy3u+/cffKXiRXdr80NAuss6K6uDJuZ98wX/3Cpb1REDjBNDAAA4NpoWugCEzGRe95400uG1Fa9v0MqoqpmJm6mmCYzE5MiMjcy0vG1AQAAtjJibteoeb2NyFz1tksTc8UsW6ZmIqqxjMxdrJXL+06c6MLFAQAAti5ibtcUIosKWbOzW8zbcdJdvSnYYj/SRJ+sVHobjQ6vDAAAsLURc7vARdG+5cbQJRH1JN/0a2KddS60r/kVT4utbZNLyyIShGEnlwUAANjyiLld84/+4bldM++58mt2+MzU9OZ6dE1EsoKw+/1qVurvH16OhQEZAAAAH4RJC92UeL5nmmQhVUVNTW68TTcvBotYdgZNRKz1xisf/9HPun7bAAAAWw/V3K4JgyA89IcLPQNun4Or5KqJZDH1Oou6bhKZZSVbEzH3ZlRodH13MAAAwBZFzO0OFTkWBIfCcHLmQqMwbmJuSoKrxbqC7PWUdM0szbiu7cEdZRNTzxtcWAyDP6qWSmv+xQAAANz6aPLsJldsnZ764vyw+lIwExPRPOS6LoYrnvOsRcFcqHX7fUVEzBL3FxHz7nt9SZOZg889HwbBY5w/AwAA+CDE3G4ykTAIjgXB2LkT2+dnIz+xxLKkK2m3bbbxof1HcUnXfT/yVCwiIr7Iv/irh07v+s6u08+7z8L3DAAA4APRtNBNrnVBRM6N7bs4vN1PCu6damKuC0H1yoybvjP70bIhYqbiqex6X1958CdkXAAAgBtCzO2ySqXi3jg7tufi0DYxX1XcvAVRt9QsXRuR/2hmYuY+5gq+Lu/2FXrnh8Z+9uiDB17+obsmGRcAAOA6EXO7L0+658b27H/n5L/66rdExHP13FSaa90pNWkbwuCZ+OJZIn6sC9p7dsfeUrUaBoGQcQEAAG4EMXdNuKR7KAyD8KfPHfzEyMVlv6kiaX+CpGPC3AE1U1X1VMxMpdDf17/Y2Dbb6FvUpj8gIrVy+bEwJOMCAADcEOLTGnI1Wncobe+Jt/viRRvr1wvLiST5aTTfzNS3ONlx9oKq7j15+uEXqkcqlYmZmYl6/fD09EZ+AQAAALcsqrlrSNsOpTV7hnov6eRrp7efm4ulb7FvdLF3NJHelvY3CgNLfaOLA2Off+aHD79QDYPgUBjWJyfJuAAAADeNau46OTo1VapWy7Xa9NSUiNTKZREpVavu7YmZmUNhKCLlWo1vCQAAQOfIVOvHRKql0tzISK1cnhsZEZGRuTkRafT21icn84NrAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAALBp/X9a8fJEzLjqyAAAAABJRU5ErkJggg==" id="72ff797e08" height="500" preserveAspectRatio="xMidYMid meet"/><clipPath id="eb5ffb5b46"><path d="M 80.65625 16.550781 L 148.90625 16.550781 L 148.90625 43.550781 L 80.65625 43.550781 Z M 80.65625 16.550781 " clip-rule="nonzero"/></clipPath><image x="0" y="0" width="930" xlink:href="data:image/png;base64,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" id="48191ea608" height="500" preserveAspectRatio="xMidYMid meet"/><mask id="88dfb3f4a0"><g filter="url(#5cb88468f9)"><g filter="url(#08b06b2c0b)" transform="matrix(0.189516, 0, 0, 0.189, -6.315875, -21.98915)"><image x="0" y="0" width="930" xlink:href="data:image/png;base64,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" height="500" preserveAspectRatio="xMidYMid meet"/></g></g></mask><image x="0" y="0" width="930" xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA6IAAAH0CAIAAACo0gcTAAAABmJLR0QA/wD/AP+gvaeTAAAgAElEQVR4nOzdaZBbWXYn9v+972FHIlckmRvJWrgUUF3qTe2q1oyI0sgqy1KMNFIlPZ6xHTVqR9gz/dExYTsUngTDDsdEjJcIjUeSx5LcsmzFBNktjUZbL5Ia1Ki7q/fu6gJqZ3HJ5JJg7iuWd48/3PceXnKp4pLIjf8fo5NJJPAWANV5cN655wBERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERLSV2u0DoD1KROw3CqpUKeXreQD1fL1SqvBdQ0RERHuf3u0DoL1IBEAZwPlKebJSqJQqxVqxWCtWSpVCtVB4vVD6agmyywdJRERE9AGc3T4A2nPKUgZwDL/71R9d+84X/7fhY5898XZ+eaC+cqg+vDjwjY9/97O/8dnPvfI5AKVSKf1P08XJ4qXPXcLZ3T1qIiIioi0Y5tIWtlThAkqbC0VJfvqqm97YuJEyKu0iruXwWt8z7z958dRbn37rVEbUX3/8ezbkLVQLxcniK0+8UqlUdvkEiIiIiACwNpeiylI+jUoJlT+b/0cLK6ecNXVrcfZy/aJWGoACREFrJVDttvT01q810rPZtU23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" id="e5820d0b84" height="500" preserveAspectRatio="xMidYMid meet"/></defs><rect x="-18" width="216" fill="#ffffff" y="-7.5" height="89.999996" fill-opacity="1"/><rect x="-18" width="216" fill="#ffffff" y="-7.5" height="89.999996" fill-opacity="1"/><rect x="-18" width="216" fill="#ffffff" y="-7.5" height="89.999996" fill-opacity="1"/><g clip-path="url(#294e9b1262)"><g mask="url(#124efb07be)"><g transform="matrix(0.125, 0, 0, 0.1245, 25.065686, -5.884486)"><image x="0" y="0" width="930" xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA6IAAAH0CAIAAACo0gcTAAAABmJLR0QA/wD/AP+gvaeTAAAgAElEQVR4nOzdaZBbWXYn9v+972FHIlckmRvJWrgUUF3qTe2q1oyI0sgqy1KMNFIlPZ6xHTVqR9gz/dExYTsUngTDDsdEjJcIjUeSx5LcsmzFBNktjUZbL5Ia1Ki7q/fu6gJqZ3HJ5JJg7iuWd48/3PceXnKp4pLIjf8fo5NJJPAWANV5cN655wBERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERLSV2u0DoD1KROw3CqpUKeXreQD1fL1SqvBdQ0RERHuf3u0DoL1IBEAZwPlKebJSqJQqxVqxWCtWSpVCtVB4vVD6agmyywdJRERE9AGc3T4A2nPKUgZwDL/71R9d+84X/7fhY5898XZ+eaC+cqg+vDjwjY9/97O/8dnPvfI5AKVSKf1P08XJ4qXPXcLZ3T1qIiIioi0Y5tIWtlThAkqbC0VJfvqqm97YuJEyKu0iruXwWt8z7z958dRbn37rVEbUX3/8ezbkLVQLxcniK0+8UqlUdvkEiIiIiACwNpeiylI+jUoJlT+b/0cLK6ecNXVrcfZy/aJWGoACREFrJVDttvT01q810rPZtU23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" height="500" preserveAspectRatio="xMidYMid meet"/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(19.285774, 66.060111)"><g><path d="M 4.75 0.15625 C 4.007812 0.15625 3.347656 0.0664062 2.765625 -0.109375 C 2.179688 -0.296875 1.695312 -0.539062 1.3125 -0.84375 C 0.925781 -1.144531 0.632812 -1.472656 0.4375 -1.828125 L 1.59375 -3.25 L 1.78125 -3.25 C 2.101562 -2.769531 2.507812 -2.382812 3 -2.09375 C 3.5 -1.8125 4.082031 -1.671875 4.75 -1.671875 C 5.3125 -1.671875 5.734375 -1.789062 6.015625 -2.03125 C 6.304688 -2.269531 6.453125 -2.601562 6.453125 -3.03125 C 6.453125 -3.28125 6.40625 -3.488281 6.3125 -3.65625 C 6.226562 -3.832031 6.078125 -3.976562 5.859375 -4.09375 C 5.640625 -4.21875 5.347656 -4.328125 4.984375 -4.421875 L 3.609375 -4.734375 C 2.648438 -4.953125 1.929688 -5.316406 1.453125 -5.828125 C 0.984375 -6.335938 0.75 -7 0.75 -7.8125 C 0.75 -8.414062 0.898438 -8.945312 1.203125 -9.40625 C 1.503906 -9.863281 1.945312 -10.21875 2.53125 -10.46875 C 3.113281 -10.726562 3.804688 -10.859375 4.609375 -10.859375 C 5.429688 -10.859375 6.132812 -10.75 6.71875 -10.53125 C 7.3125 -10.3125 7.8125 -9.976562 8.21875 -9.53125 L 7.171875 -8.09375 L 6.984375 -8.09375 C 6.679688 -8.414062 6.332031 -8.65625 5.9375 -8.8125 C 5.550781 -8.96875 5.109375 -9.046875 4.609375 -9.046875 C 4.023438 -9.046875 3.582031 -8.941406 3.28125 -8.734375 C 2.976562 -8.535156 2.828125 -8.253906 2.828125 -7.890625 C 2.828125 -7.554688 2.929688 -7.289062 3.140625 -7.09375 C 3.359375 -6.894531 3.726562 -6.738281 4.25 -6.625 L 5.65625 -6.328125 C 6.695312 -6.109375 7.453125 -5.734375 7.921875 -5.203125 C 8.390625 -4.679688 8.625 -4 8.625 -3.15625 C 8.625 -2.488281 8.476562 -1.90625 8.1875 -1.40625 C 7.894531 -0.914062 7.457031 -0.53125 6.875 -0.25 C 6.300781 0.0195312 5.59375 0.15625 4.75 0.15625 Z M 4.75 0.15625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(28.477805, 66.060111)"><g><path d="M 5.25 -10.703125 C 6.988281 -10.703125 8.3125 -10.253906 9.21875 -9.359375 C 10.132812 -8.460938 10.59375 -7.128906 10.59375 -5.359375 C 10.59375 -3.585938 10.132812 -2.25 9.21875 -1.34375 C 8.3125 -0.445312 6.988281 0 5.25 0 L 1.390625 0 L 1.390625 -10.703125 Z M 5.125 -1.78125 C 6.226562 -1.78125 7.050781 -2.0625 7.59375 -2.625 C 8.144531 -3.1875 8.421875 -4.097656 8.421875 -5.359375 C 8.421875 -6.609375 8.144531 -7.515625 7.59375 -8.078125 C 7.050781 -8.640625 6.226562 -8.921875 5.125 -8.921875 L 3.515625 -8.921875 L 3.515625 -1.78125 Z M 5.125 -1.78125 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(39.91662, 66.060111)"><g><path d="M 1.390625 0 L 1.390625 -10.703125 L 3.515625 -10.703125 L 3.515625 -6.328125 L 3.75 -6.328125 L 7.3125 -10.703125 L 9.484375 -10.703125 L 9.484375 -10.53125 L 5.546875 -5.65625 L 9.890625 -0.1875 L 9.890625 0 L 7.5 0 L 3.75 -4.625 L 3.515625 -4.625 L 3.515625 0 Z M 1.390625 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(49.803914, 66.060111)"><g><path d="M 3.78125 0.15625 C 3.226562 0.15625 2.722656 0.09375 2.265625 -0.03125 C 1.804688 -0.164062 1.410156 -0.347656 1.078125 -0.578125 C 0.753906 -0.804688 0.515625 -1.066406 0.359375 -1.359375 L 1.5 -2.578125 L 1.640625 -2.578125 C 1.910156 -2.210938 2.226562 -1.9375 2.59375 -1.75 C 2.96875 -1.570312 3.367188 -1.484375 3.796875 -1.484375 C 4.191406 -1.484375 4.488281 -1.550781 4.6875 -1.6875 C 4.882812 -1.832031 4.984375 -2.039062 4.984375 -2.3125 C 4.984375 -2.507812 4.910156 -2.675781 4.765625 -2.8125 C 4.628906 -2.957031 4.398438 -3.070312 4.078125 -3.15625 L 3 -3.40625 C 2.195312 -3.59375 1.613281 -3.882812 1.25 -4.28125 C 0.882812 -4.675781 0.703125 -5.175781 0.703125 -5.78125 C 0.703125 -6.28125 0.828125 -6.710938 1.078125 -7.078125 C 1.335938 -7.453125 1.695312 -7.738281 2.15625 -7.9375 C 2.625 -8.132812 3.171875 -8.234375 3.796875 -8.234375 C 4.523438 -8.234375 5.128906 -8.128906 5.609375 -7.921875 C 6.085938 -7.710938 6.457031 -7.429688 6.71875 -7.078125 L 5.640625 -5.90625 L 5.5 -5.90625 C 5.269531 -6.15625 5.015625 -6.335938 4.734375 -6.453125 C 4.453125 -6.578125 4.140625 -6.640625 3.796875 -6.640625 C 2.992188 -6.640625 2.59375 -6.390625 2.59375 -5.890625 C 2.59375 -5.679688 2.664062 -5.507812 2.8125 -5.375 C 2.96875 -5.238281 3.234375 -5.128906 3.609375 -5.046875 L 4.59375 -4.828125 C 5.414062 -4.660156 6.015625 -4.378906 6.390625 -3.984375 C 6.773438 -3.597656 6.96875 -3.078125 6.96875 -2.421875 C 6.96875 -1.910156 6.835938 -1.457031 6.578125 -1.0625 C 6.328125 -0.675781 5.960938 -0.375 5.484375 -0.15625 C 5.003906 0.0507812 4.4375 0.15625 3.78125 0.15625 Z M 3.78125 0.15625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(57.24683, 66.060111)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(60.78167, 66.060111)"><g><path d="M 3.15625 0.15625 C 2.632812 0.15625 2.179688 0.0625 1.796875 -0.125 C 1.421875 -0.320312 1.128906 -0.601562 0.921875 -0.96875 C 0.710938 -1.34375 0.609375 -1.785156 0.609375 -2.296875 C 0.609375 -2.773438 0.710938 -3.175781 0.921875 -3.5 C 1.128906 -3.820312 1.445312 -4.085938 1.875 -4.296875 C 2.300781 -4.503906 2.863281 -4.664062 3.5625 -4.78125 C 4.039062 -4.863281 4.40625 -4.945312 4.65625 -5.03125 C 4.914062 -5.125 5.085938 -5.226562 5.171875 -5.34375 C 5.253906 -5.46875 5.296875 -5.617188 5.296875 -5.796875 C 5.296875 -6.054688 5.207031 -6.253906 5.03125 -6.390625 C 4.851562 -6.523438 4.550781 -6.59375 4.125 -6.59375 C 3.675781 -6.59375 3.25 -6.492188 2.84375 -6.296875 C 2.4375 -6.097656 2.085938 -5.835938 1.796875 -5.515625 L 1.640625 -5.515625 L 0.796875 -6.796875 C 1.203125 -7.242188 1.703125 -7.59375 2.296875 -7.84375 C 2.890625 -8.101562 3.535156 -8.234375 4.234375 -8.234375 C 5.304688 -8.234375 6.078125 -8.003906 6.546875 -7.546875 C 7.023438 -7.097656 7.265625 -6.457031 7.265625 -5.625 L 7.265625 -2.109375 C 7.265625 -1.742188 7.425781 -1.5625 7.75 -1.5625 C 7.875 -1.5625 7.992188 -1.585938 8.109375 -1.640625 L 8.203125 -1.609375 L 8.359375 -0.1875 C 8.242188 -0.113281 8.085938 -0.0507812 7.890625 0 C 7.691406 0.0390625 7.472656 0.0625 7.234375 0.0625 C 6.742188 0.0625 6.363281 -0.03125 6.09375 -0.21875 C 5.820312 -0.40625 5.628906 -0.695312 5.515625 -1.09375 L 5.359375 -1.109375 C 4.960938 -0.265625 4.226562 0.15625 3.15625 0.15625 Z M 3.796875 -1.359375 C 4.265625 -1.359375 4.640625 -1.515625 4.921875 -1.828125 C 5.203125 -2.148438 5.34375 -2.59375 5.34375 -3.15625 L 5.34375 -3.96875 L 5.203125 -4 C 5.078125 -3.90625 4.914062 -3.820312 4.71875 -3.75 C 4.519531 -3.6875 4.238281 -3.625 3.875 -3.5625 C 3.425781 -3.488281 3.101562 -3.363281 2.90625 -3.1875 C 2.71875 -3.007812 2.625 -2.753906 2.625 -2.421875 C 2.625 -2.078125 2.726562 -1.8125 2.9375 -1.625 C 3.144531 -1.445312 3.429688 -1.359375 3.796875 -1.359375 Z M 3.796875 -1.359375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(69.293086, 66.060111)"><g><path d="M 1.171875 0 L 1.171875 -8.078125 L 3.109375 -8.078125 L 3.109375 -6.890625 L 3.265625 -6.859375 C 3.765625 -7.773438 4.582031 -8.234375 5.71875 -8.234375 C 6.644531 -8.234375 7.328125 -7.976562 7.765625 -7.46875 C 8.203125 -6.957031 8.421875 -6.21875 8.421875 -5.25 L 8.421875 0 L 6.390625 0 L 6.390625 -5 C 6.390625 -5.539062 6.28125 -5.925781 6.0625 -6.15625 C 5.851562 -6.394531 5.515625 -6.515625 5.046875 -6.515625 C 4.460938 -6.515625 4.003906 -6.328125 3.671875 -5.953125 C 3.347656 -5.578125 3.1875 -4.988281 3.1875 -4.1875 L 3.1875 0 Z M 1.171875 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(78.748583, 66.060111)"><g><path d="M 3.984375 0.15625 C 3.347656 0.15625 2.785156 0 2.296875 -0.3125 C 1.804688 -0.625 1.421875 -1.09375 1.140625 -1.71875 C 0.859375 -2.34375 0.71875 -3.113281 0.71875 -4.03125 C 0.71875 -4.957031 0.859375 -5.734375 1.140625 -6.359375 C 1.429688 -6.984375 1.828125 -7.453125 2.328125 -7.765625 C 2.835938 -8.078125 3.425781 -8.234375 4.09375 -8.234375 C 4.59375 -8.234375 5.023438 -8.144531 5.390625 -7.96875 C 5.765625 -7.800781 6.078125 -7.53125 6.328125 -7.15625 L 6.484375 -7.203125 L 6.484375 -11.328125 L 8.515625 -11.328125 L 8.515625 0 L 6.484375 0 L 6.484375 -1.046875 L 6.328125 -1.078125 C 6.109375 -0.691406 5.800781 -0.390625 5.40625 -0.171875 C 5.019531 0.046875 4.546875 0.15625 3.984375 0.15625 Z M 4.65625 -1.5625 C 5.226562 -1.5625 5.675781 -1.765625 6 -2.171875 C 6.332031 -2.585938 6.5 -3.207031 6.5 -4.03125 C 6.5 -4.863281 6.332031 -5.484375 6 -5.890625 C 5.675781 -6.304688 5.226562 -6.515625 4.65625 -6.515625 C 4.050781 -6.515625 3.59375 -6.3125 3.28125 -5.90625 C 2.96875 -5.507812 2.8125 -4.882812 2.8125 -4.03125 C 2.8125 -3.1875 2.96875 -2.5625 3.28125 -2.15625 C 3.59375 -1.757812 4.050781 -1.5625 4.65625 -1.5625 Z M 4.65625 -1.5625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(88.423635, 66.060111)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(91.958475, 66.060111)"><g><path d="M 10.28125 0 L 8.046875 0 L 7.25 -2.46875 L 3.140625 -2.46875 L 2.34375 0 L 0.15625 0 L 3.859375 -10.703125 L 6.578125 -10.703125 Z M 5.09375 -8.46875 L 3.71875 -4.25 L 6.65625 -4.25 L 5.28125 -8.46875 Z M 5.09375 -8.46875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(102.387337, 66.060111)"><g><path d="M 5.53125 -10.703125 C 6.300781 -10.703125 6.957031 -10.5625 7.5 -10.28125 C 8.039062 -10 8.445312 -9.601562 8.71875 -9.09375 C 9 -8.59375 9.140625 -8.007812 9.140625 -7.34375 C 9.140625 -6.675781 9 -6.085938 8.71875 -5.578125 C 8.445312 -5.078125 8.039062 -4.6875 7.5 -4.40625 C 6.957031 -4.125 6.300781 -3.984375 5.53125 -3.984375 L 3.515625 -3.984375 L 3.515625 0 L 1.390625 0 L 1.390625 -10.703125 Z M 5.25 -5.671875 C 6.425781 -5.671875 7.015625 -6.226562 7.015625 -7.34375 C 7.015625 -8.46875 6.425781 -9.03125 5.25 -9.03125 L 3.515625 -9.03125 L 3.515625 -5.671875 Z M 5.25 -5.671875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(112.164848, 66.060111)"><g><path d="M 3.515625 0 L 1.390625 0 L 1.390625 -10.703125 L 3.515625 -10.703125 Z M 3.515625 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(117.068241, 66.060111)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(120.60308, 66.060111)"><g><path d="M 5.25 -10.703125 C 6.988281 -10.703125 8.3125 -10.253906 9.21875 -9.359375 C 10.132812 -8.460938 10.59375 -7.128906 10.59375 -5.359375 C 10.59375 -3.585938 10.132812 -2.25 9.21875 -1.34375 C 8.3125 -0.445312 6.988281 0 5.25 0 L 1.390625 0 L 1.390625 -10.703125 Z M 5.125 -1.78125 C 6.226562 -1.78125 7.050781 -2.0625 7.59375 -2.625 C 8.144531 -3.1875 8.421875 -4.097656 8.421875 -5.359375 C 8.421875 -6.609375 8.144531 -7.515625 7.59375 -8.078125 C 7.050781 -8.640625 6.226562 -8.921875 5.125 -8.921875 L 3.515625 -8.921875 L 3.515625 -1.78125 Z M 5.125 -1.78125 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(132.041895, 66.060111)"><g><path d="M 4.6875 0.15625 C 3.90625 0.15625 3.210938 -0.00390625 2.609375 -0.328125 C 2.015625 -0.660156 1.550781 -1.140625 1.21875 -1.765625 C 0.882812 -2.390625 0.71875 -3.144531 0.71875 -4.03125 C 0.71875 -4.925781 0.882812 -5.6875 1.21875 -6.3125 C 1.550781 -6.945312 2.015625 -7.425781 2.609375 -7.75 C 3.210938 -8.070312 3.90625 -8.234375 4.6875 -8.234375 C 5.476562 -8.234375 6.171875 -8.070312 6.765625 -7.75 C 7.367188 -7.425781 7.835938 -6.945312 8.171875 -6.3125 C 8.503906 -5.6875 8.671875 -4.925781 8.671875 -4.03125 C 8.671875 -3.144531 8.503906 -2.390625 8.171875 -1.765625 C 7.835938 -1.140625 7.367188 -0.660156 6.765625 -0.328125 C 6.171875 -0.00390625 5.476562 0.15625 4.6875 0.15625 Z M 4.6875 -1.5625 C 5.945312 -1.5625 6.578125 -2.382812 6.578125 -4.03125 C 6.578125 -4.882812 6.414062 -5.507812 6.09375 -5.90625 C 5.769531 -6.3125 5.300781 -6.515625 4.6875 -6.515625 C 3.4375 -6.515625 2.8125 -5.6875 2.8125 -4.03125 C 2.8125 -2.382812 3.4375 -1.5625 4.6875 -1.5625 Z M 4.6875 -1.5625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(141.424207, 66.060111)"><g><path d="M 4.703125 0.15625 C 3.921875 0.15625 3.226562 -0.00390625 2.625 -0.328125 C 2.03125 -0.660156 1.5625 -1.140625 1.21875 -1.765625 C 0.882812 -2.390625 0.71875 -3.144531 0.71875 -4.03125 C 0.71875 -4.925781 0.882812 -5.6875 1.21875 -6.3125 C 1.5625 -6.945312 2.03125 -7.425781 2.625 -7.75 C 3.21875 -8.070312 3.898438 -8.234375 4.671875 -8.234375 C 6.378906 -8.234375 7.472656 -7.613281 7.953125 -6.375 L 6.5625 -5.390625 L 6.40625 -5.390625 C 6.238281 -5.765625 6.019531 -6.046875 5.75 -6.234375 C 5.488281 -6.421875 5.128906 -6.515625 4.671875 -6.515625 C 4.085938 -6.515625 3.628906 -6.3125 3.296875 -5.90625 C 2.972656 -5.5 2.8125 -4.875 2.8125 -4.03125 C 2.8125 -3.207031 2.976562 -2.585938 3.3125 -2.171875 C 3.644531 -1.765625 4.109375 -1.5625 4.703125 -1.5625 C 5.148438 -1.5625 5.523438 -1.679688 5.828125 -1.921875 C 6.128906 -2.160156 6.347656 -2.5 6.484375 -2.9375 L 6.640625 -2.953125 L 8.078125 -2.171875 C 7.867188 -1.484375 7.488281 -0.921875 6.9375 -0.484375 C 6.382812 -0.0546875 5.640625 0.15625 4.703125 0.15625 Z M 4.703125 0.15625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(149.745343, 66.060111)"><g><path d="M 3.78125 0.15625 C 3.226562 0.15625 2.722656 0.09375 2.265625 -0.03125 C 1.804688 -0.164062 1.410156 -0.347656 1.078125 -0.578125 C 0.753906 -0.804688 0.515625 -1.066406 0.359375 -1.359375 L 1.5 -2.578125 L 1.640625 -2.578125 C 1.910156 -2.210938 2.226562 -1.9375 2.59375 -1.75 C 2.96875 -1.570312 3.367188 -1.484375 3.796875 -1.484375 C 4.191406 -1.484375 4.488281 -1.550781 4.6875 -1.6875 C 4.882812 -1.832031 4.984375 -2.039062 4.984375 -2.3125 C 4.984375 -2.507812 4.910156 -2.675781 4.765625 -2.8125 C 4.628906 -2.957031 4.398438 -3.070312 4.078125 -3.15625 L 3 -3.40625 C 2.195312 -3.59375 1.613281 -3.882812 1.25 -4.28125 C 0.882812 -4.675781 0.703125 -5.175781 0.703125 -5.78125 C 0.703125 -6.28125 0.828125 -6.710938 1.078125 -7.078125 C 1.335938 -7.453125 1.695312 -7.738281 2.15625 -7.9375 C 2.625 -8.132812 3.171875 -8.234375 3.796875 -8.234375 C 4.523438 -8.234375 5.128906 -8.128906 5.609375 -7.921875 C 6.085938 -7.710938 6.457031 -7.429688 6.71875 -7.078125 L 5.640625 -5.90625 L 5.5 -5.90625 C 5.269531 -6.15625 5.015625 -6.335938 4.734375 -6.453125 C 4.453125 -6.578125 4.140625 -6.640625 3.796875 -6.640625 C 2.992188 -6.640625 2.59375 -6.390625 2.59375 -5.890625 C 2.59375 -5.679688 2.664062 -5.507812 2.8125 -5.375 C 2.96875 -5.238281 3.234375 -5.128906 3.609375 -5.046875 L 4.59375 -4.828125 C 5.414062 -4.660156 6.015625 -4.378906 6.390625 -3.984375 C 6.773438 -3.597656 6.96875 -3.078125 6.96875 -2.421875 C 6.96875 -1.910156 6.835938 -1.457031 6.578125 -1.0625 C 6.328125 -0.675781 5.960938 -0.375 5.484375 -0.15625 C 5.003906 0.0507812 4.4375 0.15625 3.78125 0.15625 Z M 3.78125 0.15625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(157.180298, 66.060111)"><g/></g></g><g clip-path="url(#eb5ffb5b46)"><g mask="url(#88dfb3f4a0)"><g transform="matrix(0.189516, 0, 0, 0.189, -6.315875, -21.98915)"><image x="0" y="0" width="930" xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA6IAAAH0CAIAAACo0gcTAAAABmJLR0QA/wD/AP+gvaeTAAAgAElEQVR4nOzdaZBbWXYn9v+972FHIlckmRvJWrgUUF3qTe2q1oyI0sgqy1KMNFIlPZ6xHTVqR9gz/dExYTsUngTDDsdEjJcIjUeSx5LcsmzFBNktjUZbL5Ia1Ki7q/fu6gJqZ3HJ5JJg7iuWd48/3PceXnKp4pLIjf8fo5NJJPAWANV5cN655wBERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERLSV2u0DoD1KROw3CqpUKeXreQD1fL1SqvBdQ0RERHuf3u0DoL1IBEAZwPlKebJSqJQqxVqxWCtWSpVCtVB4vVD6agmyywdJRERE9AGc3T4A2nPKUgZwDL/71R9d+84X/7fhY5898XZ+eaC+cqg+vDjwjY9/97O/8dnPvfI5AKVSKf1P08XJ4qXPXcLZ3T1qIiIioi0Y5tIWtlThAkqbC0VJfvqqm97YuJEyKu0iruXwWt8z7z958dRbn37rVEbUX3/8ezbkLVQLxcniK0+8UqlUdvkEiIiIiACwNpeiylI+jUoJlT+b/0cLK6ecNXVrcfZy/aJWGoACREFrJVDttvT01q810rPZtU23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" height="500" preserveAspectRatio="xMidYMid meet"/></g></g></g></svg>
diff --git a/docs/en/overrides/main.html b/docs/en/overrides/main.html
index fcd1704b9..7e6c0f763 100644
--- a/docs/en/overrides/main.html
+++ b/docs/en/overrides/main.html
@@ -37,7 +37,7 @@
     <div class="item">
       <a title="Fern | SDKs and API docs" style="display: block; position: relative;" href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=top-banner" target="_blank">
         <span class="sponsor-badge">sponsor</span>
-        <img class="sponsor-image" src="/img/sponsors/fern-banner.png" />
+        <img class="sponsor-image" src="/img/sponsors/fern-banner.svg" />
       </a>
     </div>
   </div>

From 74de15d0df975f7da4b29e9ad49142d7da172b6c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 31 Jul 2023 21:49:56 +0000
Subject: [PATCH 034/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 14ce41374..ead095d8d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🔧 Update sponsor Fern. PR [#9979](https://github.com/tiangolo/fastapi/pull/9979) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Update CI debug mode with Tmate. PR [#9977](https://github.com/tiangolo/fastapi/pull/9977) by [@tiangolo](https://github.com/tiangolo).
 * 🌐 Remove Vietnamese note about missing translation. PR [#9957](https://github.com/tiangolo/fastapi/pull/9957) by [@tiangolo](https://github.com/tiangolo).
 

From d2169fbad9eb1b2537292996ce8d26e7584e9e2b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 1 Aug 2023 11:19:44 +0200
Subject: [PATCH 035/317] =?UTF-8?q?=F0=9F=91=B7=20Deploy=20docs=20to=20Clo?=
 =?UTF-8?q?udflare=20Pages=20(#9978)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/workflows/deploy-docs.yml | 23 +++++++++++------------
 1 file changed, 11 insertions(+), 12 deletions(-)

diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
index 312d835af..dcd6d7107 100644
--- a/.github/workflows/deploy-docs.yml
+++ b/.github/workflows/deploy-docs.yml
@@ -29,21 +29,20 @@ jobs:
           run_id: ${{ github.event.workflow_run.id }}
           name: docs-site
           path: ./site/
-      - name: Deploy to Netlify
+      - name: Deploy to Cloudflare Pages
         if: steps.download.outputs.found_artifact == 'true'
-        id: netlify
-        uses: nwtgck/actions-netlify@v2.0.0
+        id: deploy
+        uses: cloudflare/pages-action@v1
         with:
-          publish-dir: './site'
-          production-deploy: ${{ github.event.workflow_run.head_repository.full_name == github.repository && github.event.workflow_run.head_branch == 'master' }}
-          github-token: ${{ secrets.FASTAPI_PREVIEW_DOCS_NETLIFY }}
-          enable-commit-comment: false
-        env:
-          NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
-          NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }}
+          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          projectName: fastapitiangolo
+          directory: './site'
+          gitHubToken: ${{ secrets.GITHUB_TOKEN }}
+          branch: ${{ ( github.event.workflow_run.head_repository.full_name == github.repository && github.event.workflow_run.head_branch == 'master' && 'main' ) || ( github.event.workflow_run.head_sha ) }}
       - name: Comment Deploy
-        if: steps.netlify.outputs.deploy-url != ''
+        if: steps.deploy.outputs.url != ''
         uses: ./.github/actions/comment-docs-preview-in-pr
         with:
           token: ${{ secrets.FASTAPI_PREVIEW_DOCS_COMMENT_DEPLOY }}
-          deploy_url: "${{ steps.netlify.outputs.deploy-url }}"
+          deploy_url: "${{ steps.deploy.outputs.url }}"

From 6c8c3b788bb7c3338f1105493833c9815ba243a4 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 1 Aug 2023 09:20:23 +0000
Subject: [PATCH 036/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ead095d8d..2aed9859a 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 👷 Deploy docs to Cloudflare Pages. PR [#9978](https://github.com/tiangolo/fastapi/pull/9978) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsor Fern. PR [#9979](https://github.com/tiangolo/fastapi/pull/9979) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Update CI debug mode with Tmate. PR [#9977](https://github.com/tiangolo/fastapi/pull/9977) by [@tiangolo](https://github.com/tiangolo).
 * 🌐 Remove Vietnamese note about missing translation. PR [#9957](https://github.com/tiangolo/fastapi/pull/9957) by [@tiangolo](https://github.com/tiangolo).

From c2a33f1087b5843054de839b47e7fe7200a62504 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 1 Aug 2023 23:39:22 +0200
Subject: [PATCH 037/317] =?UTF-8?q?=F0=9F=8D=B1=20Update=20sponsors,=20Fer?=
 =?UTF-8?q?n=20badge=20(#9982)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/img/sponsors/fern-banner.svg | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/docs/img/sponsors/fern-banner.svg b/docs/en/docs/img/sponsors/fern-banner.svg
index bb3a389f3..e05ccc3a4 100644
--- a/docs/en/docs/img/sponsors/fern-banner.svg
+++ b/docs/en/docs/img/sponsors/fern-banner.svg
@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="300" zoomAndPan="magnify" viewBox="0 0 224.87999 30.000001" height="40" preserveAspectRatio="xMidYMid meet" version="1.0"><defs><filter x="0%" y="0%" width="100%" height="100%" id="976da2d480"><feColorMatrix values="0 0 0 0 1 0 0 0 0 1 0 0 0 0 1 0 0 0 1 0" color-interpolation-filters="sRGB"/></filter><filter x="0%" y="0%" width="100%" height="100%" id="04c6d91fa3"><feColorMatrix values="0 0 0 0 1 0 0 0 0 1 0 0 0 0 1 0.2126 0.7152 0.0722 0 0" color-interpolation-filters="sRGB"/></filter><g/><clipPath id="df2b42bfdc"><path d="M 3.570312 0 L 221.195312 0 L 221.195312 29.03125 L 3.570312 29.03125 Z M 3.570312 0 " clip-rule="nonzero"/></clipPath><clipPath id="ebcc5006ba"><path d="M 13.035156 0 L 36.988281 0 L 36.988281 29.03125 L 13.035156 29.03125 Z M 13.035156 0 " clip-rule="nonzero"/></clipPath><image x="0" y="0" width="664" xlink:href="data:image/png;base64,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" id="ce7911fcdd" height="357" preserveAspectRatio="xMidYMid meet"/><mask id="bec189cfb3"><g filter="url(#976da2d480)"><g filter="url(#04c6d91fa3)" transform="matrix(0.101657, 0, 0, 0.101654, 6.173151, -3.471745)"><image x="0" y="0" width="664" xlink:href="data:image/png;base64,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" height="357" preserveAspectRatio="xMidYMid meet"/></g></g></mask><image x="0" y="0" width="664" xlink:href="data:image/png;base64,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" id="650f1aaacd" height="357" preserveAspectRatio="xMidYMid meet"/><clipPath id="43d9dadc40"><path d="M 36.847656 6.683594 L 76.769531 6.683594 L 76.769531 22.648438 L 36.847656 22.648438 Z M 36.847656 6.683594 " clip-rule="nonzero"/></clipPath><image x="0" y="0" width="664" xlink:href="data:image/png;base64,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" id="9ca5de9e2f" height="357" preserveAspectRatio="xMidYMid meet"/><mask id="9facad5bc3"><g filter="url(#976da2d480)"><g filter="url(#04c6d91fa3)" transform="matrix(0.154125, 0, 0, 0.154513, -13.718275, -15.72553)"><image x="0" y="0" width="664" xlink:href="data:image/png;base64,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" height="357" preserveAspectRatio="xMidYMid meet"/></g></g></mask><image x="0" y="0" width="664" xlink:href="data:image/png;base64,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" id="0607fdc061" height="357" preserveAspectRatio="xMidYMid meet"/></defs><g clip-path="url(#df2b42bfdc)"><path fill="#ffffff" d="M 3.570312 0 L 221.3125 0 L 221.3125 36.289062 L 3.570312 36.289062 Z M 3.570312 0 " fill-opacity="1" fill-rule="nonzero"/><path fill="#ffffff" d="M 3.570312 0 L 221.3125 0 L 221.3125 29.03125 L 3.570312 29.03125 Z M 3.570312 0 " fill-opacity="1" fill-rule="nonzero"/><path fill="#ffffff" d="M 3.570312 0 L 221.3125 0 L 221.3125 29.03125 L 3.570312 29.03125 Z M 3.570312 0 " fill-opacity="1" fill-rule="nonzero"/></g><g clip-path="url(#ebcc5006ba)"><g mask="url(#bec189cfb3)"><g transform="matrix(0.101657, 0, 0, 0.101654, 6.173151, -3.471745)"><image x="0" y="0" width="664" xlink:href="data:image/png;base64,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" height="357" preserveAspectRatio="xMidYMid meet"/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(90.234992, 10.887099)"><g><path d="M 3.359375 0.109375 C 2.835938 0.109375 2.367188 0.046875 1.953125 -0.078125 C 1.546875 -0.210938 1.207031 -0.382812 0.9375 -0.59375 C 0.664062 -0.8125 0.457031 -1.046875 0.3125 -1.296875 L 1.125 -2.296875 L 1.265625 -2.296875 C 1.492188 -1.960938 1.78125 -1.691406 2.125 -1.484375 C 2.476562 -1.285156 2.890625 -1.1875 3.359375 -1.1875 C 3.765625 -1.1875 4.066406 -1.269531 4.265625 -1.4375 C 4.472656 -1.613281 4.578125 -1.847656 4.578125 -2.140625 C 4.578125 -2.328125 4.546875 -2.476562 4.484375 -2.59375 C 4.421875 -2.71875 4.3125 -2.820312 4.15625 -2.90625 C 4 -3 3.789062 -3.078125 3.53125 -3.140625 L 2.5625 -3.359375 C 1.875 -3.515625 1.363281 -3.769531 1.03125 -4.125 C 0.695312 -4.488281 0.53125 -4.960938 0.53125 -5.546875 C 0.53125 -5.972656 0.632812 -6.347656 0.84375 -6.671875 C 1.0625 -7.003906 1.375 -7.257812 1.78125 -7.4375 C 2.195312 -7.613281 2.691406 -7.703125 3.265625 -7.703125 C 3.847656 -7.703125 4.347656 -7.625 4.765625 -7.46875 C 5.179688 -7.320312 5.535156 -7.085938 5.828125 -6.765625 L 5.09375 -5.75 L 4.953125 -5.75 C 4.742188 -5.96875 4.5 -6.132812 4.21875 -6.25 C 3.9375 -6.363281 3.617188 -6.421875 3.265625 -6.421875 C 2.859375 -6.421875 2.546875 -6.347656 2.328125 -6.203125 C 2.109375 -6.054688 2 -5.851562 2 -5.59375 C 2 -5.363281 2.070312 -5.175781 2.21875 -5.03125 C 2.375 -4.882812 2.640625 -4.773438 3.015625 -4.703125 L 4.015625 -4.484375 C 4.753906 -4.328125 5.285156 -4.0625 5.609375 -3.6875 C 5.941406 -3.320312 6.109375 -2.835938 6.109375 -2.234375 C 6.109375 -1.765625 6.003906 -1.351562 5.796875 -1 C 5.597656 -0.644531 5.289062 -0.367188 4.875 -0.171875 C 4.46875 0.015625 3.960938 0.109375 3.359375 0.109375 Z M 3.359375 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(96.758833, 10.887099)"><g><path d="M 3.71875 -7.59375 C 4.945312 -7.59375 5.882812 -7.273438 6.53125 -6.640625 C 7.1875 -6.003906 7.515625 -5.054688 7.515625 -3.796875 C 7.515625 -2.546875 7.1875 -1.597656 6.53125 -0.953125 C 5.882812 -0.316406 4.945312 0 3.71875 0 L 0.984375 0 L 0.984375 -7.59375 Z M 3.625 -1.265625 C 4.414062 -1.265625 5.003906 -1.460938 5.390625 -1.859375 C 5.773438 -2.265625 5.96875 -2.910156 5.96875 -3.796875 C 5.96875 -4.691406 5.773438 -5.335938 5.390625 -5.734375 C 5.003906 -6.128906 4.414062 -6.328125 3.625 -6.328125 L 2.484375 -6.328125 L 2.484375 -1.265625 Z M 3.625 -1.265625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(104.877275, 10.887099)"><g><path d="M 0.984375 0 L 0.984375 -7.59375 L 2.484375 -7.59375 L 2.484375 -4.5 L 2.65625 -4.5 L 5.1875 -7.59375 L 6.734375 -7.59375 L 6.734375 -7.46875 L 3.9375 -4.015625 L 7.015625 -0.125 L 7.015625 0 L 5.328125 0 L 2.65625 -3.28125 L 2.484375 -3.28125 L 2.484375 0 Z M 0.984375 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(111.89456, 10.887099)"><g><path d="M 2.6875 0.109375 C 2.289062 0.109375 1.925781 0.0625 1.59375 -0.03125 C 1.269531 -0.125 0.992188 -0.25 0.765625 -0.40625 C 0.535156 -0.570312 0.367188 -0.757812 0.265625 -0.96875 L 1.0625 -1.828125 L 1.171875 -1.828125 C 1.359375 -1.566406 1.582031 -1.375 1.84375 -1.25 C 2.101562 -1.125 2.382812 -1.0625 2.6875 -1.0625 C 2.96875 -1.0625 3.175781 -1.109375 3.3125 -1.203125 C 3.457031 -1.304688 3.53125 -1.453125 3.53125 -1.640625 C 3.53125 -1.785156 3.476562 -1.90625 3.375 -2 C 3.28125 -2.101562 3.117188 -2.179688 2.890625 -2.234375 L 2.125 -2.421875 C 1.5625 -2.554688 1.148438 -2.757812 0.890625 -3.03125 C 0.628906 -3.3125 0.5 -3.664062 0.5 -4.09375 C 0.5 -4.457031 0.585938 -4.769531 0.765625 -5.03125 C 0.953125 -5.289062 1.207031 -5.488281 1.53125 -5.625 C 1.863281 -5.769531 2.25 -5.84375 2.6875 -5.84375 C 3.207031 -5.84375 3.632812 -5.765625 3.96875 -5.609375 C 4.3125 -5.460938 4.578125 -5.265625 4.765625 -5.015625 L 4 -4.1875 L 3.890625 -4.1875 C 3.734375 -4.363281 3.554688 -4.492188 3.359375 -4.578125 C 3.160156 -4.660156 2.9375 -4.703125 2.6875 -4.703125 C 2.125 -4.703125 1.84375 -4.523438 1.84375 -4.171875 C 1.84375 -4.023438 1.894531 -3.90625 2 -3.8125 C 2.101562 -3.71875 2.289062 -3.640625 2.5625 -3.578125 L 3.265625 -3.421875 C 3.847656 -3.296875 4.269531 -3.097656 4.53125 -2.828125 C 4.800781 -2.554688 4.9375 -2.1875 4.9375 -1.71875 C 4.9375 -1.351562 4.847656 -1.03125 4.671875 -0.75 C 4.492188 -0.476562 4.234375 -0.265625 3.890625 -0.109375 C 3.546875 0.0351562 3.144531 0.109375 2.6875 0.109375 Z M 2.6875 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(117.177001, 10.887099)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(119.685771, 10.887099)"><g><path d="M 3.109375 0.109375 C 2.554688 0.109375 2.070312 0.015625 1.65625 -0.171875 C 1.25 -0.359375 0.929688 -0.625 0.703125 -0.96875 C 0.484375 -1.320312 0.375 -1.726562 0.375 -2.1875 C 0.375 -2.6875 0.5 -3.101562 0.75 -3.4375 C 1 -3.769531 1.375 -4.039062 1.875 -4.25 L 1.890625 -4.359375 C 1.660156 -4.640625 1.492188 -4.894531 1.390625 -5.125 C 1.285156 -5.363281 1.234375 -5.628906 1.234375 -5.921875 C 1.234375 -6.265625 1.316406 -6.570312 1.484375 -6.84375 C 1.648438 -7.113281 1.890625 -7.320312 2.203125 -7.46875 C 2.523438 -7.625 2.90625 -7.703125 3.34375 -7.703125 C 3.757812 -7.703125 4.113281 -7.632812 4.40625 -7.5 C 4.707031 -7.363281 4.9375 -7.171875 5.09375 -6.921875 C 5.25 -6.671875 5.328125 -6.382812 5.328125 -6.0625 C 5.328125 -5.632812 5.195312 -5.257812 4.9375 -4.9375 C 4.675781 -4.625 4.273438 -4.363281 3.734375 -4.15625 L 3.71875 -4.046875 L 5.125 -2.1875 C 5.207031 -2.363281 5.265625 -2.566406 5.296875 -2.796875 C 5.328125 -3.035156 5.34375 -3.300781 5.34375 -3.59375 L 5.34375 -3.859375 L 6.5625 -3.859375 C 6.5625 -2.796875 6.351562 -1.9375 5.9375 -1.28125 C 6.019531 -1.207031 6.09375 -1.15625 6.15625 -1.125 C 6.21875 -1.101562 6.289062 -1.09375 6.375 -1.09375 C 6.445312 -1.09375 6.503906 -1.09375 6.546875 -1.09375 C 6.585938 -1.101562 6.640625 -1.117188 6.703125 -1.140625 L 6.78125 -1.109375 L 6.953125 -0.078125 C 6.890625 -0.0234375 6.796875 0.0078125 6.671875 0.03125 C 6.554688 0.0507812 6.421875 0.0625 6.265625 0.0625 C 6.015625 0.0625 5.789062 0.0195312 5.59375 -0.0625 C 5.40625 -0.144531 5.226562 -0.269531 5.0625 -0.4375 L 4.953125 -0.4375 C 4.515625 -0.0703125 3.898438 0.109375 3.109375 0.109375 Z M 3.109375 -4.875 C 3.421875 -5.03125 3.648438 -5.1875 3.796875 -5.34375 C 3.941406 -5.507812 4.015625 -5.71875 4.015625 -5.96875 C 4.015625 -6.1875 3.953125 -6.351562 3.828125 -6.46875 C 3.703125 -6.582031 3.535156 -6.640625 3.328125 -6.640625 C 3.117188 -6.640625 2.945312 -6.578125 2.8125 -6.453125 C 2.6875 -6.328125 2.625 -6.15625 2.625 -5.9375 C 2.625 -5.769531 2.65625 -5.613281 2.71875 -5.46875 C 2.789062 -5.320312 2.921875 -5.125 3.109375 -4.875 Z M 3.28125 -1.125 C 3.613281 -1.125 3.898438 -1.1875 4.140625 -1.3125 L 2.453125 -3.46875 C 2.253906 -3.332031 2.101562 -3.175781 2 -3 C 1.90625 -2.820312 1.859375 -2.613281 1.859375 -2.375 C 1.859375 -2.125 1.914062 -1.90625 2.03125 -1.71875 C 2.15625 -1.53125 2.320312 -1.382812 2.53125 -1.28125 C 2.75 -1.175781 3 -1.125 3.28125 -1.125 Z M 3.28125 -1.125 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(126.780968, 10.887099)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(129.289738, 10.887099)"><g><path d="M 2.828125 0.109375 C 2.378906 0.109375 1.976562 0 1.625 -0.21875 C 1.28125 -0.4375 1.007812 -0.769531 0.8125 -1.21875 C 0.613281 -1.664062 0.515625 -2.210938 0.515625 -2.859375 C 0.515625 -3.515625 0.613281 -4.066406 0.8125 -4.515625 C 1.019531 -4.960938 1.300781 -5.296875 1.65625 -5.515625 C 2.019531 -5.734375 2.4375 -5.84375 2.90625 -5.84375 C 3.257812 -5.84375 3.566406 -5.78125 3.828125 -5.65625 C 4.085938 -5.53125 4.3125 -5.335938 4.5 -5.078125 L 4.609375 -5.109375 L 4.609375 -8.03125 L 6.046875 -8.03125 L 6.046875 0 L 4.609375 0 L 4.609375 -0.75 L 4.5 -0.765625 C 4.332031 -0.492188 4.109375 -0.28125 3.828125 -0.125 C 3.554688 0.03125 3.222656 0.109375 2.828125 0.109375 Z M 3.296875 -1.109375 C 3.703125 -1.109375 4.019531 -1.253906 4.25 -1.546875 C 4.488281 -1.835938 4.609375 -2.273438 4.609375 -2.859375 C 4.609375 -3.453125 4.488281 -3.894531 4.25 -4.1875 C 4.019531 -4.476562 3.703125 -4.625 3.296875 -4.625 C 2.878906 -4.625 2.554688 -4.476562 2.328125 -4.1875 C 2.109375 -3.90625 2 -3.460938 2 -2.859375 C 2 -2.253906 2.109375 -1.8125 2.328125 -1.53125 C 2.554688 -1.25 2.878906 -1.109375 3.296875 -1.109375 Z M 3.296875 -1.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(136.156392, 10.887099)"><g><path d="M 3.328125 0.109375 C 2.765625 0.109375 2.269531 -0.00390625 1.84375 -0.234375 C 1.425781 -0.460938 1.097656 -0.800781 0.859375 -1.25 C 0.628906 -1.695312 0.515625 -2.234375 0.515625 -2.859375 C 0.515625 -3.492188 0.628906 -4.035156 0.859375 -4.484375 C 1.097656 -4.929688 1.425781 -5.269531 1.84375 -5.5 C 2.269531 -5.726562 2.765625 -5.84375 3.328125 -5.84375 C 3.890625 -5.84375 4.378906 -5.726562 4.796875 -5.5 C 5.222656 -5.269531 5.554688 -4.929688 5.796875 -4.484375 C 6.035156 -4.035156 6.15625 -3.492188 6.15625 -2.859375 C 6.15625 -2.234375 6.035156 -1.695312 5.796875 -1.25 C 5.554688 -0.800781 5.222656 -0.460938 4.796875 -0.234375 C 4.378906 -0.00390625 3.890625 0.109375 3.328125 0.109375 Z M 3.328125 -1.109375 C 4.222656 -1.109375 4.671875 -1.691406 4.671875 -2.859375 C 4.671875 -3.460938 4.554688 -3.90625 4.328125 -4.1875 C 4.097656 -4.476562 3.765625 -4.625 3.328125 -4.625 C 2.441406 -4.625 2 -4.035156 2 -2.859375 C 2 -1.691406 2.441406 -1.109375 3.328125 -1.109375 Z M 3.328125 -1.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(142.815281, 10.887099)"><g><path d="M 3.34375 0.109375 C 2.789062 0.109375 2.300781 -0.00390625 1.875 -0.234375 C 1.445312 -0.460938 1.113281 -0.800781 0.875 -1.25 C 0.632812 -1.695312 0.515625 -2.234375 0.515625 -2.859375 C 0.515625 -3.492188 0.632812 -4.035156 0.875 -4.484375 C 1.113281 -4.929688 1.441406 -5.269531 1.859375 -5.5 C 2.285156 -5.726562 2.769531 -5.84375 3.3125 -5.84375 C 4.519531 -5.84375 5.296875 -5.40625 5.640625 -4.53125 L 4.65625 -3.8125 L 4.546875 -3.8125 C 4.421875 -4.082031 4.265625 -4.285156 4.078125 -4.421875 C 3.890625 -4.554688 3.632812 -4.625 3.3125 -4.625 C 2.894531 -4.625 2.570312 -4.476562 2.34375 -4.1875 C 2.113281 -3.894531 2 -3.453125 2 -2.859375 C 2 -2.273438 2.113281 -1.835938 2.34375 -1.546875 C 2.582031 -1.253906 2.914062 -1.109375 3.34375 -1.109375 C 3.65625 -1.109375 3.914062 -1.191406 4.125 -1.359375 C 4.34375 -1.523438 4.5 -1.769531 4.59375 -2.09375 L 4.703125 -2.09375 L 5.734375 -1.53125 C 5.585938 -1.050781 5.316406 -0.65625 4.921875 -0.34375 C 4.523438 -0.0390625 4 0.109375 3.34375 0.109375 Z M 3.34375 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(148.721019, 10.887099)"><g><path d="M 2.625 0.109375 C 1.976562 0.109375 1.5 -0.0664062 1.1875 -0.421875 C 0.882812 -0.773438 0.734375 -1.28125 0.734375 -1.9375 L 0.734375 -5.734375 L 2.171875 -5.734375 L 2.171875 -2.109375 C 2.171875 -1.765625 2.242188 -1.507812 2.390625 -1.34375 C 2.546875 -1.1875 2.785156 -1.109375 3.109375 -1.109375 C 3.503906 -1.109375 3.8125 -1.238281 4.03125 -1.5 C 4.25 -1.757812 4.359375 -2.171875 4.359375 -2.734375 L 4.359375 -5.734375 L 5.796875 -5.734375 L 5.796875 0 L 4.421875 0 L 4.421875 -0.84375 L 4.3125 -0.875 C 4.125 -0.539062 3.894531 -0.289062 3.625 -0.125 C 3.363281 0.03125 3.03125 0.109375 2.625 0.109375 Z M 2.625 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(155.348743, 10.887099)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.203125 -5.734375 L 2.203125 -4.96875 L 2.3125 -4.9375 C 2.5 -5.25 2.71875 -5.476562 2.96875 -5.625 C 3.21875 -5.769531 3.539062 -5.84375 3.9375 -5.84375 C 4.375 -5.84375 4.722656 -5.753906 4.984375 -5.578125 C 5.242188 -5.410156 5.4375 -5.160156 5.5625 -4.828125 L 5.671875 -4.828125 C 5.847656 -5.171875 6.070312 -5.425781 6.34375 -5.59375 C 6.625 -5.757812 6.972656 -5.84375 7.390625 -5.84375 C 8.578125 -5.84375 9.171875 -5.179688 9.171875 -3.859375 L 9.171875 0 L 7.734375 0 L 7.734375 -3.671875 C 7.734375 -4.003906 7.664062 -4.242188 7.53125 -4.390625 C 7.40625 -4.546875 7.195312 -4.625 6.90625 -4.625 C 6.113281 -4.625 5.71875 -4.097656 5.71875 -3.046875 L 5.71875 0 L 4.28125 0 L 4.28125 -3.671875 C 4.28125 -4.003906 4.210938 -4.242188 4.078125 -4.390625 C 3.941406 -4.546875 3.726562 -4.625 3.4375 -4.625 C 3.070312 -4.625 2.785156 -4.5 2.578125 -4.25 C 2.367188 -4 2.265625 -3.609375 2.265625 -3.078125 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(165.259164, 10.887099)"><g><path d="M 5.65625 -2.546875 L 1.984375 -2.546875 C 2.023438 -2.046875 2.164062 -1.679688 2.40625 -1.453125 C 2.644531 -1.222656 2.972656 -1.109375 3.390625 -1.109375 C 3.722656 -1.109375 3.988281 -1.171875 4.1875 -1.296875 C 4.394531 -1.421875 4.5625 -1.609375 4.6875 -1.859375 L 4.796875 -1.859375 L 5.75 -1.234375 C 5.5625 -0.835938 5.28125 -0.515625 4.90625 -0.265625 C 4.53125 -0.015625 4.023438 0.109375 3.390625 0.109375 C 2.804688 0.109375 2.296875 0 1.859375 -0.21875 C 1.429688 -0.445312 1.097656 -0.785156 0.859375 -1.234375 C 0.628906 -1.679688 0.515625 -2.222656 0.515625 -2.859375 C 0.515625 -3.515625 0.632812 -4.066406 0.875 -4.515625 C 1.125 -4.960938 1.457031 -5.296875 1.875 -5.515625 C 2.300781 -5.734375 2.773438 -5.84375 3.296875 -5.84375 C 4.109375 -5.84375 4.726562 -5.625 5.15625 -5.1875 C 5.582031 -4.757812 5.796875 -4.128906 5.796875 -3.296875 C 5.796875 -3.003906 5.785156 -2.773438 5.765625 -2.609375 Z M 4.421875 -3.46875 C 4.410156 -3.90625 4.3125 -4.222656 4.125 -4.421875 C 3.9375 -4.617188 3.660156 -4.71875 3.296875 -4.71875 C 2.566406 -4.71875 2.140625 -4.300781 2.015625 -3.46875 Z M 4.421875 -3.46875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(171.486939, 10.887099)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.203125 -5.734375 L 2.203125 -4.890625 L 2.3125 -4.859375 C 2.675781 -5.515625 3.253906 -5.84375 4.046875 -5.84375 C 4.710938 -5.84375 5.195312 -5.660156 5.5 -5.296875 C 5.8125 -4.941406 5.96875 -4.414062 5.96875 -3.71875 L 5.96875 0 L 4.53125 0 L 4.53125 -3.546875 C 4.53125 -3.929688 4.453125 -4.207031 4.296875 -4.375 C 4.148438 -4.539062 3.910156 -4.625 3.578125 -4.625 C 3.160156 -4.625 2.835938 -4.488281 2.609375 -4.21875 C 2.378906 -3.957031 2.265625 -3.539062 2.265625 -2.96875 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(178.197769, 10.887099)"><g><path d="M 3.953125 -1.359375 L 4.328125 -0.296875 C 4.171875 -0.171875 3.972656 -0.0703125 3.734375 0 C 3.503906 0.0703125 3.238281 0.109375 2.9375 0.109375 C 2.320312 0.109375 1.851562 -0.0546875 1.53125 -0.390625 C 1.207031 -0.734375 1.046875 -1.226562 1.046875 -1.875 L 1.046875 -4.59375 L 0.171875 -4.59375 L 0.171875 -5.734375 L 1.046875 -5.734375 L 1.046875 -6.859375 L 2.484375 -7.09375 L 2.484375 -5.734375 L 4.109375 -5.734375 L 4.109375 -4.59375 L 2.484375 -4.59375 L 2.484375 -1.96875 C 2.484375 -1.6875 2.539062 -1.476562 2.65625 -1.34375 C 2.78125 -1.21875 2.953125 -1.15625 3.171875 -1.15625 C 3.429688 -1.15625 3.65625 -1.222656 3.84375 -1.359375 Z M 3.953125 -1.359375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(182.649148, 10.887099)"><g><path d="M 2.234375 0.109375 C 1.867188 0.109375 1.550781 0.0390625 1.28125 -0.09375 C 1.007812 -0.226562 0.800781 -0.425781 0.65625 -0.6875 C 0.507812 -0.945312 0.4375 -1.257812 0.4375 -1.625 C 0.4375 -1.96875 0.507812 -2.253906 0.65625 -2.484375 C 0.800781 -2.710938 1.023438 -2.898438 1.328125 -3.046875 C 1.628906 -3.191406 2.03125 -3.304688 2.53125 -3.390625 C 2.875 -3.441406 3.132812 -3.5 3.3125 -3.5625 C 3.488281 -3.632812 3.609375 -3.710938 3.671875 -3.796875 C 3.734375 -3.878906 3.765625 -3.984375 3.765625 -4.109375 C 3.765625 -4.296875 3.695312 -4.4375 3.5625 -4.53125 C 3.4375 -4.632812 3.226562 -4.6875 2.9375 -4.6875 C 2.613281 -4.6875 2.304688 -4.613281 2.015625 -4.46875 C 1.734375 -4.320312 1.484375 -4.132812 1.265625 -3.90625 L 1.171875 -3.90625 L 0.5625 -4.8125 C 0.851562 -5.132812 1.207031 -5.382812 1.625 -5.5625 C 2.050781 -5.75 2.507812 -5.84375 3 -5.84375 C 3.757812 -5.84375 4.304688 -5.679688 4.640625 -5.359375 C 4.984375 -5.035156 5.15625 -4.578125 5.15625 -3.984375 L 5.15625 -1.5 C 5.15625 -1.238281 5.269531 -1.109375 5.5 -1.109375 C 5.582031 -1.109375 5.664062 -1.125 5.75 -1.15625 L 5.828125 -1.140625 L 5.921875 -0.140625 C 5.847656 -0.0859375 5.738281 -0.0390625 5.59375 0 C 5.445312 0.03125 5.289062 0.046875 5.125 0.046875 C 4.78125 0.046875 4.507812 -0.0195312 4.3125 -0.15625 C 4.125 -0.289062 3.988281 -0.5 3.90625 -0.78125 L 3.796875 -0.78125 C 3.515625 -0.1875 2.992188 0.109375 2.234375 0.109375 Z M 2.6875 -0.96875 C 3.019531 -0.96875 3.285156 -1.078125 3.484375 -1.296875 C 3.679688 -1.523438 3.78125 -1.835938 3.78125 -2.234375 L 3.78125 -2.8125 L 3.6875 -2.84375 C 3.601562 -2.769531 3.488281 -2.707031 3.34375 -2.65625 C 3.207031 -2.613281 3.007812 -2.570312 2.75 -2.53125 C 2.4375 -2.476562 2.207031 -2.382812 2.0625 -2.25 C 1.925781 -2.125 1.859375 -1.945312 1.859375 -1.71875 C 1.859375 -1.46875 1.929688 -1.28125 2.078125 -1.15625 C 2.222656 -1.03125 2.425781 -0.96875 2.6875 -0.96875 Z M 2.6875 -0.96875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(188.689934, 10.887099)"><g><path d="M 3.953125 -1.359375 L 4.328125 -0.296875 C 4.171875 -0.171875 3.972656 -0.0703125 3.734375 0 C 3.503906 0.0703125 3.238281 0.109375 2.9375 0.109375 C 2.320312 0.109375 1.851562 -0.0546875 1.53125 -0.390625 C 1.207031 -0.734375 1.046875 -1.226562 1.046875 -1.875 L 1.046875 -4.59375 L 0.171875 -4.59375 L 0.171875 -5.734375 L 1.046875 -5.734375 L 1.046875 -6.859375 L 2.484375 -7.09375 L 2.484375 -5.734375 L 4.109375 -5.734375 L 4.109375 -4.59375 L 2.484375 -4.59375 L 2.484375 -1.96875 C 2.484375 -1.6875 2.539062 -1.476562 2.65625 -1.34375 C 2.78125 -1.21875 2.953125 -1.15625 3.171875 -1.15625 C 3.429688 -1.15625 3.65625 -1.222656 3.84375 -1.359375 Z M 3.953125 -1.359375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(193.141313, 10.887099)"><g><path d="M 1.546875 -6.421875 C 1.285156 -6.421875 1.070312 -6.5 0.90625 -6.65625 C 0.75 -6.8125 0.671875 -7.015625 0.671875 -7.265625 C 0.671875 -7.503906 0.75 -7.703125 0.90625 -7.859375 C 1.070312 -8.023438 1.285156 -8.109375 1.546875 -8.109375 C 1.710938 -8.109375 1.863281 -8.070312 2 -8 C 2.132812 -7.925781 2.238281 -7.820312 2.3125 -7.6875 C 2.394531 -7.5625 2.4375 -7.421875 2.4375 -7.265625 C 2.4375 -7.097656 2.394531 -6.953125 2.3125 -6.828125 C 2.238281 -6.703125 2.132812 -6.601562 2 -6.53125 C 1.863281 -6.457031 1.710938 -6.421875 1.546875 -6.421875 Z M 0.828125 0 L 0.828125 -5.734375 L 2.265625 -5.734375 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(196.226632, 10.887099)"><g><path d="M 3.328125 0.109375 C 2.765625 0.109375 2.269531 -0.00390625 1.84375 -0.234375 C 1.425781 -0.460938 1.097656 -0.800781 0.859375 -1.25 C 0.628906 -1.695312 0.515625 -2.234375 0.515625 -2.859375 C 0.515625 -3.492188 0.628906 -4.035156 0.859375 -4.484375 C 1.097656 -4.929688 1.425781 -5.269531 1.84375 -5.5 C 2.269531 -5.726562 2.765625 -5.84375 3.328125 -5.84375 C 3.890625 -5.84375 4.378906 -5.726562 4.796875 -5.5 C 5.222656 -5.269531 5.554688 -4.929688 5.796875 -4.484375 C 6.035156 -4.035156 6.15625 -3.492188 6.15625 -2.859375 C 6.15625 -2.234375 6.035156 -1.695312 5.796875 -1.25 C 5.554688 -0.800781 5.222656 -0.460938 4.796875 -0.234375 C 4.378906 -0.00390625 3.890625 0.109375 3.328125 0.109375 Z M 3.328125 -1.109375 C 4.222656 -1.109375 4.671875 -1.691406 4.671875 -2.859375 C 4.671875 -3.460938 4.554688 -3.90625 4.328125 -4.1875 C 4.097656 -4.476562 3.765625 -4.625 3.328125 -4.625 C 2.441406 -4.625 2 -4.035156 2 -2.859375 C 2 -1.691406 2.441406 -1.109375 3.328125 -1.109375 Z M 3.328125 -1.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(202.885521, 10.887099)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.203125 -5.734375 L 2.203125 -4.890625 L 2.3125 -4.859375 C 2.675781 -5.515625 3.253906 -5.84375 4.046875 -5.84375 C 4.710938 -5.84375 5.195312 -5.660156 5.5 -5.296875 C 5.8125 -4.941406 5.96875 -4.414062 5.96875 -3.71875 L 5.96875 0 L 4.53125 0 L 4.53125 -3.546875 C 4.53125 -3.929688 4.453125 -4.207031 4.296875 -4.375 C 4.148438 -4.539062 3.910156 -4.625 3.578125 -4.625 C 3.160156 -4.625 2.835938 -4.488281 2.609375 -4.21875 C 2.378906 -3.957031 2.265625 -3.539062 2.265625 -2.96875 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(118.893006, 25.403228)"><g><path d="M 1 0 L 1 -4.59375 L 0.1875 -4.59375 L 0.1875 -5.734375 L 1 -5.734375 C 0.945312 -5.972656 0.921875 -6.203125 0.921875 -6.421875 C 0.921875 -6.785156 1 -7.09375 1.15625 -7.34375 C 1.320312 -7.601562 1.5625 -7.800781 1.875 -7.9375 C 2.1875 -8.070312 2.5625 -8.140625 3 -8.140625 C 3.625 -8.140625 4.09375 -8.03125 4.40625 -7.8125 L 4.078125 -6.75 L 3.96875 -6.734375 C 3.75 -6.890625 3.472656 -6.96875 3.140625 -6.96875 C 2.878906 -6.96875 2.679688 -6.898438 2.546875 -6.765625 C 2.421875 -6.640625 2.359375 -6.46875 2.359375 -6.25 C 2.359375 -6.15625 2.363281 -6.066406 2.375 -5.984375 C 2.382812 -5.910156 2.40625 -5.828125 2.4375 -5.734375 L 4.078125 -5.734375 L 4.078125 -4.59375 L 2.4375 -4.59375 L 2.4375 0 Z M 1 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(123.027542, 25.403228)"><g><path d="M 3.328125 0.109375 C 2.765625 0.109375 2.269531 -0.00390625 1.84375 -0.234375 C 1.425781 -0.460938 1.097656 -0.800781 0.859375 -1.25 C 0.628906 -1.695312 0.515625 -2.234375 0.515625 -2.859375 C 0.515625 -3.492188 0.628906 -4.035156 0.859375 -4.484375 C 1.097656 -4.929688 1.425781 -5.269531 1.84375 -5.5 C 2.269531 -5.726562 2.765625 -5.84375 3.328125 -5.84375 C 3.890625 -5.84375 4.378906 -5.726562 4.796875 -5.5 C 5.222656 -5.269531 5.554688 -4.929688 5.796875 -4.484375 C 6.035156 -4.035156 6.15625 -3.492188 6.15625 -2.859375 C 6.15625 -2.234375 6.035156 -1.695312 5.796875 -1.25 C 5.554688 -0.800781 5.222656 -0.460938 4.796875 -0.234375 C 4.378906 -0.00390625 3.890625 0.109375 3.328125 0.109375 Z M 3.328125 -1.109375 C 4.222656 -1.109375 4.671875 -1.691406 4.671875 -2.859375 C 4.671875 -3.460938 4.554688 -3.90625 4.328125 -4.1875 C 4.097656 -4.476562 3.765625 -4.625 3.328125 -4.625 C 2.441406 -4.625 2 -4.035156 2 -2.859375 C 2 -1.691406 2.441406 -1.109375 3.328125 -1.109375 Z M 3.328125 -1.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(129.686431, 25.403228)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.21875 -5.734375 L 2.21875 -4.875 L 2.328125 -4.859375 C 2.472656 -5.171875 2.65625 -5.398438 2.875 -5.546875 C 3.101562 -5.703125 3.378906 -5.78125 3.703125 -5.78125 C 4.023438 -5.78125 4.269531 -5.722656 4.4375 -5.609375 L 4.203125 -4.375 L 4.09375 -4.359375 C 4 -4.390625 3.90625 -4.414062 3.8125 -4.4375 C 3.726562 -4.457031 3.625 -4.46875 3.5 -4.46875 C 3.101562 -4.46875 2.796875 -4.320312 2.578125 -4.03125 C 2.367188 -3.75 2.265625 -3.300781 2.265625 -2.6875 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(134.179363, 25.403228)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(136.688133, 25.403228)"><g><path d="M 1.265625 2.4375 C 1.023438 2.4375 0.800781 2.414062 0.59375 2.375 C 0.394531 2.332031 0.234375 2.28125 0.109375 2.21875 L 0.34375 1.0625 L 0.4375 1.03125 C 0.519531 1.070312 0.625 1.101562 0.75 1.125 C 0.882812 1.15625 1.019531 1.171875 1.15625 1.171875 C 1.382812 1.171875 1.578125 1.140625 1.734375 1.078125 C 1.890625 1.023438 2.019531 0.925781 2.125 0.78125 C 2.226562 0.644531 2.320312 0.453125 2.40625 0.203125 L 0.125 -5.734375 L 1.625 -5.734375 L 3.0625 -1.75 L 3.1875 -1.75 L 4.5625 -5.734375 L 6.03125 -5.734375 L 3.734375 0.359375 C 3.546875 0.847656 3.34375 1.242188 3.125 1.546875 C 2.90625 1.847656 2.644531 2.070312 2.34375 2.21875 C 2.039062 2.363281 1.679688 2.4375 1.265625 2.4375 Z M 1.265625 2.4375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(142.837996, 25.403228)"><g><path d="M 3.328125 0.109375 C 2.765625 0.109375 2.269531 -0.00390625 1.84375 -0.234375 C 1.425781 -0.460938 1.097656 -0.800781 0.859375 -1.25 C 0.628906 -1.695312 0.515625 -2.234375 0.515625 -2.859375 C 0.515625 -3.492188 0.628906 -4.035156 0.859375 -4.484375 C 1.097656 -4.929688 1.425781 -5.269531 1.84375 -5.5 C 2.269531 -5.726562 2.765625 -5.84375 3.328125 -5.84375 C 3.890625 -5.84375 4.378906 -5.726562 4.796875 -5.5 C 5.222656 -5.269531 5.554688 -4.929688 5.796875 -4.484375 C 6.035156 -4.035156 6.15625 -3.492188 6.15625 -2.859375 C 6.15625 -2.234375 6.035156 -1.695312 5.796875 -1.25 C 5.554688 -0.800781 5.222656 -0.460938 4.796875 -0.234375 C 4.378906 -0.00390625 3.890625 0.109375 3.328125 0.109375 Z M 3.328125 -1.109375 C 4.222656 -1.109375 4.671875 -1.691406 4.671875 -2.859375 C 4.671875 -3.460938 4.554688 -3.90625 4.328125 -4.1875 C 4.097656 -4.476562 3.765625 -4.625 3.328125 -4.625 C 2.441406 -4.625 2 -4.035156 2 -2.859375 C 2 -1.691406 2.441406 -1.109375 3.328125 -1.109375 Z M 3.328125 -1.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(149.496884, 25.403228)"><g><path d="M 2.625 0.109375 C 1.976562 0.109375 1.5 -0.0664062 1.1875 -0.421875 C 0.882812 -0.773438 0.734375 -1.28125 0.734375 -1.9375 L 0.734375 -5.734375 L 2.171875 -5.734375 L 2.171875 -2.109375 C 2.171875 -1.765625 2.242188 -1.507812 2.390625 -1.34375 C 2.546875 -1.1875 2.785156 -1.109375 3.109375 -1.109375 C 3.503906 -1.109375 3.8125 -1.238281 4.03125 -1.5 C 4.25 -1.757812 4.359375 -2.171875 4.359375 -2.734375 L 4.359375 -5.734375 L 5.796875 -5.734375 L 5.796875 0 L 4.421875 0 L 4.421875 -0.84375 L 4.3125 -0.875 C 4.125 -0.539062 3.894531 -0.289062 3.625 -0.125 C 3.363281 0.03125 3.03125 0.109375 2.625 0.109375 Z M 2.625 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(156.124608, 25.403228)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.21875 -5.734375 L 2.21875 -4.875 L 2.328125 -4.859375 C 2.472656 -5.171875 2.65625 -5.398438 2.875 -5.546875 C 3.101562 -5.703125 3.378906 -5.78125 3.703125 -5.78125 C 4.023438 -5.78125 4.269531 -5.722656 4.4375 -5.609375 L 4.203125 -4.375 L 4.09375 -4.359375 C 4 -4.390625 3.90625 -4.414062 3.8125 -4.4375 C 3.726562 -4.457031 3.625 -4.46875 3.5 -4.46875 C 3.101562 -4.46875 2.796875 -4.320312 2.578125 -4.03125 C 2.367188 -3.75 2.265625 -3.300781 2.265625 -2.6875 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(160.61754, 25.403228)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(163.12631, 25.403228)"><g><path d="M 7.296875 0 L 5.703125 0 L 5.140625 -1.75 L 2.234375 -1.75 L 1.65625 0 L 0.109375 0 L 2.734375 -7.59375 L 4.671875 -7.59375 Z M 3.609375 -6.015625 L 2.640625 -3.015625 L 4.71875 -3.015625 L 3.734375 -6.015625 Z M 3.609375 -6.015625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(170.527961, 25.403228)"><g><path d="M 3.921875 -7.59375 C 4.460938 -7.59375 4.925781 -7.492188 5.3125 -7.296875 C 5.695312 -7.097656 5.988281 -6.816406 6.1875 -6.453125 C 6.382812 -6.097656 6.484375 -5.6875 6.484375 -5.21875 C 6.484375 -4.738281 6.382812 -4.316406 6.1875 -3.953125 C 5.988281 -3.597656 5.695312 -3.320312 5.3125 -3.125 C 4.925781 -2.925781 4.460938 -2.828125 3.921875 -2.828125 L 2.484375 -2.828125 L 2.484375 0 L 0.984375 0 L 0.984375 -7.59375 Z M 3.71875 -4.015625 C 4.5625 -4.015625 4.984375 -4.414062 4.984375 -5.21875 C 4.984375 -6.007812 4.5625 -6.40625 3.71875 -6.40625 L 2.484375 -6.40625 L 2.484375 -4.015625 Z M 3.71875 -4.015625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(177.467333, 25.403228)"><g><path d="M 2.484375 0 L 0.984375 0 L 0.984375 -7.59375 L 2.484375 -7.59375 Z M 2.484375 0 "/></g></g></g><g clip-path="url(#43d9dadc40)"><g mask="url(#9facad5bc3)"><g transform="matrix(0.154125, 0, 0, 0.154513, -13.718275, -15.72553)"><image x="0" y="0" width="664" xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAApgAAAFlCAIAAADAtw/EAAAABmJLR0QA/wD/AP+gvaeTAAAgAElEQVR4nOy9e3Ac+Xbfd86vu6fnjWcPCQLgc58zvHufu9qVZHM2JXklrWQ9cocpl/xQrHIlpVspV6KUKpWkisOq/BE7FSVlR7IrVXFJqdiKgLUV21dlrR7eoeyrpXSvrnT3cmaX5HKXJMAHponXABjMo/t38sfv1z0N8AUCA4AEz2ereIHBTE/PAHe+fV7fA8AwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDMMwDNNncL9P4LmHIl/zb4NhGIZ5Qlg69hMiKAOcD74tTZcc1wGAnJsrl8v7dloMwzDMswML+b5RpvIZqBSh8p/fOHpndSjtJw7NTLpNKNQK6g7VfNV13Eqxwr8lhmEY5mGwROwPH3xQvn4cbhyHk59d/bNL9Yw1aCdgeQVgNS4MI7maMWZGAKB8rvzO+++cunbKddzps9P7fdYMwzDMUwcL+T4wNTWVTLqplHtr3Bq0h67c+OT2wqwQBkgQBkpByWSqO2u6yWUfYPL7hWq+CgDq31qhxr80hmEYJoQ1Ya8pU9mpOk7N8cavtTJtG2wp5eVb1Xa3LRAJABGJJAKCAPTMTstEEGt2a96j6dJ0vprPuTnOtzMMwzAKY79P4PmCiACglqvJ1vx6rJHGJCKYhtWV3UZzWQgDAQkIAQkACAgJY56wvCE7tjqwlP/k1TN/8KO/8Qu/ka/mC6XC9d+43uuUYxiGYZ5LWMj3DiIAgOPwC3M3rs5c++TI8CGBAgAR0DCshZV7AICIgACIiAiAACQAAKBLMuPZSdOeG7/5pY9e+6HK20rOi8Vibbq2n6+KYRiG2Vc4P7t3fEDFIlQurpbv3MitdeeFYYJOpJNAcb3+2b1G3TRMCAJ3RDVljoBEBOF3XYkrsdY6UWct4bhOzs0BAI+rMQzDPJ+I/T6B54Wpqan2zKnzUL69dHfFvxdVcXWHkaxjCCP8FhGIgBAJiQhRlc8BgCAmaNizT/iJyQTGh1oAUM1Xix8UN3jLMAzDMM8HnFrfC8pUBgDzL16z/JVuM2EJCwGjKk5Almk1mssdry1QICDpzDogqLo5ICIhqvI5AkgEBMqMWJ5oHb56kjPtDMMwzyecWt8LlJAf/ighO4tZO4uAAIE+B3G5Icy5pTs33c/D7DoiAuiWN4BA9hEAEAkoCMCFiQuivUbUWY2rW3jifEsQFCtFu21PzE4AQLaRHWgMVPPVar5aK9QAIF/NF2qFQq2wnF1uZBvVfLWRbfD4H8MwTxv8mbTrTE1NuXnXoDbGVpItQ6ABgXgrqQ4q4uj7/ie3LnW6HSEEESEgISnV1x3sWsmJEBAQQjlHSJp2vdNxO/Dhmx/OTs6qG5kNEBQrRcd1lHde5UylUqyUz5fVgH5oqFc+Vw4fUT6vv1b3mS5NA+iDAAD77jEM8zTAqfXdRcXiTs3B+KIhPBN7pXGdWlcygAAEhjBandZaa0UIgYgEQVAOEGTYAQFI/UzdGNyhS9I05crQ4oevfQ8AipXiL5z4hUqlstcv+OmjXC7nS/nX3319Lbn27Te+ffa9s+r2xfG7X/705eWxuZFWKkOmzKxhoj138vrkfG5kPXl0fvSrnxRkZi0uYH10IWFAc2Txi7cmB7vWH3/lu2ffO5tzc6qcUSqUXn/39XffeJffbYZh9gWOJnaXD+iDC3DhtasnF1ev2mYCtSBvDLWBwt71xvryp7c/EcKI/GTzMYkIEQgAKRD7IDRHFJcP3+x2jdf/4EfrTv25NnYlyFfzAFC8UMy5uWq+unD81qGlodRaMld3yPK8ZKud6FrCE0ACBUmJBhIh+EAoCUgIEISSAIS+2iKfkln3VjuJzRQBNJNrd4cWhm9MFmqFulOvnKkAW+8xDLPn8EfOLjI1NZV9M/vO5DvvXf8nreVFIQSE4Tj0Au6w5Q0AAPDT2x+vtFYMpeWku90ecHSdbA8b4fRRECDRxpVu/KbVUnd83rRcTeJV89Xp0nRpujTpxUAQSVOm1m0rRn4bCVAgST3arwYENoAb1suG775+h4UgKQUKD6grSTQTQngg8abZVc+osvQ8EMgwzN7AQr6LTE1NAUD8peYi3DAineobit8AELS2EZEhDHd57kb9M2NTy9sDUSZwWu8RQLXPEQJIE1e6MN8BJ7mWSzXLb1d2+8U+DZSmSgAQztZfef3PzWTzJPirjTHErkAE6l01bRJr1X+ooQ3/zyAKb9og+KrvUAIJiYkB9zMwus3ky9/+KgSb64oXiiznDMPsNizku4VS8fXBO/Pp607KMXo+6pu1OeL2AojY6bYv3/rYk12BQofdj/419ertuoQOQABEltmV7cHUUn0t6TZTBzsuVxKuGGklU52YbUmZXZPCA4EgSfUWBCG4GsjfKNYb0iJq8C8IwXv36zUnhE2K4W8OEEAaxmJqLrP8z37uvfL58tTXp1QDPP//jGGY3YOb3XYFpQquW+iM3k7HbcPY3OMW1XJEROp9axlWs9NsttZUKh4AHppdDx9PgTpBeCxEIkRa79h31xMAUCgVDuSIeblcLhaLANBMNYdNP23APeEND7Ugvq7fVN3Xj6hSItFrHgBQqXXAwBhXueMG/wACIhCGyh4xANAHC1UaCRCJ4q2koFc/e6FWqH74le8CAM/3Mwyzq7CQ7wqlUqlQmJ5pHlu11wwjjaglWcWE92fL9WCZyu8KYaBYXF0Im9IflV3Xx4WwMS4IGFWmXZgIJmBTIhw8LScoFotrqbWcm2s7CwPppmN2AY1BE1HqYkMozyqxQZGIvKfaOq/+oDdZO9+rgJvUcUKXnqhPDyJSUG1HxIQ0cs3B0ZXMWD13/PLLjuu8+8a7xWKRO9sZhuk7bNG6W0xPTy3gmsCRcHAcVDr3QYIRNXqT0k/F08l4imTguL4VdPscobKLCUN4MoYNdCwCAMd1DkzJtlwuFyvFSrFSqBW6Y/VkohMzRFPGBaAgwkB4SZXFSYmu1nXYyrXRfYQ2PjpQJ2W0R0SonwJJW+8RAiGS/+qdia/NnDqUMoTTAYC6U4+WABiGYfoC1+76j9o43lh1v3uz+tdf/pJAEXVjfZiERIu0Qhi37t28s3ir5/L2yOR65CgAuhDcq5sDApiyvZweunxSuaA867/20lRJdbTdKFRFsjVMtiAEqWbwgnG8oKCNQRpkt85Gt8GRHh7QlvjqakqfwOKRofjn3Tu0yktuGIbpO8/4J/pTiZodP/rpsFhZtEwLwmb1x2kJaRUggWKtvXblVg3CxSpbVXIlHQSgnlErCgG2rJhrLP2/f+13AZ7tX3u5XFYj8hOdOMRasXikER1R9SdgoKGAm7vadovgEkr/o1oUoztwENZ9wsWB4RuTz/uIP8MwfYVT632GCByonINzGdM0DbOnIbipMfoBYNBTJUmm7FQ2mZUk1WN1QXYrqOK47qoLku1AiW7bjLd/9g/+WrHyzM5EEQBB5Uwl5+YmvXgi04zZECQdtG4Sab8dCK989uaqBYN/9NUTkr52Q3VmICluQjLZXn7xc9dxS/nq4/4cGIZhtgQLeZ+pVksFOP+nV//ntfnbYRMVBaNlj36s/uQP7jyQHFK36/L3kygShqNWkUeOLQ2+XB8rXig+k8XaQPaGPbv14udGuuVpz9qgl416PWtbz1/0GT0wELQeqgK6HiBE9IES7cTIyuuOWyrUypEXxTAMs21YyPvP9PTUveVZw4qpj2893E2PF5ao0kuidDxjGVYwK4WPDegfeLwg16v9TmSm2Xjpmuu4z1jjW/DSX749bidblGlib2xe9bKFLeT7VjigwG5G/aLCNfLalzeYPe+24dZ88n+6+sPn9+c0GYY5aLCQ95MylS9AceVorfl5HYUZROOEwYDZYwn72ohkwk5mEllf+qB8159Un8L9KtrfRMersezaRCepWq6eDSIq/pXrp44ujBKpde1BII7Y6wbccxVX0k3heVJ0sE3N85Mvfc/3fJICRdxKOINjE9aP/J3rz1pShGGYpxIW8n7iVB234KLA5qkvoPpo1+tNcIup3nCxmWIoPSK0XwkC3WcJ/vjDQZDiBQQ9SE3SsE1/4ejMs5Vgf/n2xFeunzq64JDUpW8K/tM75PZQwoPIm4go7FEMvGT0HaT0fen7vgcA6XhmbHj85KEXXjzyysvj+ZOHXrhxHb60VHimuw4ZhnlK4A+SfvJ7N3+vcbFhfHG12b4tQKiMatSEZCtEloyjJ72rtz5udVt6Q/m29Cq6MjU0NGlJutMRahrqac6xl6ZK1Xz1yFrW8eyj8w5Q76omVPI9/SsmCPsOH2DsQyRJKs/8eCyRslOpeDppp+JWQggDgCQRAJGUyVhuMH6qeLy4jYl2hmGYKOZ+n8DBgQhmZqqTpf/m33z0z0AgUK9c+0Qf1mGDOgFZhpWMp5udpgABGEyUPSFBel1LuBKhpElWbD1Xy6nlm08nKmFQqBUOxygpwp5B6C2e2SsVD58RYPNkGUT02zKsRCyZTmSGUsNxO2GgoVIsUkpfeuH9JfiUhuJEsQKVvTh7hmEONJxa7xsVKE5O/vK/d8/NtD4Npp+2ND6+mejdEYfSwyo5Hty8nUZn1NvLA4cSAvKNJGD5XNlu209ngr1cLjuuAwCjFtkGqoRCr4F/T1Q8TKGHzxsmzzFS/AaAbGLgqHPixfFXXxx/ZXL0WCqeRhCSpC99KSWEiXd9WKQmnofz7Zn27r4AhmGeAzgi7xsuOOehfMqrp8wcAIZ7L7ej5QFS+pl4NhlLrXeaQi8v39bBgtnmsPWNgEY8u/Qn70Aju71z2wNybm7p+M1BacugcaCXT99lFacgiR+642HkUsonSSRNYWSTg5lENpPIJO2UEIaUvlL38Djhapbon4FEqoObn87X3jxA1vcMw+wTHJH3kRIAGHjassyoyGxbxdUDhWFkkwNEYVQHW3WG2Xw4JUUbDEuH7GPplAkb14A+DZSmSnWn/tEP/Nm/+IlvSil0GlvvhtldFdfKvbEFXT27JOn5HoFM2smxoSMvjedfGHtpbOhIyk4Tke974axgz+r+AdbuJHxyaK5WquWhulsvg2GY5wYW8r7hgHMOzsU7SCggYq26DTZ87hNlkllEAeF08hZG0h9yXO35BkgESASDdxcyCABQzVefHnMSlVR3HdeKt3/lm1/vub5Qb9Ss71Ck6K2fKNKC7vu+L31TmE720Atjr7x45JXxkWPJeErF3zK4zNIPh8AERhvB6OaGsGfCg3UjO38Oyvbktf6/EoZhnjM4td4flAp8727FW5lDssJC97ZVJ0zqElAqnk7YyWZ7TTdP0Q6kLGxgV85vPg0LcctZrBVq+Wq+Bk9Lpjfn5mLZtVhDAoCKix+4yn3nhCl0gHDxCei9J0Sqi80QxmBqaCA9lIln4rGE7jsnHyJ5AohMB4QR/MZfk26QkyStzuDIvbvVhVKxwHbrDMPsFI7I+4NqP/60e3mxpcRSh+Nb9IG5n1APiMgS1lB6JLIb5PG27Q9Fu8IErVuALa+VlmZputTINp6GoFwl1RePzsRNHyHIbQQ+s31W8Z79DukIPHCq931PkrRj8UODYy8defXk2Euj2VzMsn3pq0J4GLArR5rw3B58htj7hUqS7STe/eTHL0CRR88Yhtk5HJH3h/bMtfOTF/LNrCl8uD84e3Kim08lyUwiaxpmz4x9JwIQTkIr2znAI8u5yyN3Zidn9z8oJ6hWq4VaYczywRCRZDcE+1/69DyR66RI5IxSSknSEGYmOehkc5lk1hQmAEg1AQ4Q2NhTaA+gjvCIX3T0ngBEgFn7bq3UfHNmpj8vhmGY5xuOyPvDLMzkp6sr2BAY69fCjl6TM8m4FU/Ekr1aLG235Q3uS/kSkLmeSSdL0/vf75av5muFmjc6HxeeDExXNs19bZueHZuK70NTFwQCPUhmmbGxofEXj7zy4pGXhzMjBhqSpCQJGC40p/Ai4FEheJSNb/Y6+p2RNS6QMwzTL1jI+0MWslAqxSFuCvXJ3p9qbqi5pmFlklnVu65/tO2WN4BwsEpHpUAn3vjy0bRTvLCvG04JGtlGabqUJgMwhuHaNwo9cnZEr10u8MZRt3i+R0TZRPaoc/yV8fzE6LF0PK262HrPqpa6P5F+R15XmF+RkkxIfDoy9v7MLxbZDYZhmH7AQt4fGpMDANAZiBOJMPW9/Ur2fRDJodSIGV2Gtt3qO0BYZdf+MAC4/m8vnRys59zcmf0zeitWirOTs1Zq/cjaIKgGsh3Pm4UbTYhIe+EEiW41SyZQDKdHXjry6gtjr+QGDpum5UtvYxe6bisIvniy89j0N+ATeVLmp/PXGl/hAjnDMH2Bhbw/tKFdg5rsdg0jqLz243M6LGZLkvFYPBVPK43p+YxsF9Qlcr1bE4Day+1z58oVp74/LW8EdadePl9OIBJBtA9g+ypOwWvUlyt6GEyqLLphjQ9PvjT+6snDL6YTGQJtsxrxX1Nfq3+3+fvsjaQBSJL1tRUf0M27Ts3ZzuEYhmHug5vd+oMLLgD47bYn0RS6ht2H1Dr1FpELFOl4ZnltKfzpji4XlF4Gok0EMxj/5e999Ve/+Of70vJWrBQrxcrNy9WhThxE4Aq/rTn83pKY8Ai6Nx188oEgGU8NpUeG08O2lZDkS5JhvVx1sUXrDjv5JZI23FcNcQBIiSPJeydaAK1vnP7Gtg/LMAwThSPy/lDGchnLiTUhtKGnNmfd6XERgsErIKJMIqvWoOkf7uxCAaMLvRGtDswuD+1Py1sQjovkuikCb1QA5Ui7dTHXLYC9cTI9UkYEnu8RUCaePXH4hZfHXx0bOmIZMV96eilc0MEOsKF7YIeElrgA4AN1hOwMcD6dYZg+wxF5P0FENITOWPdpWCrs85Ikk3YqZadX11cMw4iOJm/30Bvm0ADh8OLgpeM31Y/2cjeoCsdnrlxywOy18+l9paGf7GPomaJHTl31rAkUw5mR0eyhdDxtCMOXvrJD14F7kD7pSxS+4XzCvbEAANTOwOrwUzCqzzDMwYIj8n6Cov8NTKo7XUmLIYzB1DDpPrAdP9XmOTSyLJnp2MrlbacH3zpBOI6JFnTNcNWqSq0/WsUpcFbdOKutLk2k53uIwhk49OKRV04eejGbyAJAKOEY2NWG70N/3WZ6E/8EBCSl17W1ipex3McnYhjmOYcj8l2gv0FXsA4VAIgoHU/3nGF2HpSHjeGABGRIHFgeUC5ve1YmV7Pjl29+Z0ImJEm9c2QLL0wXs6FX1QbdyyYlSduyR7PDo9lcwk4CkQwm98JCePj1ZivVfrBpeRoBdZLYseVjH8gwDPOksJD3FQpqun3V8jDKlCTjsUTcijfba4hGzyR8R/ROF8kYaWQHLr9Yd+o7PuzWIGjMNErTJXO0gc24bi4PBsUeFo6HLm9RGe5JuGmPZB3lqApEMlgqqi5W+tjL9vDXtGHynYCk7DazuDYIwOE4wzD9hlPr/YSIQMoN3/aDYI8HAoBpmJnEQDjovPOnIIg4y5APRqeTq+fc3N44w+Sr+dnJWW90cbw5An50tP3BKq4j3cAoJrR7k1J6vhezYhOjR1+ayI+PTFqGJaUvSfY2ikbmCHZDv0PCfemk59hlYsBZPER52MOCBcMwzw0ckfeHMpUBYP0zaa+CgcaGnVp9IliTTYOpofry3agv205Sw+GSTVV5t23ZzDZi9dyeBeWl6ZKRW5TU0T36D2kaD33mdWsahBLuS6KEnRxJj45knJgVkyT9IAoHCJVfW+jsqoRHzzOsjje7K8nuxDn4pQpUOBxnGKbvsJD3B6fquAXXaNqm4WnLlr7u3Ix4fMqEnUzEkmvtVQMNXT7f2Q4VCJrDVenY7Maq+erE7ERfzvwRlMvl+oW6mWzjkrZeoWAt26a0ei8fHqlnSykJyLbiuYFDw5lRy7AkSV96wV4TgI1V8F1ZY76RaN5e/77AT3RG/L9MVjvVYqG42yfAMMxzCKfW+4OdtfPTeWFb0o/MNfWP6DWBIYxUPBUWzncqT9izeAMARKzn3EKtUMvverNb5Uwl5+bmj9yxraCirPPRFKp4uONE39hLpHdtK37UOfHyeP7Q4JiBhq+3iwrQPjAYZOj3aJAuOsMW9Lj5nTisZyw379ZqtT07E4ZhnitYyPtDdjYLJYgt2yRE2D3Wxw9u1Z6tviaAbGKgN+m24wsGFbKq4xBCvG2Xz5Xbdnunx33Ms0LdqZfPlRPSAD+4KNF1gl6XPgTG8spfVdXC47HE5Ojxl8dfzQ0cMg1TbTdR9i+9dnTYlXb0R7weJF2kCIsgkgjaiTunl92Ce/bs2T07FYZhnis4td4fGhON7HS29cW2sS6FMHQzVv9S6wA9wZbSTyUythVvd9tCqAB0R0/UWw5CgARHPjr9c+mlf/Wjf7jzU34Eaurs7b/8yiFpdYOu+dCJpleYCLWcpC9l3IqPZnOjAznLsHwpo74um0bJ9zj8DUbhwlcBUna7IpH9+KiDrltw9/JkGIZ5ruCIvD9MwEStVMv4Gd+TSlP6riPRcSnLsLLJgY1LunZErw5A0PzydxNkqa93i2Bj6eSi0/ENPSuvu/Zow8rSYNOoEMb4yOTLE4Wx4XGVSA/WmcAm5d77DHYYiEdL42YmN/OFZvbNrFNzuMeNYZjdg4W8P9iT9jk4B2mPWpJ2oUYOoW1LkLdNx7MqHA9/2qdnAcNMWFIAQLFS7Msx7yeYOls60hwResFo4GYavI5gWXhXCHF46MjLR/JHhieiiXSIpCJ2byj8sdxfGpfkX5v3OmnjHJyzJ21OqjMMs6tw901/UJ/gH9yYvkE1a8VCELuR4w11DhE73c7lWzVfen2xJ9vQooU4Z7ZP/tlXPnzzw/d/7P0+nXuPcrlczVcBIJFuH+7YqExZNzb5K490yzAH08O5gbGknZQkiaQyV42ujelz/eIJub9NnYBEp7OMibmvrJ+BM0Uoco8bwzC7CtfI+wMilqk8MADpBcNSY8TB7f18FhWzIhCRbdmpeGppdcEwzJ6Wb/vIQWUXAUFAdjm7GxNoBFApFt1qFaAAAOtHr3pHOigBfRC+7lQnIuXiMpIZPTx0JGEnlagDAKLY91p49NUERfzo1lRabzWTTWfEHZO2e6Fw4W18e59Oj2GY5wVOrfcNp+osD4JoxsPP9P4n2JUXadAONpgaih59J9n13r5NJERQLeuNbGMnJ7uJcrlcKRaLlUqtUMiszg+vXHcWmkOf0+DnFFsDPwYAIKXvSz+bHHxh7OUTh15IxJJSynAnafiFOuD+BuLhrzcai/vkJWzHcscAgEvjDMPsDRyR941T2e860+/gFy+utYZFJDrue+43KMTKVDwTM2O+9HWFeCcxec+pFaXXb7N4gKlSya3XLxSLc4dGC5e+szZoohRyEdGTSODF6d4reO8lTJipQwOHhzKjiCgf0pEe1fJ9IdTwqIoDgkeeNTJoTRwGE6AGXBpnGGZv4Ii8b0w0GqXS2Uyr1e62dAIcAHYtcCSimBmLx5K6dx20Bem2UbaiBISiz0u6PigXk86a47pHZ64JiavZGEkhAYCATJQxNDw89B3v5M3Mi8fyI5lRIiml/7RF4YpIJL4hFm932+bQoDVxGACgwCrOMMzewULeNwqF6QoUO5N1zMQgWJfR9+x6VMkMYaTsFGlL2B1F0YhI2jkNBWC8EwOAbCO7w7MlAALIT1VTuaYc6hhGaz3tq1v1yhM1bi+AbJH8qInzbR/DwfHN+0l3eDI7fS2k/PO1lqtNaqAy6p12zBiKKRUHOIus4gzD7B0s5H0DES5A8btDpztJkHpVx649F+h1KdnUoEAjvFbY9kWDnoRW/xlkt+xCrbBDIVdFcQDI1dzO92XbM6jrBz70wbw4IQEiAQohm2261wRLBHtRnpYoHDbsPg+y/QAA4BMtNDvYGI5dHoMqAKs4wzB7DtfI+0ke8jWoDVmjPs4DiNDAvL9EF6ik7FTCTq6r9eT90DwCkh1azq6kAWYnZrd9nLAoHm+tSvRvZ5zAo00lD7SFyuZ2+8j5b1ocvl/0tsxR6B6rr5Y88gbtMYcGVm4SAEANzp5mFWcYZq/hiLyfOOCcg3Nomb7wo7f3fYFK+LUhjHQ8IzdOZO0QgVY74ZXPlV1nm8aiU6USADiue+TWtY9ee+nqyycA9bC4On8l0YAIpEsC5EvM2ugkwJOBuUuvAg1Rp5g9JJLbj2bTgYB82TFSyeFDkz/2xa/n83kAroszDLM/cETeT4pQfH/m/SuTtydvJyT4AoIFGn3tXdem3lpRIBVP9zNmRVg3nXnnEgBUipVtHECpOAC0Y9LqriAK0lNz+hpkw/B1sBEFJEEuASNxaEsKRFwpek/Hsf8jAA8kuk4+2qOufiSlXGuup5O52KmxIRgHgEKhcPr06d0+K4ZhmAfCEXk/QcRrjWv56TwQ+eQD6J1c0PdCLwVGbkRJO2UKc6dl8uDsEDGxslb4i9fL58tPWhgggA+KxWyjAQBtW3oWIBq6dQ1RryNFVB1wweJxUCqOpkheWlvvNnzpE0mpZ/FV+B6ZIw9eYDiT1l/0E0JPwqN5DkmyQ92J7MtfHCnaV8agChIKM/kAACAASURBVDWo7fs4HMMwzzks5H3GqTlu3pWIFq5p2QlCyT4mhzHYtCVJ2padiqfDqettHC16aohkrhnJW8knPUjo93LxrbeWBmNdSyrtBt3YRqGbOgaNY0gYbv0UhhV//eRYdSSNh+pr99qy2/XbuiGfoNfBHhn6Uu9qv7Lu0cP0Zt6CywUi6nrdFVxx8PjbJ77+1ks/ks/nocatbQzD7D/Gfp/AQWN6evqNX3tjJeeZLTPWEru00kPvy0QEAEOYnu8tN5fCHSpP+kTR0yMAYylrrKYAoFKpbPEIKp1eKxTmDo8evnPdi1FgPwcYnqveLgK6zS2QdQSQiGaH4ObSz5z/1Uv/4bP2oU5zqO3Hhb/aMQyBugWut2wVdaSM2HOtDXeWPxnhlCAEK9Fxo507AUmSHb81PNQYNkTz0rFsNjswMJDL5TidzjDM0wDXyHeLwfSR9YXbthkL1aWfZXJAHY8CEMlUPG0a5iYr060fbYObrG/Wc/Xxuzm112QrhK1t8dbaStqOeb52idO1cHWuwQw2IAbxtHLNQZ9iPtodnHjzzQ+np/P5/AVwl4+1AeAL3RftdVxqzcn4GoAlIitVekcgPYkXxtTB08DDhgbCEjjd18FAasg9qMhLJM/zm4MEmVRn5As/DWer7dLFi3D06NGtv70MwzC7CqfWd4U85P/GyN/LDh8O0rU7nfO+n0jhlmzTtq0NHu9PciAIBQ8RZbI9M3Zn6y3rYWubZ/mZlWbMb0kdP4dLwZBUAB58D6i/ASBPGEIKuyMAYPbixR88e/b06dNuwQWAPOR/7sW/3bwcX0saC4dwJeutdjo++j4EEwGq+wyJdMYdg3J1b0r9gYQPV3cPr350iYGAEAikJzvxzLA9edg9Tu5IKwvvV6FUKExzdzrDME8V3KSzK3xAH1yAC9l5kZs10cAw/tvhstFNhJokhHF97tN7Ddc0TAhMS7Z+EG2wBoQCb6WW/5+3f39iZmJ2cvaxp1oul5163XHdTtyXdtf3LQgT+5ExcNCj46Ar4/ragZKrZiNjZ1fa6mhnp6c3nVi1WgWAC3BBSXv2LmbchDBIJNfFsolCqFH9Te8pQliZD74PhgcQQGUL9D9hNK+eUSfaCbpriZGJ0czkmZGfPA/ne6+Xl6AwDPP0wRH5rnABLjjg3LLrf/OL/70kqVLLO7dDfxgIkElkI99tuf9LVZeDh0mi+XSjNF0KDvOIxwEBfH1qys3llgftrg1SWgAqr92bFFftftoAJuhVBwAE7BrJu4dHZ4++4DoO3KfiAICIp0+fDgN0AGgcpltfaGaqJ7rrqa4V64IFrZgvOxI8QNJN7r3on1SwDkRAiIRIqBrs9I0ABFKCJJAgANBvk98GMxk/nM6+fOl4/czIT1ahegbOAEAZy6ziDMM8nXBEvltM0RQAuPOfp261LLQiDidqAqs/73zoQ971Op/MVj3pCRRPkl3veY4CABLezCz81n/yR/lqvna69rDHlMvlM5VKsVIBgH/5n767lk3KIN0dDoBvjMXVtJx+FgPghcufozTe/7GfDA+4lXMtU9mpOuprt+Dmp/Njr2ZbtNKIN1Yat5Kffd979Uue9AUhCoMIQACRvq5RL1atiBMEEokk+dD20Yivw2DiaDbhzIul7526lp/Ol0qlKlRdcItQ5NEyhmGecrjZbRfJQrY08iv/avWfthsLBBiGqf1qegtVnIgsM5a0U8vNpVAyt/IcRGECGhAx0YaO4eWr+VrhUSoOANp7Vfir2TgpFd/42rSKa1XXg2IICIDJxvpbf/IXANCKpy8Ui1tUcYhktpWiu3k3D/nC6cL09PT1kvzq8Nu+9KRMLVMjBznPWL9x5XuZsRHqdj2SXelLMjDeSWFm5c780RdfM2S3DvVByoyMvVh0fmp6erpU+puJmffhTahWq4VCgSWcYZhnAv6o2kVUpfxLn55cXfkMzFg419RHC/Fomfz2/MzthVnTMGHrLW86+60GwuhucmV9YaCarz4sHJ8qlVzHcXO54fm5RGvF8tbDRnE9Fg7Bik8d4QPqRnVS4XnXSN4af+HrU1OFWg12/Pen6uiz2dlrjWv5Qr4IxfNwPj+dhxKUoPSdG3+w7q2mEwNSXpJQJSSBp9da4ykj+7VjPzoN0zA9XSsVzsG5mZkZAGg0GqzfDMM8c/Bn1i6iAken5qyMX4+lPRGMa++GlhvCWFydv3b3qiEM0J3Xjzk4qZ3p4fkIcWXg7v/3wxcellcPG9TXsvFUo7WW8YG0fXpo76LnzpRfW+QiAQAMwJjpiaWYuhTYeiC+RYioApX2THsWZvOQz05mC1CI/Fy9G/q6pwrVxkytBtUJmLQnT3EKnWGYZxf+8Npdpqam3LwrO+vzy6svjMQCm5S+aXkYkSNix+t8Mlv1t1gm104ogaMKgFhPXBmpL5jtSrFy/99FqOLdOKFtdf22hMDzhULLdIIg+tZf6nWuaKCIGZ3c+PJaPdl0U/e3tu0GkWG/aQD1jCWAEjwdq1EZhmH6Anet7y5nz551C+78l1dzg0kiH3rN5D0t38nxQ0EiItu00/E0SRne8shHKs+ToI3cwLnBhde+9Zb60SbK5bLqLe/YUlp+R7YlQDgOrofFlaoHs+IaAgKwsWt0JC7F1urJVK65NyoOEBktx7OI04jTiGfZGp1hmAMGC/le4FSd0avHOxj3pIRgdBt7leydzqQpZRJCZBJZitzyCLQFPOhtZIbptwnL58qb7xYZM2sM2tICT41uqUuAXoM6gM6oh8ZtqPxVTG9VtoXZFgDQdFNvlys7fLEMwzBMFA5N9gKVYHcL7pFrRnIVURgAeuRap6S35ROuiPS7iZVm49M7l6E3BvYQA5rAEy20XZPr9k3sNLKN9995P3xE9PriX3793bXBOPmRPaTh0+hYHMLWtvCkbhx7zanfdNwVdZA9i8UZhmGeHzgi3wtUgv0MnJkYeSXZSfmglnopS7WeoO7wWYjItuKWGQsPpXvP7ic0qAECANMw/a5VqBVOXTsVqrjaZgYAdw+PfviDX17NJKSvLg3CreDaQi1U8WBlOBABEqykh+3Wqps7+jDLF4ZhGGbn8Bz5HlHGMhHBIPx28h999t4fvPCzP4Jo9CbLdTS7nd63sNBORJZpxa14u7sOKB61EKyXVwdCaHoedM26U8+5OX22wbB4MxUT/nr98Cioiw/sDZkpCadItR8wHEynQ3fvOfXVb78xAQBuLveNX//17b5zDMMwzKNgId9TKlD5pLAoVl/744s3/8pbRwVEtHwHfexhbG2gkYqnl9YW1K3wQAe50JE1qGV3TOteahlS8Ovf+HVQw+L1upvLDSzdnZkYjXda6jA6o76xEhBRcb0HBVAcvjP3yiefHb9+K9nsPJHlC8MwDPOkcI18TylTWX1hXVrPzDQHJw4bIAAiBqYI2yiZR8vkq+srV29/3HOE3XRdoLPfYSYAl8eHYp/50rVdx50+Ox2OmS0PxIRcMciicAVJtCyOG2LxoEgAgJBptMdn629e/LY6Dv+FMQzD7CpcI99TQpPR7ulEtzCwbnTUtFjYAL69knl05Xk8lrBMuzdfvvGepNeQBeE4QPamN1qbzLm5qIp3bBnrdEwyVe0bQw0P2tw3qzipeXHwjMSl06+zijMMw+wZ/Em7D4Rx+Y+tFmGp+en8d0GIqFcMRALfLR4z6gzz2Z2rS81FQxiwaXNqpFldfePHE917ZncpkXNzZ6Ci3Fq6tgSb2jI4odA8Jlj2QoF3W0/FAQRgx0gMLLezjYbdbhcrFf7bYhiG2QM4It8HVFx+Bs78QPrMD0z8+LA43vX9QC5JOZZs2y4GAeOxRPANQqRxnbDX5EYAIHDOcm9bq5UzlXy1qtxaaLAtY7Ir9RWEzqhHt5L2DFkJeioOjfTQrYkXXMdpZLNvs4ozDMPsFSzk+0MZy0UoAsDMzMzqJ7FYY8CnDoG2i4GNKv5Eco6ICTsZ+Z42TqNReLshzTXwpkvTk7OTruM03dTc7EDbM3xttYrBBhQMHFcxouJIqJP0BlHXSMyP6AZ1HjNjGIbZS1jI9w0VeV+8eBEArLnDqyLxqehKIDUc9qShedSrNRFLGsLQD6FgmlwJMKBeZUI4k14w7g29/u3Xs42sm8stD9ht3/K1ZusLitDyJYjFQx91ANJtc6Irsssdp16HLW8WZxiGYfrF85EBJShWio7rTMxOqBsGGgPVfLWarwJAoVYo1ArL2eVGtgEAsxOzbfvBi0N2idD37fjCEXvV95buIRq6sN1rZ39M1XyT0l+erTY7TS3nGOwTDXQZkHyMidk7/8t/Wfnf/35+afjsyPxsdnVRKt/1cKE59HaoRevi4VpSCWR1hd3Wl4McizMMw+w9z0tEXilWCrXCQGNgdmJ2oDEAAIVaoVao1Qq1Qq0AAAONgUa20cg23rr4VqVYKVaKv/Rrv/TO772Tv5TfseXaYwh93/7O8N+7fHSug3FfSqnd37YamkcF3hBGMp7udZoTEAZ7TQMrdnMhkZorEsLf/0e109//diZQcUDs9aNvVnGKzIujBLK6yCrOMAyzvzwXEfkPXcsf//x4ai2VWcqq1HW8E687rpurA4BTzzmu04612/EWIDQGVnzDX0f/tW+9Wc1Xp0vTpekSALiOu6therhOu3GxcfTLI21raabxidJVdYdIQ3u0hXzDEdQXhjDmlu7evPe5KUyAzc7qiNT2/YG5w3j38Ft/8h/SqwtXXz5JgYpH4nZ9baAz6qpErqfMpEAUHVZxhmGY/eeAC/nf/dd/PQEYE0YsbpAHKFH6Uld2DVR94hIRpNrlJcESwpDo2bBqdiTNDy17SC9e/CoAlM+VJ2Ymso1srVDbvbdtamoqn88XCgUA+HfVf+EaN0SXRJA4UdJKD1+1orRcCGN5bfGzu1eCPrWw2A0AhCjMjjg6n23fEpa7Fm+vBQZwD1iTfn9GHQAIhNUlVnGGYZingQMr5FNTJQCYySSrncVhMAxUZrQ6ar1/dahq4QIgRAgWchKCEAkT7iTvpRurifVuIzFdms5X8zk3t3vRuTrFmZmZixcvWl/t+Obq2uKcaZhAoZyDypVvsoGLjJKLVmf9yu2alDKI43v/66OZXTfGv0/Y6IoVL1hkGvTXRVU8MnW2UcXBbusXzyrOMAyzvxzYGnk+XwKA8ZGXf3DsC8OpUc/3AKB34YKbIdTt3US6X5skEpHf9PxMY9CiSSNhO42/8e9+6ux7ZyvFysTMxC6Vz8Nu9nw+/zMnf/7S0btXU4s/f/p/IJSkZ82BkBBRy7m6ANnQB0eWYVmGFZF2PSoGKM3GPevate69m6LRBV0Th/ut3kPxV3vOggl0P2F0WMUZhmGeHg5mRE4EMzP/9eTkr/7r7/1qA5qWEbvpfl5fnjMNM7jDZgXWQS0ChptGNt2JAAT6hrUsVtdJdlZ1dF6oFabP7oqeRavml459x0h2c3IghaYBhj5nhNCyBSJFdPX1tTtXltcWDcMMTdgASKzaI3P1tcYfnrj5c3JzWfy+HnWgcPU4AqBPdsw/NNFQBnAPVnECAMhX84UaFGoAUAOAah6qeagVgvsczD86hmGY/eFgfqZ+QMUiVD64d+7qjU4qlkYQiGJ2/sbc4h1DGJH5KoRgQ1jPhTSU74i5abjPBAhQoEVwPbmyitKaH/jwzQ9nJ2fV/XeDqamp8Gvjyy3fWussz5MwROQqI+xD691TGDP3btxdvGUaVvgCAND5TB4j0bzkBwF6aPmi95LChh71XkZdIsXaaHeMpLOWyjXfLlfUE5XLUHfydrvRtrM5t1Y+p0+gfL4MUA7PJ7wdAMrn9UNqeWjbs5XiQf0zZBiG2QsO5ifoJTr3HuBbd+nOXdMKonBEcXt+5u7SbUMYwUTWQ4azwxVhwXrQYPtXtLYuOjJ5Z/D2bxd/H3QMuluhOUSa4M7D+aE5kVoRdguREAHDc4rKuSEMd3nuev0zlYQgIiSY/MiyZldtL6bb5aJ70DZ0t0UdWRGAUAhbdI2lmDqZs1PTxQo4roq5AQCq+VKhNr0wdOqjLyTbsU66kRmtkzMHgC4SuDlwHajnRKIVj3VjX7q0Nrx4TT2kfA6KFShe6L1SdpRhGIZ5Ig6mkH9AHxShOPX5/9FZXRJghnG2IYzZ+Zt3F28Zopdjf5zRSmh/AqBTzVotEUgIo3bo5rLRca6dUvffPS1XmXYX3BrUxqoDmfqKee/7nZe+GC5cAYBwabghjEZz+ertT4QQauJOJvAfvlP4jb/7EQTLUgHUpQpuzKhv3GkGQAgJwz88vrxWT/5m8Xo1D41sY3ZytnweAEAMvbCUyDVbja6Io++3hxy77Xflut8WwkLZQWF4Ai2QJAzZxSSkILbokjAsf/1eDqQpfbv7lb/4VJ39h29OVPOw26MBDMMwB4kD+GFZpvIZOHPv1pU7s5cGE4dNNFStV49mobi9MHtnYdYwzKiKRwrEDyIoGGujNIhUjgXQOi4bNO+j4zo5N7erNqVqc5pTdZyaIxM3vHSzZZOZMszQDA5AvcxWd/3ybE2SRELfglP/1ou3UdcHesarvRf+YBUHtLpgt0V74lNvYPE3z1yvFKE0XZJWNbG6dmQh87WxV7+5dEd4QB5JCAsTeqFK5MQxLGLoayYkQWAlzOWBQ8O3a/HOSv1w57f+1t3SdEk1H6iHsaIzDMM8mgP4Gflrl37NLbiH/tIwvfVELH2/LZrW8sVbKsceZtHhPouVzUSXhetsOwAAoCSBXiMxcOVU5UylUqwA7O5bGy2cp49CN74yL2YsaQmBwUg4dv3ulVu1bqdDMZGuw8k/8r0Y6A65B2bUe9kH3eMuiERX2G3RyM40srONgdk/+6rTEcdSLWPcT6wvoOd1SbXSbyrRbwlE5S6DCESGEBgz7w02l4abX4j7Rro7d/XL06XpfBVyLnAdnWEY5mEcwPGzU9lT+en8aHLMsuJqhZe6PZQtSfLIyOThwSO+74W2aaqz6zG7SQLTclSCR2rWHIAQfTDTrdaLnw95MQAoVoq7GpefPXv27NmzAJDP53/8B0rtK5mxRGFwcIy8jtJVIjLQMMDwTYitwYkL0oupV/CgSTNSt2+IxQWBjwm7Lf4cbs9OXryT69Sz+fHPJiZupQfumKt3O912R3qSJBGRCvKfDL0bBkgSEXi+9FrdoTnr2OWBte+P/uMvfTo09PFPT7969j2oFGH3hv0YhmGedQ5gmHPp0qVCoTD10f/ZEXUBpg6gI1PRYVw+c+/G3NId0zB7sTbAlt6TXmgemKyBLie7R1u+lzj1TT1rtdvbwIioWq1ms9nJyclpmI7Nt73V1ZXlOQtjSHDFvdK+1zj5LYwtE5mRXv0Hur7oAJmAQAA244sj90ZqhUK5XP7pXzqae2nEs4d8r+NLP9xxHm0siMbkveuEYDDuAUbxG7sSeoNzoBPwwkRPQCt9z7cxhqc5OmcYhnkgB+0TkQgAzlVur//WnaW/ah1DFFEXt01ajogz7o368t2wtTt6n8c9EwD2BD3wTAFCTP5UYfaPrk38xyDNvvvvMRFVoToLsxfh4jk494d/+k/u3LhMb07MfuejoT9eTS2gtDYYvIWvjoIYHUPzVyAEXEl78yPLAJXb9TcXslbmOHgdUkBkLi/4FnRFHHtD+I88XQguGDbNBfSOCWE5HRENsTjaMnHlS7WPy+d2fUCAYRjm2eJACjn8/o0fuX7vi0l72ACjtwRsY2k4vP1G/bN7DXc7Wg4bQvMw4ESEf/BT7/3VP3/9j7/6bX23PXmby1R+88MJb2Gh+Z1vN9fN9u9cSbxxVBpIRqTBLSqZQS0hdH0BAATRNejWhGgkb6xb/loiDR0ppR+5FoJgd8oD7d6fGN0Xp04Ewmn2qOMsogAjZqwk656NMTjtuNWcWwOeVWMYhjl4NfIq5AGArGwc0veXVKMqHkr7sdzJ4fSo5yu/UnwCFYewah5OZOup7v/um19PWP7k/Gh/X92jyZ+tNv6395u/+e32HZArZP+V414MyVDnGLyqTSq+8XUiCOHTwLJYsRoLTnLNTMq250tfDawFlW3tDwsbLHO2T3go3eau/GKpV3QnIulTd91LLY5mFkfTZlscOQIAdSdfmirt9OkZhmGecYz9PoE+UywX34Oz9gq012KWsMNet1Cw7tdyABhID7Y6rWZ7TQgRDphtVc57uWnlkYZAQASHG4MS6drhO/lq/hu5b1QqlV16yYqpkpa0blz6JmLbV2Vv/UJAR+QQNbMLbwlG6ZYy3bmh9scnVuYHO7LlSSkhlNig4I2ow/s+pxkivyb9byTrHm6FQR/kWmvibxfrdeGmjjmu8+4b7xaLxd1+exmGYZ5aDlpqXY1ZZ+7IzCwl7LiBBmxo7dJsyrEjoi/9a3eurK43jNAK7YlC8w0J4jBvL+as5vE//VrdqbuOu4u+b6GKJ6Uwum2wNl2OPOQd0KtRiIiQltPdG2PNlUHZ6Xi6ER0AMPBcf/AO9N1ElS0Ao69F/UQINEyYOHR6UEysfs/f7beXYRjmaeagpdYVCGjEHiU4m1RcWaGdPPxiMp5We9KiEri1p9RjaIE4okpdH/ITyy995jqu4zq71MEeqngnJdtZEag4PkzFe81kalcrEaG8dah99Wizkem2O12pZsMx6DYnUAKuu9r3DF2y0PWLXrIdQEryunDzzqVf/pn/0civuY4LAJxmZxjm+eRgCjkAoC/CFeMPvsN9Wm4Z1slDLyRiCV/6gWfpk2h51BlNT2gR+ITJzpFWKufm+vCq7qMXi9sk41Ks+oGK3z8urk4o3JOip8cBYH7Iq77WXY11O76vvHF0vbq3SAWDsbA9Z6MZHYXePUS+R3/rH//wtYU/tRrLAFDNV5U1DcMwzHPFwRRyIvKlB+G880PYnF0n37biJw6/aBmWlFIlkgMPt60RFpCDfm4CMNGLW/7CsZm6U+9v1Fgul13HAYB2TIKMyQ4GDfo6fKWNJ68uL0IvO/XfOx+NfvelZave9KWvSuWkSgQqsR78s78EVXO1PR3DdjuS5LV9a309tjA/5OqdLqzlDMM8Vxw0Ic9DHgBy4Oj+LYRHh9NRLRcofOmn7NSJQy8IFIGW6+HpLefY9Q5QvQ1UdWml12F4xXVcHTX2A5Wod3O5RjbWTHU69npv1SqFYXfv/iqUVQIOiIRk+rg8Iv/bX/zYXJcyCMSRdDX80d7z+wNiOLcfZtqJyJdSeO3kgnf06ijsvq0ewzDMU8XBE/LqOTjn4D07ZqlbHhtPRq1IhBC+9LPJgWO5ExRkpyHS+7alk9DzXmGTOKCEuGV5zlKtUAvXgeyEUKhe+fhSttGxu3aQgw6z0BvzCL3FpEhIBGR3xefH1i6emBMdKXVFHHSPW2D09jSyKdMO+upEenTo1uBPzgz8yrdeK14oAlRYyhmGeU44aEJeAADAjOd3EJRibSWyjAo2APjSH844k6PHpfSf2CJGgT3bMpVgJ7+dIlGaLjWyjR0G5QRwplIBgFc+ufSf/fZ7zZQEkGpCSxutwQYZVite9LUIEhAYEr9/qvFxrmF09Fa3MMbVp/+UyrhGXSTBhjQ7gpSN2uF/8EMfDU/+c4BK5Qzn2BmGeS54qj+vt4GKmf/99Z+5uXTcMhwEERkGe/yLjUbehjBuzc/cXpg1n2jhae9YoFd+B8tPJeAtY/23fuKbxUqx8nZlmy8w+OJ33/3RVtxayyakKuPrmev7zNYi69302jaC2rGVG6OrlocgepcvT3yxsu9EltFhMPsnDDw1/62PXxj47Z9f1nd7dl4QwzDMNjhoEbmKq4fj/0Uu9Wr0I/yJVFzd2Zf+keEJJ5vzfC9qUYKPaaELn1LPTlFgy24AJlGUz5frTn17wWL4oOvHxw2/tZK1JehVbAAEQYPdhpw6BvlnJAAwfbw8rlRcQNAB8KwE4pvB4BVDryNA+nRt5Ic7MHpodmC/z49hGGYvOGhCDgDVavVLh38MWykACUGX9la43/RNkjzqHB9KD6vh8qgibolgJwjqFSNy0E9dfuPPd1gpv3t49JNXTs6N5YKucvVUGGh48GopsFTRFxJgeuLa4dXPD61aPoIgCtbJUDCJ9uQ7xfcbvUSewsI5AkhfphfGjl8ZBYB8lf3YGYY54BxAIZ/Nzk5PTzfttu9Tb8XW1vrUHmDginjUOZGOZ3zpByPiAFtsYu+Fx7qF3sDu4ug9XSl/QsrlcjWfB4DPTk7MjY3qDH84axbYrIaE/d0IKIEsX9wZXr8yvmJKAagmubR/OoaLUGjD66IIW33Jew9CcH0ViculfKl25Gf/+Qtn32NLdoZhDjgHzWsdAN76xbduFG9YN7uAHQONwA1sqys+oullpY+mMDPJgeW1Rc/vCiGiP3p8Lhq1q7kaakcASfhbP/lvso1s41cbcH6rL0oZv3znjTfmR5N3xkeDFxMpwm/uUg9bwYAQTA/nU63vnliQRCBJqgH5yMuM8sDboyoebQzc9F7tT3I+1PIgLgcAIEh42dXEocXcS45bffcNl+3YGYY5kBxAIX/j1944A2eE323fXjaSQmCwB+VJBqND9QpN31KJ9NLqopTySbU8WB2mUuyY7iSzi4PfLVwqVorXf/P6Vk5GqXiq2Yx1ln0rCLyxt3pts4or+7ZQ1nzopOHa13zImHErZsYsyzKFEOHboYNuqULvyBfRRaL3Kf2mGzdN6O21rmOQggg7BYhIAsZiryauJ298DAAs5AzDHEieqeamLfMBfVCE4nuf/dPW2rwAoxecwpaCckU0xy6lNA1zYXX+87lPlXFKr9N7C03saixbbys3xGKHjnxUqOarW9nzEZqwtmPSsyQg6sp42LO98el7+0kDvzppwvW/ius5YXaRhI6kSZKUJH1fBpAvpU++lFLd5oe33yfqkXfxYVIdvT9sDN93UeP1e9Jbvi4E/t//1bf+19954bM7Mdcp8GIVhmEOGq/9CwAAIABJREFUHgdTyC/RpffgvR+aO31n7mMDTdiuePQs2hAlSVOYc0t3brrXDWEG405bjstDbRVo3nasOzmI+Lo8jA/KxbV6summOjHpmUhCQu8pHzBrFp40hhvLJMy8icvH0GgDbeyI6J1z4LLSO0IYnEvyfSl93/N8v+v5nq+kn6SUQRAf9MhRGK8/4t3YFLJHT6Y/6q5XtFJEy8XR8dYV/4TjVnNujXvfGIY5YJj7fQK7ggvuOTh3wfpdKcAAiLa8PZFUaJUktQwMfennBsc63c7dpdumYYax5mNFSPehKbmTkszuVp59qlRaq6+lcs3Vrum3rY0qrlR6c4Ih+IlqZSP0Ye41XDqGZgdAaIEN5bOnow/qV0dEFEIYYFqhMOuEu9ZwSSpq933f93yv63ld3/d96UspCcJD6pZBLfCbavDhmQRvI4QT8crmfutDB8FBIVy7qjsBiW669oB/LefWnuRADMMwzwYHU8iLUJyZmTkz+e7KbXeJ7gg1fQUAERO3LYEbdJqIpPTHR4+2vfbi6vwmo5hHHQbD2TUgQEg2Yew23DnyiIeUy2W3XndcWO2aLRRoUJDI15ck94e91FN5IADRhcWT6L6CZketQglONAyFg2uLyHlGSgZBszrc19cmBCIGfznBxYQqrqvw3fekUnTf83xf+p7ve76K5SGi3/erezCury8tkHrXGE8Qskcm+PXAQgeFjbecL1vQLk1xgp1hmAPFwUytA8ClS5dqtVry1faivC7QgKCwvY3k7SYtR0Tf967eudxsrxnCiDZ5PTqlHN4tKdrfO3L3d77ybYAH/wYIoFIsXigWj9z63G43yBB6L2rPXW7z4yKlcQAkAhASPv4Jw4+TCCPUh6vhpla1zYTddY8bQtuUWtfjbETSl57ne57ndTyv6/mer8vwvtrXEjQEPuQ93PikqPe6PCJYD+oLEP5qTCFi5vqgU81Xa4Xawf3DZxjmueNgRuQAUKvVAGDRbTRy/oA0ws/tbWj5JhUnItOwjudOXb39sed70Sb2rR0NVoQ16DoAUKwUK1DZdAclWcVKZXEo6zqHyQg9ZYL8833tdUH4GeSmCRCgFYPMjFw9IXyDYOOO8vv78x5d2360zG/KkMODJtMM0zAsIw52eDfdSudJz/O6nW633fW6vqq8B3V3inbFb36LKHBb15dQG7U9GEZTmQsiAgkxNFawWivUHvCmMwzDPLMc5MBkamoKANaP3UR73RC9ljfYrhepzveqnafCaDSXrt25Ehwt0sb+sCg7SNT7hlzq4MT3Tj+wcf2DYrFYqVx882v13NDicIawd96BUt9/8N6FhmqONwHWTbw9LrqTcd9pSQrS08Fd+/irf4TM39+yvulHAMGoPYGU0vd8z/N9z/O6qujueV1PShk2A6C2sbn/HECvjInkHJTeqzcNgAzDaA7eO33t46mvQ61wsP/2GYZ5jjiwEXmItZr24gTQDT+5t98aTT2dkNIbSA6OjxyduXfdQEMPMj9EZyEokauvBYiBRhYAJmYnNt1tqlRqNxrny+XTl/5sJRsP7F03RJ2bjxy0voU1b0MQtsXgqvjLL63lZgrVl+ovLdaBQPd/qSR7/6T8gdH8BnWPFOPDGze22gEACCFETFi2BaC76KUvva7ndbxut+t1Pb/rq4q7bqaLNMmHXrX6sNH2vcDwXkqZaA5/cvJwrXCXg3KGYQ4MB9CiNeTs2bP5/LQ5PzxEd4EkRNTl0YXeh9FTJgIA9KV/aPDwocExz+9CqLPwsIP3dE4Adux2NV/dZNSqRsYb2ez4rU+ViqsHBsH4xu2koE9kY92bEAC6GGsLAGjbfvlcudPO/MOfmkahNRwDH7RdNVaPNrKpyXu4b+QsuGsvcCc10qam2yQJIWJ2LJVNDYwMjBwaGT0y6ow7uXFnKDeYzKSsmKXqGtKXqpMuzMarYyp6l1BE0BYeDJbPQ93Z3OjHMAzzjHLwI/JS6ezv/emvtLyGnRlA5fK2g6nlUHLUEdSGtFa3tby6YBhmIKwPemAgHEQAktqxFngYFfLQ+KVjS1Ouh63aEJR5H9ymHtSS1esSgK2YTRBfSccd1/2/fvH9YqX4xn9MDHXKJoAXzHv33GT2ML/80MD9QU740Zx8b/RcCFMAmIadsNMDRJLU2Fu30+20O5121+/6PsnAIx+jz6jfIpIDjSPfe1WovTU14IE0hmGeeQ5yRA4AhcJ0tVpaufk1i0a9jdndRzVpP5JNI2eIeMw5EY8loltVdL/WfQ/V5WApN/2sXC67jgMAXVuSRSB7GWkKsvYPONrGpaqI4GEXybg7dtTN5c5OTwNC8UKx7tQ7q7V16khVNY6sU9n3NSgbAveI9EazJr1mNwqCdilJEiCalhlPxrND2ZHDI7lxZ/TIyJAzkMqmYvEYIvq+nnnrNUYQdaCDdqY0zWtUGIY5IBxwIUeEWq3k5t3moNVJSokbEuzb03LUtukbnNiP5U71RtH0Ps2HHpxww9uu/N3cXG51xKY4+cGz9MxGHzRsFvq3hW3qBoHdMQcXW069Hj2467hOci2bWTbbMdJdYKERu66/Pz1EpR0ior4hlMewCb+n64ZhxJPx7GB22BlyxkZzE7mRQyOpTMqKmYioRt2Uoc1rA4lDa58XL/CGU4ZhDgIHXMgB4OzZs27BvXt6GdrxLnVJaTlsiKqfmI1GMT75mURmYuSolD7QhvT7xkoshkXt8CYCOFOpAMDwaj2daHekbuJSLmr6KR7w/BCxFCd12LaRjLUNAHBcN2r+On12OpdqVgHs2ivWUB0F/f/t3W1wW9d5J/D/ORfvIEGKIqAXk5Ic2U0MyEnaNI7VtCN40x0366RJugN2JzvZzUynu7NNZ7/s150x9G23nxt/2G1n08m2nQqp2yZp2nSaBko7kRMn9cYxYMeubNmk9YLLV5AEAdx7z9kP594LkOKrTImU8P/ZlkgKAC9gDR885zznefo2y4P2MYfS7UE9qGrb2N7VfyGC1rFCiGg0MpRJHz02lj2ZHT8xfiQ3mhpKSksqV/3LK158bShn14HiAT0zIqJ98+AHciNby46+evo4zmpPAYAOGqaun8C9e+E7AK21ENJT3vjIsdzoCVe5CKO4XheFRdAIHBCJTgJAppmpFovFavX9r72SbDVbi6aHibkmEfRa3aTAzS9j7z2yGGq2ZyYeyTSbAKYqG4+0lZ+q2kD52XKkG/kfn/pzHbSaC0+VH9pYfrutUvYNN/Azda0ty4onYsMjQ0dPHD02kTt6bCw9FEsOR4DyAT0DIqL99ACOMb1d9WL1i8UvPvnkkx959FeWOreanVnzDsZkzHecmvdvk5tPh1Mjq+3lTrctpQyCsR+7/fbnpjuKEGIlNfHGI5mlzombzT/+whdO3LjmWdqEVD9hF2LjdFLzTXvTOhEsqstuLBFxxO/+/nMzk5Of+ta3Nr3aa1+5VqwWH/7ehR+vpZvaE4gIhGPhNh+/cvht2GLH+sL4MFOHeeejIS0ZT8R+aSq5VD+p5oaBM1UONyWi+9ygZORTU1OTk5MA9FDc0ybz3YfN8g2Fb1LI07n3RSMxpVV4AFyvz54BwNLNzBKAdtI2h81WM4nw25sPhH+SbB2N/sDrj0CLWEpo62cfOGeS+60v1y98+8FKasWJmSYrYeFb2K9mry/CoXJ7mXp/UAegodue/snfJNyfncQups8RER1+gxLIjSqq3z36kiOO6m5XY/9judZeMpaczJ6GX5/Vu43uW83vuh7QKj9b/siP0YmriG6roG+ZCaebFrgBppt6WKmmAUAJtMXIwlq20bhcLG6fUZvCNwDzrlxVWgHorbCHM9X2+hocRkFBIsyrGP7PFZB6NfH6SruRbezwEERE94n7bS31vSnrcraWzdazTu5m98hiVERE3w/697jG7nd80yoiIzOz79xYeDdiRcKe4f0tWqUlb0Vvnfo+hLJOvTMshNRh+9Stz7j759DC/qNaSw3hiUTbfzd2+9b4pkqX/JNXE24iMrQmghWAcIj57Z3Y7z9B93kgGNwOLSRkMx1/4+FGtmFnbc5AI6IHw/3+A3vPTAN2AN0P3HT1QkREN8Ry3NFgFYS9TYKU9o3rr62sLVuWhf4+7FoLKZJDEdVo5b4n0qujEE3A77bWW+TeNIr3hXlzl240oZFwrUTWtncZxY3SpVLWzubsXPvRt/TwatiIXQdR737cL+/R4RF8v0pBQ2uh7bFmc03MR7rFy0UuqhPRA+P+/Wl95y5duoQ8UEB35qYzuxSz/PZ2fTFyz6n5hiV6KWW7u/b6u6+6ypXr28lBICU6ibdjx34kIVxA+HHcrJhvGUD9g2L+L0DMcltyZObkWdzRXm+5XK5eqI65sXiqc3ou6y88C//tCPoam95n+rf9/U46GlIkh9JXvdmvfuKbwGD+rSeiB9aA/ki7pP283PnpLa2XIKRYv5mKvYdzPxIHsdySlr3UeNt+05IWsO7EduolHF3zhhvBabTelPHNg2fvXQKEv1qsVNST0Y5lZ7N2LneH+aUGgA9cnzj/8oez3QT89XWEiwP3X17e37UO/ll7CEB3vfbo8Kvvq16oVovV++xJERFta7CK3UJTYgoAaoi+dgzzw2utFaDX9C1cYDc33mURXDD+2pw7g6vc8UxufDjrei6COjdAC61TUZWxpb8+HjZn0VtE8f63FP6NIZWMbtb75Q68dnLGXU2mXjqn/SJ2oLe6fncHq+y7XhwHgrJAiLZYdqPviLVGtlG8XGQUJ6IHzIAGcphYXgeAmH2iO5Z543HHCyakheG87xTy+smbWxBCmFRQwLRoVSePTibjSaU8/0yUhhfDyX/SGsq/T1+Tudsf0ETWvvYyWmjdjSZaqVHTm31PW+O3XS4AFKvFs68UvFwjPTwLCX9D2a8P88vF7vxb3DO6r+8shN/jRohuXCxF9KwnAdjZ9/qmh4joEBrcQA5gamoKgJ237UfbR99KO4g5jgO/IbcOIjr2FNH9bmnBUnksEpscP+OvoGuhJaJrWo0p5Uf9vubsmz1aL78Mh6dBC9U3FuU9EiheLgKwGjn1aj7143P+EBYzsjzYKjjUsdw/2BfsjAfdbSHEomi7C/E5139pWaZORA+kgQ7kCDqxA5Ct1PDPTo8MPxwfGfOgIXRw0HybHF2HLUd6O+tYN1LFU14mNTqe8RfYlYVjP4G2pL9KHm59b3ZtOmiojjAtltqNpkcX141FeY/CJFU2cjNnr/7Pz1QQdIH1i+8Ocw/XIA0HgiQ86G3z7sjsUsw5+rNHsnYWjOJE9OAaiBat26terJoernbefvMDM/9l9L8tRqufPv3fX2o8BUhxWwFaX47uf2w2xcOWbMFgsV7d3HByeHl1qS272Tcw/qrWEcDEe2zahhUIzpv5jxZ0NhlqOlcfefzs1asRz/vSc8/t2ytQrRaLRQCZhTFvaHVubP548wiCZxNMWQue8KGhNYICQS2COj0BaMj/d/rNH5994/uPvwygUC8896V9e62IiA6bQ/Rz+cCVdfkCLtiw66i/f+Vt3Y0vLJ+Mz3dikSEhlFBCSLPs7N++lwoG/V4ArAvqQZ2aJeRcd+HmK2+8r6rNArtY34l9E0Gpul/TDp1aicS6a5/5q29Wi8Wn7kKHcHMgrVqsTs5mH3t38sNvnzVPo1cqHyy2H3w4171tfBFMgvP/h1j67fTin134Tu/GB32xRER3FX/IbVTW5f5PH507kXXHFttzC7M3k5GotMwqt7VV/7NeEzdAhM3YpNBrTuf//tRacHRUChUc1t7ieFt/Ezezch/R0uog4op8rVao1+/W/7a+9fPfvPyJU6tjwu07jNfXYeVgTqaF3fHgnysz7yvgD5tBpy1alp73xJUnr8xMzgD8C05ED75B3yO/XVmUy6JsPs4j//mj/+n7x2ql0//50dOwjt1YGvU6SU9gybVcJZSnPaVdTyvTdQ1m2zz8BcEeuiW877wt7Y6OSqGC5DGYXL6B38QtqFQHtBQQro64AkC9ULiLsSl46InpCdUYW+7q4CwetPa3AUy7d/9K79nGuQ7+01oEFYVCm80LU6YOW3ZuptbmPQHg/AvnIRjFiWgg8EfddrTWVVSzyAKVAi5eRBnAE0vvP9k5ZmPWxpytbctBYk0m25artLQ8QApABOPPtNYyHfP+ccb7h7cRi/Tl2Vu3mtlsUX05k2rH03ttxXrHwn7suW6iEWufjQktVdCezj8TH3RewV1daV/XqM0/wQd/cQAw74jWIqvpmycT70yWny3na/lCvcDSNiIaHAzku6I1qijayNZRuIALRRQBXMRF86dPLL36UPtcA9pG1ha20EitItZB7Npa9+aKvjbvvbPml8Vh6/V0843WLaqbiOkpOTR96lHc27GbYT/2mw9fE8MrQ1EzObUvfgaf+Ee297er67oBq2YRHeEqut9LB8qJSafryWZq7F8eqeVrdtZm4zYiGjSRg76A+4MQAKoAgIqJrzXU8sjXUQeQHLn1wZE/A3QY2ueBC1Xgz156RyeVEEL2DVjbOtiFuWawqA6p9dFGs5WOZRsNO5e720+zX2WqYt43yJWUnVx99eE3M170sZsTQkmzcxDm4n2jzP2T57iDBrd97138pL+v97y/PW9uKiAhhetMj6ysSBVtjmWXMgAK9QL7vRDRAGLysg+0BvBsDaijUEc9VVt95Ac3P/dbX/3WF5+xZTzYPO+1Md+yUD1opeaHNI0vfuX5b3z6k9OTD9+zRfXblS6VavlavVAH8Pm/+ZSzknw4DkhtNvvRy8iB9VNWzd3DSS+brMCvT7sRjH3rOwGw7gC7gNAQnrQaqblVeNbcWKVU4Vo6EQ04BvJ9Vi6Xs41G1rZTrbnZ3Kgf6oKz5tssPftBDb1KdUuIoYX2yx/6KO7tovqmFwcgX8tPfW2qmWvcOP1OWogjKi6UhFbwQ2zfhDc/JIeH6/o/CIU3WFfgDz/2I9h712Y+nNbefMSZHV5ONofd1USlVJmYnsg0M/VCnX+LiWiQsWp9P2ngQrVq53KLo2k7eySM4vAPjW8TxREc6oLfj1WIWMt1I6l9bOJ25wQgMPW1KQCZRu79L/7iH3zyG3MdIRczKpGEpSCxIRHXYfm+3yE+/CD8V/f/6vdVBXp74VJDAlp8pC3Sc8OzjvyDT37jw98p/um/+caVJ6/ka/mZyZn6OUZxIhp0/Cm4n17J5wv1+vO/8ZnZ8WNxZ1YHiWk4SnybJm4bKtVPv7UwPXlyeXj0ABfVN2X6xmTtbKFeANB9yNZRV0ba0YfeXl05KnVES09AwxNhyxwTn8X6hu296eoAgsFx0txJWY6Qt1LzVjs2uTA61BxuN3IAavlaLV/L2TlWtBERhfjjcN9cKpUmpqdnJidj3eXFsXRYs7ab5qZ+b/NgXVoJHXFjb73vMRz4ovoWbr+qq7/8T1EVsVaGc3ZWRx2VanvDbS0jMWjlegpSCk9rIbXwhBYCEpZWjhCWJ6XwvFvDdnbmdKyVBtDIzk6fuP63T/5TqVIybxe2+b5ERAOOVev7QwO1Wq1eKDgJtZpO9n99m+Fm8Fu6mmHkAQGposk1de8r1XcvDKjhB9OWW/3E35cv+p/+5JevJFUk3UrnGtlIuPkNaH87J6hMB+aydmtopeNFz1x92Nz3oRu5//25SxPTE81Ms5Ft5Owc4zcR0VaYke8Ps2r84vlfuPb42Zbrad13AGvHdDyo6jbhvBMd18LzrPhhW1TfgUaxWgyX3E3b9jCub6/8bLlYLZqBqgB4IpyIaPf4k3IfXCqVnrxyZXJm5ntPPXHt4Qml0VtU76vYvp1Gr07d3EwILA3l5seO435fRl4f17fBsE1E9F5waf29MovqL5w//9PWrH1sRPd6s/Wdqt78juHQrp7UauetU8fztVq9sEP82+GatnLPgqVAFVUAFdw/iwpERPchJkHvlQmaP3jy568WHu6q9WPCdrhnr5jdbCHHo05y1vvs89/a26BSjWIV8c7ExMxELY9mpmmat2yqVCkByDSnM82ZmYkZO4tqkX8LiIjuY8zI35NLpdL0lSuTMzPtRLSrgKAl2Y4dSsO+J6YBOwAh9Oj1lZXkeC2fL+4iipfLaGTzAKo1VIv18sWZWv785Awqpcov/LiQXI2sJpcB7Y8t0zrRTcfcuLlvMzM5OfPCSB3lZ1GsIv/l/NWzzekJNlchIrr/8Mf2nQubuA21Zm9lj5jXslfittOLG+6hm/PV6dVu6dI3v/30081MZrsaN418Ld/MNAt1nH9hppYvNXJvjtlzljM8tDTcyMLy5InFvGe97XU6UkXdiBdxO0pGk8KdHT8RaS4KiJizEu80lzPNbjyiop0P1t+t5UumV1qhjrNXMzm7fl9v0BMRDQ4G8jv33WLxcrH44Z/8cO1IpK0jMD1FTffwbV9YM9TMP2cODQ0pxfB8++UPffRCtbrlonoQwmcmZ0qVUqVU+WzlsbHGUNcaHkKkhTU4SpsxI1ppvXEYmQC09KeQ+MsG2ooILxJru45YOtqemVQ/+Hi9VCkV6pVGNl+9AADM0YmIDjn+kL5Dl0qlTLP59Le//bWpZ1bTiV5YFjtE8v5KddPHTWqMzjc78SOZZvOF8+c3KVZfH8JX0jdWE0sjs8nxhbjTBaC0RvCWYDfCXuYQkBAQQkFY8bh1K9OKuq2xhYQlvPnsI5VSJV9DzuY+OhHR4WUd9AXcl0y8nJmcvPbwiaUjQ73JKCZAb5uRm7al/sFxYcZ7qZGl9me+/tedePz2RfXSpRKAeqH+9N89PfnmEXiLk82h9LuR5Ir0XK216o/eYlfQ133G9EMHFDxXJVZkdC0JGW/LRDNjn6uNfOLy7Fe+iFIFUwUUi9h9BR4REd0bzLPuxHeLxWK1+vznPrUwlrS0h177F2Db5i9+1hxspENrASFdnWhb+VqtUK/339dk5o1s3s4WVoauR9a8I42UdrpaQ2tlbrNhoJo5jm4SbgGhTSGdGY3qX4B/sn3DVeq+Ruj+H0VkKhKZT92M6MUPvHkTQC0PVrkTER02zMj37FKpFPG8P/7CF47OX1dRCZMHh+3Ztj105m9RB9FWaHTiSSc6tDI00kqnz9V7x8ZMIp5u2UupCWhxFNHoLaUcV2vt17ybbyv63hmYKzEXIUyIFwIi/A+i73sDwWA2f+pokK77VfRQcDwV66QskXVEUonI5I2Vr3wR+Vq+WCzWK1uecCMionuJudWeXSqVACxn4hZaUP3Z+A5FbkGNWy97F0IvZI4tjq7r49afiI/cehOO14lmoD2l/HblpqZOA+H88u26x+3IT9r9aehhjh/m6FIIIYCIbA3ZbkJEcS5r13J2PbxUIiI6QJxHvjcmiitLDzc72kRR4Q8+2aFUHRA6nGtqPkdy1VkcPZ6v1cLblC6VzOlwF7HY/JyLdCeS1p6rlJ9va+HP8F5XVPde3o+JYBXeTEPX5vnoMEFXWntKK0elmuOj9rH4wryHGIBGNm+WDYiI6AAxI98DDdTy+Xqh0I17Kgavr6f61tPGw/tqoK+Pm4CMWMOza597/pt+HzcNABPTE+dfOD9ivwnH7USHtKt7i+DmDQOwm0Es7+VJhpl5L0EPKuKFEJGIjHSWEbWWjr3vypNXZiZnAP49IiI6MNwj34NisfjEiy++/v6H15JSi6D/C/wd5m3uaIKjX0YmBAApxBF7uRsdyjSbH3r5ZVEGgGtn0Bxpnn49nWqnHBVVXt9aepDN+7vwdymKwy+f85+OXy+ngy8JU2bnWjGI+MLI7D8/+RrAXXMiooPEQL5b5XI5vbr6tampo/PXnWTMJMd+B7edwqqA0CLMpbWAlm56uLn8ma9/Y2Zi4ne/XARQqNvaO376jYmJaxnPUWENWrj3bs6N3b0IvslFY5Nwrv30XKdWo2NLyZN29uzVcwAKpQJjORHRvcdAvlvFYtHO5bL2jCW6Klju1sES907dWNEXxSGFEEp5VgJAvYB6IddK5zoyPdI6mbkR81RfUbpfQ2d2w+/acvo2/LPu68O5WXVXenRu6OdU3FlTbjQBxnIiooPAvc1duVQq2dlsvL2aWW6tDnlAb3d8x+1qE+z7Do5rqUS0K1dTM514s1aAnS1ElxejXstbU8FR9GCCGnZqFHfP9Be3m7cVZs1AIhKLOLFEd2jE3LAyxbmlRET3DjPynZka81Y6LUR7LemvqMO0Mtdix9Xu3l669u8qPUS78l/ONltDLy2lHlIdRLod1UXfcr15XD+oH3wUh3kaveWBcE6r1oBSUeFq11Nx5uVERPcaj5/trFosFur1mLtqRT0RNEQ1Vej+ka2tme4tIkxohe5EkzMPDb/40VS9MHnj+BPwpOU4ylXBKrppFOOvXh+KEB4yTWbCTXuz0gChPDhtL9JpRZuL5oY8lkZEdM8wI99BX43bjXYsqoMRZ/D3rHeYciaCmjUTyaXQN45nnNjpNx69nmitpBOp5bb2O72IINUVfk5+uKJ4yC8J0OF2gTDPUsNSnvCYlxMR3VPMyHdwoVqtFwqPvv7KaiYZtCMXwZCzHYvV0b9/LoRcjEbcyEQtX0svOLLTWZhvaqVEGBR1UAePwxrFQ+HY9WAbQCsoT0W77djykrkJ83IionuAGfl2TFv13/rDP3ztsfd1IhYQlGwH58K2v7sGIIIOMICUcj7lTS/8MBaNqcii6rraC850Bevq4rAtp28tONWOYPlAaA2tdQJKe8qLx7N27ZknbA5MIyK6qyIHfQGHXTOT+dtf+1etZMRfHPe3hnfurKYB6N7cMaHRjnQ7R5b0sbiTXFFdZTJamOJ3iHAwmg6bxGndexewH0SYRvf1Vl//J3t9RNPsRvh1ehBa6a7jRdEZWX47Z9erF3DodvqJiB4sDORbMm3VPUsvDx+F9ICgaG3nfqwAEJ43M/eDhWZWL4xGWhFHOK4Ojpb1jnUF4a730L2y9X3jP2TfPwC0GUme6qtoAAAU8ElEQVTut4Dd4yCW4ACef2cIpTQcJ/eB1FtDx6vFm8Uqqvt3/UREtAH3yHfgRK3WsA6mnJg8e+e+LBp9R8y11hYakyozeXzBasMNjm4FzVDFbSfMdD+llVLKU8pTntf7wNuF3l2U0mrdo/Z/O9EnXOrX66+iF+pvF6bzQexXSl99xelitHwR8c4EN8uJiO4eZuSbM+l4J26tJTNxZw4IGp7vfOLMCJfgtRY4tjz0B//u6tm/m1VKIVh11zpc2e7dKUjCEYTXvjAre79DCilEeBN/WdufbNILwlBaae1HcbVJSDafifC79725uP0phVE8GOTS162mvwGtEFprpRCdHXt7/KOZ5plavsYFdiKiu4Q/XDcRTjnrDEktHM/f/zW71TuvdAe74wJCKyDexVd/6Z2jnagy/V6kEEJIKaRlSUtKy/wjhDTMB0IIKWVfWA3XwYH+34P4GF7TbSmzWbo3YVuZDF9rpZTS2lOeUsqk7q6fwSvXhP3glFlvIsxtTzt44xBGdPStzJuIrqz4Gx+8+eKv1LHZAxAR0XvHjHwTtXy+UK+/e+bE0pGxlgtgfQ3aTvyO6hoasDw9fU5MDB2x4rCilrSkFYlIS1pSSkv2xUgTac390Z+phzluL39f/7vu/9JWl2S+jWU26/u+S9hGHVprKM/zXM91XNdxPddzXc9zPc/1lKc0FAAppD+/fN0eey+mh0V0poerpbqJFQ0znvXSeXZvJSLadwzkG2lgutmslEopZ2nNU8H0UL3LWB70dtFaQHhoZeXsOXHUHRGWDG6gwyw5XOe+7SHWfyFIs/316/5biuAem11b703A7Xvb694F+H9qWZZlWfFEvHd5Snue57qe0+l2O12363qeMvm82Gy1QJvj8EE3O630mbeymb/OpFqntn/diIjozvAc+UalfP6Rq1dnzpxcPDHuei7CHi3YXQF5MPYE0EJASTn7c8LyENaObYjTvSqz25ae+yvgRN8Hm2ffQYX8hgfXYWu5LZ7B+gsIN86DZyyFZVmxWDSRSqTSqeRQMplOJpLxSDQCQCutPGWeWu+h/LltwZA0oU8eHXXXPFdG2e6NiGjfMSNfJ0zH085ix+1gXXTdOYqbaIYwzRZojQtpJSDbQvu92fvj8FanxHtxd4tYvrnNLnCTEO43b1lXuSbEFu8QNMI4DUBKacWtWCKWHoZS2nXcbrvb6XSdjuN0Hc/z+uvfAQgt4GHp6qocjiGVZNUbEdG+YyBfx+yOv7Yy15lMCwc6KMXe5SBwEQwt9be8pYzGEdErKiLgSjMNpX8OKPb5lPiuCGx+Ol0EbeVMVr7Z3US4qGD+OBqLxuKxtNZKa7frrK2utVsd13WVqxCU9UFDKS+qOsupd+uFer6Wr4NJORHRvuE58o0qpVI3FplzYiZ6i2D2yW7i7fr0WozLsfSiSsQXHM/TWpmbhJVgW6+SHxgR/NqfVgf1eOsWD8wSuql/NzvxsURs9Oho9qFs7mT2SHY0nooD8JSntIKGaolIR5UqpWamedieNRHRfY175D2XSiU7l+vG5HJ6DKKDvjK3XW2OI1ihFv558CF7Dsvx1LuLPz5xJCJEMiL8A9h+7ttrU35orYvlfav0m1bPmYhuWVYsGUsNp5LJRCQagdau4yrolDXcTrz5w49dLVZx7Y/u7dMgInpwMSPfSAsNq+mvQIfZ8473gj8zxF9X1zraiXdlpFSppK8rALOu6CwnIPyCdQjTv0VsLH473Nal6Wa9ws/igy8Gte7QiCVimbFM9mQ2e3I8lUrGO93hTqZ8EVk7f6BPgojogcJA7iuXy3Y22xxOxTtaaJiR4+Yc1Y7jSuEfDFvXIi3mLP/kwx+p5fOlygsAmpnmyOtnG9G2DmK5EGHvlEO3xr4bAsL/Vwh/PExY6y6Ef+xNaQDJdPLo8bGRo0eO2WmgXKjnDvTCiYgeKAzkvgvVqp3LjS3MrqZVMOjEnKDa9e54MLsMGtJSTjT+bLls53ICqExVOvFO+dny1eytn5x6y3R5DRuxC9x3mflGwaEzPy8PD7CZrXSzjx7tpGPeOQBA8SCvlYjowcJADgTp+LPlshsVQoaHyEzv0b3sjgdfWE6Mvv5z5yqlUjEYx10tVgH840d+tObK3/v0nysBfwKo8FfYHwxBLPc/1EG3GUuJjmtFl0YBlMvlA71GIqIHCo+f+eqFwp9GdTepoBCk47tuyxrUsJkPpLCUiJnHFJWgKakANIrVYvFy8ZG3HnY1okloT4eHukWYpN/nghfNH/gKAFKsuvpGvNXJNnI219WJiPYTM3JoIF+rAVgYG4byF8ihdzd13PBvZ9q5CqWG4m0n22jcdjMULxcBnK4VdDcJZQXpuAgW2XdTV3eohU1he53mBG6MzNdOztTyNTtrMx0nItpf933+9969ks8X6vW//I1nVsbjXhdahM3SdxXGe33OzXA0iCPzq53YcL5WO1ffpPNJuVxuZBt21h6PYjQmPdc1rcqDFYAN7dTvK0EZflj9BiGcGN4cavzVxy8D/OtGRLT/mJEDQKVUkqqjXKmDQ1VmXXg39w2TaH90WVQeu9UoVbYc81Uul+2sDWDWwWJXCRnR/qBzUyhvitnf+3O617RZW9BmiwHm9ZBara3p2PVcvsYjZ0REd8WgB/JLpVK9UOjGvNmxlN98LUyMd5c/9lfDCYjk4trHXvhn0+p1q7uE0zxnHSy5Svlbyn7zVh0efLuP+I3kRe/aBaTEkifmHAGgUC8wHSciuhsGPZDb2SyAtVQiAunv6AZnx3d36iw4EW7K3DRcK3ExOHW2jTCWzznw4Ghplp2Dg+U6KIG/H8K5Dt+DiP73IKKznJx1/ZeBk8iJiO6SgQ7kGjh79Wq9UJAaQkn400f9KWW7IfpuJ4A3zzz+zukzAC4Xizve18S2bGp1ZGjRgQOpzF657rVix+FPzLUZTN63ngDAkojMjo68fjZrZ8EoTkR0Nw10r/Visfir3/nOzZPjUirP7O76k8521f9chwfBTc8YAQGsDI1h10el65X6M7/9UGM1dXMtaUFELRGMLQlmeQdFcIfxWFpQcG8u1B/RKiAgpX0kNv0QgHQr/dyXnjvoCyUiepANdEYO4GK5HOuuedINm7ntYTk7nDoODQEp7uRdUfmpqt1KA5hzhAtHCVPBroVG0L1VB+Vjh0n/croIGtoJQMjuajw2fdLciofNiIjutsEN5OVy+XKxmGotzo6PamUmdfonwXdblrVhH91VybXuJsfHdxKusY8OLXpwBLRfCh8m4odpuoo/jzyY+SK06Jveqpqumom0G9kGGMWJiO6JQe/sFnU6cWdN+91EzVCyXcVxP9CGNdpaH51baiXlVsfHt1eZqpS/W2yspuy16HgUw/GYcDvaBHTR24A22fqBlX/3z14Njpn5T19ARsRiR5oadTtrc0WdiOjeGNyM3Ih221qZyvNgKNnu7ugvdofH1KKxmONuc3x8R+Ea+6wDpxn14klI8+7Cj+Km2VxYz36vafgDzvzppUIHg2IgZfLT5xwcmXVYo05EdK8NaCA3q76ji7fSqwvB14SfWu6Cn72Hn2otOm5yrbv98fEd+WvsdnbktTPXxcKNkSVzSN1k5EL49ez6Htezh2l38K3D6nQBSIFIZNT789WhH55kjToR0b03oIHcsDwnakX8inP0/bYT0bup2VWX2dn5G8cmdv8IW6lMVXJ2rnqh+if/+pvX48ttTwPKlL/557xML1h/IsndDOb+CoV/nF0L04dWBIsDApZMdkSkcST2g5PWK2kAOTvHKE5EdI8N4h65Biq1Wr1QsJTnKqWx58ljfjrut27RMcs9Orf4yb/+bi2/D41Iy+WyCaI30s0xR4xbYlR4KhrRSoffF9D+Krv227Tvz965X4Pvb4aHs9KDg+29Nw5KKtcRzfZQZoYF6kREB2kQA3m1WCxVKn8aUU5UaUv2zpztPpYLHa5ta4ho03vihZfe47r6+scHgMKlAoBZTy6l2ym4YyrhD0zV4QB0BBV3wRk1veuS+w3Mo4T9aREcDu97rhqAlJZQtuysau06yexyKgOAUZyI6OAMYkOYZz760a9NTY0tNLy4v4BsguIuh475fWDgb6hLAa2jz//b3wRwB/Xq26hX6oVSoZav/cPHv//rf/L5G1n79z/7tY+/ke/PvoXpxCI2tmf3a8s3zdT94CxMaZ/oP9km/ON34eHwXmmdgI6IE1b7aCdq/fOHfv+3/xeCfi/VanUfnzUREe3JIAbywtQUgKMWVLsVtHMzLcl2FcgFglGjpr+61HNjuXZiyM7l9j2k1St1+8t2sVpcTa8+WiuMtVPNdDPu6ZiKAjLs8W6uKmQ+RxCkw6GspvsrzKR1/xcAvXtCi/71c/MFCQ0hrYWRU1bnv376L751aaqWr+Xs3ItPvFg/t59vXIiI6A4MXLGbWQT+QHvl86PHzFf8lHW3586CsePhyror7qwPzG4JVJ+qFuoFAMffPKMb46124q2R+d/79YowiwLCX1UPwXwtaLuGcLFBmAPgWgQz14UQphA+uKP/Jf87RyJdjWuZxWlrLf7WpP1yoVIpXbhQLdQL1aeqnGZGRHQYDNwP4y//zu/YudyH7HeX1+Y99GaX7TohR9gORWstIB0rPrLUtbPZLz1311uglC6Vwo/V0OroWnq8PbrwfjF2Y15pLSE1VN+EdGxYcBf+IBb0Osv2/YHWAloLCc9NLsSXrE48a+dW4p3rqaVKqVKqlMybCW6HExEdKoMYyLO23RyJR7w1s1EMf2l9d3NLsW5uqQWdajqvPP6LT1658mvf/vbdvfSACedZO5uzcwDWTs8j4liOi2Q3lhCtxKp2ekPVLctSWgkFAAoagKUBSyoFaKWFhhRWRGgLYj7RcTE30nzn5LvVn/9R+WIZQCPbqF6oAqgX6oP3l4WI6D4wWHvkGkitrsbU2vJI0m9o4k8m2W2lmz+dLLix8HDyxux//KOvzkxO/tG1a3fnqjeqV+r1Sv2ZJ54xn0aXktGFIWsp89r73/jpo6+1HTiulMtDrmPNJ9feHZmfyd7qRpzMWgqA0Hhn3O44cll4cjnlOpH5ZGvVcmZyN4+/fSb11uT10flvfeLv87U8gJydS7fSlamK/ZyNi/fmyRER0d4MVpL13WKxWK1+/bO/tjoec7yIMiHZVILt7hF0MLLUVK6PzTY//fW/n56YmJyZOaiXMlzrrl6oVotVAOWL5Vq+BqBQL5Sf9f+0rxEdNr1N+WK5kW1cPXt1emKa+TcR0f1isH5a/+3TT79w/vzjr/xoOZ3QUiEoWd91HPePW5vi7gj0qavv3jp2+skrV07NzNzNC9/1xQH5Wn5yZnJiZgLAzMSMH5WxLpAXq8V4Jx7ephPvVIssXiMiui8N1g/vcIM85rU9qD2n4+jfINdC6Yea87/6F9+r5fP7e4KciIholwZoj9xskFteezmTVBbCA1jYS0aOsHsMxOkzC92F6Ez21BMvvsgdZCIiOhADdI68WiwW6vW58SOeVCalBvYaxfuHlIh3bh37wWO/XM/nB2tZg4iIDpMBCuSdePxiuexFLLn+Se9+gljfOWwIiLTdytdqZ69e3c+rJCIi2osBCuQA8rUaIDQkep1Z95KP66Azq4CO6BHVLFUqE9PTd++CiYiItjdAgXxierpUqcQ7nf4vil3n4/65cwACEjj90Jwbj5rl+v29TiIiot0blGI3DeRs+6cffOzm8VNOLBiRYo6E77IVTNg3RgNCNNuZV05/pJVKPfHii3f1yomIiLYxKBl5LZ8H8O5DJ9oZN5itDexpZX3dLVULqXyt1onH9/c6iYiI9iRy0Bdwj8xMTtYLBYm1Oz46r/tarAuorG2/cu4Xn7xyZV8vk4iIaG8GJSMHUC8UoKHgnwI3NWu7pHX/DDEolUzCerZc3rDjTkREdI8NSiCPdzrPlstW3IMJyWane9czyPtmdANCPB7LRD1Ui8VitXpXLpeIiGh3BqLYTQNnrl179clHvY8lF5eSCAPzXmal9M9JmxPy5UfzrHQjIqIDNygZOYDVROLqdBbqDu8udLC9rrEcibDSjYiIDoMBCuSRRdfynP598T2Wvfmb6lqrrN2oFwp5niAnIqKDNkCBHFpbXi92C0D317DtyIxXAbQUo83ms+Uye7oREdGBG5TjZ9VisZWMtpOpWLetRXCS3O+3ul1mroNWMD6BIWHlbBsAe7oREdGBG4iMXACXi8UXP/ZxJxoXfnmf3zXdHA3fKi/XJgXvi/RCYykSv3HyVLVYvOvXTUREtJOBCOShVnqkHUkIDa3NEFNTjg6hN85A0zB74kJrLUy8N19XIntr7oWPnr9cLHJ6KRERHbhBCeTlchnAamqklRzWUKZozR9Frs0/JnYHv2ptFtWFECacQ2shxbFb9mf+8m8u8Pg4EREdDoOyRx5aGj0+vLIcVy1PS+WfDvf7w4RRvP94ebjuLrXQSh+/ZQMoVqtPMZYTEdEhMCgZOYKkPNtoZJa6oiuhIOFn3wjWzw2YjFzroLO6FApridTiyLGff+lVccft2omIiPbbAAVyAOVyOWvbAGId2Y0lOlEH0AJaw8/Iw+htArjQElJ2YonFI8duHj+7OHrsoJ8BERHROoMVyAFMVSoA7Gz2+kOPplejyVbHE56QQgZ5thQQQkBAuroTj7cSmaWRLEM4EREdTgMXyAFMVSp2LnehWv33f/z8a489kWhHT043/sP/ed6VlietU6fmRTwyvNQ9cWNuYrphZ0+1UiPmjmZxnoiI6PAY3N1eDVSLxWyjUajXL5bLH3nxSmptqZHPraUy76QeyddqpUqlWixeLhbBEE5ERIfV4AZyw4RzAJeLRROty+VyttE4e/XqxPR0oV4f9BeIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIiIfP8fXxZ5vdaSZjAAAAAASUVORK5CYII=" height="357" preserveAspectRatio="xMidYMid meet"/></g></g></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="300" zoomAndPan="magnify" viewBox="0 0 224.87999 30.000001" height="40" preserveAspectRatio="xMidYMid meet" version="1.0"><defs><g/><clipPath id="ef5ae8abd8"><path d="M 3.570312 0 L 221.195312 0 L 221.195312 29.03125 L 3.570312 29.03125 Z M 3.570312 0 " clip-rule="nonzero"/></clipPath><clipPath id="16c6c08de4"><path d="M 13 7 L 29 7 L 29 28.839844 L 13 28.839844 Z M 13 7 " clip-rule="nonzero"/></clipPath></defs><g clip-path="url(#ef5ae8abd8)"><path fill="#ffffff" d="M 3.570312 0 L 221.3125 0 L 221.3125 36.289062 L 3.570312 36.289062 Z M 3.570312 0 " fill-opacity="1" fill-rule="nonzero"/><path fill="#ffffff" d="M 3.570312 0 L 221.3125 0 L 221.3125 29.03125 L 3.570312 29.03125 Z M 3.570312 0 " fill-opacity="1" fill-rule="nonzero"/><path fill="#ffffff" d="M 3.570312 0 L 221.3125 0 L 221.3125 29.03125 L 3.570312 29.03125 Z M 3.570312 0 " fill-opacity="1" fill-rule="nonzero"/></g><g fill="#000000" fill-opacity="1"><g transform="translate(92.004145, 10.887099)"><g><path d="M 3.6875 0.109375 C 3.050781 0.109375 2.5 -0.0351562 2.03125 -0.328125 C 1.570312 -0.617188 1.21875 -1.054688 0.96875 -1.640625 C 0.71875 -2.222656 0.59375 -2.941406 0.59375 -3.796875 C 0.59375 -4.660156 0.742188 -5.382812 1.046875 -5.96875 C 1.347656 -6.550781 1.765625 -6.984375 2.296875 -7.265625 C 2.835938 -7.554688 3.460938 -7.703125 4.171875 -7.703125 C 4.898438 -7.703125 5.519531 -7.566406 6.03125 -7.296875 C 6.539062 -7.023438 6.898438 -6.625 7.109375 -6.09375 L 6.015625 -5.421875 L 5.875 -5.4375 C 5.71875 -5.769531 5.5 -6.015625 5.21875 -6.171875 C 4.9375 -6.328125 4.585938 -6.40625 4.171875 -6.40625 C 3.515625 -6.40625 3.007812 -6.195312 2.65625 -5.78125 C 2.3125 -5.375 2.140625 -4.710938 2.140625 -3.796875 C 2.140625 -2.878906 2.300781 -2.210938 2.625 -1.796875 C 2.957031 -1.378906 3.4375 -1.171875 4.0625 -1.171875 C 4.613281 -1.171875 5.019531 -1.289062 5.28125 -1.53125 C 5.539062 -1.78125 5.671875 -2.148438 5.671875 -2.640625 L 5.671875 -2.96875 L 3.875 -2.96875 L 3.875 -4.1875 L 7.15625 -4.1875 L 7.15625 0 L 5.71875 0 L 5.71875 -1.015625 L 5.609375 -1.03125 C 5.453125 -0.664062 5.21875 -0.382812 4.90625 -0.1875 C 4.59375 0.0078125 4.1875 0.109375 3.6875 0.109375 Z M 3.6875 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(99.92521, 10.887099)"><g><path d="M 5.65625 -2.546875 L 1.984375 -2.546875 C 2.023438 -2.046875 2.164062 -1.679688 2.40625 -1.453125 C 2.644531 -1.222656 2.972656 -1.109375 3.390625 -1.109375 C 3.722656 -1.109375 3.988281 -1.171875 4.1875 -1.296875 C 4.394531 -1.421875 4.5625 -1.609375 4.6875 -1.859375 L 4.796875 -1.859375 L 5.75 -1.234375 C 5.5625 -0.835938 5.28125 -0.515625 4.90625 -0.265625 C 4.53125 -0.015625 4.023438 0.109375 3.390625 0.109375 C 2.804688 0.109375 2.296875 0 1.859375 -0.21875 C 1.429688 -0.445312 1.097656 -0.785156 0.859375 -1.234375 C 0.628906 -1.679688 0.515625 -2.222656 0.515625 -2.859375 C 0.515625 -3.515625 0.632812 -4.066406 0.875 -4.515625 C 1.125 -4.960938 1.457031 -5.296875 1.875 -5.515625 C 2.300781 -5.734375 2.773438 -5.84375 3.296875 -5.84375 C 4.109375 -5.84375 4.726562 -5.625 5.15625 -5.1875 C 5.582031 -4.757812 5.796875 -4.128906 5.796875 -3.296875 C 5.796875 -3.003906 5.785156 -2.773438 5.765625 -2.609375 Z M 4.421875 -3.46875 C 4.410156 -3.90625 4.3125 -4.222656 4.125 -4.421875 C 3.9375 -4.617188 3.660156 -4.71875 3.296875 -4.71875 C 2.566406 -4.71875 2.140625 -4.300781 2.015625 -3.46875 Z M 4.421875 -3.46875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(106.152985, 10.887099)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.203125 -5.734375 L 2.203125 -4.890625 L 2.3125 -4.859375 C 2.675781 -5.515625 3.253906 -5.84375 4.046875 -5.84375 C 4.710938 -5.84375 5.195312 -5.660156 5.5 -5.296875 C 5.8125 -4.941406 5.96875 -4.414062 5.96875 -3.71875 L 5.96875 0 L 4.53125 0 L 4.53125 -3.546875 C 4.53125 -3.929688 4.453125 -4.207031 4.296875 -4.375 C 4.148438 -4.539062 3.910156 -4.625 3.578125 -4.625 C 3.160156 -4.625 2.835938 -4.488281 2.609375 -4.21875 C 2.378906 -3.957031 2.265625 -3.539062 2.265625 -2.96875 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(112.863815, 10.887099)"><g><path d="M 5.65625 -2.546875 L 1.984375 -2.546875 C 2.023438 -2.046875 2.164062 -1.679688 2.40625 -1.453125 C 2.644531 -1.222656 2.972656 -1.109375 3.390625 -1.109375 C 3.722656 -1.109375 3.988281 -1.171875 4.1875 -1.296875 C 4.394531 -1.421875 4.5625 -1.609375 4.6875 -1.859375 L 4.796875 -1.859375 L 5.75 -1.234375 C 5.5625 -0.835938 5.28125 -0.515625 4.90625 -0.265625 C 4.53125 -0.015625 4.023438 0.109375 3.390625 0.109375 C 2.804688 0.109375 2.296875 0 1.859375 -0.21875 C 1.429688 -0.445312 1.097656 -0.785156 0.859375 -1.234375 C 0.628906 -1.679688 0.515625 -2.222656 0.515625 -2.859375 C 0.515625 -3.515625 0.632812 -4.066406 0.875 -4.515625 C 1.125 -4.960938 1.457031 -5.296875 1.875 -5.515625 C 2.300781 -5.734375 2.773438 -5.84375 3.296875 -5.84375 C 4.109375 -5.84375 4.726562 -5.625 5.15625 -5.1875 C 5.582031 -4.757812 5.796875 -4.128906 5.796875 -3.296875 C 5.796875 -3.003906 5.785156 -2.773438 5.765625 -2.609375 Z M 4.421875 -3.46875 C 4.410156 -3.90625 4.3125 -4.222656 4.125 -4.421875 C 3.9375 -4.617188 3.660156 -4.71875 3.296875 -4.71875 C 2.566406 -4.71875 2.140625 -4.300781 2.015625 -3.46875 Z M 4.421875 -3.46875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(119.09159, 10.887099)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.21875 -5.734375 L 2.21875 -4.875 L 2.328125 -4.859375 C 2.472656 -5.171875 2.65625 -5.398438 2.875 -5.546875 C 3.101562 -5.703125 3.378906 -5.78125 3.703125 -5.78125 C 4.023438 -5.78125 4.269531 -5.722656 4.4375 -5.609375 L 4.203125 -4.375 L 4.09375 -4.359375 C 4 -4.390625 3.90625 -4.414062 3.8125 -4.4375 C 3.726562 -4.457031 3.625 -4.46875 3.5 -4.46875 C 3.101562 -4.46875 2.796875 -4.320312 2.578125 -4.03125 C 2.367188 -3.75 2.265625 -3.300781 2.265625 -2.6875 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(123.584522, 10.887099)"><g><path d="M 2.234375 0.109375 C 1.867188 0.109375 1.550781 0.0390625 1.28125 -0.09375 C 1.007812 -0.226562 0.800781 -0.425781 0.65625 -0.6875 C 0.507812 -0.945312 0.4375 -1.257812 0.4375 -1.625 C 0.4375 -1.96875 0.507812 -2.253906 0.65625 -2.484375 C 0.800781 -2.710938 1.023438 -2.898438 1.328125 -3.046875 C 1.628906 -3.191406 2.03125 -3.304688 2.53125 -3.390625 C 2.875 -3.441406 3.132812 -3.5 3.3125 -3.5625 C 3.488281 -3.632812 3.609375 -3.710938 3.671875 -3.796875 C 3.734375 -3.878906 3.765625 -3.984375 3.765625 -4.109375 C 3.765625 -4.296875 3.695312 -4.4375 3.5625 -4.53125 C 3.4375 -4.632812 3.226562 -4.6875 2.9375 -4.6875 C 2.613281 -4.6875 2.304688 -4.613281 2.015625 -4.46875 C 1.734375 -4.320312 1.484375 -4.132812 1.265625 -3.90625 L 1.171875 -3.90625 L 0.5625 -4.8125 C 0.851562 -5.132812 1.207031 -5.382812 1.625 -5.5625 C 2.050781 -5.75 2.507812 -5.84375 3 -5.84375 C 3.757812 -5.84375 4.304688 -5.679688 4.640625 -5.359375 C 4.984375 -5.035156 5.15625 -4.578125 5.15625 -3.984375 L 5.15625 -1.5 C 5.15625 -1.238281 5.269531 -1.109375 5.5 -1.109375 C 5.582031 -1.109375 5.664062 -1.125 5.75 -1.15625 L 5.828125 -1.140625 L 5.921875 -0.140625 C 5.847656 -0.0859375 5.738281 -0.0390625 5.59375 0 C 5.445312 0.03125 5.289062 0.046875 5.125 0.046875 C 4.78125 0.046875 4.507812 -0.0195312 4.3125 -0.15625 C 4.125 -0.289062 3.988281 -0.5 3.90625 -0.78125 L 3.796875 -0.78125 C 3.515625 -0.1875 2.992188 0.109375 2.234375 0.109375 Z M 2.6875 -0.96875 C 3.019531 -0.96875 3.285156 -1.078125 3.484375 -1.296875 C 3.679688 -1.523438 3.78125 -1.835938 3.78125 -2.234375 L 3.78125 -2.8125 L 3.6875 -2.84375 C 3.601562 -2.769531 3.488281 -2.707031 3.34375 -2.65625 C 3.207031 -2.613281 3.007812 -2.570312 2.75 -2.53125 C 2.4375 -2.476562 2.207031 -2.382812 2.0625 -2.25 C 1.925781 -2.125 1.859375 -1.945312 1.859375 -1.71875 C 1.859375 -1.46875 1.929688 -1.28125 2.078125 -1.15625 C 2.222656 -1.03125 2.425781 -0.96875 2.6875 -0.96875 Z M 2.6875 -0.96875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(129.625308, 10.887099)"><g><path d="M 3.953125 -1.359375 L 4.328125 -0.296875 C 4.171875 -0.171875 3.972656 -0.0703125 3.734375 0 C 3.503906 0.0703125 3.238281 0.109375 2.9375 0.109375 C 2.320312 0.109375 1.851562 -0.0546875 1.53125 -0.390625 C 1.207031 -0.734375 1.046875 -1.226562 1.046875 -1.875 L 1.046875 -4.59375 L 0.171875 -4.59375 L 0.171875 -5.734375 L 1.046875 -5.734375 L 1.046875 -6.859375 L 2.484375 -7.09375 L 2.484375 -5.734375 L 4.109375 -5.734375 L 4.109375 -4.59375 L 2.484375 -4.59375 L 2.484375 -1.96875 C 2.484375 -1.6875 2.539062 -1.476562 2.65625 -1.34375 C 2.78125 -1.21875 2.953125 -1.15625 3.171875 -1.15625 C 3.429688 -1.15625 3.65625 -1.222656 3.84375 -1.359375 Z M 3.953125 -1.359375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(134.076687, 10.887099)"><g><path d="M 5.65625 -2.546875 L 1.984375 -2.546875 C 2.023438 -2.046875 2.164062 -1.679688 2.40625 -1.453125 C 2.644531 -1.222656 2.972656 -1.109375 3.390625 -1.109375 C 3.722656 -1.109375 3.988281 -1.171875 4.1875 -1.296875 C 4.394531 -1.421875 4.5625 -1.609375 4.6875 -1.859375 L 4.796875 -1.859375 L 5.75 -1.234375 C 5.5625 -0.835938 5.28125 -0.515625 4.90625 -0.265625 C 4.53125 -0.015625 4.023438 0.109375 3.390625 0.109375 C 2.804688 0.109375 2.296875 0 1.859375 -0.21875 C 1.429688 -0.445312 1.097656 -0.785156 0.859375 -1.234375 C 0.628906 -1.679688 0.515625 -2.222656 0.515625 -2.859375 C 0.515625 -3.515625 0.632812 -4.066406 0.875 -4.515625 C 1.125 -4.960938 1.457031 -5.296875 1.875 -5.515625 C 2.300781 -5.734375 2.773438 -5.84375 3.296875 -5.84375 C 4.109375 -5.84375 4.726562 -5.625 5.15625 -5.1875 C 5.582031 -4.757812 5.796875 -4.128906 5.796875 -3.296875 C 5.796875 -3.003906 5.785156 -2.773438 5.765625 -2.609375 Z M 4.421875 -3.46875 C 4.410156 -3.90625 4.3125 -4.222656 4.125 -4.421875 C 3.9375 -4.617188 3.660156 -4.71875 3.296875 -4.71875 C 2.566406 -4.71875 2.140625 -4.300781 2.015625 -3.46875 Z M 4.421875 -3.46875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(140.304462, 10.887099)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(142.813232, 10.887099)"><g><path d="M 3.359375 0.109375 C 2.835938 0.109375 2.367188 0.046875 1.953125 -0.078125 C 1.546875 -0.210938 1.207031 -0.382812 0.9375 -0.59375 C 0.664062 -0.8125 0.457031 -1.046875 0.3125 -1.296875 L 1.125 -2.296875 L 1.265625 -2.296875 C 1.492188 -1.960938 1.78125 -1.691406 2.125 -1.484375 C 2.476562 -1.285156 2.890625 -1.1875 3.359375 -1.1875 C 3.765625 -1.1875 4.066406 -1.269531 4.265625 -1.4375 C 4.472656 -1.613281 4.578125 -1.847656 4.578125 -2.140625 C 4.578125 -2.328125 4.546875 -2.476562 4.484375 -2.59375 C 4.421875 -2.71875 4.3125 -2.820312 4.15625 -2.90625 C 4 -3 3.789062 -3.078125 3.53125 -3.140625 L 2.5625 -3.359375 C 1.875 -3.515625 1.363281 -3.769531 1.03125 -4.125 C 0.695312 -4.488281 0.53125 -4.960938 0.53125 -5.546875 C 0.53125 -5.972656 0.632812 -6.347656 0.84375 -6.671875 C 1.0625 -7.003906 1.375 -7.257812 1.78125 -7.4375 C 2.195312 -7.613281 2.691406 -7.703125 3.265625 -7.703125 C 3.847656 -7.703125 4.347656 -7.625 4.765625 -7.46875 C 5.179688 -7.320312 5.535156 -7.085938 5.828125 -6.765625 L 5.09375 -5.75 L 4.953125 -5.75 C 4.742188 -5.96875 4.5 -6.132812 4.21875 -6.25 C 3.9375 -6.363281 3.617188 -6.421875 3.265625 -6.421875 C 2.859375 -6.421875 2.546875 -6.347656 2.328125 -6.203125 C 2.109375 -6.054688 2 -5.851562 2 -5.59375 C 2 -5.363281 2.070312 -5.175781 2.21875 -5.03125 C 2.375 -4.882812 2.640625 -4.773438 3.015625 -4.703125 L 4.015625 -4.484375 C 4.753906 -4.328125 5.285156 -4.0625 5.609375 -3.6875 C 5.941406 -3.320312 6.109375 -2.835938 6.109375 -2.234375 C 6.109375 -1.765625 6.003906 -1.351562 5.796875 -1 C 5.597656 -0.644531 5.289062 -0.367188 4.875 -0.171875 C 4.46875 0.015625 3.960938 0.109375 3.359375 0.109375 Z M 3.359375 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(149.337073, 10.887099)"><g><path d="M 3.71875 -7.59375 C 4.945312 -7.59375 5.882812 -7.273438 6.53125 -6.640625 C 7.1875 -6.003906 7.515625 -5.054688 7.515625 -3.796875 C 7.515625 -2.546875 7.1875 -1.597656 6.53125 -0.953125 C 5.882812 -0.316406 4.945312 0 3.71875 0 L 0.984375 0 L 0.984375 -7.59375 Z M 3.625 -1.265625 C 4.414062 -1.265625 5.003906 -1.460938 5.390625 -1.859375 C 5.773438 -2.265625 5.96875 -2.910156 5.96875 -3.796875 C 5.96875 -4.691406 5.773438 -5.335938 5.390625 -5.734375 C 5.003906 -6.128906 4.414062 -6.328125 3.625 -6.328125 L 2.484375 -6.328125 L 2.484375 -1.265625 Z M 3.625 -1.265625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(157.455515, 10.887099)"><g><path d="M 0.984375 0 L 0.984375 -7.59375 L 2.484375 -7.59375 L 2.484375 -4.5 L 2.65625 -4.5 L 5.1875 -7.59375 L 6.734375 -7.59375 L 6.734375 -7.46875 L 3.9375 -4.015625 L 7.015625 -0.125 L 7.015625 0 L 5.328125 0 L 2.65625 -3.28125 L 2.484375 -3.28125 L 2.484375 0 Z M 0.984375 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(164.4728, 10.887099)"><g><path d="M 2.6875 0.109375 C 2.289062 0.109375 1.925781 0.0625 1.59375 -0.03125 C 1.269531 -0.125 0.992188 -0.25 0.765625 -0.40625 C 0.535156 -0.570312 0.367188 -0.757812 0.265625 -0.96875 L 1.0625 -1.828125 L 1.171875 -1.828125 C 1.359375 -1.566406 1.582031 -1.375 1.84375 -1.25 C 2.101562 -1.125 2.382812 -1.0625 2.6875 -1.0625 C 2.96875 -1.0625 3.175781 -1.109375 3.3125 -1.203125 C 3.457031 -1.304688 3.53125 -1.453125 3.53125 -1.640625 C 3.53125 -1.785156 3.476562 -1.90625 3.375 -2 C 3.28125 -2.101562 3.117188 -2.179688 2.890625 -2.234375 L 2.125 -2.421875 C 1.5625 -2.554688 1.148438 -2.757812 0.890625 -3.03125 C 0.628906 -3.3125 0.5 -3.664062 0.5 -4.09375 C 0.5 -4.457031 0.585938 -4.769531 0.765625 -5.03125 C 0.953125 -5.289062 1.207031 -5.488281 1.53125 -5.625 C 1.863281 -5.769531 2.25 -5.84375 2.6875 -5.84375 C 3.207031 -5.84375 3.632812 -5.765625 3.96875 -5.609375 C 4.3125 -5.460938 4.578125 -5.265625 4.765625 -5.015625 L 4 -4.1875 L 3.890625 -4.1875 C 3.734375 -4.363281 3.554688 -4.492188 3.359375 -4.578125 C 3.160156 -4.660156 2.9375 -4.703125 2.6875 -4.703125 C 2.125 -4.703125 1.84375 -4.523438 1.84375 -4.171875 C 1.84375 -4.023438 1.894531 -3.90625 2 -3.8125 C 2.101562 -3.71875 2.289062 -3.640625 2.5625 -3.578125 L 3.265625 -3.421875 C 3.847656 -3.296875 4.269531 -3.097656 4.53125 -2.828125 C 4.800781 -2.554688 4.9375 -2.1875 4.9375 -1.71875 C 4.9375 -1.351562 4.847656 -1.03125 4.671875 -0.75 C 4.492188 -0.476562 4.234375 -0.265625 3.890625 -0.109375 C 3.546875 0.0351562 3.144531 0.109375 2.6875 0.109375 Z M 2.6875 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(169.755241, 10.887099)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(172.264011, 10.887099)"><g><path d="M 3.109375 0.109375 C 2.554688 0.109375 2.070312 0.015625 1.65625 -0.171875 C 1.25 -0.359375 0.929688 -0.625 0.703125 -0.96875 C 0.484375 -1.320312 0.375 -1.726562 0.375 -2.1875 C 0.375 -2.6875 0.5 -3.101562 0.75 -3.4375 C 1 -3.769531 1.375 -4.039062 1.875 -4.25 L 1.890625 -4.359375 C 1.660156 -4.640625 1.492188 -4.894531 1.390625 -5.125 C 1.285156 -5.363281 1.234375 -5.628906 1.234375 -5.921875 C 1.234375 -6.265625 1.316406 -6.570312 1.484375 -6.84375 C 1.648438 -7.113281 1.890625 -7.320312 2.203125 -7.46875 C 2.523438 -7.625 2.90625 -7.703125 3.34375 -7.703125 C 3.757812 -7.703125 4.113281 -7.632812 4.40625 -7.5 C 4.707031 -7.363281 4.9375 -7.171875 5.09375 -6.921875 C 5.25 -6.671875 5.328125 -6.382812 5.328125 -6.0625 C 5.328125 -5.632812 5.195312 -5.257812 4.9375 -4.9375 C 4.675781 -4.625 4.273438 -4.363281 3.734375 -4.15625 L 3.71875 -4.046875 L 5.125 -2.1875 C 5.207031 -2.363281 5.265625 -2.566406 5.296875 -2.796875 C 5.328125 -3.035156 5.34375 -3.300781 5.34375 -3.59375 L 5.34375 -3.859375 L 6.5625 -3.859375 C 6.5625 -2.796875 6.351562 -1.9375 5.9375 -1.28125 C 6.019531 -1.207031 6.09375 -1.15625 6.15625 -1.125 C 6.21875 -1.101562 6.289062 -1.09375 6.375 -1.09375 C 6.445312 -1.09375 6.503906 -1.09375 6.546875 -1.09375 C 6.585938 -1.101562 6.640625 -1.117188 6.703125 -1.140625 L 6.78125 -1.109375 L 6.953125 -0.078125 C 6.890625 -0.0234375 6.796875 0.0078125 6.671875 0.03125 C 6.554688 0.0507812 6.421875 0.0625 6.265625 0.0625 C 6.015625 0.0625 5.789062 0.0195312 5.59375 -0.0625 C 5.40625 -0.144531 5.226562 -0.269531 5.0625 -0.4375 L 4.953125 -0.4375 C 4.515625 -0.0703125 3.898438 0.109375 3.109375 0.109375 Z M 3.109375 -4.875 C 3.421875 -5.03125 3.648438 -5.1875 3.796875 -5.34375 C 3.941406 -5.507812 4.015625 -5.71875 4.015625 -5.96875 C 4.015625 -6.1875 3.953125 -6.351562 3.828125 -6.46875 C 3.703125 -6.582031 3.535156 -6.640625 3.328125 -6.640625 C 3.117188 -6.640625 2.945312 -6.578125 2.8125 -6.453125 C 2.6875 -6.328125 2.625 -6.15625 2.625 -5.9375 C 2.625 -5.769531 2.65625 -5.613281 2.71875 -5.46875 C 2.789062 -5.320312 2.921875 -5.125 3.109375 -4.875 Z M 3.28125 -1.125 C 3.613281 -1.125 3.898438 -1.1875 4.140625 -1.3125 L 2.453125 -3.46875 C 2.253906 -3.332031 2.101562 -3.175781 2 -3 C 1.90625 -2.820312 1.859375 -2.613281 1.859375 -2.375 C 1.859375 -2.125 1.914062 -1.90625 2.03125 -1.71875 C 2.15625 -1.53125 2.320312 -1.382812 2.53125 -1.28125 C 2.75 -1.175781 3 -1.125 3.28125 -1.125 Z M 3.28125 -1.125 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(179.359208, 10.887099)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(181.867978, 10.887099)"><g><path d="M 3.71875 -7.59375 C 4.945312 -7.59375 5.882812 -7.273438 6.53125 -6.640625 C 7.1875 -6.003906 7.515625 -5.054688 7.515625 -3.796875 C 7.515625 -2.546875 7.1875 -1.597656 6.53125 -0.953125 C 5.882812 -0.316406 4.945312 0 3.71875 0 L 0.984375 0 L 0.984375 -7.59375 Z M 3.625 -1.265625 C 4.414062 -1.265625 5.003906 -1.460938 5.390625 -1.859375 C 5.773438 -2.265625 5.96875 -2.910156 5.96875 -3.796875 C 5.96875 -4.691406 5.773438 -5.335938 5.390625 -5.734375 C 5.003906 -6.128906 4.414062 -6.328125 3.625 -6.328125 L 2.484375 -6.328125 L 2.484375 -1.265625 Z M 3.625 -1.265625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(189.98642, 10.887099)"><g><path d="M 3.328125 0.109375 C 2.765625 0.109375 2.269531 -0.00390625 1.84375 -0.234375 C 1.425781 -0.460938 1.097656 -0.800781 0.859375 -1.25 C 0.628906 -1.695312 0.515625 -2.234375 0.515625 -2.859375 C 0.515625 -3.492188 0.628906 -4.035156 0.859375 -4.484375 C 1.097656 -4.929688 1.425781 -5.269531 1.84375 -5.5 C 2.269531 -5.726562 2.765625 -5.84375 3.328125 -5.84375 C 3.890625 -5.84375 4.378906 -5.726562 4.796875 -5.5 C 5.222656 -5.269531 5.554688 -4.929688 5.796875 -4.484375 C 6.035156 -4.035156 6.15625 -3.492188 6.15625 -2.859375 C 6.15625 -2.234375 6.035156 -1.695312 5.796875 -1.25 C 5.554688 -0.800781 5.222656 -0.460938 4.796875 -0.234375 C 4.378906 -0.00390625 3.890625 0.109375 3.328125 0.109375 Z M 3.328125 -1.109375 C 4.222656 -1.109375 4.671875 -1.691406 4.671875 -2.859375 C 4.671875 -3.460938 4.554688 -3.90625 4.328125 -4.1875 C 4.097656 -4.476562 3.765625 -4.625 3.328125 -4.625 C 2.441406 -4.625 2 -4.035156 2 -2.859375 C 2 -1.691406 2.441406 -1.109375 3.328125 -1.109375 Z M 3.328125 -1.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(196.645309, 10.887099)"><g><path d="M 3.34375 0.109375 C 2.789062 0.109375 2.300781 -0.00390625 1.875 -0.234375 C 1.445312 -0.460938 1.113281 -0.800781 0.875 -1.25 C 0.632812 -1.695312 0.515625 -2.234375 0.515625 -2.859375 C 0.515625 -3.492188 0.632812 -4.035156 0.875 -4.484375 C 1.113281 -4.929688 1.441406 -5.269531 1.859375 -5.5 C 2.285156 -5.726562 2.769531 -5.84375 3.3125 -5.84375 C 4.519531 -5.84375 5.296875 -5.40625 5.640625 -4.53125 L 4.65625 -3.8125 L 4.546875 -3.8125 C 4.421875 -4.082031 4.265625 -4.285156 4.078125 -4.421875 C 3.890625 -4.554688 3.632812 -4.625 3.3125 -4.625 C 2.894531 -4.625 2.570312 -4.476562 2.34375 -4.1875 C 2.113281 -3.894531 2 -3.453125 2 -2.859375 C 2 -2.273438 2.113281 -1.835938 2.34375 -1.546875 C 2.582031 -1.253906 2.914062 -1.109375 3.34375 -1.109375 C 3.65625 -1.109375 3.914062 -1.191406 4.125 -1.359375 C 4.34375 -1.523438 4.5 -1.769531 4.59375 -2.09375 L 4.703125 -2.09375 L 5.734375 -1.53125 C 5.585938 -1.050781 5.316406 -0.65625 4.921875 -0.34375 C 4.523438 -0.0390625 4 0.109375 3.34375 0.109375 Z M 3.34375 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(202.551047, 10.887099)"><g><path d="M 2.6875 0.109375 C 2.289062 0.109375 1.925781 0.0625 1.59375 -0.03125 C 1.269531 -0.125 0.992188 -0.25 0.765625 -0.40625 C 0.535156 -0.570312 0.367188 -0.757812 0.265625 -0.96875 L 1.0625 -1.828125 L 1.171875 -1.828125 C 1.359375 -1.566406 1.582031 -1.375 1.84375 -1.25 C 2.101562 -1.125 2.382812 -1.0625 2.6875 -1.0625 C 2.96875 -1.0625 3.175781 -1.109375 3.3125 -1.203125 C 3.457031 -1.304688 3.53125 -1.453125 3.53125 -1.640625 C 3.53125 -1.785156 3.476562 -1.90625 3.375 -2 C 3.28125 -2.101562 3.117188 -2.179688 2.890625 -2.234375 L 2.125 -2.421875 C 1.5625 -2.554688 1.148438 -2.757812 0.890625 -3.03125 C 0.628906 -3.3125 0.5 -3.664062 0.5 -4.09375 C 0.5 -4.457031 0.585938 -4.769531 0.765625 -5.03125 C 0.953125 -5.289062 1.207031 -5.488281 1.53125 -5.625 C 1.863281 -5.769531 2.25 -5.84375 2.6875 -5.84375 C 3.207031 -5.84375 3.632812 -5.765625 3.96875 -5.609375 C 4.3125 -5.460938 4.578125 -5.265625 4.765625 -5.015625 L 4 -4.1875 L 3.890625 -4.1875 C 3.734375 -4.363281 3.554688 -4.492188 3.359375 -4.578125 C 3.160156 -4.660156 2.9375 -4.703125 2.6875 -4.703125 C 2.125 -4.703125 1.84375 -4.523438 1.84375 -4.171875 C 1.84375 -4.023438 1.894531 -3.90625 2 -3.8125 C 2.101562 -3.71875 2.289062 -3.640625 2.5625 -3.578125 L 3.265625 -3.421875 C 3.847656 -3.296875 4.269531 -3.097656 4.53125 -2.828125 C 4.800781 -2.554688 4.9375 -2.1875 4.9375 -1.71875 C 4.9375 -1.351562 4.847656 -1.03125 4.671875 -0.75 C 4.492188 -0.476562 4.234375 -0.265625 3.890625 -0.109375 C 3.546875 0.0351562 3.144531 0.109375 2.6875 0.109375 Z M 2.6875 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(99.89729, 25.403228)"><g><path d="M 1 0 L 1 -4.59375 L 0.1875 -4.59375 L 0.1875 -5.734375 L 1 -5.734375 C 0.945312 -5.972656 0.921875 -6.203125 0.921875 -6.421875 C 0.921875 -6.785156 1 -7.09375 1.15625 -7.34375 C 1.320312 -7.601562 1.5625 -7.800781 1.875 -7.9375 C 2.1875 -8.070312 2.5625 -8.140625 3 -8.140625 C 3.625 -8.140625 4.09375 -8.03125 4.40625 -7.8125 L 4.078125 -6.75 L 3.96875 -6.734375 C 3.75 -6.890625 3.472656 -6.96875 3.140625 -6.96875 C 2.878906 -6.96875 2.679688 -6.898438 2.546875 -6.765625 C 2.421875 -6.640625 2.359375 -6.46875 2.359375 -6.25 C 2.359375 -6.15625 2.363281 -6.066406 2.375 -5.984375 C 2.382812 -5.910156 2.40625 -5.828125 2.4375 -5.734375 L 4.078125 -5.734375 L 4.078125 -4.59375 L 2.4375 -4.59375 L 2.4375 0 Z M 1 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(104.031826, 25.403228)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.21875 -5.734375 L 2.21875 -4.875 L 2.328125 -4.859375 C 2.472656 -5.171875 2.65625 -5.398438 2.875 -5.546875 C 3.101562 -5.703125 3.378906 -5.78125 3.703125 -5.78125 C 4.023438 -5.78125 4.269531 -5.722656 4.4375 -5.609375 L 4.203125 -4.375 L 4.09375 -4.359375 C 4 -4.390625 3.90625 -4.414062 3.8125 -4.4375 C 3.726562 -4.457031 3.625 -4.46875 3.5 -4.46875 C 3.101562 -4.46875 2.796875 -4.320312 2.578125 -4.03125 C 2.367188 -3.75 2.265625 -3.300781 2.265625 -2.6875 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(108.524758, 25.403228)"><g><path d="M 3.328125 0.109375 C 2.765625 0.109375 2.269531 -0.00390625 1.84375 -0.234375 C 1.425781 -0.460938 1.097656 -0.800781 0.859375 -1.25 C 0.628906 -1.695312 0.515625 -2.234375 0.515625 -2.859375 C 0.515625 -3.492188 0.628906 -4.035156 0.859375 -4.484375 C 1.097656 -4.929688 1.425781 -5.269531 1.84375 -5.5 C 2.269531 -5.726562 2.765625 -5.84375 3.328125 -5.84375 C 3.890625 -5.84375 4.378906 -5.726562 4.796875 -5.5 C 5.222656 -5.269531 5.554688 -4.929688 5.796875 -4.484375 C 6.035156 -4.035156 6.15625 -3.492188 6.15625 -2.859375 C 6.15625 -2.234375 6.035156 -1.695312 5.796875 -1.25 C 5.554688 -0.800781 5.222656 -0.460938 4.796875 -0.234375 C 4.378906 -0.00390625 3.890625 0.109375 3.328125 0.109375 Z M 3.328125 -1.109375 C 4.222656 -1.109375 4.671875 -1.691406 4.671875 -2.859375 C 4.671875 -3.460938 4.554688 -3.90625 4.328125 -4.1875 C 4.097656 -4.476562 3.765625 -4.625 3.328125 -4.625 C 2.441406 -4.625 2 -4.035156 2 -2.859375 C 2 -1.691406 2.441406 -1.109375 3.328125 -1.109375 Z M 3.328125 -1.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(115.183647, 25.403228)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.203125 -5.734375 L 2.203125 -4.96875 L 2.3125 -4.9375 C 2.5 -5.25 2.71875 -5.476562 2.96875 -5.625 C 3.21875 -5.769531 3.539062 -5.84375 3.9375 -5.84375 C 4.375 -5.84375 4.722656 -5.753906 4.984375 -5.578125 C 5.242188 -5.410156 5.4375 -5.160156 5.5625 -4.828125 L 5.671875 -4.828125 C 5.847656 -5.171875 6.070312 -5.425781 6.34375 -5.59375 C 6.625 -5.757812 6.972656 -5.84375 7.390625 -5.84375 C 8.578125 -5.84375 9.171875 -5.179688 9.171875 -3.859375 L 9.171875 0 L 7.734375 0 L 7.734375 -3.671875 C 7.734375 -4.003906 7.664062 -4.242188 7.53125 -4.390625 C 7.40625 -4.546875 7.195312 -4.625 6.90625 -4.625 C 6.113281 -4.625 5.71875 -4.097656 5.71875 -3.046875 L 5.71875 0 L 4.28125 0 L 4.28125 -3.671875 C 4.28125 -4.003906 4.210938 -4.242188 4.078125 -4.390625 C 3.941406 -4.546875 3.726562 -4.625 3.4375 -4.625 C 3.070312 -4.625 2.785156 -4.5 2.578125 -4.25 C 2.367188 -4 2.265625 -3.609375 2.265625 -3.078125 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(125.094068, 25.403228)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(127.602838, 25.403228)"><g><path d="M 1.265625 2.4375 C 1.023438 2.4375 0.800781 2.414062 0.59375 2.375 C 0.394531 2.332031 0.234375 2.28125 0.109375 2.21875 L 0.34375 1.0625 L 0.4375 1.03125 C 0.519531 1.070312 0.625 1.101562 0.75 1.125 C 0.882812 1.15625 1.019531 1.171875 1.15625 1.171875 C 1.382812 1.171875 1.578125 1.140625 1.734375 1.078125 C 1.890625 1.023438 2.019531 0.925781 2.125 0.78125 C 2.226562 0.644531 2.320312 0.453125 2.40625 0.203125 L 0.125 -5.734375 L 1.625 -5.734375 L 3.0625 -1.75 L 3.1875 -1.75 L 4.5625 -5.734375 L 6.03125 -5.734375 L 3.734375 0.359375 C 3.546875 0.847656 3.34375 1.242188 3.125 1.546875 C 2.90625 1.847656 2.644531 2.070312 2.34375 2.21875 C 2.039062 2.363281 1.679688 2.4375 1.265625 2.4375 Z M 1.265625 2.4375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(133.752701, 25.403228)"><g><path d="M 3.328125 0.109375 C 2.765625 0.109375 2.269531 -0.00390625 1.84375 -0.234375 C 1.425781 -0.460938 1.097656 -0.800781 0.859375 -1.25 C 0.628906 -1.695312 0.515625 -2.234375 0.515625 -2.859375 C 0.515625 -3.492188 0.628906 -4.035156 0.859375 -4.484375 C 1.097656 -4.929688 1.425781 -5.269531 1.84375 -5.5 C 2.269531 -5.726562 2.765625 -5.84375 3.328125 -5.84375 C 3.890625 -5.84375 4.378906 -5.726562 4.796875 -5.5 C 5.222656 -5.269531 5.554688 -4.929688 5.796875 -4.484375 C 6.035156 -4.035156 6.15625 -3.492188 6.15625 -2.859375 C 6.15625 -2.234375 6.035156 -1.695312 5.796875 -1.25 C 5.554688 -0.800781 5.222656 -0.460938 4.796875 -0.234375 C 4.378906 -0.00390625 3.890625 0.109375 3.328125 0.109375 Z M 3.328125 -1.109375 C 4.222656 -1.109375 4.671875 -1.691406 4.671875 -2.859375 C 4.671875 -3.460938 4.554688 -3.90625 4.328125 -4.1875 C 4.097656 -4.476562 3.765625 -4.625 3.328125 -4.625 C 2.441406 -4.625 2 -4.035156 2 -2.859375 C 2 -1.691406 2.441406 -1.109375 3.328125 -1.109375 Z M 3.328125 -1.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(140.41159, 25.403228)"><g><path d="M 2.625 0.109375 C 1.976562 0.109375 1.5 -0.0664062 1.1875 -0.421875 C 0.882812 -0.773438 0.734375 -1.28125 0.734375 -1.9375 L 0.734375 -5.734375 L 2.171875 -5.734375 L 2.171875 -2.109375 C 2.171875 -1.765625 2.242188 -1.507812 2.390625 -1.34375 C 2.546875 -1.1875 2.785156 -1.109375 3.109375 -1.109375 C 3.503906 -1.109375 3.8125 -1.238281 4.03125 -1.5 C 4.25 -1.757812 4.359375 -2.171875 4.359375 -2.734375 L 4.359375 -5.734375 L 5.796875 -5.734375 L 5.796875 0 L 4.421875 0 L 4.421875 -0.84375 L 4.3125 -0.875 C 4.125 -0.539062 3.894531 -0.289062 3.625 -0.125 C 3.363281 0.03125 3.03125 0.109375 2.625 0.109375 Z M 2.625 0.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(147.039314, 25.403228)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.21875 -5.734375 L 2.21875 -4.875 L 2.328125 -4.859375 C 2.472656 -5.171875 2.65625 -5.398438 2.875 -5.546875 C 3.101562 -5.703125 3.378906 -5.78125 3.703125 -5.78125 C 4.023438 -5.78125 4.269531 -5.722656 4.4375 -5.609375 L 4.203125 -4.375 L 4.09375 -4.359375 C 4 -4.390625 3.90625 -4.414062 3.8125 -4.4375 C 3.726562 -4.457031 3.625 -4.46875 3.5 -4.46875 C 3.101562 -4.46875 2.796875 -4.320312 2.578125 -4.03125 C 2.367188 -3.75 2.265625 -3.300781 2.265625 -2.6875 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(151.532245, 25.403228)"><g/></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(154.041016, 25.403228)"><g><path d="M 4.140625 0.109375 C 3.441406 0.109375 2.828125 -0.03125 2.296875 -0.3125 C 1.765625 -0.601562 1.347656 -1.039062 1.046875 -1.625 C 0.742188 -2.207031 0.59375 -2.929688 0.59375 -3.796875 C 0.59375 -4.671875 0.742188 -5.398438 1.046875 -5.984375 C 1.347656 -6.566406 1.765625 -7 2.296875 -7.28125 C 2.828125 -7.5625 3.441406 -7.703125 4.140625 -7.703125 C 4.835938 -7.703125 5.453125 -7.5625 5.984375 -7.28125 C 6.515625 -7 6.925781 -6.566406 7.21875 -5.984375 C 7.519531 -5.398438 7.671875 -4.671875 7.671875 -3.796875 C 7.671875 -2.929688 7.519531 -2.203125 7.21875 -1.609375 C 6.925781 -1.023438 6.515625 -0.59375 5.984375 -0.3125 C 5.453125 -0.03125 4.835938 0.109375 4.140625 0.109375 Z M 4.140625 -1.1875 C 4.785156 -1.1875 5.273438 -1.394531 5.609375 -1.8125 C 5.953125 -2.226562 6.125 -2.890625 6.125 -3.796875 C 6.125 -4.703125 5.953125 -5.363281 5.609375 -5.78125 C 5.273438 -6.195312 4.785156 -6.40625 4.140625 -6.40625 C 3.492188 -6.40625 3 -6.195312 2.65625 -5.78125 C 2.3125 -5.363281 2.140625 -4.703125 2.140625 -3.796875 C 2.140625 -2.890625 2.3125 -2.226562 2.65625 -1.8125 C 3 -1.394531 3.492188 -1.1875 4.140625 -1.1875 Z M 4.140625 -1.1875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(162.315282, 25.403228)"><g><path d="M 0.828125 2.328125 L 0.828125 -5.734375 L 2.265625 -5.734375 L 2.265625 -4.984375 L 2.375 -4.96875 C 2.539062 -5.25 2.765625 -5.460938 3.046875 -5.609375 C 3.335938 -5.765625 3.671875 -5.84375 4.046875 -5.84375 C 4.515625 -5.84375 4.921875 -5.734375 5.265625 -5.515625 C 5.609375 -5.296875 5.875 -4.960938 6.0625 -4.515625 C 6.257812 -4.066406 6.359375 -3.515625 6.359375 -2.859375 C 6.359375 -2.203125 6.253906 -1.648438 6.046875 -1.203125 C 5.847656 -0.765625 5.566406 -0.4375 5.203125 -0.21875 C 4.847656 0 4.429688 0.109375 3.953125 0.109375 C 3.597656 0.109375 3.289062 0.0507812 3.03125 -0.0625 C 2.769531 -0.1875 2.550781 -0.375 2.375 -0.625 L 2.265625 -0.609375 L 2.265625 2.328125 Z M 3.5625 -1.109375 C 3.988281 -1.109375 4.3125 -1.25 4.53125 -1.53125 C 4.757812 -1.8125 4.875 -2.253906 4.875 -2.859375 C 4.875 -3.460938 4.757812 -3.90625 4.53125 -4.1875 C 4.3125 -4.476562 3.988281 -4.625 3.5625 -4.625 C 3.15625 -4.625 2.832031 -4.476562 2.59375 -4.1875 C 2.363281 -3.894531 2.25 -3.453125 2.25 -2.859375 C 2.25 -2.273438 2.363281 -1.835938 2.59375 -1.546875 C 2.832031 -1.253906 3.15625 -1.109375 3.5625 -1.109375 Z M 3.5625 -1.109375 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(169.176742, 25.403228)"><g><path d="M 5.65625 -2.546875 L 1.984375 -2.546875 C 2.023438 -2.046875 2.164062 -1.679688 2.40625 -1.453125 C 2.644531 -1.222656 2.972656 -1.109375 3.390625 -1.109375 C 3.722656 -1.109375 3.988281 -1.171875 4.1875 -1.296875 C 4.394531 -1.421875 4.5625 -1.609375 4.6875 -1.859375 L 4.796875 -1.859375 L 5.75 -1.234375 C 5.5625 -0.835938 5.28125 -0.515625 4.90625 -0.265625 C 4.53125 -0.015625 4.023438 0.109375 3.390625 0.109375 C 2.804688 0.109375 2.296875 0 1.859375 -0.21875 C 1.429688 -0.445312 1.097656 -0.785156 0.859375 -1.234375 C 0.628906 -1.679688 0.515625 -2.222656 0.515625 -2.859375 C 0.515625 -3.515625 0.632812 -4.066406 0.875 -4.515625 C 1.125 -4.960938 1.457031 -5.296875 1.875 -5.515625 C 2.300781 -5.734375 2.773438 -5.84375 3.296875 -5.84375 C 4.109375 -5.84375 4.726562 -5.625 5.15625 -5.1875 C 5.582031 -4.757812 5.796875 -4.128906 5.796875 -3.296875 C 5.796875 -3.003906 5.785156 -2.773438 5.765625 -2.609375 Z M 4.421875 -3.46875 C 4.410156 -3.90625 4.3125 -4.222656 4.125 -4.421875 C 3.9375 -4.617188 3.660156 -4.71875 3.296875 -4.71875 C 2.566406 -4.71875 2.140625 -4.300781 2.015625 -3.46875 Z M 4.421875 -3.46875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(175.404517, 25.403228)"><g><path d="M 0.828125 0 L 0.828125 -5.734375 L 2.203125 -5.734375 L 2.203125 -4.890625 L 2.3125 -4.859375 C 2.675781 -5.515625 3.253906 -5.84375 4.046875 -5.84375 C 4.710938 -5.84375 5.195312 -5.660156 5.5 -5.296875 C 5.8125 -4.941406 5.96875 -4.414062 5.96875 -3.71875 L 5.96875 0 L 4.53125 0 L 4.53125 -3.546875 C 4.53125 -3.929688 4.453125 -4.207031 4.296875 -4.375 C 4.148438 -4.539062 3.910156 -4.625 3.578125 -4.625 C 3.160156 -4.625 2.835938 -4.488281 2.609375 -4.21875 C 2.378906 -3.957031 2.265625 -3.539062 2.265625 -2.96875 L 2.265625 0 Z M 0.828125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(182.115348, 25.403228)"><g><path d="M 7.296875 0 L 5.703125 0 L 5.140625 -1.75 L 2.234375 -1.75 L 1.65625 0 L 0.109375 0 L 2.734375 -7.59375 L 4.671875 -7.59375 Z M 3.609375 -6.015625 L 2.640625 -3.015625 L 4.71875 -3.015625 L 3.734375 -6.015625 Z M 3.609375 -6.015625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(189.516998, 25.403228)"><g><path d="M 3.921875 -7.59375 C 4.460938 -7.59375 4.925781 -7.492188 5.3125 -7.296875 C 5.695312 -7.097656 5.988281 -6.816406 6.1875 -6.453125 C 6.382812 -6.097656 6.484375 -5.6875 6.484375 -5.21875 C 6.484375 -4.738281 6.382812 -4.316406 6.1875 -3.953125 C 5.988281 -3.597656 5.695312 -3.320312 5.3125 -3.125 C 4.925781 -2.925781 4.460938 -2.828125 3.921875 -2.828125 L 2.484375 -2.828125 L 2.484375 0 L 0.984375 0 L 0.984375 -7.59375 Z M 3.71875 -4.015625 C 4.5625 -4.015625 4.984375 -4.414062 4.984375 -5.21875 C 4.984375 -6.007812 4.5625 -6.40625 3.71875 -6.40625 L 2.484375 -6.40625 L 2.484375 -4.015625 Z M 3.71875 -4.015625 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(196.456371, 25.403228)"><g><path d="M 2.484375 0 L 0.984375 0 L 0.984375 -7.59375 L 2.484375 -7.59375 Z M 2.484375 0 "/></g></g></g><path fill="#77b255" d="M 26.832031 18.226562 C 24.703125 17.964844 23.769531 16.769531 21.898438 14.382812 C 24.289062 12.511719 25.484375 11.578125 27.609375 11.835938 C 29.742188 12.097656 31.738281 13.421875 32.542969 15.683594 C 31.21875 17.679688 28.960938 18.484375 26.832031 18.226562 Z M 22.144531 25.15625 C 20.140625 25.007812 19.210938 23.933594 17.351562 21.785156 C 19.5 19.925781 20.574219 18.996094 22.582031 19.140625 C 24.585938 19.285156 26.519531 20.433594 27.375 22.511719 C 26.226562 24.441406 24.152344 25.300781 22.144531 25.15625 Z M 17.253906 12.804688 C 18.304688 14.089844 18.191406 15.257812 17.960938 17.59375 C 15.625 17.363281 14.457031 17.246094 13.402344 15.964844 C 12.351562 14.679688 11.941406 12.871094 12.699219 11.175781 C 14.507812 10.765625 16.203125 11.523438 17.253906 12.804688 Z M 33.859375 8.523438 C 31.941406 9.324219 30.585938 8.769531 27.871094 7.660156 C 28.980469 4.945312 29.535156 3.585938 31.449219 2.78125 C 33.363281 1.980469 35.675781 2.132812 37.433594 3.644531 C 37.28125 5.957031 35.769531 7.71875 33.859375 8.523438 Z M 23.832031 5.726562 C 24.519531 7.984375 23.734375 9.457031 22.164062 12.402344 C 19.21875 10.832031 17.746094 10.046875 17.058594 7.792969 C 16.371094 5.535156 16.8125 2.933594 18.722656 1.117188 C 21.324219 1.558594 23.144531 3.46875 23.832031 5.726562 Z M 23.832031 5.726562 " fill-opacity="1" fill-rule="nonzero"/><path fill="#a6d388" d="M 17.058594 7.792969 C 17.738281 10.015625 19.183594 10.8125 22.042969 12.335938 L 22.042969 12.332031 C 21.988281 10.351562 19.894531 3.78125 18.6875 1.15625 C 16.808594 2.972656 16.375 5.550781 17.058594 7.792969 Z M 12.664062 11.273438 C 11.960938 12.9375 12.371094 14.703125 13.402344 15.964844 C 14.457031 17.246094 15.625 17.363281 17.960938 17.59375 C 17.175781 16.070312 14.097656 12.570312 12.664062 11.273438 Z M 12.664062 11.273438 " fill-opacity="1" fill-rule="nonzero"/><path fill="#5c913b" d="M 27.609375 11.835938 C 25.597656 11.59375 24.40625 12.425781 22.257812 14.101562 C 23.632812 14.183594 29.167969 14.6875 32.527344 15.703125 C 32.53125 15.695312 32.539062 15.691406 32.542969 15.683594 C 31.738281 13.421875 29.742188 12.097656 27.609375 11.835938 Z M 27.371094 22.503906 C 26.515625 20.429688 24.585938 19.285156 22.582031 19.140625 C 20.613281 19 19.539062 19.894531 17.472656 21.679688 C 19.648438 21.441406 23.6875 20.996094 27.371094 22.503906 Z M 27.371094 22.503906 " fill-opacity="1" fill-rule="nonzero"/><path fill="#a6d388" d="M 28.011719 7.71875 C 30.628906 8.785156 31.976562 9.308594 33.855469 8.523438 C 35.757812 7.722656 37.261719 5.976562 37.429688 3.679688 C 34.34375 4.277344 29.257812 6.941406 28.011719 7.71875 Z M 28.011719 7.71875 " fill-opacity="1" fill-rule="nonzero"/><g clip-path="url(#16c6c08de4)"><path fill="#a06253" d="M 14.121094 28.101562 C 13.660156 28.027344 13.046875 27.445312 13.117188 26.988281 C 13.546875 24.1875 15.367188 17.417969 27.503906 7.523438 C 27.867188 7.226562 28.273438 7.003906 28.578125 7.355469 C 28.886719 7.707031 28.539062 8.101562 28.1875 8.410156 C 17.738281 17.507812 15.988281 24.710938 15.589844 27.332031 C 15.515625 27.789062 14.578125 28.167969 14.121094 28.101562 Z M 14.121094 28.101562 " fill-opacity="1" fill-rule="nonzero"/></g><g fill="#000000" fill-opacity="1"><g transform="translate(39.401535, 19.959679)"><g><path d="M 8.453125 -11.046875 L 8.453125 -9.21875 L 3.625 -9.21875 L 3.625 -6.296875 L 8 -6.296875 L 8 -4.484375 L 3.625 -4.484375 L 3.625 0 L 1.4375 0 L 1.4375 -11.046875 Z M 8.453125 -11.046875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(48.335845, 19.959679)"><g><path d="M 8.234375 -3.703125 L 2.875 -3.703125 C 2.9375 -2.972656 3.144531 -2.441406 3.5 -2.109375 C 3.851562 -1.785156 4.332031 -1.625 4.9375 -1.625 C 5.414062 -1.625 5.804688 -1.710938 6.109375 -1.890625 C 6.410156 -2.066406 6.648438 -2.335938 6.828125 -2.703125 L 6.984375 -2.703125 L 8.375 -1.8125 C 8.101562 -1.226562 7.691406 -0.753906 7.140625 -0.390625 C 6.597656 -0.0234375 5.863281 0.15625 4.9375 0.15625 C 4.082031 0.15625 3.335938 -0.00390625 2.703125 -0.328125 C 2.078125 -0.660156 1.59375 -1.148438 1.25 -1.796875 C 0.914062 -2.441406 0.75 -3.234375 0.75 -4.171875 C 0.75 -5.117188 0.925781 -5.914062 1.28125 -6.5625 C 1.644531 -7.207031 2.128906 -7.691406 2.734375 -8.015625 C 3.347656 -8.335938 4.035156 -8.5 4.796875 -8.5 C 5.972656 -8.5 6.875 -8.1875 7.5 -7.5625 C 8.132812 -6.9375 8.453125 -6.019531 8.453125 -4.8125 C 8.453125 -4.375 8.4375 -4.03125 8.40625 -3.78125 Z M 6.4375 -5.046875 C 6.414062 -5.679688 6.269531 -6.144531 6 -6.4375 C 5.726562 -6.726562 5.328125 -6.875 4.796875 -6.875 C 3.734375 -6.875 3.109375 -6.265625 2.921875 -5.046875 Z M 6.4375 -5.046875 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(57.398657, 19.959679)"><g><path d="M 1.203125 0 L 1.203125 -8.34375 L 3.234375 -8.34375 L 3.234375 -7.09375 L 3.390625 -7.0625 C 3.597656 -7.53125 3.863281 -7.875 4.1875 -8.09375 C 4.519531 -8.3125 4.921875 -8.421875 5.390625 -8.421875 C 5.859375 -8.421875 6.21875 -8.335938 6.46875 -8.171875 L 6.109375 -6.359375 L 5.953125 -6.328125 C 5.816406 -6.390625 5.6875 -6.429688 5.5625 -6.453125 C 5.4375 -6.484375 5.28125 -6.5 5.09375 -6.5 C 4.507812 -6.5 4.0625 -6.289062 3.75 -5.875 C 3.445312 -5.46875 3.296875 -4.8125 3.296875 -3.90625 L 3.296875 0 Z M 1.203125 0 "/></g></g></g><g fill="#000000" fill-opacity="1"><g transform="translate(63.936885, 19.959679)"><g><path d="M 1.203125 0 L 1.203125 -8.34375 L 3.21875 -8.34375 L 3.21875 -7.109375 L 3.375 -7.078125 C 3.894531 -8.023438 4.734375 -8.5 5.890625 -8.5 C 6.859375 -8.5 7.566406 -8.234375 8.015625 -7.703125 C 8.460938 -7.179688 8.6875 -6.421875 8.6875 -5.421875 L 8.6875 0 L 6.59375 0 L 6.59375 -5.15625 C 6.59375 -5.71875 6.484375 -6.117188 6.265625 -6.359375 C 6.046875 -6.609375 5.691406 -6.734375 5.203125 -6.734375 C 4.597656 -6.734375 4.128906 -6.535156 3.796875 -6.140625 C 3.460938 -5.753906 3.296875 -5.144531 3.296875 -4.3125 L 3.296875 0 Z M 1.203125 0 "/></g></g></g></svg>

From 01f91fdb57e55b4540363ef5749480dc3f3e8bf6 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 1 Aug 2023 21:40:00 +0000
Subject: [PATCH 038/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2aed9859a..895926cab 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🍱 Update sponsors, Fern badge. PR [#9982](https://github.com/tiangolo/fastapi/pull/9982) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Deploy docs to Cloudflare Pages. PR [#9978](https://github.com/tiangolo/fastapi/pull/9978) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsor Fern. PR [#9979](https://github.com/tiangolo/fastapi/pull/9979) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Update CI debug mode with Tmate. PR [#9977](https://github.com/tiangolo/fastapi/pull/9977) by [@tiangolo](https://github.com/tiangolo).

From 88d96799b15e530c068f749626595c739bce3fcf Mon Sep 17 00:00:00 2001
From: Nikita <omegastrikeclan@yandex.ru>
Date: Wed, 2 Aug 2023 18:14:19 +0300
Subject: [PATCH 039/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Russian=20translat?=
 =?UTF-8?q?ion=20for=20`docs/ru/docs/tutorial/security/index.md`=20(#9963)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: dedkot <dedkot01@gmail.com>
Co-authored-by: Vladislav Kramorenko <85196001+Xewus@users.noreply.github.com>
---
 docs/ru/docs/tutorial/security/index.md | 101 ++++++++++++++++++++++++
 1 file changed, 101 insertions(+)
 create mode 100644 docs/ru/docs/tutorial/security/index.md

diff --git a/docs/ru/docs/tutorial/security/index.md b/docs/ru/docs/tutorial/security/index.md
new file mode 100644
index 000000000..d5fe4e76f
--- /dev/null
+++ b/docs/ru/docs/tutorial/security/index.md
@@ -0,0 +1,101 @@
+# Настройка авторизации
+
+Существует множество способов обеспечения безопасности, аутентификации и авторизации.
+
+Обычно эта тема является достаточно сложной и трудной.
+
+Во многих фреймворках и системах только работа с определением доступов к приложению и аутентификацией требует значительных затрат усилий и написания множества кода (во многих случаях его объём может составлять более 50% от всего написанного кода).
+
+**FastAPI** предоставляет несколько инструментов, которые помогут вам настроить **Авторизацию** легко, быстро, стандартным способом, без необходимости изучать все её тонкости.
+
+Но сначала давайте рассмотрим некоторые небольшие концепции.
+
+## Куда-то торопишься?
+
+Если вам не нужна информация о каких-либо из следующих терминов и вам просто нужно добавить защиту с аутентификацией на основе логина и пароля *прямо сейчас*, переходите к следующим главам.
+
+## OAuth2
+
+OAuth2 - это протокол, который определяет несколько способов обработки аутентификации и авторизации.
+
+Он довольно обширен и охватывает несколько сложных вариантов использования.
+
+OAuth2 включает в себя способы аутентификации с использованием "третьей стороны".
+
+Это то, что используют под собой все кнопки "вход с помощью Facebook, Google, Twitter, GitHub" на страницах авторизации.
+
+### OAuth 1
+
+Ранее использовался протокол OAuth 1, который сильно отличается от OAuth2 и является более сложным, поскольку он включал прямые описания того, как шифровать сообщение.
+
+В настоящее время он не очень популярен и не используется.
+
+OAuth2 не указывает, как шифровать сообщение, он ожидает, что ваше приложение будет обслуживаться по протоколу HTTPS.
+
+!!! tip "Подсказка"
+    В разделе **Развертывание** вы увидите [как настроить протокол HTTPS бесплатно, используя Traefik и Let's Encrypt.](https://fastapi.tiangolo.com/ru/deployment/https/)
+
+
+## OpenID Connect
+
+OpenID Connect - это еще один протокол, основанный на **OAuth2**.
+
+Он просто расширяет OAuth2, уточняя некоторые вещи, не имеющие однозначного определения в OAuth2, в попытке сделать его более совместимым.
+
+Например, для входа в Google используется OpenID Connect (который под собой использует OAuth2).
+
+Но вход в Facebook не поддерживает OpenID Connect. У него есть собственная вариация OAuth2.
+
+### OpenID (не "OpenID Connect")
+
+Также ранее использовался стандарт "OpenID", который пытался решить ту же проблему, что и **OpenID Connect**, но не был основан на OAuth2.
+
+Таким образом, это была полноценная дополнительная система.
+
+В настоящее время не очень популярен и не используется.
+
+## OpenAPI
+
+OpenAPI (ранее известный как Swagger) - это открытая спецификация для создания API (в настоящее время является частью Linux Foundation).
+
+**FastAPI** основан на **OpenAPI**.
+
+Это то, что делает возможным наличие множества автоматических интерактивных интерфейсов документирования, сгенерированного кода и т.д.
+
+В OpenAPI есть способ использовать несколько "схем" безопасности.
+
+Таким образом, вы можете воспользоваться преимуществами Всех этих стандартных инструментов, включая интерактивные системы документирования.
+
+OpenAPI может использовать следующие схемы авторизации:
+
+* `apiKey`: уникальный идентификатор для приложения, который может быть получен из:
+    * Параметров запроса.
+    * Заголовка.
+    * Cookies.
+* `http`: стандартные системы аутентификации по протоколу HTTP, включая:
+    * `bearer`: заголовок `Authorization` со значением `Bearer {уникальный токен}`. Это унаследовано от OAuth2.
+    * Базовая аутентификация по протоколу HTTP.
+    * HTTP Digest и т.д.
+* `oauth2`: все способы обеспечения безопасности OAuth2 называемые "потоки" (англ. "flows").
+    * Некоторые из этих "потоков" подходят для реализации аутентификации через сторонний сервис использующий OAuth 2.0 (например, Google, Facebook, Twitter, GitHub и т.д.):
+        * `implicit`
+        * `clientCredentials`
+        * `authorizationCode`
+    * Но есть один конкретный "поток", который может быть идеально использован для обработки аутентификации непосредственно в том же приложении:
+        * `password`: в некоторых следующих главах будут рассмотрены примеры этого.
+* `openIdConnect`: способ определить, как автоматически обнаруживать данные аутентификации OAuth2.
+    * Это автоматическое обнаружение определено в спецификации OpenID Connect.
+
+
+!!! tip "Подсказка"
+    Интеграция сторонних сервисов для аутентификации/авторизации таких как Google, Facebook, Twitter, GitHub и т.д. осуществляется достаточно легко.
+
+    Самой сложной проблемой является создание такого провайдера аутентификации/авторизации, но **FastAPI** предоставляет вам инструменты, позволяющие легко это сделать, выполняя при этом всю тяжелую работу за вас.
+
+## Преимущества **FastAPI**
+
+Fast API предоставляет несколько инструментов для каждой из этих схем безопасности в модуле `fastapi.security`, которые упрощают использование этих механизмов безопасности.
+
+В следующих главах вы увидите, как обезопасить свой API, используя инструменты, предоставляемые **FastAPI**.
+
+И вы также увидите, как он автоматически интегрируется в систему интерактивной документации.

From 2d8a776836e1363e021b2a1233a72584f57b5d7a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 2 Aug 2023 15:15:10 +0000
Subject: [PATCH 040/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 895926cab..fde398be5 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Russian translation for `docs/ru/docs/tutorial/security/index.md`. PR [#9963](https://github.com/tiangolo/fastapi/pull/9963) by [@eVery1337](https://github.com/eVery1337).
 * 🍱 Update sponsors, Fern badge. PR [#9982](https://github.com/tiangolo/fastapi/pull/9982) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Deploy docs to Cloudflare Pages. PR [#9978](https://github.com/tiangolo/fastapi/pull/9978) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsor Fern. PR [#9979](https://github.com/tiangolo/fastapi/pull/9979) by [@tiangolo](https://github.com/tiangolo).

From 37818f553ddb21b7adaaf16d18b95f9710065ad4 Mon Sep 17 00:00:00 2001
From: Irfanuddin Shafi Ahmed <irfanudeen08@gmail.com>
Date: Wed, 2 Aug 2023 20:58:34 +0530
Subject: [PATCH 041/317] =?UTF-8?q?=E2=9C=85=20Fix=20test=20error=20in=20W?=
 =?UTF-8?q?indows=20for=20`jsonable=5Fencoder`=20(#9840)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Marcelo Trylesinski <marcelotryle@gmail.com>
---
 tests/test_jsonable_encoder.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/tests/test_jsonable_encoder.py b/tests/test_jsonable_encoder.py
index ff3033ecd..7c8338ff3 100644
--- a/tests/test_jsonable_encoder.py
+++ b/tests/test_jsonable_encoder.py
@@ -247,8 +247,9 @@ def test_encode_model_with_pure_path():
             class Config:
                 arbitrary_types_allowed = True
 
-    obj = ModelWithPath(path=PurePath("/foo", "bar"))
-    assert jsonable_encoder(obj) == {"path": "/foo/bar"}
+    test_path = PurePath("/foo", "bar")
+    obj = ModelWithPath(path=test_path)
+    assert jsonable_encoder(obj) == {"path": str(test_path)}
 
 
 def test_encode_model_with_pure_posix_path():

From b473cdd88d878b6657f0c80edb384b71971841a8 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 2 Aug 2023 15:29:13 +0000
Subject: [PATCH 042/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index fde398be5..5065295e6 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ✅ Fix test error in Windows for `jsonable_encoder`. PR [#9840](https://github.com/tiangolo/fastapi/pull/9840) by [@iudeen](https://github.com/iudeen).
 * 🌐 Add Russian translation for `docs/ru/docs/tutorial/security/index.md`. PR [#9963](https://github.com/tiangolo/fastapi/pull/9963) by [@eVery1337](https://github.com/eVery1337).
 * 🍱 Update sponsors, Fern badge. PR [#9982](https://github.com/tiangolo/fastapi/pull/9982) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Deploy docs to Cloudflare Pages. PR [#9978](https://github.com/tiangolo/fastapi/pull/9978) by [@tiangolo](https://github.com/tiangolo).

From 1e6bfa1f3931b841f3c2e173a5e673e854130a8d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 2 Aug 2023 17:57:20 +0200
Subject: [PATCH 043/317] =?UTF-8?q?=E2=99=BB=EF=B8=8F=20Update=20FastAPI?=
 =?UTF-8?q?=20People=20logic=20with=20new=20Pydantic=20(#9985)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/actions/people/Dockerfile  |  2 +-
 .github/actions/people/app/main.py | 14 ++++++++------
 2 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/.github/actions/people/Dockerfile b/.github/actions/people/Dockerfile
index fa4197e6a..6d65f1c2b 100644
--- a/.github/actions/people/Dockerfile
+++ b/.github/actions/people/Dockerfile
@@ -1,6 +1,6 @@
 FROM python:3.7
 
-RUN pip install httpx PyGithub "pydantic==1.5.1" "pyyaml>=5.3.1,<6.0.0"
+RUN pip install httpx PyGithub "pydantic==2.0.2" "pyyaml>=5.3.1,<6.0.0"
 
 COPY ./app /app
 
diff --git a/.github/actions/people/app/main.py b/.github/actions/people/app/main.py
index b11e3456d..cb6b229e8 100644
--- a/.github/actions/people/app/main.py
+++ b/.github/actions/people/app/main.py
@@ -9,7 +9,8 @@ from typing import Any, Container, DefaultDict, Dict, List, Set, Union
 import httpx
 import yaml
 from github import Github
-from pydantic import BaseModel, BaseSettings, SecretStr
+from pydantic import BaseModel, SecretStr
+from pydantic_settings import BaseSettings
 
 github_graphql_url = "https://api.github.com/graphql"
 questions_category_id = "MDE4OkRpc2N1c3Npb25DYXRlZ29yeTMyMDAxNDM0"
@@ -382,6 +383,7 @@ def get_graphql_response(
     data = response.json()
     if "errors" in data:
         logging.error(f"Errors in response, after: {after}, category_id: {category_id}")
+        logging.error(data["errors"])
         logging.error(response.text)
         raise RuntimeError(response.text)
     return data
@@ -389,7 +391,7 @@ def get_graphql_response(
 
 def get_graphql_issue_edges(*, settings: Settings, after: Union[str, None] = None):
     data = get_graphql_response(settings=settings, query=issues_query, after=after)
-    graphql_response = IssuesResponse.parse_obj(data)
+    graphql_response = IssuesResponse.model_validate(data)
     return graphql_response.data.repository.issues.edges
 
 
@@ -404,19 +406,19 @@ def get_graphql_question_discussion_edges(
         after=after,
         category_id=questions_category_id,
     )
-    graphql_response = DiscussionsResponse.parse_obj(data)
+    graphql_response = DiscussionsResponse.model_validate(data)
     return graphql_response.data.repository.discussions.edges
 
 
 def get_graphql_pr_edges(*, settings: Settings, after: Union[str, None] = None):
     data = get_graphql_response(settings=settings, query=prs_query, after=after)
-    graphql_response = PRsResponse.parse_obj(data)
+    graphql_response = PRsResponse.model_validate(data)
     return graphql_response.data.repository.pullRequests.edges
 
 
 def get_graphql_sponsor_edges(*, settings: Settings, after: Union[str, None] = None):
     data = get_graphql_response(settings=settings, query=sponsors_query, after=after)
-    graphql_response = SponsorsResponse.parse_obj(data)
+    graphql_response = SponsorsResponse.model_validate(data)
     return graphql_response.data.user.sponsorshipsAsMaintainer.edges
 
 
@@ -607,7 +609,7 @@ def get_top_users(
 if __name__ == "__main__":
     logging.basicConfig(level=logging.INFO)
     settings = Settings()
-    logging.info(f"Using config: {settings.json()}")
+    logging.info(f"Using config: {settings.model_dump_json()}")
     g = Github(settings.input_token.get_secret_value())
     repo = g.get_repo(settings.github_repository)
     question_commentors, question_last_month_commentors, question_authors = get_experts(

From 165f29fe5ec6be1d42b82cdef8b3d144300005f9 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 2 Aug 2023 15:57:57 +0000
Subject: [PATCH 044/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 5065295e6..d0b7c6a93 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ♻️ Update FastAPI People logic with new Pydantic. PR [#9985](https://github.com/tiangolo/fastapi/pull/9985) by [@tiangolo](https://github.com/tiangolo).
 * ✅ Fix test error in Windows for `jsonable_encoder`. PR [#9840](https://github.com/tiangolo/fastapi/pull/9840) by [@iudeen](https://github.com/iudeen).
 * 🌐 Add Russian translation for `docs/ru/docs/tutorial/security/index.md`. PR [#9963](https://github.com/tiangolo/fastapi/pull/9963) by [@eVery1337](https://github.com/eVery1337).
 * 🍱 Update sponsors, Fern badge. PR [#9982](https://github.com/tiangolo/fastapi/pull/9982) by [@tiangolo](https://github.com/tiangolo).

From 53220b983227ef6147a43dfdc0528ff4e6c31f6c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 2 Aug 2023 20:57:48 +0200
Subject: [PATCH 045/317] =?UTF-8?q?=E2=9E=95=20Add=20pydantic-settings=20t?=
 =?UTF-8?q?o=20FastAPI=20People=20dependencies=20(#9988)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/actions/people/Dockerfile | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/actions/people/Dockerfile b/.github/actions/people/Dockerfile
index 6d65f1c2b..f0f389c64 100644
--- a/.github/actions/people/Dockerfile
+++ b/.github/actions/people/Dockerfile
@@ -1,6 +1,6 @@
-FROM python:3.7
+FROM python:3.11
 
-RUN pip install httpx PyGithub "pydantic==2.0.2" "pyyaml>=5.3.1,<6.0.0"
+RUN pip install httpx PyGithub "pydantic==2.0.2" pydantic-settings "pyyaml>=5.3.1,<6.0.0"
 
 COPY ./app /app
 

From 38291292451481ca9004a5031464fac036de0161 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 2 Aug 2023 18:58:29 +0000
Subject: [PATCH 046/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d0b7c6a93..920886e5d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ➕ Add pydantic-settings to FastAPI People dependencies. PR [#9988](https://github.com/tiangolo/fastapi/pull/9988) by [@tiangolo](https://github.com/tiangolo).
 * ♻️ Update FastAPI People logic with new Pydantic. PR [#9985](https://github.com/tiangolo/fastapi/pull/9985) by [@tiangolo](https://github.com/tiangolo).
 * ✅ Fix test error in Windows for `jsonable_encoder`. PR [#9840](https://github.com/tiangolo/fastapi/pull/9840) by [@iudeen](https://github.com/iudeen).
 * 🌐 Add Russian translation for `docs/ru/docs/tutorial/security/index.md`. PR [#9963](https://github.com/tiangolo/fastapi/pull/9963) by [@eVery1337](https://github.com/eVery1337).

From 89537a0497ef3ccacbe2f4959c3b4f31414319ee Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 3 Aug 2023 16:12:28 +0200
Subject: [PATCH 047/317] =?UTF-8?q?=F0=9F=90=B3=20Update=20Dockerfile=20wi?=
 =?UTF-8?q?th=20compatibility=20versions,=20to=20upgrade=20later=20(#9998)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/actions/people/Dockerfile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/actions/people/Dockerfile b/.github/actions/people/Dockerfile
index f0f389c64..1455106bd 100644
--- a/.github/actions/people/Dockerfile
+++ b/.github/actions/people/Dockerfile
@@ -1,4 +1,4 @@
-FROM python:3.11
+FROM python:3.9
 
 RUN pip install httpx PyGithub "pydantic==2.0.2" pydantic-settings "pyyaml>=5.3.1,<6.0.0"
 

From ad1d7f539ea53c3b75e9c23051d66663eac6146f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 3 Aug 2023 14:13:59 +0000
Subject: [PATCH 048/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 920886e5d..91745453c 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🐳 Update Dockerfile with compatibility versions, to upgrade later. PR [#9998](https://github.com/tiangolo/fastapi/pull/9998) by [@tiangolo](https://github.com/tiangolo).
 * ➕ Add pydantic-settings to FastAPI People dependencies. PR [#9988](https://github.com/tiangolo/fastapi/pull/9988) by [@tiangolo](https://github.com/tiangolo).
 * ♻️ Update FastAPI People logic with new Pydantic. PR [#9985](https://github.com/tiangolo/fastapi/pull/9985) by [@tiangolo](https://github.com/tiangolo).
 * ✅ Fix test error in Windows for `jsonable_encoder`. PR [#9840](https://github.com/tiangolo/fastapi/pull/9840) by [@iudeen](https://github.com/iudeen).

From 3fa6cfbcc5d37cecfc6a936c42c832978ecbfba6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 3 Aug 2023 16:25:11 +0200
Subject: [PATCH 049/317] =?UTF-8?q?=F0=9F=91=A5=20Update=20FastAPI=20Peopl?=
 =?UTF-8?q?e=20(#9999)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: github-actions <github-actions@github.com>
---
 docs/en/data/github_sponsors.yml |  93 +++++++--------
 docs/en/data/people.yml          | 188 +++++++++++++++----------------
 2 files changed, 142 insertions(+), 139 deletions(-)

diff --git a/docs/en/data/github_sponsors.yml b/docs/en/data/github_sponsors.yml
index 56a886c68..3a68ba62b 100644
--- a/docs/en/data/github_sponsors.yml
+++ b/docs/en/data/github_sponsors.yml
@@ -2,6 +2,9 @@ sponsors:
 - - login: cryptapi
     avatarUrl: https://avatars.githubusercontent.com/u/44925437?u=61369138589bc7fee6c417f3fbd50fbd38286cc4&v=4
     url: https://github.com/cryptapi
+  - login: fern-api
+    avatarUrl: https://avatars.githubusercontent.com/u/102944815?v=4
+    url: https://github.com/fern-api
   - login: nanram22
     avatarUrl: https://avatars.githubusercontent.com/u/116367316?v=4
     url: https://github.com/nanram22
@@ -29,15 +32,18 @@ sponsors:
   - login: VincentParedes
     avatarUrl: https://avatars.githubusercontent.com/u/103889729?v=4
     url: https://github.com/VincentParedes
+- - login: arcticfly
+    avatarUrl: https://avatars.githubusercontent.com/u/41524992?u=03c88529a86cf51f7a380e890d84d84c71468848&v=4
+    url: https://github.com/arcticfly
 - - login: getsentry
     avatarUrl: https://avatars.githubusercontent.com/u/1396951?v=4
     url: https://github.com/getsentry
-- - login: takashi-yoneya
+- - login: acsone
+    avatarUrl: https://avatars.githubusercontent.com/u/7601056?v=4
+    url: https://github.com/acsone
+  - login: takashi-yoneya
     avatarUrl: https://avatars.githubusercontent.com/u/33813153?u=2d0522bceba0b8b69adf1f2db866503bd96f944e&v=4
     url: https://github.com/takashi-yoneya
-  - login: mercedes-benz
-    avatarUrl: https://avatars.githubusercontent.com/u/34240465?v=4
-    url: https://github.com/mercedes-benz
   - login: xoflare
     avatarUrl: https://avatars.githubusercontent.com/u/74335107?v=4
     url: https://github.com/xoflare
@@ -50,12 +56,12 @@ sponsors:
   - login: BoostryJP
     avatarUrl: https://avatars.githubusercontent.com/u/57932412?v=4
     url: https://github.com/BoostryJP
+  - login: jina-ai
+    avatarUrl: https://avatars.githubusercontent.com/u/60539444?v=4
+    url: https://github.com/jina-ai
 - - login: HiredScore
     avatarUrl: https://avatars.githubusercontent.com/u/3908850?v=4
     url: https://github.com/HiredScore
-  - login: petebachant
-    avatarUrl: https://avatars.githubusercontent.com/u/4604869?u=b17a5a4ac82f77b7efff864d439e8068d2a36593&v=4
-    url: https://github.com/petebachant
   - login: Trivie
     avatarUrl: https://avatars.githubusercontent.com/u/8161763?v=4
     url: https://github.com/Trivie
@@ -74,9 +80,6 @@ sponsors:
   - login: RodneyU215
     avatarUrl: https://avatars.githubusercontent.com/u/3329665?u=ec6a9adf8e7e8e306eed7d49687c398608d1604f&v=4
     url: https://github.com/RodneyU215
-  - login: tizz98
-    avatarUrl: https://avatars.githubusercontent.com/u/5739698?u=f095a3659e3a8e7c69ccd822696990b521ea25f9&v=4
-    url: https://github.com/tizz98
   - login: americanair
     avatarUrl: https://avatars.githubusercontent.com/u/12281813?v=4
     url: https://github.com/americanair
@@ -92,11 +95,17 @@ sponsors:
 - - login: indeedeng
     avatarUrl: https://avatars.githubusercontent.com/u/2905043?v=4
     url: https://github.com/indeedeng
+  - login: iguit0
+    avatarUrl: https://avatars.githubusercontent.com/u/12905770?u=63a1a96d1e6c27d85c4f946b84836599de047f65&v=4
+    url: https://github.com/iguit0
+  - login: JacobKochems
+    avatarUrl: https://avatars.githubusercontent.com/u/41692189?u=a75f62ddc0d060ee6233a91e19c433d2687b8eb6&v=4
+    url: https://github.com/JacobKochems
 - - login: Kludex
     avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
     url: https://github.com/Kludex
   - login: samuelcolvin
-    avatarUrl: https://avatars.githubusercontent.com/u/4039449?u=807390ba9cfe23906c3bf8a0d56aaca3cf2bfa0d&v=4
+    avatarUrl: https://avatars.githubusercontent.com/u/4039449?u=42eb3b833047c8c4b4f647a031eaef148c16d93f&v=4
     url: https://github.com/samuelcolvin
   - login: jefftriplett
     avatarUrl: https://avatars.githubusercontent.com/u/50527?u=af1ddfd50f6afd6d99f333ba2ac8d0a5b245ea74&v=4
@@ -104,9 +113,6 @@ sponsors:
   - login: jstanden
     avatarUrl: https://avatars.githubusercontent.com/u/63288?u=c3658d57d2862c607a0e19c2101c3c51876e36ad&v=4
     url: https://github.com/jstanden
-  - login: kamalgill
-    avatarUrl: https://avatars.githubusercontent.com/u/133923?u=0df9181d97436ce330e9acf90ab8a54b7022efe7&v=4
-    url: https://github.com/kamalgill
   - login: dekoza
     avatarUrl: https://avatars.githubusercontent.com/u/210980?u=c03c78a8ae1039b500dfe343665536ebc51979b2&v=4
     url: https://github.com/dekoza
@@ -149,6 +155,9 @@ sponsors:
   - login: zsinx6
     avatarUrl: https://avatars.githubusercontent.com/u/3532625?u=ba75a5dc744d1116ccfeaaf30d41cb2fe81fe8dd&v=4
     url: https://github.com/zsinx6
+  - login: kennywakeland
+    avatarUrl: https://avatars.githubusercontent.com/u/3631417?u=7c8f743f1ae325dfadea7c62bbf1abd6a824fc55&v=4
+    url: https://github.com/kennywakeland
   - login: aacayaco
     avatarUrl: https://avatars.githubusercontent.com/u/3634801?u=eaadda178c964178fcb64886f6c732172c8f8219&v=4
     url: https://github.com/aacayaco
@@ -194,9 +203,6 @@ sponsors:
   - login: Shackelford-Arden
     avatarUrl: https://avatars.githubusercontent.com/u/7362263?v=4
     url: https://github.com/Shackelford-Arden
-  - login: savannahostrowski
-    avatarUrl: https://avatars.githubusercontent.com/u/8949415?u=c3177aa099fb2b8c36aeba349278b77f9a8df211&v=4
-    url: https://github.com/savannahostrowski
   - login: wdwinslow
     avatarUrl: https://avatars.githubusercontent.com/u/11562137?u=dc01daafb354135603a263729e3d26d939c0c452&v=4
     url: https://github.com/wdwinslow
@@ -236,9 +242,6 @@ sponsors:
   - login: ygorpontelo
     avatarUrl: https://avatars.githubusercontent.com/u/32963605?u=35f7103f9c4c4c2589ae5737ee882e9375ef072e&v=4
     url: https://github.com/ygorpontelo
-  - login: AlrasheedA
-    avatarUrl: https://avatars.githubusercontent.com/u/33544979?u=7fe66bf62b47682612b222e3e8f4795ef3be769b&v=4
-    url: https://github.com/AlrasheedA
   - login: ProteinQure
     avatarUrl: https://avatars.githubusercontent.com/u/33707203?v=4
     url: https://github.com/ProteinQure
@@ -281,9 +284,6 @@ sponsors:
   - login: DelfinaCare
     avatarUrl: https://avatars.githubusercontent.com/u/83734439?v=4
     url: https://github.com/DelfinaCare
-  - login: khoadaniel
-    avatarUrl: https://avatars.githubusercontent.com/u/84840546?v=4
-    url: https://github.com/khoadaniel
   - login: osawa-koki
     avatarUrl: https://avatars.githubusercontent.com/u/94336223?u=59c6fe6945bcbbaff87b2a794238671b060620d2&v=4
     url: https://github.com/osawa-koki
@@ -327,14 +327,11 @@ sponsors:
     avatarUrl: https://avatars.githubusercontent.com/u/861044?u=5abfca5588f3e906b31583d7ee62f6de4b68aa24&v=4
     url: https://github.com/browniebroke
   - login: janfilips
-    avatarUrl: https://avatars.githubusercontent.com/u/870699?u=96df18ad355e58b9397accc55f4eeb7a86e959b0&v=4
+    avatarUrl: https://avatars.githubusercontent.com/u/870699?u=80702ec63f14e675cd4cdcc6ce3821d2ed207fd7&v=4
     url: https://github.com/janfilips
   - login: WillHogan
     avatarUrl: https://avatars.githubusercontent.com/u/1661551?u=7036c064cf29781470573865264ec8e60b6b809f&v=4
     url: https://github.com/WillHogan
-  - login: NateShoffner
-    avatarUrl: https://avatars.githubusercontent.com/u/1712163?u=b43cc2fa3fd8bec54b7706e4b98b72543c7bfea8&v=4
-    url: https://github.com/NateShoffner
   - login: my3
     avatarUrl: https://avatars.githubusercontent.com/u/1825270?v=4
     url: https://github.com/my3
@@ -344,12 +341,6 @@ sponsors:
   - login: cbonoz
     avatarUrl: https://avatars.githubusercontent.com/u/2351087?u=fd3e8030b2cc9fbfbb54a65e9890c548a016f58b&v=4
     url: https://github.com/cbonoz
-  - login: Patechoc
-    avatarUrl: https://avatars.githubusercontent.com/u/2376641?u=23b49e9eda04f078cb74fa3f93593aa6a57bb138&v=4
-    url: https://github.com/Patechoc
-  - login: larsvik
-    avatarUrl: https://avatars.githubusercontent.com/u/3442226?v=4
-    url: https://github.com/larsvik
   - login: anthonycorletti
     avatarUrl: https://avatars.githubusercontent.com/u/3477132?v=4
     url: https://github.com/anthonycorletti
@@ -359,6 +350,9 @@ sponsors:
   - login: Alisa-lisa
     avatarUrl: https://avatars.githubusercontent.com/u/4137964?u=e7e393504f554f4ff15863a1e01a5746863ef9ce&v=4
     url: https://github.com/Alisa-lisa
+  - login: piotrgredowski
+    avatarUrl: https://avatars.githubusercontent.com/u/4294480?v=4
+    url: https://github.com/piotrgredowski
   - login: danielunderwood
     avatarUrl: https://avatars.githubusercontent.com/u/4472301?v=4
     url: https://github.com/danielunderwood
@@ -383,6 +377,9 @@ sponsors:
   - login: mattwelke
     avatarUrl: https://avatars.githubusercontent.com/u/7719209?u=80f02a799323b1472b389b836d95957c93a6d856&v=4
     url: https://github.com/mattwelke
+  - login: harsh183
+    avatarUrl: https://avatars.githubusercontent.com/u/7780198?v=4
+    url: https://github.com/harsh183
   - login: hcristea
     avatarUrl: https://avatars.githubusercontent.com/u/7814406?u=61d7a4fcf846983a4606788eac25e1c6c1209ba8&v=4
     url: https://github.com/hcristea
@@ -428,9 +425,6 @@ sponsors:
   - login: shuheng-liu
     avatarUrl: https://avatars.githubusercontent.com/u/22414322?u=813c45f30786c6b511b21a661def025d8f7b609e&v=4
     url: https://github.com/shuheng-liu
-  - login: ghandic
-    avatarUrl: https://avatars.githubusercontent.com/u/23500353?u=e2e1d736f924d9be81e8bfc565b6d8836ba99773&v=4
-    url: https://github.com/ghandic
   - login: pers0n4
     avatarUrl: https://avatars.githubusercontent.com/u/24864600?u=f211a13a7b572cbbd7779b9c8d8cb428cc7ba07e&v=4
     url: https://github.com/pers0n4
@@ -458,9 +452,6 @@ sponsors:
   - login: bnkc
     avatarUrl: https://avatars.githubusercontent.com/u/34930566?u=527044d90b5ebb7f8dad517db5da1f45253b774b&v=4
     url: https://github.com/bnkc
-  - login: devbruce
-    avatarUrl: https://avatars.githubusercontent.com/u/35563380?u=ca4e811ac7f7b3eb1600fa63285119fcdee01188&v=4
-    url: https://github.com/devbruce
   - login: declon
     avatarUrl: https://avatars.githubusercontent.com/u/36180226?v=4
     url: https://github.com/declon
@@ -476,6 +467,9 @@ sponsors:
   - login: ArtyomVancyan
     avatarUrl: https://avatars.githubusercontent.com/u/44609997?v=4
     url: https://github.com/ArtyomVancyan
+  - login: josehenriqueroveda
+    avatarUrl: https://avatars.githubusercontent.com/u/46685746?u=2e672057a7dbe1dba47e57c378fc0cac336022eb&v=4
+    url: https://github.com/josehenriqueroveda
   - login: hgalytoby
     avatarUrl: https://avatars.githubusercontent.com/u/50397689?u=f4888c2c54929bd86eed0d3971d09fcb306e5088&v=4
     url: https://github.com/hgalytoby
@@ -485,27 +479,36 @@ sponsors:
   - login: conservative-dude
     avatarUrl: https://avatars.githubusercontent.com/u/55538308?u=f250c44942ea6e73a6bd90739b381c470c192c11&v=4
     url: https://github.com/conservative-dude
-  - login: leo-jp-edwards
-    avatarUrl: https://avatars.githubusercontent.com/u/58213433?u=2c128e8b0794b7a66211cd7d8ebe05db20b7e9c0&v=4
-    url: https://github.com/leo-jp-edwards
   - login: 0417taehyun
     avatarUrl: https://avatars.githubusercontent.com/u/63915557?u=47debaa860fd52c9b98c97ef357ddcec3b3fb399&v=4
     url: https://github.com/0417taehyun
 - - login: ssbarnea
     avatarUrl: https://avatars.githubusercontent.com/u/102495?u=b4bf6818deefe59952ac22fec6ed8c76de1b8f7c&v=4
     url: https://github.com/ssbarnea
-  - login: tomast1337
-    avatarUrl: https://avatars.githubusercontent.com/u/15125899?u=2c2f2907012d820499e2c43632389184923513fe&v=4
-    url: https://github.com/tomast1337
+  - login: Patechoc
+    avatarUrl: https://avatars.githubusercontent.com/u/2376641?u=23b49e9eda04f078cb74fa3f93593aa6a57bb138&v=4
+    url: https://github.com/Patechoc
+  - login: LanceMoe
+    avatarUrl: https://avatars.githubusercontent.com/u/18505474?u=7fd3ead4364bdf215b6d75cb122b3811c391ef6b&v=4
+    url: https://github.com/LanceMoe
   - login: sadikkuzu
     avatarUrl: https://avatars.githubusercontent.com/u/23168063?u=d179c06bb9f65c4167fcab118526819f8e0dac17&v=4
     url: https://github.com/sadikkuzu
   - login: ruizdiazever
     avatarUrl: https://avatars.githubusercontent.com/u/29817086?u=2df54af55663d246e3a4dc8273711c37f1adb117&v=4
     url: https://github.com/ruizdiazever
+  - login: samnimoh
+    avatarUrl: https://avatars.githubusercontent.com/u/33413170?u=147bc516be6cb647b28d7e3b3fea3a018a331145&v=4
+    url: https://github.com/samnimoh
   - login: danburonline
     avatarUrl: https://avatars.githubusercontent.com/u/34251194?u=2cad4388c1544e539ecb732d656e42fb07b4ff2d&v=4
     url: https://github.com/danburonline
+  - login: iharshgor
+    avatarUrl: https://avatars.githubusercontent.com/u/35490011?u=2dea054476e752d9e92c9d71a9a7cc919b1c2f8e&v=4
+    url: https://github.com/iharshgor
   - login: rwxd
     avatarUrl: https://avatars.githubusercontent.com/u/40308458?u=cd04a39e3655923be4f25c2ba8a5a07b3da3230a&v=4
     url: https://github.com/rwxd
+  - login: ThomasPalma1
+    avatarUrl: https://avatars.githubusercontent.com/u/66331874?u=5763f7402d784ba189b60d704ff5849b4d0a63fb&v=4
+    url: https://github.com/ThomasPalma1
diff --git a/docs/en/data/people.yml b/docs/en/data/people.yml
index dd2dbe5ea..89d189564 100644
--- a/docs/en/data/people.yml
+++ b/docs/en/data/people.yml
@@ -1,16 +1,16 @@
 maintainers:
 - login: tiangolo
-  answers: 1844
-  prs: 430
+  answers: 1849
+  prs: 466
   avatarUrl: https://avatars.githubusercontent.com/u/1326112?u=740f11212a731f56798f558ceddb0bd07642afa7&v=4
   url: https://github.com/tiangolo
 experts:
 - login: Kludex
-  count: 434
+  count: 463
   avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
   url: https://github.com/Kludex
 - login: dmontagu
-  count: 237
+  count: 239
   avatarUrl: https://avatars.githubusercontent.com/u/35119617?u=540f30c937a6450812628b9592a1dfe91bbe148e&v=4
   url: https://github.com/dmontagu
 - login: Mause
@@ -25,34 +25,34 @@ experts:
   count: 193
   avatarUrl: https://avatars.githubusercontent.com/u/13659033?u=e8bea32d07a5ef72f7dde3b2079ceb714923ca05&v=4
   url: https://github.com/JarroVGIT
-- login: euri10
-  count: 152
-  avatarUrl: https://avatars.githubusercontent.com/u/1104190?u=321a2e953e6645a7d09b732786c7a8061e0f8a8b&v=4
-  url: https://github.com/euri10
 - login: jgould22
-  count: 139
+  count: 157
   avatarUrl: https://avatars.githubusercontent.com/u/4335847?u=ed77f67e0bb069084639b24d812dbb2a2b1dc554&v=4
   url: https://github.com/jgould22
+- login: euri10
+  count: 153
+  avatarUrl: https://avatars.githubusercontent.com/u/1104190?u=321a2e953e6645a7d09b732786c7a8061e0f8a8b&v=4
+  url: https://github.com/euri10
 - login: phy25
   count: 126
-  avatarUrl: https://avatars.githubusercontent.com/u/331403?u=191cd73f0c936497c8d1931a217bb3039d050265&v=4
+  avatarUrl: https://avatars.githubusercontent.com/u/331403?v=4
   url: https://github.com/phy25
 - login: iudeen
-  count: 118
+  count: 121
   avatarUrl: https://avatars.githubusercontent.com/u/10519440?u=2843b3303282bff8b212dcd4d9d6689452e4470c&v=4
   url: https://github.com/iudeen
 - login: raphaelauv
   count: 83
   avatarUrl: https://avatars.githubusercontent.com/u/10202690?u=e6f86f5c0c3026a15d6b51792fa3e532b12f1371&v=4
   url: https://github.com/raphaelauv
-- login: ghandic
-  count: 71
-  avatarUrl: https://avatars.githubusercontent.com/u/23500353?u=e2e1d736f924d9be81e8bfc565b6d8836ba99773&v=4
-  url: https://github.com/ghandic
 - login: ArcLightSlavik
   count: 71
   avatarUrl: https://avatars.githubusercontent.com/u/31127044?u=b0f2c37142f4b762e41ad65dc49581813422bd71&v=4
   url: https://github.com/ArcLightSlavik
+- login: ghandic
+  count: 71
+  avatarUrl: https://avatars.githubusercontent.com/u/23500353?u=e2e1d736f924d9be81e8bfc565b6d8836ba99773&v=4
+  url: https://github.com/ghandic
 - login: falkben
   count: 57
   avatarUrl: https://avatars.githubusercontent.com/u/653031?u=ad9838e089058c9e5a0bab94c0eec7cc181e0cd0&v=4
@@ -61,10 +61,10 @@ experts:
   count: 49
   avatarUrl: https://avatars.githubusercontent.com/u/516999?u=437c0c5038558c67e887ccd863c1ba0f846c03da&v=4
   url: https://github.com/sm-Fifteen
-- login: adriangb
+- login: insomnes
   count: 45
-  avatarUrl: https://avatars.githubusercontent.com/u/1755071?u=612704256e38d6ac9cbed24f10e4b6ac2da74ecb&v=4
-  url: https://github.com/adriangb
+  avatarUrl: https://avatars.githubusercontent.com/u/16958893?u=f8be7088d5076d963984a21f95f44e559192d912&v=4
+  url: https://github.com/insomnes
 - login: yinziyan1206
   count: 45
   avatarUrl: https://avatars.githubusercontent.com/u/37829370?u=da44ca53aefd5c23f346fab8e9fd2e108294c179&v=4
@@ -73,22 +73,22 @@ experts:
   count: 45
   avatarUrl: https://avatars.githubusercontent.com/u/685002?u=b5094ab4527fc84b006c0ac9ff54367bdebb2267&v=4
   url: https://github.com/acidjunk
-- login: insomnes
-  count: 45
-  avatarUrl: https://avatars.githubusercontent.com/u/16958893?u=f8be7088d5076d963984a21f95f44e559192d912&v=4
-  url: https://github.com/insomnes
 - login: Dustyposa
   count: 45
   avatarUrl: https://avatars.githubusercontent.com/u/27180793?u=5cf2877f50b3eb2bc55086089a78a36f07042889&v=4
   url: https://github.com/Dustyposa
-- login: odiseo0
-  count: 43
-  avatarUrl: https://avatars.githubusercontent.com/u/87550035?u=2da05dab6cc8e1ade557801634760a56e4101796&v=4
-  url: https://github.com/odiseo0
+- login: adriangb
+  count: 44
+  avatarUrl: https://avatars.githubusercontent.com/u/1755071?u=612704256e38d6ac9cbed24f10e4b6ac2da74ecb&v=4
+  url: https://github.com/adriangb
 - login: frankie567
   count: 43
   avatarUrl: https://avatars.githubusercontent.com/u/1144727?u=85c025e3fcc7bd79a5665c63ee87cdf8aae13374&v=4
   url: https://github.com/frankie567
+- login: odiseo0
+  count: 43
+  avatarUrl: https://avatars.githubusercontent.com/u/87550035?u=241a71f6b7068738b81af3e57f45ffd723538401&v=4
+  url: https://github.com/odiseo0
 - login: includeamin
   count: 40
   avatarUrl: https://avatars.githubusercontent.com/u/11836741?u=8bd5ef7e62fe6a82055e33c4c0e0a7879ff8cfb6&v=4
@@ -97,14 +97,14 @@ experts:
   count: 37
   avatarUrl: https://avatars.githubusercontent.com/u/5167622?u=de8f597c81d6336fcebc37b32dfd61a3f877160c&v=4
   url: https://github.com/STeveShary
-- login: chbndrhnns
-  count: 35
-  avatarUrl: https://avatars.githubusercontent.com/u/7534547?v=4
-  url: https://github.com/chbndrhnns
 - login: krishnardt
   count: 35
   avatarUrl: https://avatars.githubusercontent.com/u/31960541?u=47f4829c77f4962ab437ffb7995951e41eeebe9b&v=4
   url: https://github.com/krishnardt
+- login: chbndrhnns
+  count: 35
+  avatarUrl: https://avatars.githubusercontent.com/u/7534547?v=4
+  url: https://github.com/chbndrhnns
 - login: panla
   count: 32
   avatarUrl: https://avatars.githubusercontent.com/u/41326348?u=ba2fda6b30110411ecbf406d187907e2b420ac19&v=4
@@ -121,38 +121,38 @@ experts:
   count: 25
   avatarUrl: https://avatars.githubusercontent.com/u/365303?u=07ca03c5ee811eb0920e633cc3c3db73dbec1aa5&v=4
   url: https://github.com/wshayes
+- login: acnebs
+  count: 23
+  avatarUrl: https://avatars.githubusercontent.com/u/9054108?v=4
+  url: https://github.com/acnebs
 - login: SirTelemak
   count: 23
   avatarUrl: https://avatars.githubusercontent.com/u/9435877?u=719327b7d2c4c62212456d771bfa7c6b8dbb9eac&v=4
   url: https://github.com/SirTelemak
-- login: acnebs
-  count: 22
-  avatarUrl: https://avatars.githubusercontent.com/u/9054108?u=c27e50269f1ef8ea950cc6f0268c8ec5cebbe9c9&v=4
-  url: https://github.com/acnebs
 - login: rafsaf
   count: 21
   avatarUrl: https://avatars.githubusercontent.com/u/51059348?u=f8f0d6d6e90fac39fa786228158ba7f013c74271&v=4
   url: https://github.com/rafsaf
-- login: chris-allnutt
+- login: n8sty
   count: 20
-  avatarUrl: https://avatars.githubusercontent.com/u/565544?v=4
-  url: https://github.com/chris-allnutt
+  avatarUrl: https://avatars.githubusercontent.com/u/2964996?v=4
+  url: https://github.com/n8sty
 - login: nsidnev
   count: 20
   avatarUrl: https://avatars.githubusercontent.com/u/22559461?u=a9cc3238217e21dc8796a1a500f01b722adb082c&v=4
   url: https://github.com/nsidnev
-- login: n8sty
+- login: chris-allnutt
+  count: 20
+  avatarUrl: https://avatars.githubusercontent.com/u/565544?v=4
+  url: https://github.com/chris-allnutt
+- login: zoliknemet
   count: 18
-  avatarUrl: https://avatars.githubusercontent.com/u/2964996?v=4
-  url: https://github.com/n8sty
+  avatarUrl: https://avatars.githubusercontent.com/u/22326718?u=31ba446ac290e23e56eea8e4f0c558aaf0b40779&v=4
+  url: https://github.com/zoliknemet
 - login: retnikt
   count: 18
   avatarUrl: https://avatars.githubusercontent.com/u/24581770?v=4
   url: https://github.com/retnikt
-- login: zoliknemet
-  count: 18
-  avatarUrl: https://avatars.githubusercontent.com/u/22326718?u=31ba446ac290e23e56eea8e4f0c558aaf0b40779&v=4
-  url: https://github.com/zoliknemet
 - login: Hultner
   count: 17
   avatarUrl: https://avatars.githubusercontent.com/u/2669034?u=115e53df959309898ad8dc9443fbb35fee71df07&v=4
@@ -198,38 +198,30 @@ experts:
   avatarUrl: https://avatars.githubusercontent.com/u/12537771?u=7444d20019198e34911082780cc7ad73f2b97cb3&v=4
   url: https://github.com/jorgerpo
 last_month_active:
-- login: jgould22
-  count: 15
-  avatarUrl: https://avatars.githubusercontent.com/u/4335847?u=ed77f67e0bb069084639b24d812dbb2a2b1dc554&v=4
-  url: https://github.com/jgould22
 - login: Kludex
-  count: 13
+  count: 24
   avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
   url: https://github.com/Kludex
-- login: abhint
-  count: 5
-  avatarUrl: https://avatars.githubusercontent.com/u/25699289?u=b5d219277b4d001ac26fb8be357fddd88c29d51b&v=4
-  url: https://github.com/abhint
-- login: chrisK824
-  count: 4
-  avatarUrl: https://avatars.githubusercontent.com/u/79946379?u=03d85b22d696a58a9603e55fbbbe2de6b0f4face&v=4
-  url: https://github.com/chrisK824
+- login: jgould22
+  count: 17
+  avatarUrl: https://avatars.githubusercontent.com/u/4335847?u=ed77f67e0bb069084639b24d812dbb2a2b1dc554&v=4
+  url: https://github.com/jgould22
 - login: arjwilliams
-  count: 3
+  count: 8
   avatarUrl: https://avatars.githubusercontent.com/u/22227620?v=4
   url: https://github.com/arjwilliams
-- login: wu-clan
-  count: 3
-  avatarUrl: https://avatars.githubusercontent.com/u/52145145?u=f8c9e5c8c259d248e1683fedf5027b4ee08a0967&v=4
-  url: https://github.com/wu-clan
 - login: Ahmed-Abdou14
-  count: 3
-  avatarUrl: https://avatars.githubusercontent.com/u/104530599?u=d1e1c064d57c3ad5b6481716928da840f6d5a492&v=4
+  count: 4
+  avatarUrl: https://avatars.githubusercontent.com/u/104530599?u=05365b155a1ff911532e8be316acfad2e0736f98&v=4
   url: https://github.com/Ahmed-Abdou14
-- login: esrefzeki
+- login: iudeen
   count: 3
-  avatarUrl: https://avatars.githubusercontent.com/u/54935247?u=193cf5a169ca05fc54995a4dceabc82c7dc6e5ea&v=4
-  url: https://github.com/esrefzeki
+  avatarUrl: https://avatars.githubusercontent.com/u/10519440?u=2843b3303282bff8b212dcd4d9d6689452e4470c&v=4
+  url: https://github.com/iudeen
+- login: mikeedjones
+  count: 3
+  avatarUrl: https://avatars.githubusercontent.com/u/4087139?u=cc4a242896ac2fcf88a53acfaf190d0fe0a1f0c9&v=4
+  url: https://github.com/mikeedjones
 top_contributors:
 - login: waynerv
   count: 25
@@ -240,7 +232,7 @@ top_contributors:
   avatarUrl: https://avatars.githubusercontent.com/u/41147016?u=55010621aece725aa702270b54fed829b6a1fe60&v=4
   url: https://github.com/tokusumi
 - login: Kludex
-  count: 20
+  count: 21
   avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
   url: https://github.com/Kludex
 - login: jaystone776
@@ -264,7 +256,7 @@ top_contributors:
   avatarUrl: https://avatars.githubusercontent.com/u/11489395?u=4adb6986bf3debfc2b8216ae701f2bd47d73da7d&v=4
   url: https://github.com/mariacamilagl
 - login: Smlep
-  count: 10
+  count: 11
   avatarUrl: https://avatars.githubusercontent.com/u/16785985?v=4
   url: https://github.com/Smlep
 - login: Serrones
@@ -287,6 +279,10 @@ top_contributors:
   count: 7
   avatarUrl: https://avatars.githubusercontent.com/u/119126536?u=9fc0d48f3307817bafecc5861eb2168401a6cb04&v=4
   url: https://github.com/Alexandrhub
+- login: NinaHwang
+  count: 6
+  avatarUrl: https://avatars.githubusercontent.com/u/79563565?u=eee6bfe9224c71193025ab7477f4f96ceaa05c62&v=4
+  url: https://github.com/NinaHwang
 - login: batlopes
   count: 6
   avatarUrl: https://avatars.githubusercontent.com/u/33462923?u=0fb3d7acb316764616f11e4947faf080e49ad8d9&v=4
@@ -297,7 +293,7 @@ top_contributors:
   url: https://github.com/wshayes
 - login: samuelcolvin
   count: 5
-  avatarUrl: https://avatars.githubusercontent.com/u/4039449?u=807390ba9cfe23906c3bf8a0d56aaca3cf2bfa0d&v=4
+  avatarUrl: https://avatars.githubusercontent.com/u/4039449?u=42eb3b833047c8c4b4f647a031eaef148c16d93f&v=4
   url: https://github.com/samuelcolvin
 - login: SwftAlpc
   count: 5
@@ -311,10 +307,6 @@ top_contributors:
   count: 5
   avatarUrl: https://avatars.githubusercontent.com/u/43503750?u=f440bc9062afb3c43b9b9c6cdfdcfe31d58699ef&v=4
   url: https://github.com/ComicShrimp
-- login: NinaHwang
-  count: 5
-  avatarUrl: https://avatars.githubusercontent.com/u/79563565?u=eee6bfe9224c71193025ab7477f4f96ceaa05c62&v=4
-  url: https://github.com/NinaHwang
 - login: jekirl
   count: 4
   avatarUrl: https://avatars.githubusercontent.com/u/2546697?u=a027452387d85bd4a14834e19d716c99255fb3b7&v=4
@@ -335,10 +327,18 @@ top_contributors:
   count: 4
   avatarUrl: https://avatars.githubusercontent.com/u/3360631?u=5fa1f475ad784d64eb9666bdd43cc4d285dcc773&v=4
   url: https://github.com/hitrust
+- login: JulianMaurin
+  count: 4
+  avatarUrl: https://avatars.githubusercontent.com/u/63545168?u=b7d15ac865268cbefc2d739e2f23d9aeeac1a622&v=4
+  url: https://github.com/JulianMaurin
 - login: lsglucas
   count: 4
   avatarUrl: https://avatars.githubusercontent.com/u/61513630?u=320e43fe4dc7bc6efc64e9b8f325f8075634fd20&v=4
   url: https://github.com/lsglucas
+- login: iudeen
+  count: 4
+  avatarUrl: https://avatars.githubusercontent.com/u/10519440?u=2843b3303282bff8b212dcd4d9d6689452e4470c&v=4
+  url: https://github.com/iudeen
 - login: axel584
   count: 4
   avatarUrl: https://avatars.githubusercontent.com/u/1334088?u=9667041f5b15dc002b6f9665fda8c0412933ac04&v=4
@@ -349,7 +349,7 @@ top_contributors:
   url: https://github.com/ivan-abc
 top_reviewers:
 - login: Kludex
-  count: 122
+  count: 136
   avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
   url: https://github.com/Kludex
 - login: BilalAlpaslan
@@ -357,7 +357,7 @@ top_reviewers:
   avatarUrl: https://avatars.githubusercontent.com/u/47563997?u=63ed66e304fe8d765762c70587d61d9196e5c82d&v=4
   url: https://github.com/BilalAlpaslan
 - login: yezz123
-  count: 77
+  count: 78
   avatarUrl: https://avatars.githubusercontent.com/u/52716203?u=d7062cbc6eb7671d5dc9cc0e32a24ae335e0f225&v=4
   url: https://github.com/yezz123
 - login: tokusumi
@@ -372,20 +372,20 @@ top_reviewers:
   count: 47
   avatarUrl: https://avatars.githubusercontent.com/u/59285379?v=4
   url: https://github.com/Laineyzhang55
+- login: iudeen
+  count: 46
+  avatarUrl: https://avatars.githubusercontent.com/u/10519440?u=2843b3303282bff8b212dcd4d9d6689452e4470c&v=4
+  url: https://github.com/iudeen
 - login: ycd
   count: 45
   avatarUrl: https://avatars.githubusercontent.com/u/62724709?u=bba5af018423a2858d49309bed2a899bb5c34ac5&v=4
   url: https://github.com/ycd
-- login: iudeen
-  count: 44
-  avatarUrl: https://avatars.githubusercontent.com/u/10519440?u=2843b3303282bff8b212dcd4d9d6689452e4470c&v=4
-  url: https://github.com/iudeen
 - login: cikay
   count: 41
   avatarUrl: https://avatars.githubusercontent.com/u/24587499?u=e772190a051ab0eaa9c8542fcff1892471638f2b&v=4
   url: https://github.com/cikay
 - login: Xewus
-  count: 35
+  count: 38
   avatarUrl: https://avatars.githubusercontent.com/u/85196001?u=f8e2dc7e5104f109cef944af79050ea8d1b8f914&v=4
   url: https://github.com/Xewus
 - login: JarroVGIT
@@ -412,6 +412,10 @@ top_reviewers:
   count: 26
   avatarUrl: https://avatars.githubusercontent.com/u/61513630?u=320e43fe4dc7bc6efc64e9b8f325f8075634fd20&v=4
   url: https://github.com/lsglucas
+- login: LorhanSohaky
+  count: 24
+  avatarUrl: https://avatars.githubusercontent.com/u/16273730?u=095b66f243a2cd6a0aadba9a095009f8aaf18393&v=4
+  url: https://github.com/LorhanSohaky
 - login: Ryandaydev
   count: 24
   avatarUrl: https://avatars.githubusercontent.com/u/4292423?u=809f3d1074d04bbc28012a7f17f06ea56f5bd71a&v=4
@@ -420,10 +424,6 @@ top_reviewers:
   count: 23
   avatarUrl: https://avatars.githubusercontent.com/u/35119617?u=540f30c937a6450812628b9592a1dfe91bbe148e&v=4
   url: https://github.com/dmontagu
-- login: LorhanSohaky
-  count: 23
-  avatarUrl: https://avatars.githubusercontent.com/u/16273730?u=095b66f243a2cd6a0aadba9a095009f8aaf18393&v=4
-  url: https://github.com/LorhanSohaky
 - login: rjNemo
   count: 21
   avatarUrl: https://avatars.githubusercontent.com/u/56785022?u=d5c3a02567c8649e146fcfc51b6060ccaf8adef8&v=4
@@ -434,7 +434,7 @@ top_reviewers:
   url: https://github.com/hard-coders
 - login: odiseo0
   count: 20
-  avatarUrl: https://avatars.githubusercontent.com/u/87550035?u=2da05dab6cc8e1ade557801634760a56e4101796&v=4
+  avatarUrl: https://avatars.githubusercontent.com/u/87550035?u=241a71f6b7068738b81af3e57f45ffd723538401&v=4
   url: https://github.com/odiseo0
 - login: 0417taehyun
   count: 19
@@ -456,6 +456,10 @@ top_reviewers:
   count: 16
   avatarUrl: https://avatars.githubusercontent.com/u/52768429?u=6a3aa15277406520ad37f6236e89466ed44bc5b8&v=4
   url: https://github.com/SwftAlpc
+- login: axel584
+  count: 16
+  avatarUrl: https://avatars.githubusercontent.com/u/1334088?u=9667041f5b15dc002b6f9665fda8c0412933ac04&v=4
+  url: https://github.com/axel584
 - login: DevDae
   count: 16
   avatarUrl: https://avatars.githubusercontent.com/u/87962045?u=08e10fa516e844934f4b3fc7c38b33c61697e4a1&v=4
@@ -488,10 +492,6 @@ top_reviewers:
   count: 12
   avatarUrl: https://avatars.githubusercontent.com/u/31848542?u=494ecc298e3f26197495bb357ad0f57cfd5f7a32&v=4
   url: https://github.com/RunningIkkyu
-- login: axel584
-  count: 12
-  avatarUrl: https://avatars.githubusercontent.com/u/1334088?u=9667041f5b15dc002b6f9665fda8c0412933ac04&v=4
-  url: https://github.com/axel584
 - login: ivan-abc
   count: 12
   avatarUrl: https://avatars.githubusercontent.com/u/36765187?u=c6e0ba571c1ccb6db9d94e62e4b8b5eda811a870&v=4
@@ -500,6 +500,10 @@ top_reviewers:
   count: 11
   avatarUrl: https://avatars.githubusercontent.com/u/46193920?u=789927ee09cfabd752d3bd554fa6baf4850d2777&v=4
   url: https://github.com/solomein-sv
+- login: wdh99
+  count: 11
+  avatarUrl: https://avatars.githubusercontent.com/u/108172295?u=8a8fb95d5afe3e0fa33257b2aecae88d436249eb&v=4
+  url: https://github.com/wdh99
 - login: mariacamilagl
   count: 10
   avatarUrl: https://avatars.githubusercontent.com/u/11489395?u=4adb6986bf3debfc2b8216ae701f2bd47d73da7d&v=4
@@ -540,7 +544,3 @@ top_reviewers:
   count: 9
   avatarUrl: https://avatars.githubusercontent.com/u/69092910?u=4ac58eab99bd37d663f3d23551df96d4fbdbf760&v=4
   url: https://github.com/bezaca
-- login: oandersonmagalhaes
-  count: 9
-  avatarUrl: https://avatars.githubusercontent.com/u/83456692?v=4
-  url: https://github.com/oandersonmagalhaes

From a73cdaed35d6d9a120ba4831c512b3a7cb25b697 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 3 Aug 2023 14:25:48 +0000
Subject: [PATCH 050/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 91745453c..ab8c6e68c 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 👥 Update FastAPI People. PR [#9999](https://github.com/tiangolo/fastapi/pull/9999) by [@tiangolo](https://github.com/tiangolo).
 * 🐳 Update Dockerfile with compatibility versions, to upgrade later. PR [#9998](https://github.com/tiangolo/fastapi/pull/9998) by [@tiangolo](https://github.com/tiangolo).
 * ➕ Add pydantic-settings to FastAPI People dependencies. PR [#9988](https://github.com/tiangolo/fastapi/pull/9988) by [@tiangolo](https://github.com/tiangolo).
 * ♻️ Update FastAPI People logic with new Pydantic. PR [#9985](https://github.com/tiangolo/fastapi/pull/9985) by [@tiangolo](https://github.com/tiangolo).

From 4ab0363ad794fd60e1ebead224f57a1d01e6bd6b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 3 Aug 2023 17:24:31 +0200
Subject: [PATCH 051/317] =?UTF-8?q?=E2=9E=96=20Remove=20direct=20dependenc?=
 =?UTF-8?q?y=20on=20MkDocs,=20Material=20for=20MkDocs=20defines=20its=20ow?=
 =?UTF-8?q?n=20dependency=20(#9986)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/workflows/build-docs.yml | 8 ++++----
 requirements-docs.txt            | 1 -
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/build-docs.yml b/.github/workflows/build-docs.yml
index 19009447b..eb816b72f 100644
--- a/.github/workflows/build-docs.yml
+++ b/.github/workflows/build-docs.yml
@@ -44,14 +44,14 @@ jobs:
         id: cache
         with:
           path: ${{ env.pythonLocation }}
-          key: ${{ runner.os }}-python-docs-${{ env.pythonLocation }}-${{ hashFiles('pyproject.toml', 'requirements-docs.txt') }}-v05
+          key: ${{ runner.os }}-python-docs-${{ env.pythonLocation }}-${{ hashFiles('pyproject.toml', 'requirements-docs.txt') }}-v06
       - name: Install docs extras
         if: steps.cache.outputs.cache-hit != 'true'
         run: pip install -r requirements-docs.txt
       # Install MkDocs Material Insiders here just to put it in the cache for the rest of the steps
       - name: Install Material for MkDocs Insiders
         if: ( github.event_name != 'pull_request' || github.event.pull_request.head.repo.fork == false ) && steps.cache.outputs.cache-hit != 'true'
-        run: pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/squidfunk/mkdocs-material-insiders.git
+        run: pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/squidfunk/mkdocs-material-insiders.git@9.1.21-insiders-4.38.0
       - name: Export Language Codes
         id: show-langs
         run: |
@@ -80,13 +80,13 @@ jobs:
         id: cache
         with:
           path: ${{ env.pythonLocation }}
-          key: ${{ runner.os }}-python-docs-${{ env.pythonLocation }}-${{ hashFiles('pyproject.toml', 'requirements-docs.txt') }}-v05
+          key: ${{ runner.os }}-python-docs-${{ env.pythonLocation }}-${{ hashFiles('pyproject.toml', 'requirements-docs.txt') }}-v06
       - name: Install docs extras
         if: steps.cache.outputs.cache-hit != 'true'
         run: pip install -r requirements-docs.txt
       - name: Install Material for MkDocs Insiders
         if: ( github.event_name != 'pull_request' || github.event.pull_request.head.repo.fork == false ) && steps.cache.outputs.cache-hit != 'true'
-        run: pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/squidfunk/mkdocs-material-insiders.git
+        run: pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/squidfunk/mkdocs-material-insiders.git@9.1.21-insiders-4.38.0
       - name: Update Languages
         run: python ./scripts/docs.py update-languages
       - uses: actions/cache@v3
diff --git a/requirements-docs.txt b/requirements-docs.txt
index df60ca4df..7152ebf7b 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -1,5 +1,4 @@
 -e .
-mkdocs==1.4.3
 mkdocs-material==9.1.17
 mdx-include >=1.4.1,<2.0.0
 mkdocs-markdownextradata-plugin >=0.1.7,<0.3.0

From 94c48cfc8cb5987113c6a8558a7a428d27888cce Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 3 Aug 2023 15:25:10 +0000
Subject: [PATCH 052/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ab8c6e68c..caf74c353 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 📍 Update MkDocs Material dependencies. PR [#9986](https://github.com/tiangolo/fastapi/pull/9986) by [@tiangolo](https://github.com/tiangolo).
 * 👥 Update FastAPI People. PR [#9999](https://github.com/tiangolo/fastapi/pull/9999) by [@tiangolo](https://github.com/tiangolo).
 * 🐳 Update Dockerfile with compatibility versions, to upgrade later. PR [#9998](https://github.com/tiangolo/fastapi/pull/9998) by [@tiangolo](https://github.com/tiangolo).
 * ➕ Add pydantic-settings to FastAPI People dependencies. PR [#9988](https://github.com/tiangolo/fastapi/pull/9988) by [@tiangolo](https://github.com/tiangolo).

From 25694f5ae100741c9f7ee0d409e298609e71366e Mon Sep 17 00:00:00 2001
From: David Montague <35119617+dmontagu@users.noreply.github.com>
Date: Thu, 3 Aug 2023 16:46:57 +0100
Subject: [PATCH 053/317] =?UTF-8?q?=E2=9C=85=20Fix=20tests=20for=20compati?=
 =?UTF-8?q?bility=20with=20pydantic=202.1.1=20(#9943)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
---
 .github/workflows/test.yml                  |  4 +--
 tests/test_filter_pydantic_sub_model_pv2.py |  4 +--
 tests/test_multi_body_errors.py             | 34 +++++++++++++++++++--
 3 files changed, 35 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index b95358d01..fbaf759c3 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -25,7 +25,7 @@ jobs:
         id: cache
         with:
           path: ${{ env.pythonLocation }}
-          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-pydantic-v2-${{ hashFiles('pyproject.toml', 'requirements-tests.txt') }}-test-v03
+          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-pydantic-v2-${{ hashFiles('pyproject.toml', 'requirements-tests.txt') }}-test-v04
       - name: Install Dependencies
         if: steps.cache.outputs.cache-hit != 'true'
         run: pip install -r requirements-tests.txt
@@ -54,7 +54,7 @@ jobs:
         id: cache
         with:
           path: ${{ env.pythonLocation }}
-          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-${{ matrix.pydantic-version }}-${{ hashFiles('pyproject.toml', 'requirements-tests.txt') }}-test-v03
+          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-${{ matrix.pydantic-version }}-${{ hashFiles('pyproject.toml', 'requirements-tests.txt') }}-test-v04
       - name: Install Dependencies
         if: steps.cache.outputs.cache-hit != 'true'
         run: pip install -r requirements-tests.txt
diff --git a/tests/test_filter_pydantic_sub_model_pv2.py b/tests/test_filter_pydantic_sub_model_pv2.py
index 656332a01..ae12179bd 100644
--- a/tests/test_filter_pydantic_sub_model_pv2.py
+++ b/tests/test_filter_pydantic_sub_model_pv2.py
@@ -1,7 +1,7 @@
 from typing import Optional
 
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import HasRepr, IsDict
 from fastapi import Depends, FastAPI
 from fastapi.exceptions import ResponseValidationError
 from fastapi.testclient import TestClient
@@ -66,7 +66,7 @@ def test_validator_is_cloned(client: TestClient):
                 "loc": ("response", "name"),
                 "msg": "Value error, name must end in A",
                 "input": "modelX",
-                "ctx": {"error": "name must end in A"},
+                "ctx": {"error": HasRepr("ValueError('name must end in A')")},
                 "url": match_pydantic_error_url("value_error"),
             }
         )
diff --git a/tests/test_multi_body_errors.py b/tests/test_multi_body_errors.py
index aa989c612..931f08fc1 100644
--- a/tests/test_multi_body_errors.py
+++ b/tests/test_multi_body_errors.py
@@ -51,7 +51,7 @@ def test_jsonable_encoder_requiring_error():
                     "loc": ["body", 0, "age"],
                     "msg": "Input should be greater than 0",
                     "input": -1.0,
-                    "ctx": {"gt": 0.0},
+                    "ctx": {"gt": "0"},
                     "url": match_pydantic_error_url("greater_than"),
                 }
             ]
@@ -84,9 +84,23 @@ def test_put_incorrect_body_multiple():
                     "input": {"age": "five"},
                     "url": match_pydantic_error_url("missing"),
                 },
+                {
+                    "ctx": {"class": "Decimal"},
+                    "input": "five",
+                    "loc": ["body", 0, "age", "is-instance[Decimal]"],
+                    "msg": "Input should be an instance of Decimal",
+                    "type": "is_instance_of",
+                    "url": match_pydantic_error_url("is_instance_of"),
+                },
                 {
                     "type": "decimal_parsing",
-                    "loc": ["body", 0, "age"],
+                    "loc": [
+                        "body",
+                        0,
+                        "age",
+                        "function-after[to_decimal(), "
+                        "union[int,constrained-str,function-plain[str()]]]",
+                    ],
                     "msg": "Input should be a valid decimal",
                     "input": "five",
                 },
@@ -97,9 +111,23 @@ def test_put_incorrect_body_multiple():
                     "input": {"age": "six"},
                     "url": match_pydantic_error_url("missing"),
                 },
+                {
+                    "ctx": {"class": "Decimal"},
+                    "input": "six",
+                    "loc": ["body", 1, "age", "is-instance[Decimal]"],
+                    "msg": "Input should be an instance of Decimal",
+                    "type": "is_instance_of",
+                    "url": match_pydantic_error_url("is_instance_of"),
+                },
                 {
                     "type": "decimal_parsing",
-                    "loc": ["body", 1, "age"],
+                    "loc": [
+                        "body",
+                        1,
+                        "age",
+                        "function-after[to_decimal(), "
+                        "union[int,constrained-str,function-plain[str()]]]",
+                    ],
                     "msg": "Input should be a valid decimal",
                     "input": "six",
                 },

From 10b4c31f063d9a098e69dfc48a3a62028fab1261 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 3 Aug 2023 15:47:35 +0000
Subject: [PATCH 054/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index caf74c353..91574addd 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ✅ Fix tests for compatibility with pydantic 2.1.1. PR [#9943](https://github.com/tiangolo/fastapi/pull/9943) by [@dmontagu](https://github.com/dmontagu).
 * 📍 Update MkDocs Material dependencies. PR [#9986](https://github.com/tiangolo/fastapi/pull/9986) by [@tiangolo](https://github.com/tiangolo).
 * 👥 Update FastAPI People. PR [#9999](https://github.com/tiangolo/fastapi/pull/9999) by [@tiangolo](https://github.com/tiangolo).
 * 🐳 Update Dockerfile with compatibility versions, to upgrade later. PR [#9998](https://github.com/tiangolo/fastapi/pull/9998) by [@tiangolo](https://github.com/tiangolo).

From 059fb128926ae06a52af472bd91b216ce45a5997 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 3 Aug 2023 17:59:41 +0200
Subject: [PATCH 055/317] =?UTF-8?q?=F0=9F=94=A7=20Update=20the=20Question?=
 =?UTF-8?q?=20template=20to=20ask=20for=20the=20Pydantic=20version=20(#100?=
 =?UTF-8?q?00)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/DISCUSSION_TEMPLATE/questions.yml | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/.github/DISCUSSION_TEMPLATE/questions.yml b/.github/DISCUSSION_TEMPLATE/questions.yml
index 3726b7d18..98424a341 100644
--- a/.github/DISCUSSION_TEMPLATE/questions.yml
+++ b/.github/DISCUSSION_TEMPLATE/questions.yml
@@ -123,6 +123,20 @@ body:
         ```
     validations:
       required: true
+  - type: input
+    id: pydantic-version
+    attributes:
+      label: Pydantic Version
+      description: |
+        What Pydantic version are you using?
+
+        You can find the Pydantic version with:
+
+        ```bash
+        python -c "import pydantic; print(pydantic.version.VERSION)"
+        ```
+    validations:
+      required: true
   - type: input
     id: python-version
     attributes:

From 3af7265a435ebb1016dfa190c196afb045451d4f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 3 Aug 2023 16:00:19 +0000
Subject: [PATCH 056/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 91574addd..c85ef0ad2 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🔧 Update the Question template to ask for the Pydantic version. PR [#10000](https://github.com/tiangolo/fastapi/pull/10000) by [@tiangolo](https://github.com/tiangolo).
 * ✅ Fix tests for compatibility with pydantic 2.1.1. PR [#9943](https://github.com/tiangolo/fastapi/pull/9943) by [@dmontagu](https://github.com/dmontagu).
 * 📍 Update MkDocs Material dependencies. PR [#9986](https://github.com/tiangolo/fastapi/pull/9986) by [@tiangolo](https://github.com/tiangolo).
 * 👥 Update FastAPI People. PR [#9999](https://github.com/tiangolo/fastapi/pull/9999) by [@tiangolo](https://github.com/tiangolo).

From 86e4e9f8f9266e471192aefaac7ef55cee957a3d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 4 Aug 2023 19:47:42 +0200
Subject: [PATCH 057/317] =?UTF-8?q?=F0=9F=94=A7=20Restore=20MkDocs=20Mater?=
 =?UTF-8?q?ial=20pin=20after=20the=20fix=20(#10001)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/workflows/build-docs.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/build-docs.yml b/.github/workflows/build-docs.yml
index eb816b72f..dedf23fb9 100644
--- a/.github/workflows/build-docs.yml
+++ b/.github/workflows/build-docs.yml
@@ -51,7 +51,7 @@ jobs:
       # Install MkDocs Material Insiders here just to put it in the cache for the rest of the steps
       - name: Install Material for MkDocs Insiders
         if: ( github.event_name != 'pull_request' || github.event.pull_request.head.repo.fork == false ) && steps.cache.outputs.cache-hit != 'true'
-        run: pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/squidfunk/mkdocs-material-insiders.git@9.1.21-insiders-4.38.0
+        run: pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/squidfunk/mkdocs-material-insiders.git
       - name: Export Language Codes
         id: show-langs
         run: |
@@ -86,7 +86,7 @@ jobs:
         run: pip install -r requirements-docs.txt
       - name: Install Material for MkDocs Insiders
         if: ( github.event_name != 'pull_request' || github.event.pull_request.head.repo.fork == false ) && steps.cache.outputs.cache-hit != 'true'
-        run: pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/squidfunk/mkdocs-material-insiders.git@9.1.21-insiders-4.38.0
+        run: pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/squidfunk/mkdocs-material-insiders.git
       - name: Update Languages
         run: python ./scripts/docs.py update-languages
       - uses: actions/cache@v3

From b3a1f910048ea60a108a8f40ee5643778047b344 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 4 Aug 2023 17:48:24 +0000
Subject: [PATCH 058/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c85ef0ad2..dc61f76f2 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🔧 Restore MkDocs Material pin after the fix. PR [#10001](https://github.com/tiangolo/fastapi/pull/10001) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update the Question template to ask for the Pydantic version. PR [#10000](https://github.com/tiangolo/fastapi/pull/10000) by [@tiangolo](https://github.com/tiangolo).
 * ✅ Fix tests for compatibility with pydantic 2.1.1. PR [#9943](https://github.com/tiangolo/fastapi/pull/9943) by [@dmontagu](https://github.com/dmontagu).
 * 📍 Update MkDocs Material dependencies. PR [#9986](https://github.com/tiangolo/fastapi/pull/9986) by [@tiangolo](https://github.com/tiangolo).

From ebdf952545cbd95a16d21d48421fea7aa07e3b69 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 4 Aug 2023 20:18:38 +0200
Subject: [PATCH 059/317] =?UTF-8?q?=F0=9F=91=B7=20Add=20GitHub=20Actions?=
 =?UTF-8?q?=20step=20dump=20context=20to=20debug=20external=20failures=20(?=
 =?UTF-8?q?#10008)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/workflows/issue-manager.yml       |  4 ++++
 .github/workflows/label-approved.yml      |  4 ++++
 .github/workflows/latest-changes.yml      |  4 ++++
 .github/workflows/notify-translations.yml |  4 ++++
 .github/workflows/people.yml              |  4 ++++
 .github/workflows/smokeshow.yml           |  4 ++++
 .github/workflows/test.yml                | 16 ++++++++++++++++
 7 files changed, 40 insertions(+)

diff --git a/.github/workflows/issue-manager.yml b/.github/workflows/issue-manager.yml
index 324623103..bb967fa11 100644
--- a/.github/workflows/issue-manager.yml
+++ b/.github/workflows/issue-manager.yml
@@ -19,6 +19,10 @@ jobs:
     if: github.repository_owner == 'tiangolo'
     runs-on: ubuntu-latest
     steps:
+      - name: Dump GitHub context
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+        run: echo "$GITHUB_CONTEXT"
       - uses: tiangolo/issue-manager@0.4.0
         with:
           token: ${{ secrets.FASTAPI_ISSUE_MANAGER }}
diff --git a/.github/workflows/label-approved.yml b/.github/workflows/label-approved.yml
index 976d29f74..2113c468a 100644
--- a/.github/workflows/label-approved.yml
+++ b/.github/workflows/label-approved.yml
@@ -9,6 +9,10 @@ jobs:
     if: github.repository_owner == 'tiangolo'
     runs-on: ubuntu-latest
     steps:
+    - name: Dump GitHub context
+      env:
+        GITHUB_CONTEXT: ${{ toJson(github) }}
+      run: echo "$GITHUB_CONTEXT"
     - uses: docker://tiangolo/label-approved:0.0.2
       with:
         token: ${{ secrets.FASTAPI_LABEL_APPROVED }}
diff --git a/.github/workflows/latest-changes.yml b/.github/workflows/latest-changes.yml
index 0461f3dd3..e38870f46 100644
--- a/.github/workflows/latest-changes.yml
+++ b/.github/workflows/latest-changes.yml
@@ -20,6 +20,10 @@ jobs:
   latest-changes:
     runs-on: ubuntu-latest
     steps:
+      - name: Dump GitHub context
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+        run: echo "$GITHUB_CONTEXT"
       - uses: actions/checkout@v3
         with:
           # To allow latest-changes to commit to the main branch
diff --git a/.github/workflows/notify-translations.yml b/.github/workflows/notify-translations.yml
index cd7affbc3..44ee83ec0 100644
--- a/.github/workflows/notify-translations.yml
+++ b/.github/workflows/notify-translations.yml
@@ -19,6 +19,10 @@ jobs:
   notify-translations:
     runs-on: ubuntu-latest
     steps:
+      - name: Dump GitHub context
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+        run: echo "$GITHUB_CONTEXT"
       - uses: actions/checkout@v3
       # Allow debugging with tmate
       - name: Setup tmate session
diff --git a/.github/workflows/people.yml b/.github/workflows/people.yml
index aa7f34464..4480a1427 100644
--- a/.github/workflows/people.yml
+++ b/.github/workflows/people.yml
@@ -15,6 +15,10 @@ jobs:
     if: github.repository_owner == 'tiangolo'
     runs-on: ubuntu-latest
     steps:
+      - name: Dump GitHub context
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+        run: echo "$GITHUB_CONTEXT"
       - uses: actions/checkout@v3
       # Ref: https://github.com/actions/runner/issues/2033
       - name: Fix git safe.directory in container
diff --git a/.github/workflows/smokeshow.yml b/.github/workflows/smokeshow.yml
index c6d894d9f..4e689d95c 100644
--- a/.github/workflows/smokeshow.yml
+++ b/.github/workflows/smokeshow.yml
@@ -14,6 +14,10 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
+      - name: Dump GitHub context
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+        run: echo "$GITHUB_CONTEXT"
       - uses: actions/setup-python@v4
         with:
           python-version: '3.9'
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index fbaf759c3..6a512a019 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -13,6 +13,10 @@ jobs:
   lint:
     runs-on: ubuntu-latest
     steps:
+      - name: Dump GitHub context
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+        run: echo "$GITHUB_CONTEXT"
       - uses: actions/checkout@v3
       - name: Set up Python
         uses: actions/setup-python@v4
@@ -42,6 +46,10 @@ jobs:
         pydantic-version: ["pydantic-v1", "pydantic-v2"]
       fail-fast: false
     steps:
+      - name: Dump GitHub context
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+        run: echo "$GITHUB_CONTEXT"
       - uses: actions/checkout@v3
       - name: Set up Python
         uses: actions/setup-python@v4
@@ -80,6 +88,10 @@ jobs:
     needs: [test]
     runs-on: ubuntu-latest
     steps:
+      - name: Dump GitHub context
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+        run: echo "$GITHUB_CONTEXT"
       - uses: actions/checkout@v3
       - uses: actions/setup-python@v4
         with:
@@ -110,6 +122,10 @@ jobs:
       - coverage-combine
     runs-on: ubuntu-latest
     steps:
+      - name: Dump GitHub context
+        env:
+          GITHUB_CONTEXT: ${{ toJson(github) }}
+        run: echo "$GITHUB_CONTEXT"
       - name: Decide whether the needed jobs succeeded or failed
         uses: re-actors/alls-green@release/v1
         with:

From d943e02232081a795874b00e399dcb0a0b179daf Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 4 Aug 2023 18:19:22 +0000
Subject: [PATCH 060/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index dc61f76f2..e45373f7b 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 👷 Add GitHub Actions step dump context to debug external failures. PR [#10008](https://github.com/tiangolo/fastapi/pull/10008) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Restore MkDocs Material pin after the fix. PR [#10001](https://github.com/tiangolo/fastapi/pull/10001) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update the Question template to ask for the Pydantic version. PR [#10000](https://github.com/tiangolo/fastapi/pull/10000) by [@tiangolo](https://github.com/tiangolo).
 * ✅ Fix tests for compatibility with pydantic 2.1.1. PR [#9943](https://github.com/tiangolo/fastapi/pull/9943) by [@dmontagu](https://github.com/dmontagu).

From 19a2c3bb54ecef5fab936b45e4c262b283e100f6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 4 Aug 2023 22:47:07 +0200
Subject: [PATCH 061/317] =?UTF-8?q?=E2=9C=A8=20Enable=20Pydantic's=20seria?=
 =?UTF-8?q?lization=20mode=20for=20responses,=20add=20support=20for=20Pyda?=
 =?UTF-8?q?ntic's=20`computed=5Ffield`,=20better=20OpenAPI=20for=20respons?=
 =?UTF-8?q?e=20models,=20proper=20required=20attributes,=20better=20genera?=
 =?UTF-8?q?ted=20clients=20(#10011)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* ✨ Enable Pydantic's serialization mode for responses

* ✅ Update tests with new Pydantic v2 serialization mode

* ✅ Add a test for Pydantic v2's computed_field
---
 fastapi/routing.py                            |   4 +-
 tests/test_computed_fields.py                 |  77 +++++++
 tests/test_filter_pydantic_sub_model_pv2.py   |   8 +-
 .../test_body_updates/test_tutorial001.py     | 210 ++++++++++++++---
 .../test_tutorial001_py310.py                 | 211 +++++++++++++++---
 .../test_tutorial001_py39.py                  | 211 +++++++++++++++---
 .../test_dataclasses/test_tutorial002.py      |  12 +-
 .../test_dataclasses/test_tutorial003.py      | 185 ++++++++++++---
 .../test_extra_models/test_tutorial003.py     |  13 +-
 .../test_tutorial003_py310.py                 |  13 +-
 .../test_tutorial004.py                       | 155 +++++++++++--
 .../test_tutorial005.py                       | 155 +++++++++++--
 .../test_tutorial005_py310.py                 | 156 +++++++++++--
 .../test_tutorial005_py39.py                  | 156 +++++++++++--
 .../test_response_model/test_tutorial003.py   |   8 +-
 .../test_tutorial003_01.py                    |   8 +-
 .../test_tutorial003_01_py310.py              |   8 +-
 .../test_tutorial003_py310.py                 |   8 +-
 .../test_response_model/test_tutorial004.py   |   8 +-
 .../test_tutorial004_py310.py                 |   8 +-
 .../test_tutorial004_py39.py                  |   8 +-
 .../test_response_model/test_tutorial005.py   |   8 +-
 .../test_tutorial005_py310.py                 |   8 +-
 .../test_response_model/test_tutorial006.py   |   8 +-
 .../test_tutorial006_py310.py                 |   8 +-
 .../test_security/test_tutorial005.py         |   8 +-
 .../test_security/test_tutorial005_an.py      |   8 +-
 .../test_tutorial005_an_py310.py              |   8 +-
 .../test_security/test_tutorial005_an_py39.py |   8 +-
 .../test_security/test_tutorial005_py310.py   |   8 +-
 .../test_security/test_tutorial005_py39.py    |   8 +-
 31 files changed, 1446 insertions(+), 256 deletions(-)
 create mode 100644 tests/test_computed_fields.py

diff --git a/fastapi/routing.py b/fastapi/routing.py
index d8ff0579c..6efd40ff3 100644
--- a/fastapi/routing.py
+++ b/fastapi/routing.py
@@ -448,9 +448,7 @@ class APIRoute(routing.Route):
             self.response_field = create_response_field(
                 name=response_name,
                 type_=self.response_model,
-                # TODO: This should actually set mode='serialization', just, that changes the schemas
-                # mode="serialization",
-                mode="validation",
+                mode="serialization",
             )
             # Create a clone of the field, so that a Pydantic submodel is not returned
             # as is just because it's an instance of a subclass of a more limited class
diff --git a/tests/test_computed_fields.py b/tests/test_computed_fields.py
new file mode 100644
index 000000000..5286507b2
--- /dev/null
+++ b/tests/test_computed_fields.py
@@ -0,0 +1,77 @@
+import pytest
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+
+from .utils import needs_pydanticv2
+
+
+@pytest.fixture(name="client")
+def get_client():
+    app = FastAPI()
+
+    from pydantic import BaseModel, computed_field
+
+    class Rectangle(BaseModel):
+        width: int
+        length: int
+
+        @computed_field
+        @property
+        def area(self) -> int:
+            return self.width * self.length
+
+    @app.get("/")
+    def read_root() -> Rectangle:
+        return Rectangle(width=3, length=4)
+
+    client = TestClient(app)
+    return client
+
+
+@needs_pydanticv2
+def test_get(client: TestClient):
+    response = client.get("/")
+    assert response.status_code == 200, response.text
+    assert response.json() == {"width": 3, "length": 4, "area": 12}
+
+
+@needs_pydanticv2
+def test_openapi_schema(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/": {
+                "get": {
+                    "summary": "Read Root",
+                    "operationId": "read_root__get",
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {"$ref": "#/components/schemas/Rectangle"}
+                                }
+                            },
+                        }
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "Rectangle": {
+                    "properties": {
+                        "width": {"type": "integer", "title": "Width"},
+                        "length": {"type": "integer", "title": "Length"},
+                        "area": {"type": "integer", "title": "Area", "readOnly": True},
+                    },
+                    "type": "object",
+                    "required": ["width", "length", "area"],
+                    "title": "Rectangle",
+                }
+            }
+        },
+    }
diff --git a/tests/test_filter_pydantic_sub_model_pv2.py b/tests/test_filter_pydantic_sub_model_pv2.py
index ae12179bd..9f5e6b08f 100644
--- a/tests/test_filter_pydantic_sub_model_pv2.py
+++ b/tests/test_filter_pydantic_sub_model_pv2.py
@@ -1,7 +1,7 @@
 from typing import Optional
 
 import pytest
-from dirty_equals import HasRepr, IsDict
+from dirty_equals import HasRepr, IsDict, IsOneOf
 from fastapi import Depends, FastAPI
 from fastapi.exceptions import ResponseValidationError
 from fastapi.testclient import TestClient
@@ -139,7 +139,11 @@ def test_openapi_schema(client: TestClient):
                 },
                 "ModelA": {
                     "title": "ModelA",
-                    "required": ["name", "foo"],
+                    "required": IsOneOf(
+                        ["name", "description", "foo"],
+                        # TODO remove when deprecating Pydantic v1
+                        ["name", "foo"],
+                    ),
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
diff --git a/tests/test_tutorial/test_body_updates/test_tutorial001.py b/tests/test_tutorial/test_body_updates/test_tutorial001.py
index b02f7c81c..f1a46210a 100644
--- a/tests/test_tutorial/test_body_updates/test_tutorial001.py
+++ b/tests/test_tutorial/test_body_updates/test_tutorial001.py
@@ -1,7 +1,8 @@
 import pytest
-from dirty_equals import IsDict
 from fastapi.testclient import TestClient
 
+from ...utils import needs_pydanticv1, needs_pydanticv2
+
 
 @pytest.fixture(name="client")
 def get_client():
@@ -36,7 +37,181 @@ def test_put(client: TestClient):
     }
 
 
+@needs_pydanticv2
 def test_openapi_schema(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/{item_id}": {
+                "get": {
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/ItemOutput"
+                                    }
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Read Item",
+                    "operationId": "read_item_items__item_id__get",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "string"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                },
+                "put": {
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/ItemOutput"
+                                    }
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Update Item",
+                    "operationId": "update_item_items__item_id__put",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "string"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/ItemInput"}
+                            }
+                        },
+                        "required": True,
+                    },
+                },
+            }
+        },
+        "components": {
+            "schemas": {
+                "ItemInput": {
+                    "title": "Item",
+                    "type": "object",
+                    "properties": {
+                        "name": {
+                            "title": "Name",
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                        },
+                        "description": {
+                            "title": "Description",
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                        },
+                        "price": {
+                            "title": "Price",
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                        },
+                        "tax": {"title": "Tax", "type": "number", "default": 10.5},
+                        "tags": {
+                            "title": "Tags",
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ItemOutput": {
+                    "title": "Item",
+                    "type": "object",
+                    "required": ["name", "description", "price", "tax", "tags"],
+                    "properties": {
+                        "name": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Name",
+                        },
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                        "price": {
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                            "title": "Price",
+                        },
+                        "tax": {"title": "Tax", "type": "number", "default": 10.5},
+                        "tags": {
+                            "title": "Tags",
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+            }
+        },
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+def test_openapi_schema_pv1(client: TestClient):
     response = client.get("/openapi.json")
     assert response.status_code == 200, response.text
     assert response.json() == {
@@ -124,36 +299,9 @@ def test_openapi_schema(client: TestClient):
                     "title": "Item",
                     "type": "object",
                     "properties": {
-                        "name": IsDict(
-                            {
-                                "title": "Name",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Name", "type": "string"}
-                        ),
-                        "description": IsDict(
-                            {
-                                "title": "Description",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Description", "type": "string"}
-                        ),
-                        "price": IsDict(
-                            {
-                                "title": "Price",
-                                "anyOf": [{"type": "number"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Price", "type": "number"}
-                        ),
+                        "name": {"title": "Name", "type": "string"},
+                        "description": {"title": "Description", "type": "string"},
+                        "price": {"title": "Price", "type": "number"},
                         "tax": {"title": "Tax", "type": "number", "default": 10.5},
                         "tags": {
                             "title": "Tags",
diff --git a/tests/test_tutorial/test_body_updates/test_tutorial001_py310.py b/tests/test_tutorial/test_body_updates/test_tutorial001_py310.py
index 4af2652a7..ab696e4c8 100644
--- a/tests/test_tutorial/test_body_updates/test_tutorial001_py310.py
+++ b/tests/test_tutorial/test_body_updates/test_tutorial001_py310.py
@@ -1,8 +1,7 @@
 import pytest
-from dirty_equals import IsDict
 from fastapi.testclient import TestClient
 
-from ...utils import needs_py310
+from ...utils import needs_py310, needs_pydanticv1, needs_pydanticv2
 
 
 @pytest.fixture(name="client")
@@ -41,7 +40,182 @@ def test_put(client: TestClient):
 
 
 @needs_py310
+@needs_pydanticv2
 def test_openapi_schema(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/{item_id}": {
+                "get": {
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/ItemOutput"
+                                    }
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Read Item",
+                    "operationId": "read_item_items__item_id__get",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "string"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                },
+                "put": {
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/ItemOutput"
+                                    }
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Update Item",
+                    "operationId": "update_item_items__item_id__put",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "string"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/ItemInput"}
+                            }
+                        },
+                        "required": True,
+                    },
+                },
+            }
+        },
+        "components": {
+            "schemas": {
+                "ItemInput": {
+                    "title": "Item",
+                    "type": "object",
+                    "properties": {
+                        "name": {
+                            "title": "Name",
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                        },
+                        "description": {
+                            "title": "Description",
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                        },
+                        "price": {
+                            "title": "Price",
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                        },
+                        "tax": {"title": "Tax", "type": "number", "default": 10.5},
+                        "tags": {
+                            "title": "Tags",
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ItemOutput": {
+                    "title": "Item",
+                    "type": "object",
+                    "required": ["name", "description", "price", "tax", "tags"],
+                    "properties": {
+                        "name": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Name",
+                        },
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                        "price": {
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                            "title": "Price",
+                        },
+                        "tax": {"title": "Tax", "type": "number", "default": 10.5},
+                        "tags": {
+                            "title": "Tags",
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+            }
+        },
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_py310
+@needs_pydanticv1
+def test_openapi_schema_pv1(client: TestClient):
     response = client.get("/openapi.json")
     assert response.status_code == 200, response.text
     assert response.json() == {
@@ -129,36 +303,9 @@ def test_openapi_schema(client: TestClient):
                     "title": "Item",
                     "type": "object",
                     "properties": {
-                        "name": IsDict(
-                            {
-                                "title": "Name",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Name", "type": "string"}
-                        ),
-                        "description": IsDict(
-                            {
-                                "title": "Description",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Description", "type": "string"}
-                        ),
-                        "price": IsDict(
-                            {
-                                "title": "Price",
-                                "anyOf": [{"type": "number"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Price", "type": "number"}
-                        ),
+                        "name": {"title": "Name", "type": "string"},
+                        "description": {"title": "Description", "type": "string"},
+                        "price": {"title": "Price", "type": "number"},
                         "tax": {"title": "Tax", "type": "number", "default": 10.5},
                         "tags": {
                             "title": "Tags",
diff --git a/tests/test_tutorial/test_body_updates/test_tutorial001_py39.py b/tests/test_tutorial/test_body_updates/test_tutorial001_py39.py
index 832f45388..2ee6a5cb4 100644
--- a/tests/test_tutorial/test_body_updates/test_tutorial001_py39.py
+++ b/tests/test_tutorial/test_body_updates/test_tutorial001_py39.py
@@ -1,8 +1,7 @@
 import pytest
-from dirty_equals import IsDict
 from fastapi.testclient import TestClient
 
-from ...utils import needs_py39
+from ...utils import needs_py39, needs_pydanticv1, needs_pydanticv2
 
 
 @pytest.fixture(name="client")
@@ -41,7 +40,182 @@ def test_put(client: TestClient):
 
 
 @needs_py39
+@needs_pydanticv2
 def test_openapi_schema(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/{item_id}": {
+                "get": {
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/ItemOutput"
+                                    }
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Read Item",
+                    "operationId": "read_item_items__item_id__get",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "string"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                },
+                "put": {
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/ItemOutput"
+                                    }
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Update Item",
+                    "operationId": "update_item_items__item_id__put",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "string"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/ItemInput"}
+                            }
+                        },
+                        "required": True,
+                    },
+                },
+            }
+        },
+        "components": {
+            "schemas": {
+                "ItemInput": {
+                    "title": "Item",
+                    "type": "object",
+                    "properties": {
+                        "name": {
+                            "title": "Name",
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                        },
+                        "description": {
+                            "title": "Description",
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                        },
+                        "price": {
+                            "title": "Price",
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                        },
+                        "tax": {"title": "Tax", "type": "number", "default": 10.5},
+                        "tags": {
+                            "title": "Tags",
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ItemOutput": {
+                    "title": "Item",
+                    "type": "object",
+                    "required": ["name", "description", "price", "tax", "tags"],
+                    "properties": {
+                        "name": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Name",
+                        },
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                        "price": {
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                            "title": "Price",
+                        },
+                        "tax": {"title": "Tax", "type": "number", "default": 10.5},
+                        "tags": {
+                            "title": "Tags",
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+            }
+        },
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_py39
+@needs_pydanticv1
+def test_openapi_schema_pv1(client: TestClient):
     response = client.get("/openapi.json")
     assert response.status_code == 200, response.text
     assert response.json() == {
@@ -129,36 +303,9 @@ def test_openapi_schema(client: TestClient):
                     "title": "Item",
                     "type": "object",
                     "properties": {
-                        "name": IsDict(
-                            {
-                                "title": "Name",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Name", "type": "string"}
-                        ),
-                        "description": IsDict(
-                            {
-                                "title": "Description",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Description", "type": "string"}
-                        ),
-                        "price": IsDict(
-                            {
-                                "title": "Price",
-                                "anyOf": [{"type": "number"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Price", "type": "number"}
-                        ),
+                        "name": {"title": "Name", "type": "string"},
+                        "description": {"title": "Description", "type": "string"},
+                        "price": {"title": "Price", "type": "number"},
                         "tax": {"title": "Tax", "type": "number", "default": 10.5},
                         "tags": {
                             "title": "Tags",
diff --git a/tests/test_tutorial/test_dataclasses/test_tutorial002.py b/tests/test_tutorial/test_dataclasses/test_tutorial002.py
index 7d88e2861..4146f4cd6 100644
--- a/tests/test_tutorial/test_dataclasses/test_tutorial002.py
+++ b/tests/test_tutorial/test_dataclasses/test_tutorial002.py
@@ -1,4 +1,4 @@
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from docs_src.dataclasses.tutorial002 import app
@@ -21,8 +21,7 @@ def test_get_item():
 def test_openapi_schema():
     response = client.get("/openapi.json")
     assert response.status_code == 200
-    data = response.json()
-    assert data == {
+    assert response.json() == {
         "openapi": "3.1.0",
         "info": {"title": "FastAPI", "version": "0.1.0"},
         "paths": {
@@ -47,7 +46,11 @@ def test_openapi_schema():
             "schemas": {
                 "Item": {
                     "title": "Item",
-                    "required": ["name", "price"],
+                    "required": IsOneOf(
+                        ["name", "price", "tags", "description", "tax"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["name", "price"],
+                    ),
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
@@ -57,7 +60,6 @@ def test_openapi_schema():
                                 "title": "Tags",
                                 "type": "array",
                                 "items": {"type": "string"},
-                                "default": [],
                             }
                         )
                         | IsDict(
diff --git a/tests/test_tutorial/test_dataclasses/test_tutorial003.py b/tests/test_tutorial/test_dataclasses/test_tutorial003.py
index 597757e09..2e5809914 100644
--- a/tests/test_tutorial/test_dataclasses/test_tutorial003.py
+++ b/tests/test_tutorial/test_dataclasses/test_tutorial003.py
@@ -1,8 +1,9 @@
-from dirty_equals import IsDict
 from fastapi.testclient import TestClient
 
 from docs_src.dataclasses.tutorial003 import app
 
+from ...utils import needs_pydanticv1, needs_pydanticv2
+
 client = TestClient(app)
 
 
@@ -52,6 +53,7 @@ def test_get_authors():
     ]
 
 
+@needs_pydanticv2
 def test_openapi_schema():
     response = client.get("/openapi.json")
     assert response.status_code == 200
@@ -77,7 +79,7 @@ def test_openapi_schema():
                                 "schema": {
                                     "title": "Items",
                                     "type": "array",
-                                    "items": {"$ref": "#/components/schemas/Item"},
+                                    "items": {"$ref": "#/components/schemas/ItemInput"},
                                 }
                             }
                         },
@@ -132,26 +134,164 @@ def test_openapi_schema():
             "schemas": {
                 "Author": {
                     "title": "Author",
+                    "required": ["name", "items"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "items": {
+                            "title": "Items",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ItemOutput"},
+                        },
+                    },
+                },
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+                "ItemInput": {
+                    "title": "Item",
                     "required": ["name"],
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
-                        "items": IsDict(
-                            {
-                                "title": "Items",
-                                "type": "array",
-                                "items": {"$ref": "#/components/schemas/Item"},
-                                "default": [],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {
-                                "title": "Items",
-                                "type": "array",
-                                "items": {"$ref": "#/components/schemas/Item"},
+                        "description": {
+                            "title": "Description",
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                        },
+                    },
+                },
+                "ItemOutput": {
+                    "title": "Item",
+                    "required": ["name", "description"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": {
+                            "title": "Description",
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                        },
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+            }
+        },
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+def test_openapi_schema_pv1():
+    response = client.get("/openapi.json")
+    assert response.status_code == 200
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/authors/{author_id}/items/": {
+                "post": {
+                    "summary": "Create Author Items",
+                    "operationId": "create_author_items_authors__author_id__items__post",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Author Id", "type": "string"},
+                            "name": "author_id",
+                            "in": "path",
+                        }
+                    ],
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "title": "Items",
+                                    "type": "array",
+                                    "items": {"$ref": "#/components/schemas/Item"},
+                                }
                             }
-                        ),
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {"$ref": "#/components/schemas/Author"}
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            },
+            "/authors/": {
+                "get": {
+                    "summary": "Get Authors",
+                    "operationId": "get_authors_authors__get",
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "title": "Response Get Authors Authors  Get",
+                                        "type": "array",
+                                        "items": {
+                                            "$ref": "#/components/schemas/Author"
+                                        },
+                                    }
+                                }
+                            },
+                        }
+                    },
+                }
+            },
+        },
+        "components": {
+            "schemas": {
+                "Author": {
+                    "title": "Author",
+                    "required": ["name"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "items": {
+                            "title": "Items",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/Item"},
+                        },
                     },
                 },
                 "HTTPValidationError": {
@@ -171,16 +311,7 @@ def test_openapi_schema():
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
-                        "description": IsDict(
-                            {
-                                "title": "Description",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Description", "type": "string"}
-                        ),
+                        "description": {"title": "Description", "type": "string"},
                     },
                 },
                 "ValidationError": {
diff --git a/tests/test_tutorial/test_extra_models/test_tutorial003.py b/tests/test_tutorial/test_extra_models/test_tutorial003.py
index 21192b7db..0ccb99948 100644
--- a/tests/test_tutorial/test_extra_models/test_tutorial003.py
+++ b/tests/test_tutorial/test_extra_models/test_tutorial003.py
@@ -1,3 +1,4 @@
+from dirty_equals import IsOneOf
 from fastapi.testclient import TestClient
 
 from docs_src.extra_models.tutorial003 import app
@@ -76,7 +77,11 @@ def test_openapi_schema():
             "schemas": {
                 "PlaneItem": {
                     "title": "PlaneItem",
-                    "required": ["description", "size"],
+                    "required": IsOneOf(
+                        ["description", "type", "size"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["description", "size"],
+                    ),
                     "type": "object",
                     "properties": {
                         "description": {"title": "Description", "type": "string"},
@@ -86,7 +91,11 @@ def test_openapi_schema():
                 },
                 "CarItem": {
                     "title": "CarItem",
-                    "required": ["description"],
+                    "required": IsOneOf(
+                        ["description", "type"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["description"],
+                    ),
                     "type": "object",
                     "properties": {
                         "description": {"title": "Description", "type": "string"},
diff --git a/tests/test_tutorial/test_extra_models/test_tutorial003_py310.py b/tests/test_tutorial/test_extra_models/test_tutorial003_py310.py
index c17ddbbe1..b2fe65fd9 100644
--- a/tests/test_tutorial/test_extra_models/test_tutorial003_py310.py
+++ b/tests/test_tutorial/test_extra_models/test_tutorial003_py310.py
@@ -1,4 +1,5 @@
 import pytest
+from dirty_equals import IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py310
@@ -86,7 +87,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "PlaneItem": {
                     "title": "PlaneItem",
-                    "required": ["description", "size"],
+                    "required": IsOneOf(
+                        ["description", "type", "size"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["description", "size"],
+                    ),
                     "type": "object",
                     "properties": {
                         "description": {"title": "Description", "type": "string"},
@@ -96,7 +101,11 @@ def test_openapi_schema(client: TestClient):
                 },
                 "CarItem": {
                     "title": "CarItem",
-                    "required": ["description"],
+                    "required": IsOneOf(
+                        ["description", "type"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["description"],
+                    ),
                     "type": "object",
                     "properties": {
                         "description": {"title": "Description", "type": "string"},
diff --git a/tests/test_tutorial/test_path_operation_advanced_configurations/test_tutorial004.py b/tests/test_tutorial/test_path_operation_advanced_configurations/test_tutorial004.py
index dd123f48d..3ffc0bca7 100644
--- a/tests/test_tutorial/test_path_operation_advanced_configurations/test_tutorial004.py
+++ b/tests/test_tutorial/test_path_operation_advanced_configurations/test_tutorial004.py
@@ -1,8 +1,9 @@
-from dirty_equals import IsDict
 from fastapi.testclient import TestClient
 
 from docs_src.path_operation_advanced_configuration.tutorial004 import app
 
+from ...utils import needs_pydanticv1, needs_pydanticv2
+
 client = TestClient(app)
 
 
@@ -18,7 +19,137 @@ def test_query_params_str_validations():
     }
 
 
+@needs_pydanticv2
 def test_openapi_schema():
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "post": {
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/ItemOutput"
+                                    }
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Create an item",
+                    "description": "Create an item with all the information:\n\n- **name**: each item must have a name\n- **description**: a long description\n- **price**: required\n- **tax**: if the item doesn't have tax, you can omit this\n- **tags**: a set of unique tag strings for this item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/ItemInput"}
+                            }
+                        },
+                        "required": True,
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "ItemInput": {
+                    "title": "Item",
+                    "required": ["name", "price"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": {
+                            "title": "Description",
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                        },
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": {
+                            "title": "Tax",
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                        },
+                        "tags": {
+                            "title": "Tags",
+                            "uniqueItems": True,
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ItemOutput": {
+                    "title": "Item",
+                    "required": ["name", "description", "price", "tax", "tags"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": {
+                            "title": "Description",
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                        },
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": {
+                            "title": "Tax",
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                        },
+                        "tags": {
+                            "title": "Tags",
+                            "uniqueItems": True,
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+            }
+        },
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+def test_openapi_schema_pv1():
     response = client.get("/openapi.json")
     assert response.status_code == 200, response.text
     assert response.json() == {
@@ -69,27 +200,9 @@ def test_openapi_schema():
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
-                        "description": IsDict(
-                            {
-                                "title": "Description",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Description", "type": "string"}
-                        ),
+                        "description": {"title": "Description", "type": "string"},
                         "price": {"title": "Price", "type": "number"},
-                        "tax": IsDict(
-                            {
-                                "title": "Tax",
-                                "anyOf": [{"type": "number"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Tax", "type": "number"}
-                        ),
+                        "tax": {"title": "Tax", "type": "number"},
                         "tags": {
                             "title": "Tags",
                             "uniqueItems": True,
diff --git a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005.py b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005.py
index e7e9a982e..ff98295a6 100644
--- a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005.py
+++ b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005.py
@@ -1,8 +1,9 @@
-from dirty_equals import IsDict
 from fastapi.testclient import TestClient
 
 from docs_src.path_operation_configuration.tutorial005 import app
 
+from ...utils import needs_pydanticv1, needs_pydanticv2
+
 client = TestClient(app)
 
 
@@ -18,7 +19,137 @@ def test_query_params_str_validations():
     }
 
 
+@needs_pydanticv2
 def test_openapi_schema():
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "post": {
+                    "responses": {
+                        "200": {
+                            "description": "The created item",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/ItemOutput"
+                                    }
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Create an item",
+                    "description": "Create an item with all the information:\n\n- **name**: each item must have a name\n- **description**: a long description\n- **price**: required\n- **tax**: if the item doesn't have tax, you can omit this\n- **tags**: a set of unique tag strings for this item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/ItemInput"}
+                            }
+                        },
+                        "required": True,
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "ItemInput": {
+                    "title": "Item",
+                    "required": ["name", "price"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": {
+                            "title": "Description",
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                        },
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": {
+                            "title": "Tax",
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                        },
+                        "tags": {
+                            "title": "Tags",
+                            "uniqueItems": True,
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ItemOutput": {
+                    "title": "Item",
+                    "required": ["name", "description", "price", "tax", "tags"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": {
+                            "title": "Tax",
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                        },
+                        "tags": {
+                            "title": "Tags",
+                            "uniqueItems": True,
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+            }
+        },
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_pydanticv1
+def test_openapi_schema_pv1():
     response = client.get("/openapi.json")
     assert response.status_code == 200, response.text
     assert response.json() == {
@@ -69,27 +200,9 @@ def test_openapi_schema():
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
-                        "description": IsDict(
-                            {
-                                "title": "Description",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Description", "type": "string"}
-                        ),
+                        "description": {"title": "Description", "type": "string"},
                         "price": {"title": "Price", "type": "number"},
-                        "tax": IsDict(
-                            {
-                                "title": "Tax",
-                                "anyOf": [{"type": "number"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Tax", "type": "number"}
-                        ),
+                        "tax": {"title": "Tax", "type": "number"},
                         "tags": {
                             "title": "Tags",
                             "uniqueItems": True,
diff --git a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py310.py b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py310.py
index ebfeb809c..ad1c09eae 100644
--- a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py310.py
+++ b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py310.py
@@ -1,8 +1,7 @@
 import pytest
-from dirty_equals import IsDict
 from fastapi.testclient import TestClient
 
-from ...utils import needs_py310
+from ...utils import needs_py310, needs_pydanticv1, needs_pydanticv2
 
 
 @pytest.fixture(name="client")
@@ -27,7 +26,138 @@ def test_query_params_str_validations(client: TestClient):
 
 
 @needs_py310
+@needs_pydanticv2
 def test_openapi_schema(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "post": {
+                    "responses": {
+                        "200": {
+                            "description": "The created item",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/ItemOutput"
+                                    }
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Create an item",
+                    "description": "Create an item with all the information:\n\n- **name**: each item must have a name\n- **description**: a long description\n- **price**: required\n- **tax**: if the item doesn't have tax, you can omit this\n- **tags**: a set of unique tag strings for this item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/ItemInput"}
+                            }
+                        },
+                        "required": True,
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "ItemInput": {
+                    "title": "Item",
+                    "required": ["name", "price"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": {
+                            "title": "Description",
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                        },
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": {
+                            "title": "Tax",
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                        },
+                        "tags": {
+                            "title": "Tags",
+                            "uniqueItems": True,
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ItemOutput": {
+                    "title": "Item",
+                    "required": ["name", "description", "price", "tax", "tags"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": {
+                            "title": "Tax",
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                        },
+                        "tags": {
+                            "title": "Tags",
+                            "uniqueItems": True,
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+            }
+        },
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_py310
+@needs_pydanticv1
+def test_openapi_schema_pv1(client: TestClient):
     response = client.get("/openapi.json")
     assert response.status_code == 200, response.text
     assert response.json() == {
@@ -78,27 +208,9 @@ def test_openapi_schema(client: TestClient):
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
-                        "description": IsDict(
-                            {
-                                "title": "Description",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Description", "type": "string"}
-                        ),
+                        "description": {"title": "Description", "type": "string"},
                         "price": {"title": "Price", "type": "number"},
-                        "tax": IsDict(
-                            {
-                                "title": "Tax",
-                                "anyOf": [{"type": "number"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Tax", "type": "number"}
-                        ),
+                        "tax": {"title": "Tax", "type": "number"},
                         "tags": {
                             "title": "Tags",
                             "uniqueItems": True,
diff --git a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py39.py b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py39.py
index 8e79afe96..045d1d402 100644
--- a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py39.py
+++ b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py39.py
@@ -1,8 +1,7 @@
 import pytest
-from dirty_equals import IsDict
 from fastapi.testclient import TestClient
 
-from ...utils import needs_py39
+from ...utils import needs_py39, needs_pydanticv1, needs_pydanticv2
 
 
 @pytest.fixture(name="client")
@@ -27,7 +26,138 @@ def test_query_params_str_validations(client: TestClient):
 
 
 @needs_py39
+@needs_pydanticv2
 def test_openapi_schema(client: TestClient):
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "post": {
+                    "responses": {
+                        "200": {
+                            "description": "The created item",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/ItemOutput"
+                                    }
+                                }
+                            },
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                    "summary": "Create an item",
+                    "description": "Create an item with all the information:\n\n- **name**: each item must have a name\n- **description**: a long description\n- **price**: required\n- **tax**: if the item doesn't have tax, you can omit this\n- **tags**: a set of unique tag strings for this item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/ItemInput"}
+                            }
+                        },
+                        "required": True,
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "ItemInput": {
+                    "title": "Item",
+                    "required": ["name", "price"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": {
+                            "title": "Description",
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                        },
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": {
+                            "title": "Tax",
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                        },
+                        "tags": {
+                            "title": "Tags",
+                            "uniqueItems": True,
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ItemOutput": {
+                    "title": "Item",
+                    "required": ["name", "description", "price", "tax", "tags"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": {
+                            "title": "Tax",
+                            "anyOf": [{"type": "number"}, {"type": "null"}],
+                        },
+                        "tags": {
+                            "title": "Tags",
+                            "uniqueItems": True,
+                            "type": "array",
+                            "items": {"type": "string"},
+                            "default": [],
+                        },
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+            }
+        },
+    }
+
+
+# TODO: remove when deprecating Pydantic v1
+@needs_py39
+@needs_pydanticv1
+def test_openapi_schema_pv1(client: TestClient):
     response = client.get("/openapi.json")
     assert response.status_code == 200, response.text
     assert response.json() == {
@@ -78,27 +208,9 @@ def test_openapi_schema(client: TestClient):
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
-                        "description": IsDict(
-                            {
-                                "title": "Description",
-                                "anyOf": [{"type": "string"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Description", "type": "string"}
-                        ),
+                        "description": {"title": "Description", "type": "string"},
                         "price": {"title": "Price", "type": "number"},
-                        "tax": IsDict(
-                            {
-                                "title": "Tax",
-                                "anyOf": [{"type": "number"}, {"type": "null"}],
-                            }
-                        )
-                        | IsDict(
-                            # TODO: remove when deprecating Pydantic v1
-                            {"title": "Tax", "type": "number"}
-                        ),
+                        "tax": {"title": "Tax", "type": "number"},
                         "tags": {
                             "title": "Tags",
                             "uniqueItems": True,
diff --git a/tests/test_tutorial/test_response_model/test_tutorial003.py b/tests/test_tutorial/test_response_model/test_tutorial003.py
index 20221399b..384c8e0f1 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial003.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial003.py
@@ -1,4 +1,4 @@
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from docs_src.response_model.tutorial003 import app
@@ -70,7 +70,11 @@ def test_openapi_schema():
             "schemas": {
                 "UserOut": {
                     "title": "UserOut",
-                    "required": ["username", "email"],
+                    "required": IsOneOf(
+                        ["username", "email", "full_name"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["username", "email"],
+                    ),
                     "type": "object",
                     "properties": {
                         "username": {"title": "Username", "type": "string"},
diff --git a/tests/test_tutorial/test_response_model/test_tutorial003_01.py b/tests/test_tutorial/test_response_model/test_tutorial003_01.py
index e8f0658f4..3a6a0b20d 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial003_01.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial003_01.py
@@ -1,4 +1,4 @@
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from docs_src.response_model.tutorial003_01 import app
@@ -70,7 +70,11 @@ def test_openapi_schema():
             "schemas": {
                 "BaseUser": {
                     "title": "BaseUser",
-                    "required": ["username", "email"],
+                    "required": IsOneOf(
+                        ["username", "email", "full_name"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["username", "email"],
+                    ),
                     "type": "object",
                     "properties": {
                         "username": {"title": "Username", "type": "string"},
diff --git a/tests/test_tutorial/test_response_model/test_tutorial003_01_py310.py b/tests/test_tutorial/test_response_model/test_tutorial003_01_py310.py
index a69f8cc8d..6985b9de6 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial003_01_py310.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial003_01_py310.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py310
@@ -79,7 +79,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "BaseUser": {
                     "title": "BaseUser",
-                    "required": ["username", "email"],
+                    "required": IsOneOf(
+                        ["username", "email", "full_name"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["username", "email"],
+                    ),
                     "type": "object",
                     "properties": {
                         "username": {"title": "Username", "type": "string"},
diff --git a/tests/test_tutorial/test_response_model/test_tutorial003_py310.py b/tests/test_tutorial/test_response_model/test_tutorial003_py310.py
index 64dcd6cbd..3a3aee38a 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial003_py310.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial003_py310.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py310
@@ -79,7 +79,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "UserOut": {
                     "title": "UserOut",
-                    "required": ["username", "email"],
+                    "required": IsOneOf(
+                        ["username", "email", "full_name"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["username", "email"],
+                    ),
                     "type": "object",
                     "properties": {
                         "username": {"title": "Username", "type": "string"},
diff --git a/tests/test_tutorial/test_response_model/test_tutorial004.py b/tests/test_tutorial/test_response_model/test_tutorial004.py
index 8beb847d1..e9bde18dd 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial004.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial004.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from docs_src.response_model.tutorial004 import app
@@ -79,7 +79,11 @@ def test_openapi_schema():
             "schemas": {
                 "Item": {
                     "title": "Item",
-                    "required": ["name", "price"],
+                    "required": IsOneOf(
+                        ["name", "description", "price", "tax", "tags"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["name", "price"],
+                    ),
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
diff --git a/tests/test_tutorial/test_response_model/test_tutorial004_py310.py b/tests/test_tutorial/test_response_model/test_tutorial004_py310.py
index 28eb88c34..6f8a3cbea 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial004_py310.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial004_py310.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py310
@@ -87,7 +87,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "Item": {
                     "title": "Item",
-                    "required": ["name", "price"],
+                    "required": IsOneOf(
+                        ["name", "description", "price", "tax", "tags"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["name", "price"],
+                    ),
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
diff --git a/tests/test_tutorial/test_response_model/test_tutorial004_py39.py b/tests/test_tutorial/test_response_model/test_tutorial004_py39.py
index 9e1a21f8d..cfaa1eba2 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial004_py39.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial004_py39.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py39
@@ -87,7 +87,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "Item": {
                     "title": "Item",
-                    "required": ["name", "price"],
+                    "required": IsOneOf(
+                        ["name", "description", "price", "tax", "tags"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["name", "price"],
+                    ),
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
diff --git a/tests/test_tutorial/test_response_model/test_tutorial005.py b/tests/test_tutorial/test_response_model/test_tutorial005.py
index 06e5d0fd1..b20864c07 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial005.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial005.py
@@ -1,4 +1,4 @@
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from docs_src.response_model.tutorial005 import app
@@ -102,7 +102,11 @@ def test_openapi_schema():
             "schemas": {
                 "Item": {
                     "title": "Item",
-                    "required": ["name", "price"],
+                    "required": IsOneOf(
+                        ["name", "description", "price", "tax"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["name", "price"],
+                    ),
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
diff --git a/tests/test_tutorial/test_response_model/test_tutorial005_py310.py b/tests/test_tutorial/test_response_model/test_tutorial005_py310.py
index 0f1566243..de552c8f2 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial005_py310.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial005_py310.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py310
@@ -112,7 +112,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "Item": {
                     "title": "Item",
-                    "required": ["name", "price"],
+                    "required": IsOneOf(
+                        ["name", "description", "price", "tax"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["name", "price"],
+                    ),
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
diff --git a/tests/test_tutorial/test_response_model/test_tutorial006.py b/tests/test_tutorial/test_response_model/test_tutorial006.py
index 6e6152b9f..1e47e2ead 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial006.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial006.py
@@ -1,4 +1,4 @@
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from docs_src.response_model.tutorial006 import app
@@ -102,7 +102,11 @@ def test_openapi_schema():
             "schemas": {
                 "Item": {
                     "title": "Item",
-                    "required": ["name", "price"],
+                    "required": IsOneOf(
+                        ["name", "description", "price", "tax"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["name", "price"],
+                    ),
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
diff --git a/tests/test_tutorial/test_response_model/test_tutorial006_py310.py b/tests/test_tutorial/test_response_model/test_tutorial006_py310.py
index 9a980ab5b..40058b12d 100644
--- a/tests/test_tutorial/test_response_model/test_tutorial006_py310.py
+++ b/tests/test_tutorial/test_response_model/test_tutorial006_py310.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py310
@@ -112,7 +112,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "Item": {
                     "title": "Item",
-                    "required": ["name", "price"],
+                    "required": IsOneOf(
+                        ["name", "description", "price", "tax"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["name", "price"],
+                    ),
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
diff --git a/tests/test_tutorial/test_security/test_tutorial005.py b/tests/test_tutorial/test_security/test_tutorial005.py
index 22ae76f42..c669c306d 100644
--- a/tests/test_tutorial/test_security/test_tutorial005.py
+++ b/tests/test_tutorial/test_security/test_tutorial005.py
@@ -1,4 +1,4 @@
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from docs_src.security.tutorial005 import (
@@ -267,7 +267,11 @@ def test_openapi_schema():
             "schemas": {
                 "User": {
                     "title": "User",
-                    "required": ["username"],
+                    "required": IsOneOf(
+                        ["username", "email", "full_name", "disabled"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["username"],
+                    ),
                     "type": "object",
                     "properties": {
                         "username": {"title": "Username", "type": "string"},
diff --git a/tests/test_tutorial/test_security/test_tutorial005_an.py b/tests/test_tutorial/test_security/test_tutorial005_an.py
index 07239cc89..aaab04f78 100644
--- a/tests/test_tutorial/test_security/test_tutorial005_an.py
+++ b/tests/test_tutorial/test_security/test_tutorial005_an.py
@@ -1,4 +1,4 @@
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from docs_src.security.tutorial005_an import (
@@ -267,7 +267,11 @@ def test_openapi_schema():
             "schemas": {
                 "User": {
                     "title": "User",
-                    "required": ["username"],
+                    "required": IsOneOf(
+                        ["username", "email", "full_name", "disabled"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["username"],
+                    ),
                     "type": "object",
                     "properties": {
                         "username": {"title": "Username", "type": "string"},
diff --git a/tests/test_tutorial/test_security/test_tutorial005_an_py310.py b/tests/test_tutorial/test_security/test_tutorial005_an_py310.py
index 1ab836639..243d0773c 100644
--- a/tests/test_tutorial/test_security/test_tutorial005_an_py310.py
+++ b/tests/test_tutorial/test_security/test_tutorial005_an_py310.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py310
@@ -295,7 +295,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "User": {
                     "title": "User",
-                    "required": ["username"],
+                    "required": IsOneOf(
+                        ["username", "email", "full_name", "disabled"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["username"],
+                    ),
                     "type": "object",
                     "properties": {
                         "username": {"title": "Username", "type": "string"},
diff --git a/tests/test_tutorial/test_security/test_tutorial005_an_py39.py b/tests/test_tutorial/test_security/test_tutorial005_an_py39.py
index 6aabbe04a..17a3f9aa2 100644
--- a/tests/test_tutorial/test_security/test_tutorial005_an_py39.py
+++ b/tests/test_tutorial/test_security/test_tutorial005_an_py39.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py39
@@ -295,7 +295,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "User": {
                     "title": "User",
-                    "required": ["username"],
+                    "required": IsOneOf(
+                        ["username", "email", "full_name", "disabled"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["username"],
+                    ),
                     "type": "object",
                     "properties": {
                         "username": {"title": "Username", "type": "string"},
diff --git a/tests/test_tutorial/test_security/test_tutorial005_py310.py b/tests/test_tutorial/test_security/test_tutorial005_py310.py
index c21884df8..06455cd63 100644
--- a/tests/test_tutorial/test_security/test_tutorial005_py310.py
+++ b/tests/test_tutorial/test_security/test_tutorial005_py310.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py310
@@ -295,7 +295,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "User": {
                     "title": "User",
-                    "required": ["username"],
+                    "required": IsOneOf(
+                        ["username", "email", "full_name", "disabled"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["username"],
+                    ),
                     "type": "object",
                     "properties": {
                         "username": {"title": "Username", "type": "string"},
diff --git a/tests/test_tutorial/test_security/test_tutorial005_py39.py b/tests/test_tutorial/test_security/test_tutorial005_py39.py
index 170c5d60b..9455bfb4e 100644
--- a/tests/test_tutorial/test_security/test_tutorial005_py39.py
+++ b/tests/test_tutorial/test_security/test_tutorial005_py39.py
@@ -1,5 +1,5 @@
 import pytest
-from dirty_equals import IsDict
+from dirty_equals import IsDict, IsOneOf
 from fastapi.testclient import TestClient
 
 from ...utils import needs_py39
@@ -295,7 +295,11 @@ def test_openapi_schema(client: TestClient):
             "schemas": {
                 "User": {
                     "title": "User",
-                    "required": ["username"],
+                    "required": IsOneOf(
+                        ["username", "email", "full_name", "disabled"],
+                        # TODO: remove when deprecating Pydantic v1
+                        ["username"],
+                    ),
                     "type": "object",
                     "properties": {
                         "username": {"title": "Username", "type": "string"},

From 1c2051473865fcc76284eac177104fc342b51aeb Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 4 Aug 2023 20:47:42 +0000
Subject: [PATCH 062/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index e45373f7b..32224ffc0 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ✨ Enable Pydantic's serialization mode for responses, add support for Pydantic's `computed_field`, better OpenAPI for response models, proper required attributes, better generated clients. PR [#10011](https://github.com/tiangolo/fastapi/pull/10011) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Add GitHub Actions step dump context to debug external failures. PR [#10008](https://github.com/tiangolo/fastapi/pull/10008) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Restore MkDocs Material pin after the fix. PR [#10001](https://github.com/tiangolo/fastapi/pull/10001) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update the Question template to ask for the Pydantic version. PR [#10000](https://github.com/tiangolo/fastapi/pull/10000) by [@tiangolo](https://github.com/tiangolo).

From 944c59180354e81988a7ed67454f3fdb879f5b2d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 4 Aug 2023 22:50:34 +0200
Subject: [PATCH 063/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 19 +++++++++++++++----
 1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 32224ffc0..c3756ebd3 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,23 +2,34 @@
 
 ## Latest Changes
 
+### Features
+
 * ✨ Enable Pydantic's serialization mode for responses, add support for Pydantic's `computed_field`, better OpenAPI for response models, proper required attributes, better generated clients. PR [#10011](https://github.com/tiangolo/fastapi/pull/10011) by [@tiangolo](https://github.com/tiangolo).
+
+### Refactors
+
+* ✅ Fix tests for compatibility with pydantic 2.1.1. PR [#9943](https://github.com/tiangolo/fastapi/pull/9943) by [@dmontagu](https://github.com/dmontagu).
+* ✅ Fix test error in Windows for `jsonable_encoder`. PR [#9840](https://github.com/tiangolo/fastapi/pull/9840) by [@iudeen](https://github.com/iudeen).
+
+### Translations
+
+* 🌐 Add Russian translation for `docs/ru/docs/tutorial/security/index.md`. PR [#9963](https://github.com/tiangolo/fastapi/pull/9963) by [@eVery1337](https://github.com/eVery1337).
+* 🌐 Remove Vietnamese note about missing translation. PR [#9957](https://github.com/tiangolo/fastapi/pull/9957) by [@tiangolo](https://github.com/tiangolo).
+
+### Internal
+
 * 👷 Add GitHub Actions step dump context to debug external failures. PR [#10008](https://github.com/tiangolo/fastapi/pull/10008) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Restore MkDocs Material pin after the fix. PR [#10001](https://github.com/tiangolo/fastapi/pull/10001) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update the Question template to ask for the Pydantic version. PR [#10000](https://github.com/tiangolo/fastapi/pull/10000) by [@tiangolo](https://github.com/tiangolo).
-* ✅ Fix tests for compatibility with pydantic 2.1.1. PR [#9943](https://github.com/tiangolo/fastapi/pull/9943) by [@dmontagu](https://github.com/dmontagu).
 * 📍 Update MkDocs Material dependencies. PR [#9986](https://github.com/tiangolo/fastapi/pull/9986) by [@tiangolo](https://github.com/tiangolo).
 * 👥 Update FastAPI People. PR [#9999](https://github.com/tiangolo/fastapi/pull/9999) by [@tiangolo](https://github.com/tiangolo).
 * 🐳 Update Dockerfile with compatibility versions, to upgrade later. PR [#9998](https://github.com/tiangolo/fastapi/pull/9998) by [@tiangolo](https://github.com/tiangolo).
 * ➕ Add pydantic-settings to FastAPI People dependencies. PR [#9988](https://github.com/tiangolo/fastapi/pull/9988) by [@tiangolo](https://github.com/tiangolo).
 * ♻️ Update FastAPI People logic with new Pydantic. PR [#9985](https://github.com/tiangolo/fastapi/pull/9985) by [@tiangolo](https://github.com/tiangolo).
-* ✅ Fix test error in Windows for `jsonable_encoder`. PR [#9840](https://github.com/tiangolo/fastapi/pull/9840) by [@iudeen](https://github.com/iudeen).
-* 🌐 Add Russian translation for `docs/ru/docs/tutorial/security/index.md`. PR [#9963](https://github.com/tiangolo/fastapi/pull/9963) by [@eVery1337](https://github.com/eVery1337).
 * 🍱 Update sponsors, Fern badge. PR [#9982](https://github.com/tiangolo/fastapi/pull/9982) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Deploy docs to Cloudflare Pages. PR [#9978](https://github.com/tiangolo/fastapi/pull/9978) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsor Fern. PR [#9979](https://github.com/tiangolo/fastapi/pull/9979) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Update CI debug mode with Tmate. PR [#9977](https://github.com/tiangolo/fastapi/pull/9977) by [@tiangolo](https://github.com/tiangolo).
-* 🌐 Remove Vietnamese note about missing translation. PR [#9957](https://github.com/tiangolo/fastapi/pull/9957) by [@tiangolo](https://github.com/tiangolo).
 
 ## 0.100.1
 

From 77d1f69b1f2dced4fc7e2e0e934ffc259a4b4a98 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 4 Aug 2023 22:57:30 +0200
Subject: [PATCH 064/317] =?UTF-8?q?=F0=9F=93=8C=20Do=20not=20allow=20Pydan?=
 =?UTF-8?q?tic=202.1.0=20that=20breaks=20(require=202.1.1)=20(#10012)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index f0917578f..9b7cca9c9 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -42,7 +42,7 @@ classifiers = [
 ]
 dependencies = [
     "starlette>=0.27.0,<0.28.0",
-    "pydantic>=1.7.4,!=1.8,!=1.8.1,!=2.0.0,!=2.0.1,<3.0.0",
+    "pydantic>=1.7.4,!=1.8,!=1.8.1,!=2.0.0,!=2.0.1,!=2.1.0,<3.0.0",
     "typing-extensions>=4.5.0",
 ]
 dynamic = ["version"]

From 89a7cea56157837db092c8047d4c028193c30429 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 4 Aug 2023 20:58:08 +0000
Subject: [PATCH 065/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c3756ebd3..383be69ff 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 📌 Do not allow Pydantic 2.1.0 that breaks (require 2.1.1). PR [#10012](https://github.com/tiangolo/fastapi/pull/10012) by [@tiangolo](https://github.com/tiangolo).
 ### Features
 
 * ✨ Enable Pydantic's serialization mode for responses, add support for Pydantic's `computed_field`, better OpenAPI for response models, proper required attributes, better generated clients. PR [#10011](https://github.com/tiangolo/fastapi/pull/10011) by [@tiangolo](https://github.com/tiangolo).

From 4b5277744ad57a46fa28ea287012c83ba0a7f4f0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 4 Aug 2023 22:59:44 +0200
Subject: [PATCH 066/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 383be69ff..a7a5a424e 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,7 +2,6 @@
 
 ## Latest Changes
 
-* 📌 Do not allow Pydantic 2.1.0 that breaks (require 2.1.1). PR [#10012](https://github.com/tiangolo/fastapi/pull/10012) by [@tiangolo](https://github.com/tiangolo).
 ### Features
 
 * ✨ Enable Pydantic's serialization mode for responses, add support for Pydantic's `computed_field`, better OpenAPI for response models, proper required attributes, better generated clients. PR [#10011](https://github.com/tiangolo/fastapi/pull/10011) by [@tiangolo](https://github.com/tiangolo).
@@ -12,6 +11,10 @@
 * ✅ Fix tests for compatibility with pydantic 2.1.1. PR [#9943](https://github.com/tiangolo/fastapi/pull/9943) by [@dmontagu](https://github.com/dmontagu).
 * ✅ Fix test error in Windows for `jsonable_encoder`. PR [#9840](https://github.com/tiangolo/fastapi/pull/9840) by [@iudeen](https://github.com/iudeen).
 
+### Upgrades
+
+* 📌 Do not allow Pydantic 2.1.0 that breaks (require 2.1.1). PR [#10012](https://github.com/tiangolo/fastapi/pull/10012) by [@tiangolo](https://github.com/tiangolo).
+
 ### Translations
 
 * 🌐 Add Russian translation for `docs/ru/docs/tutorial/security/index.md`. PR [#9963](https://github.com/tiangolo/fastapi/pull/9963) by [@eVery1337](https://github.com/eVery1337).

From 8adbafc0760c9fd0d97da748545b3a5f92dbb0ea Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 4 Aug 2023 23:00:17 +0200
Subject: [PATCH 067/317] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.10?=
 =?UTF-8?q?1.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 3 +++
 fastapi/__init__.py           | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index a7a5a424e..5957a73c0 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,9 @@
 
 ## Latest Changes
 
+
+## 0.101.0
+
 ### Features
 
 * ✨ Enable Pydantic's serialization mode for responses, add support for Pydantic's `computed_field`, better OpenAPI for response models, proper required attributes, better generated clients. PR [#10011](https://github.com/tiangolo/fastapi/pull/10011) by [@tiangolo](https://github.com/tiangolo).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index 7dfeca0d4..c113ac1fd 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.100.1"
+__version__ = "0.101.0"
 
 from starlette import status as status
 

From d48a184dd8bf7063265af2b0d44ba101884ed1a4 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 5 Aug 2023 10:22:39 +0200
Subject: [PATCH 068/317] =?UTF-8?q?=E2=AC=86=20Bump=20mkdocs-material=20fr?=
 =?UTF-8?q?om=209.1.17=20to=209.1.21=20(#9960)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Bumps [mkdocs-material](https://github.com/squidfunk/mkdocs-material) from 9.1.17 to 9.1.21.
- [Release notes](https://github.com/squidfunk/mkdocs-material/releases)
- [Changelog](https://github.com/squidfunk/mkdocs-material/blob/master/CHANGELOG)
- [Commits](https://github.com/squidfunk/mkdocs-material/compare/9.1.17...9.1.21)

---
updated-dependencies:
- dependency-name: mkdocs-material
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 requirements-docs.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements-docs.txt b/requirements-docs.txt
index 7152ebf7b..220d1ec3a 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -1,5 +1,5 @@
 -e .
-mkdocs-material==9.1.17
+mkdocs-material==9.1.21
 mdx-include >=1.4.1,<2.0.0
 mkdocs-markdownextradata-plugin >=0.1.7,<0.3.0
 typer-cli >=0.0.13,<0.0.14

From 8f316be088d63b9557d85fe25e9c3b26937fa9b6 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 5 Aug 2023 10:22:58 +0200
Subject: [PATCH 069/317] =?UTF-8?q?=E2=AC=86=20Bump=20mypy=20from=201.4.0?=
 =?UTF-8?q?=20to=201.4.1=20(#9756)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Bumps [mypy](https://github.com/python/mypy) from 1.4.0 to 1.4.1.
- [Commits](https://github.com/python/mypy/compare/v1.4.0...v1.4.1)

---
updated-dependencies:
- dependency-name: mypy
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 requirements-tests.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements-tests.txt b/requirements-tests.txt
index abefac685..0113b6f7a 100644
--- a/requirements-tests.txt
+++ b/requirements-tests.txt
@@ -2,7 +2,7 @@
 pydantic-settings >=2.0.0
 pytest >=7.1.3,<8.0.0
 coverage[toml] >= 6.5.0,< 8.0
-mypy ==1.4.0
+mypy ==1.4.1
 ruff ==0.0.275
 black == 23.3.0
 httpx >=0.23.0,<0.25.0

From 0148c9508c9c42988503a16c1b909d1d268760dd Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 5 Aug 2023 08:23:14 +0000
Subject: [PATCH 070/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 5957a73c0..63e27fc98 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ⬆ Bump mkdocs-material from 9.1.17 to 9.1.21. PR [#9960](https://github.com/tiangolo/fastapi/pull/9960) by [@dependabot[bot]](https://github.com/apps/dependabot).
 
 ## 0.101.0
 

From abfcb59fd065843e669e4e3a19bf5540e789c1ab Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 5 Aug 2023 08:23:39 +0000
Subject: [PATCH 071/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 63e27fc98..621f82d55 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ⬆ Bump mypy from 1.4.0 to 1.4.1. PR [#9756](https://github.com/tiangolo/fastapi/pull/9756) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ Bump mkdocs-material from 9.1.17 to 9.1.21. PR [#9960](https://github.com/tiangolo/fastapi/pull/9960) by [@dependabot[bot]](https://github.com/apps/dependabot).
 
 ## 0.101.0

From 5891be5ff1156e28a7a3128248ce3268ef97118e Mon Sep 17 00:00:00 2001
From: Ahsan Sheraz <ahsansheraz250@gmail.com>
Date: Sat, 5 Aug 2023 13:24:21 +0500
Subject: [PATCH 072/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Urdu=20translation?=
 =?UTF-8?q?=20for=20`docs/ur/docs/benchmarks.md`=20(#9974)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/ur/docs/benchmarks.md | 52 ++++++++++++++++++++++++++++++++++++++
 docs/ur/mkdocs.yml         |  1 +
 2 files changed, 53 insertions(+)
 create mode 100644 docs/ur/docs/benchmarks.md
 create mode 100644 docs/ur/mkdocs.yml

diff --git a/docs/ur/docs/benchmarks.md b/docs/ur/docs/benchmarks.md
new file mode 100644
index 000000000..9fc793e6f
--- /dev/null
+++ b/docs/ur/docs/benchmarks.md
@@ -0,0 +1,52 @@
+# بینچ مارکس
+
+انڈیپنڈنٹ ٹیک امپور بینچ مارک **FASTAPI** Uvicorn کے تحت چلنے والی ایپلی کیشنز کو <a href="https://www.techempower.com/benchmarks/#section=test&runid=7464e520-0dc2-473d-bd34-dbdfd7e85911&hw=ph&test=query&l=zijzen-7" class="external-link" target="_blank"> ایک تیز رفتار Python فریم ورک میں سے ایک </a> ، صرف Starlette اور Uvicorn کے نیچے ( FASTAPI  کے ذریعہ اندرونی طور پر استعمال کیا جاتا ہے ) (*)
+
+لیکن جب بینچ مارک اور موازنہ کی جانچ پڑتال کرتے ہو تو آپ کو مندرجہ ذیل بات ذہن میں رکھنی چاہئے.
+
+## بینچ مارک اور رفتار
+
+جب آپ بینچ مارک کی جانچ کرتے ہیں تو ، مساوی کے مقابلے میں مختلف اقسام کے متعدد اوزار دیکھنا عام ہے.
+
+خاص طور پر ، Uvicorn, Starlette اور FastAPI کو دیکھنے کے لئے ( بہت سے دوسرے ٹولز ) کے ساتھ موازنہ کیا گیا.
+
+ٹول کے ذریعہ حل ہونے والا آسان مسئلہ ، اس کی بہتر کارکردگی ہوگی. اور زیادہ تر بینچ مارک ٹول کے ذریعہ فراہم کردہ اضافی خصوصیات کی جانچ نہیں کرتے ہیں.
+
+درجہ بندی کی طرح ہے:
+
+<ul style="direction: rtl;">
+    <li><div style="text-align: right;">ASGI :<b>Uvicorn</b> سرور</div></li>
+    <ul>
+        <li><div style="text-align: right;"><b>Starlette</b>:  (Uvicorn استعمال کرتا ہے) ایک ویب مائیکرو فریم ورک </div></li>
+        <ul>
+            <li><div style="text-align: right;"><b>FastAPI</b>: (Starlette کا استعمال کرتا ہے) ایک API مائکرو فریم ورک جس میں APIs بنانے کے لیے کئی اضافی خصوصیات ہیں، ڈیٹا کی توثیق وغیرہ کے ساتھ۔</div></li>
+        </ul>
+    </ul>
+</ul>
+
+<ul style="direction: rtl;">
+    <li><div style="text-align: right;"><b>Uvicorn</b>:</div></li>
+    <ul>
+        <li><div style="text-align: right;">بہترین کارکردگی ہوگی، کیونکہ اس میں سرور کے علاوہ زیادہ اضافی کوڈ نہیں ہے۔</div></li>
+        <li><div style="text-align: right;">آپ براہ راست Uvicorn میں درخواست نہیں لکھیں گے۔ اس کا مطلب یہ ہوگا کہ آپ کے کوڈ میں کم و بیش، کم از کم، Starlette (یا <b>FastAPI</b>) کی طرف سے فراہم کردہ تمام کوڈ شامل کرنا ہوں گے۔ اور اگر آپ نے ایسا کیا تو، آپ کی حتمی ایپلیکیشن کا وہی اوور ہیڈ ہوگا جیسا کہ ایک فریم ورک استعمال کرنے اور آپ کے ایپ کوڈ اور کیڑے کو کم سے کم کرنا۔</div></li>
+        <li><div style="text-align: right;">اگر آپ Uvicorn کا موازنہ کر رہے ہیں تو اس کا موازنہ Daphne، Hypercorn، uWSGI وغیرہ ایپلیکیشن سرورز سے کریں۔</div></li>
+    </ul>
+</ul>
+<ul style="direction: rtl;">
+    <li><div style="text-align: right;"><b>Starlette</b>:</div></li>
+    <ul>
+        <li><div style="text-align: right;">Uvicorn کے بعد اگلی بہترین کارکردگی ہوگی۔ درحقیقت، Starlette چلانے کے لیے Uvicorn کا استعمال کرتی ہے۔ لہذا، یہ شاید زیادہ کوڈ پر عمل درآمد کرکے Uvicorn سے "سست" ہوسکتا ہے۔</div></li>
+        <li><div style="text-align: right;">لیکن یہ آپ کو آسان ویب ایپلیکیشنز بنانے کے لیے ٹولز فراہم کرتا ہے، راستوں پر مبنی روٹنگ کے ساتھ، وغیرہ۔</div></li>
+        <li><div style="text-align: right;">اگر آپ سٹارلیٹ کا موازنہ کر رہے ہیں تو اس کا موازنہ Sanic، Flask، Django وغیرہ سے کریں۔ ویب فریم ورکس (یا مائیکرو فریم ورکس)</div></li>
+    </ul>
+</ul>
+<ul style="direction: rtl;">
+    <li><div style="text-align: right;"><b>FastAPI</b>:</div></li>
+    <ul>
+        <li><div style="text-align: right;">جس طرح سے Uvicorn Starlette کا استعمال کرتا ہے اور اس سے تیز نہیں ہو سکتا، Starlette <b>FastAPI</b> کا استعمال کرتا ہے، اس لیے یہ اس سے تیز نہیں ہو سکتا۔</div></li>
+        <li><div style="text-align: right;">Starlette FastAPI کے اوپری حصے میں مزید خصوصیات فراہم کرتا ہے۔ وہ خصوصیات جن کی آپ کو APIs بناتے وقت تقریباً ہمیشہ ضرورت ہوتی ہے، جیسے ڈیٹا کی توثیق اور سیریلائزیشن۔ اور اسے استعمال کرنے سے، آپ کو خودکار دستاویزات مفت میں مل جاتی ہیں (خودکار دستاویزات چلنے والی ایپلی کیشنز میں اوور ہیڈ کو بھی شامل نہیں کرتی ہیں، یہ اسٹارٹ اپ پر تیار ہوتی ہیں)۔</div></li>
+        <li><div style="text-align: right;">اگر آپ نے FastAPI کا استعمال نہیں کیا ہے اور Starlette کو براہ راست استعمال کیا ہے (یا کوئی دوسرا ٹول، جیسے Sanic، Flask، Responder، وغیرہ) آپ کو تمام ڈیٹا کی توثیق اور سیریلائزیشن کو خود نافذ کرنا ہوگا۔ لہذا، آپ کی حتمی ایپلیکیشن اب بھی وہی اوور ہیڈ ہوگی جیسا کہ اسے FastAPI کا استعمال کرتے ہوئے بنایا گیا تھا۔ اور بہت سے معاملات میں، یہ ڈیٹا کی توثیق اور سیریلائزیشن ایپلی کیشنز میں لکھے گئے کوڈ کی سب سے بڑی مقدار ہے۔</div></li>
+        <li><div style="text-align: right;">لہذا، FastAPI کا استعمال کرکے آپ ترقیاتی وقت، Bugs، کوڈ کی لائنوں کی بچت کر رہے ہیں، اور شاید آپ کو وہی کارکردگی (یا بہتر) ملے گی اگر آپ اسے استعمال نہیں کرتے (جیسا کہ آپ کو یہ سب اپنے کوڈ میں لاگو کرنا ہوگا۔ )</div></li>
+        <li><div style="text-align: right;">اگر آپ FastAPI کا موازنہ کر رہے ہیں، تو اس کا موازنہ ویب ایپلیکیشن فریم ورک (یا ٹولز کے سیٹ) سے کریں جو ڈیٹا کی توثیق، سیریلائزیشن اور دستاویزات فراہم کرتا ہے، جیسے Flask-apispec، NestJS، Molten، وغیرہ۔ مربوط خودکار ڈیٹا کی توثیق، سیریلائزیشن اور دستاویزات کے ساتھ فریم ورک۔</div></li>
+    </ul>
+</ul>
diff --git a/docs/ur/mkdocs.yml b/docs/ur/mkdocs.yml
new file mode 100644
index 000000000..de18856f4
--- /dev/null
+++ b/docs/ur/mkdocs.yml
@@ -0,0 +1 @@
+INHERIT: ../en/mkdocs.yml

From 1c919dee3ce73a5b3d134dbb335c0a38af8438b5 Mon Sep 17 00:00:00 2001
From: Aleksandr Pavlov <sasch2010pavlov@mail.ru>
Date: Sat, 5 Aug 2023 12:26:03 +0400
Subject: [PATCH 073/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Russian=20translat?=
 =?UTF-8?q?ion=20for=20`docs/ru/docs/tutorial/dependencies/global-dependen?=
 =?UTF-8?q?cies.md`=20(#9970)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: dedkot <dedkot01@gmail.com>
Co-authored-by: Vladislav Kramorenko <85196001+Xewus@users.noreply.github.com>
---
 .../dependencies/global-dependencies.md       | 34 +++++++++++++++++++
 1 file changed, 34 insertions(+)
 create mode 100644 docs/ru/docs/tutorial/dependencies/global-dependencies.md

diff --git a/docs/ru/docs/tutorial/dependencies/global-dependencies.md b/docs/ru/docs/tutorial/dependencies/global-dependencies.md
new file mode 100644
index 000000000..870d42cf5
--- /dev/null
+++ b/docs/ru/docs/tutorial/dependencies/global-dependencies.md
@@ -0,0 +1,34 @@
+# Глобальные зависимости
+
+Для некоторых типов приложений может потребоваться добавить зависимости ко всему приложению.
+
+Подобно тому, как вы можете [добавлять зависимости через параметр `dependencies` в *декораторах операций пути*](dependencies-in-path-operation-decorators.md){.internal-link target=_blank}, вы можете добавлять зависимости сразу ко всему `FastAPI` приложению.
+
+В этом случае они будут применяться ко всем *операциям пути* в приложении:
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="16"
+    {!> ../../../docs_src/dependencies/tutorial012_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="16"
+    {!> ../../../docs_src/dependencies/tutorial012_an.py!}
+    ```
+
+=== "Python 3.6 non-Annotated"
+
+    !!! tip "Подсказка"
+        Рекомендуется использовать 'Annotated' версию, если это возможно.
+
+    ```Python hl_lines="15"
+    {!> ../../../docs_src/dependencies/tutorial012.py!}
+    ```
+
+Все способы [добавления зависимостей в *декораторах операций пути*](dependencies-in-path-operation-decorators.md){.internal-link target=_blank} по-прежнему применимы, но в данном случае зависимости применяются ко всем *операциям пути* приложения.
+
+## Зависимости для групп *операций пути*
+
+Позднее, читая о том, как структурировать более крупные [приложения, содержащие много файлов](../../tutorial/bigger-applications.md){.internal-link target=_blank}, вы узнаете, как объявить один параметр dependencies для целой группы *операций пути*.

From d86a695db931d623b4225992817d1f9ed8eb259b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 5 Aug 2023 08:26:40 +0000
Subject: [PATCH 074/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 621f82d55..d656813cb 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Urdu translation for `docs/ur/docs/benchmarks.md`. PR [#9974](https://github.com/tiangolo/fastapi/pull/9974) by [@AhsanSheraz](https://github.com/AhsanSheraz).
 * ⬆ Bump mypy from 1.4.0 to 1.4.1. PR [#9756](https://github.com/tiangolo/fastapi/pull/9756) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ Bump mkdocs-material from 9.1.17 to 9.1.21. PR [#9960](https://github.com/tiangolo/fastapi/pull/9960) by [@dependabot[bot]](https://github.com/apps/dependabot).
 

From f2e80fae093e8d219e101715a8f92a15edf0ff31 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 5 Aug 2023 08:28:26 +0000
Subject: [PATCH 075/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d656813cb..82d256b73 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Russian translation for `docs/ru/docs/tutorial/dependencies/global-dependencies.md`. PR [#9970](https://github.com/tiangolo/fastapi/pull/9970) by [@dudyaosuplayer](https://github.com/dudyaosuplayer).
 * 🌐 Add Urdu translation for `docs/ur/docs/benchmarks.md`. PR [#9974](https://github.com/tiangolo/fastapi/pull/9974) by [@AhsanSheraz](https://github.com/AhsanSheraz).
 * ⬆ Bump mypy from 1.4.0 to 1.4.1. PR [#9756](https://github.com/tiangolo/fastapi/pull/9756) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ Bump mkdocs-material from 9.1.17 to 9.1.21. PR [#9960](https://github.com/tiangolo/fastapi/pull/9960) by [@dependabot[bot]](https://github.com/apps/dependabot).

From b76112f1a5230a8724994b9fa9fcf5bb417b1e09 Mon Sep 17 00:00:00 2001
From: Reza Rohani <theonlykingpin@gmail.com>
Date: Sat, 5 Aug 2023 12:03:08 +0330
Subject: [PATCH 076/317] =?UTF-8?q?=F0=9F=93=9D=20Fix=20code=20highlightin?=
 =?UTF-8?q?g=20in=20`docs/en/docs/tutorial/bigger-applications.md`=20(#980?=
 =?UTF-8?q?6)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Update bigger-applications.md
---
 docs/en/docs/tutorial/bigger-applications.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/docs/tutorial/bigger-applications.md b/docs/en/docs/tutorial/bigger-applications.md
index daa7353a2..26d26475f 100644
--- a/docs/en/docs/tutorial/bigger-applications.md
+++ b/docs/en/docs/tutorial/bigger-applications.md
@@ -377,7 +377,7 @@ The `router` from `users` would overwrite the one from `items` and we wouldn't b
 
 So, to be able to use both of them in the same file, we import the submodules directly:
 
-```Python hl_lines="4"
+```Python hl_lines="5"
 {!../../../docs_src/bigger_applications/app/main.py!}
 ```
 

From 0b496ea1f8b75943617c3b69421e2b6bfef46006 Mon Sep 17 00:00:00 2001
From: Vicente Merino <47841749+VicenteMerino@users.noreply.github.com>
Date: Sat, 5 Aug 2023 04:34:07 -0400
Subject: [PATCH 077/317] =?UTF-8?q?=F0=9F=93=9D=20Fix=20typo=20in=20`docs/?=
 =?UTF-8?q?en/docs/contributing.md`=20(#9878)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Vicente Merino <vmerino@rexmas.com>
---
 docs/en/docs/contributing.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/docs/contributing.md b/docs/en/docs/contributing.md
index f968489ae..cfdb607d7 100644
--- a/docs/en/docs/contributing.md
+++ b/docs/en/docs/contributing.md
@@ -126,7 +126,7 @@ And if you update that local FastAPI source code when you run that Python file a
 That way, you don't have to "install" your local version to be able to test every change.
 
 !!! note "Technical Details"
-    This only happens when you install using this included `requiements.txt` instead of installing `pip install fastapi` directly.
+    This only happens when you install using this included `requirements.txt` instead of installing `pip install fastapi` directly.
 
     That is because inside of the `requirements.txt` file, the local version of FastAPI is marked to be installed in "editable" mode, with the `-e` option.
 

From 51f5497f3f91efcaf23ee2cf408b8fa61178ed69 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 5 Aug 2023 08:35:55 +0000
Subject: [PATCH 078/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 82d256b73..92061066f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 📝 Fix code highlighting in `docs/en/docs/tutorial/bigger-applications.md`. PR [#9806](https://github.com/tiangolo/fastapi/pull/9806) by [@theonlykingpin](https://github.com/theonlykingpin).
 * 🌐 Add Russian translation for `docs/ru/docs/tutorial/dependencies/global-dependencies.md`. PR [#9970](https://github.com/tiangolo/fastapi/pull/9970) by [@dudyaosuplayer](https://github.com/dudyaosuplayer).
 * 🌐 Add Urdu translation for `docs/ur/docs/benchmarks.md`. PR [#9974](https://github.com/tiangolo/fastapi/pull/9974) by [@AhsanSheraz](https://github.com/AhsanSheraz).
 * ⬆ Bump mypy from 1.4.0 to 1.4.1. PR [#9756](https://github.com/tiangolo/fastapi/pull/9756) by [@dependabot[bot]](https://github.com/apps/dependabot).

From 33e77b6e257eb263cfc82bf0572b453cb1272eb6 Mon Sep 17 00:00:00 2001
From: Adejumo Ridwan Suleiman <adejumo999@gmail.com>
Date: Sat, 5 Aug 2023 09:36:05 +0100
Subject: [PATCH 079/317] =?UTF-8?q?=F0=9F=93=9D=20Add=20external=20article?=
 =?UTF-8?q?:=20Build=20an=20SMS=20Spam=20Classifier=20Serverless=20Databas?=
 =?UTF-8?q?e=20with=20FaunaDB=20and=20FastAPI=20(#9847)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/data/external_links.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/data/external_links.yml b/docs/en/data/external_links.yml
index ad738df35..a7f766d16 100644
--- a/docs/en/data/external_links.yml
+++ b/docs/en/data/external_links.yml
@@ -1,5 +1,9 @@
 articles:
   english:
+  - author: Adejumo Ridwan Suleiman
+    author_link: https://www.linkedin.com/in/adejumoridwan/
+    link: https://medium.com/python-in-plain-english/build-an-sms-spam-classifier-serverless-database-with-faunadb-and-fastapi-23dbb275bc5b
+    title: Build an SMS Spam Classifier Serverless Database with FaunaDB and FastAPI
   - author: Raf Rasenberg
     author_link: https://rafrasenberg.com/about/
     link: https://rafrasenberg.com/fastapi-lambda/

From 87e126be2e3633a46163ae28f0b418903fdfd515 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 5 Aug 2023 08:36:27 +0000
Subject: [PATCH 080/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 92061066f..3b52700ef 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 📝 Fix typo in `docs/en/docs/contributing.md`. PR [#9878](https://github.com/tiangolo/fastapi/pull/9878) by [@VicenteMerino](https://github.com/VicenteMerino).
 * 📝 Fix code highlighting in `docs/en/docs/tutorial/bigger-applications.md`. PR [#9806](https://github.com/tiangolo/fastapi/pull/9806) by [@theonlykingpin](https://github.com/theonlykingpin).
 * 🌐 Add Russian translation for `docs/ru/docs/tutorial/dependencies/global-dependencies.md`. PR [#9970](https://github.com/tiangolo/fastapi/pull/9970) by [@dudyaosuplayer](https://github.com/dudyaosuplayer).
 * 🌐 Add Urdu translation for `docs/ur/docs/benchmarks.md`. PR [#9974](https://github.com/tiangolo/fastapi/pull/9974) by [@AhsanSheraz](https://github.com/AhsanSheraz).

From bb7bbafb5fa496166037b04a9fbb108aed3b84c9 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 5 Aug 2023 08:38:32 +0000
Subject: [PATCH 081/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 3b52700ef..f8138e2a8 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 📝 Add external article: Build an SMS Spam Classifier Serverless Database with FaunaDB and FastAPI. PR [#9847](https://github.com/tiangolo/fastapi/pull/9847) by [@adejumoridwan](https://github.com/adejumoridwan).
 * 📝 Fix typo in `docs/en/docs/contributing.md`. PR [#9878](https://github.com/tiangolo/fastapi/pull/9878) by [@VicenteMerino](https://github.com/VicenteMerino).
 * 📝 Fix code highlighting in `docs/en/docs/tutorial/bigger-applications.md`. PR [#9806](https://github.com/tiangolo/fastapi/pull/9806) by [@theonlykingpin](https://github.com/theonlykingpin).
 * 🌐 Add Russian translation for `docs/ru/docs/tutorial/dependencies/global-dependencies.md`. PR [#9970](https://github.com/tiangolo/fastapi/pull/9970) by [@dudyaosuplayer](https://github.com/dudyaosuplayer).

From 5e59acd35bd00018462b6401bf78e52c91b48f70 Mon Sep 17 00:00:00 2001
From: ElliottLarsen <86161304+ElliottLarsen@users.noreply.github.com>
Date: Sat, 5 Aug 2023 02:39:38 -0600
Subject: [PATCH 082/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20typos=20in?=
 =?UTF-8?q?=20comments=20on=20internal=20code=20in=20`fastapi/concurrency.?=
 =?UTF-8?q?py`=20and=20`fastapi/routing.py`=20(#9590)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Marcelo Trylesinski <marcelotryle@gmail.com>
---
 fastapi/concurrency.py | 2 +-
 fastapi/routing.py     | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/fastapi/concurrency.py b/fastapi/concurrency.py
index 31b878d5d..754061c86 100644
--- a/fastapi/concurrency.py
+++ b/fastapi/concurrency.py
@@ -19,7 +19,7 @@ async def contextmanager_in_threadpool(
 ) -> AsyncGenerator[_T, None]:
     # blocking __exit__ from running waiting on a free thread
     # can create race conditions/deadlocks if the context manager itself
-    # has it's own internal pool (e.g. a database connection pool)
+    # has its own internal pool (e.g. a database connection pool)
     # to avoid this we let __exit__ run without a capacity limit
     # since we're creating a new limiter for each call, any non-zero limit
     # works (1 is arbitrary)
diff --git a/fastapi/routing.py b/fastapi/routing.py
index 6efd40ff3..1e3dfb4d5 100644
--- a/fastapi/routing.py
+++ b/fastapi/routing.py
@@ -83,7 +83,7 @@ def _prepare_response_content(
         if read_with_orm_mode:
             # Let from_orm extract the data from this model instead of converting
             # it now to a dict.
-            # Otherwise there's no way to extract lazy data that requires attribute
+            # Otherwise, there's no way to extract lazy data that requires attribute
             # access instead of dict iteration, e.g. lazy relationships.
             return res
         return _model_dump(
@@ -456,7 +456,7 @@ class APIRoute(routing.Route):
             # that doesn't have the hashed_password. But because it's a subclass, it
             # would pass the validation and be returned as is.
             # By being a new field, no inheritance will be passed as is. A new model
-            # will be always created.
+            # will always be created.
             # TODO: remove when deprecating Pydantic v1
             self.secure_cloned_response_field: Optional[
                 ModelField

From 69d5ebf34d088019b7dfa15729dabe3603e2d16e Mon Sep 17 00:00:00 2001
From: Francis Bergin <francisbergin@hotmail.com>
Date: Sat, 5 Aug 2023 04:40:24 -0400
Subject: [PATCH 083/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20typo=20in=20?=
 =?UTF-8?q?release=20notes=20(#9835)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f8138e2a8..fa8fd9d28 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -107,7 +107,7 @@ A command line tool that will **process your code** and update most of the thing
 
 ### Pydantic v1
 
-**This version of FastAPI still supports Pydantic v1**. And although Pydantic v1 will be deprecated at some point, ti will still be supported for a while.
+**This version of FastAPI still supports Pydantic v1**. And although Pydantic v1 will be deprecated at some point, it will still be supported for a while.
 
 This means that you can install the new Pydantic v2, and if something fails, you can install Pydantic v1 while you fix any problems you might have, but having the latest FastAPI.
 

From bdd991244d4ff1393725996ac15425857e643c6f Mon Sep 17 00:00:00 2001
From: Russ Biggs <russbiggs@gmail.com>
Date: Sat, 5 Aug 2023 02:41:21 -0600
Subject: [PATCH 084/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20typo=20in=20?=
 =?UTF-8?q?deprecation=20warnings=20in=20`fastapi/params.py`=20(#9854)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

fix typo for deprecation warnings depreacated -> deprecated
---
 fastapi/params.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/fastapi/params.py b/fastapi/params.py
index 30af5713e..2d8100650 100644
--- a/fastapi/params.py
+++ b/fastapi/params.py
@@ -69,7 +69,7 @@ class Param(FieldInfo):
         self.deprecated = deprecated
         if example is not _Unset:
             warnings.warn(
-                "`example` has been depreacated, please use `examples` instead",
+                "`example` has been deprecated, please use `examples` instead",
                 category=DeprecationWarning,
                 stacklevel=4,
             )
@@ -98,7 +98,7 @@ class Param(FieldInfo):
             kwargs["examples"] = examples
         if regex is not None:
             warnings.warn(
-                "`regex` has been depreacated, please use `pattern` instead",
+                "`regex` has been deprecated, please use `pattern` instead",
                 category=DeprecationWarning,
                 stacklevel=4,
             )
@@ -512,7 +512,7 @@ class Body(FieldInfo):
         self.deprecated = deprecated
         if example is not _Unset:
             warnings.warn(
-                "`example` has been depreacated, please use `examples` instead",
+                "`example` has been deprecated, please use `examples` instead",
                 category=DeprecationWarning,
                 stacklevel=4,
             )

From 0f4a962c201023333b653ea1412011d02e87dd65 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 5 Aug 2023 08:43:01 +0000
Subject: [PATCH 085/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index fa8fd9d28..ac8a67633 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ✏️ Fix typos in comments on internal code in `fastapi/concurrency.py` and `fastapi/routing.py`. PR [#9590](https://github.com/tiangolo/fastapi/pull/9590) by [@ElliottLarsen](https://github.com/ElliottLarsen).
 * 📝 Add external article: Build an SMS Spam Classifier Serverless Database with FaunaDB and FastAPI. PR [#9847](https://github.com/tiangolo/fastapi/pull/9847) by [@adejumoridwan](https://github.com/adejumoridwan).
 * 📝 Fix typo in `docs/en/docs/contributing.md`. PR [#9878](https://github.com/tiangolo/fastapi/pull/9878) by [@VicenteMerino](https://github.com/VicenteMerino).
 * 📝 Fix code highlighting in `docs/en/docs/tutorial/bigger-applications.md`. PR [#9806](https://github.com/tiangolo/fastapi/pull/9806) by [@theonlykingpin](https://github.com/theonlykingpin).

From 6df10c9753fa4a0f2d82506da63adf8985caca2b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 5 Aug 2023 08:44:36 +0000
Subject: [PATCH 086/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ac8a67633..b195a7bb1 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ✏️ Fix typo in release notes. PR [#9835](https://github.com/tiangolo/fastapi/pull/9835) by [@francisbergin](https://github.com/francisbergin).
 * ✏️ Fix typos in comments on internal code in `fastapi/concurrency.py` and `fastapi/routing.py`. PR [#9590](https://github.com/tiangolo/fastapi/pull/9590) by [@ElliottLarsen](https://github.com/ElliottLarsen).
 * 📝 Add external article: Build an SMS Spam Classifier Serverless Database with FaunaDB and FastAPI. PR [#9847](https://github.com/tiangolo/fastapi/pull/9847) by [@adejumoridwan](https://github.com/adejumoridwan).
 * 📝 Fix typo in `docs/en/docs/contributing.md`. PR [#9878](https://github.com/tiangolo/fastapi/pull/9878) by [@VicenteMerino](https://github.com/VicenteMerino).

From 942ee69d857710ee4f0dffce50b6d4d4db10b540 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 5 Aug 2023 08:46:58 +0000
Subject: [PATCH 087/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b195a7bb1..723f338a9 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ✏️ Fix typo in deprecation warnings in `fastapi/params.py`. PR [#9854](https://github.com/tiangolo/fastapi/pull/9854) by [@russbiggs](https://github.com/russbiggs).
 * ✏️ Fix typo in release notes. PR [#9835](https://github.com/tiangolo/fastapi/pull/9835) by [@francisbergin](https://github.com/francisbergin).
 * ✏️ Fix typos in comments on internal code in `fastapi/concurrency.py` and `fastapi/routing.py`. PR [#9590](https://github.com/tiangolo/fastapi/pull/9590) by [@ElliottLarsen](https://github.com/ElliottLarsen).
 * 📝 Add external article: Build an SMS Spam Classifier Serverless Database with FaunaDB and FastAPI. PR [#9847](https://github.com/tiangolo/fastapi/pull/9847) by [@adejumoridwan](https://github.com/adejumoridwan).

From 14c96ef31bc2069dbc7dad82a501de10d83c4cf6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 9 Aug 2023 15:26:33 +0200
Subject: [PATCH 088/317] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors,=20add?=
 =?UTF-8?q?=20Jina=20back=20as=20bronze=20sponsor=20(#10050)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/data/sponsors.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index 53cdb9bad..6cfd5b556 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -37,3 +37,6 @@ bronze:
   - url: https://www.flint.sh
     title: IT expertise, consulting and development by passionate people
     img: https://fastapi.tiangolo.com/img/sponsors/flint.png
+  - url: https://bit.ly/3JJ7y5C
+    title: Build cross-modal and multimodal applications on the cloud
+    img: https://fastapi.tiangolo.com/img/sponsors/jina2.svg

From 01383a57cbdf57cf1ba9b39381e6ab37c8d30792 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 9 Aug 2023 13:27:14 +0000
Subject: [PATCH 089/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 723f338a9..486b57071 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🔧 Update sponsors, add Jina back as bronze sponsor. PR [#10050](https://github.com/tiangolo/fastapi/pull/10050) by [@tiangolo](https://github.com/tiangolo).
 * ✏️ Fix typo in deprecation warnings in `fastapi/params.py`. PR [#9854](https://github.com/tiangolo/fastapi/pull/9854) by [@russbiggs](https://github.com/russbiggs).
 * ✏️ Fix typo in release notes. PR [#9835](https://github.com/tiangolo/fastapi/pull/9835) by [@francisbergin](https://github.com/francisbergin).
 * ✏️ Fix typos in comments on internal code in `fastapi/concurrency.py` and `fastapi/routing.py`. PR [#9590](https://github.com/tiangolo/fastapi/pull/9590) by [@ElliottLarsen](https://github.com/ElliottLarsen).

From 87398723f91efb24834bdded970bc5065049d50d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 9 Aug 2023 19:04:49 +0200
Subject: [PATCH 090/317] =?UTF-8?q?=F0=9F=94=A7=20Add=20sponsor=20Porter?=
 =?UTF-8?q?=20(#10051)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/data/sponsors.yml                   |   3 +++
 docs/en/data/sponsors_badge.yml             |   2 ++
 docs/en/docs/img/sponsors/porter-banner.png | Bin 0 -> 17260 bytes
 docs/en/docs/img/sponsors/porter.png        | Bin 0 -> 23992 bytes
 docs/en/overrides/main.html                 |   6 ++++++
 5 files changed, 11 insertions(+)
 create mode 100755 docs/en/docs/img/sponsors/porter-banner.png
 create mode 100755 docs/en/docs/img/sponsors/porter.png

diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index 6cfd5b556..6d9119520 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -8,6 +8,9 @@ gold:
   - url: https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=main-badge
     title: Fern | SDKs and API docs
     img: https://fastapi.tiangolo.com/img/sponsors/fern.svg
+  - url: https://www.porter.run
+    title: Deploy FastAPI on AWS with a few clicks
+    img: https://fastapi.tiangolo.com/img/sponsors/porter.png
 silver:
   - url: https://www.deta.sh/?ref=fastapi
     title: The launchpad for all your (team's) ideas
diff --git a/docs/en/data/sponsors_badge.yml b/docs/en/data/sponsors_badge.yml
index b3cb06327..7c3bb2f47 100644
--- a/docs/en/data/sponsors_badge.yml
+++ b/docs/en/data/sponsors_badge.yml
@@ -17,3 +17,5 @@ logins:
   - databento-bot
   - nanram22
   - Flint-company
+  - porter-dev
+  - fern-api
diff --git a/docs/en/docs/img/sponsors/porter-banner.png b/docs/en/docs/img/sponsors/porter-banner.png
new file mode 100755
index 0000000000000000000000000000000000000000..fa2e741c0cbb326b271e3e3f545a4dbc55f72519
GIT binary patch
literal 17260
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
LNkvXXu0mjfJEqlj

literal 0
HcmV?d00001

diff --git a/docs/en/docs/img/sponsors/porter.png b/docs/en/docs/img/sponsors/porter.png
new file mode 100755
index 0000000000000000000000000000000000000000..582a15156470bd8af7ebf8e9c05beddea1a7de11
GIT binary patch
literal 23992
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

literal 0
HcmV?d00001

diff --git a/docs/en/overrides/main.html b/docs/en/overrides/main.html
index 7e6c0f763..983d7eb3e 100644
--- a/docs/en/overrides/main.html
+++ b/docs/en/overrides/main.html
@@ -40,6 +40,12 @@
         <img class="sponsor-image" src="/img/sponsors/fern-banner.svg" />
       </a>
     </div>
+    <div class="item">
+      <a title="Deploy FastAPI on AWS with a few clicks" style="display: block; position: relative;" href="https://www.porter.run" target="_blank">
+        <span class="sponsor-badge">sponsor</span>
+        <img class="sponsor-image" src="/img/sponsors/porter-banner.png" />
+      </a>
+    </div>
   </div>
 </div>
 {% endblock %}

From 82fafcc7ea2d8e2808bf5750a25be4255ba2f683 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 9 Aug 2023 17:05:31 +0000
Subject: [PATCH 091/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 486b57071..39e04ca98 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🔧 Add sponsor Porter. PR [#10051](https://github.com/tiangolo/fastapi/pull/10051) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, add Jina back as bronze sponsor. PR [#10050](https://github.com/tiangolo/fastapi/pull/10050) by [@tiangolo](https://github.com/tiangolo).
 * ✏️ Fix typo in deprecation warnings in `fastapi/params.py`. PR [#9854](https://github.com/tiangolo/fastapi/pull/9854) by [@russbiggs](https://github.com/russbiggs).
 * ✏️ Fix typo in release notes. PR [#9835](https://github.com/tiangolo/fastapi/pull/9835) by [@francisbergin](https://github.com/francisbergin).

From f0ab797de47d7eb4c80394339039ffaf4a734fae Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nguy=E1=BB=85n=20Kh=E1=BA=AFc=20Th=C3=A0nh?=
 <nguyenkhacthanh244@gmail.com>
Date: Thu, 10 Aug 2023 22:52:25 +0700
Subject: [PATCH 092/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Vietnamese=20trans?=
 =?UTF-8?q?lation=20for=20`docs/vi/docs/python-types.md`=20(#10047)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
 docs/en/mkdocs.yml           |   2 +-
 docs/vi/docs/python-types.md | 545 +++++++++++++++++++++++++++++++++++
 2 files changed, 546 insertions(+), 1 deletion(-)
 create mode 100644 docs/vi/docs/python-types.md

diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index a18613185..a66b6c147 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -241,7 +241,7 @@ extra:
   - link: /uk/
     name: uk
   - link: /vi/
-    name: vi
+    name: vi - Tiếng Việt
   - link: /zh/
     name: zh - 汉语
 extra_css:
diff --git a/docs/vi/docs/python-types.md b/docs/vi/docs/python-types.md
new file mode 100644
index 000000000..7f4f51131
--- /dev/null
+++ b/docs/vi/docs/python-types.md
@@ -0,0 +1,545 @@
+# Giới thiệu kiểu dữ liệu Python
+
+Python hỗ trợ tùy chọn "type hints" (còn được gọi là "type annotations").
+
+Những **"type hints"** hay chú thích là một cú pháp đặc biệt cho phép khai báo <abbr title="ví dụ: str, int, float, bool"> kiểu dữ liệu</abbr> của một biến.
+
+Bằng việc khai báo kiểu dữ liệu cho các biến của bạn, các trình soạn thảo và các công cụ có thể hỗ trợ bạn tốt hơn.
+
+Đây chỉ là một **hướng dẫn nhanh** về gợi ý kiểu dữ liệu trong Python. Nó chỉ bao gồm những điều cần thiết tối thiểu để sử dụng chúng với **FastAPI**... đó thực sự là rất ít.
+
+**FastAPI** hoàn toàn được dựa trên những gợi ý kiểu dữ liệu, chúng mang đến nhiều ưu điểm và lợi ích.
+
+Nhưng thậm chí nếu bạn không bao giờ sử dụng **FastAPI**, bạn sẽ được lợi từ việc học một ít về chúng.
+
+!!! note
+    Nếu bạn là một chuyên gia về Python, và bạn đã biết mọi thứ về gợi ý kiểu dữ liệu, bỏ qua và đi tới chương tiếp theo.
+
+## Động lực
+
+Hãy bắt đầu với một ví dụ đơn giản:
+
+```Python
+{!../../../docs_src/python_types/tutorial001.py!}
+```
+
+Kết quả khi gọi chương trình này:
+
+```
+John Doe
+```
+
+Hàm thực hiện như sau:
+
+* Lấy một `first_name` và `last_name`.
+* Chuyển đổi kí tự đầu tiên của mỗi biến sang kiểu chữ hoa với `title()`.
+* <abbr title="Đặt chúng lại với nhau thành một. Với các nội dung lần lượt.">Nối</abbr> chúng lại với nhau bằng một kí tự trắng ở giữa.
+
+```Python hl_lines="2"
+{!../../../docs_src/python_types/tutorial001.py!}
+```
+
+### Sửa đổi
+
+Nó là một chương trình rất đơn giản.
+
+Nhưng bây giờ hình dung rằng bạn đang viết nó từ đầu.
+
+Tại một vài thời điểm, bạn sẽ bắt đầu định nghĩa hàm, bạn có các tham số...
+
+Nhưng sau đó bạn phải gọi "phương thức chuyển đổi kí tự đầu tiên sang kiểu chữ hoa".
+
+Có phải là `upper`? Có phải là `uppercase`? `first_uppercase`? `capitalize`?
+
+Sau đó, bạn thử hỏi người bạn cũ của mình, autocompletion của trình soạn thảo.
+
+Bạn gõ tham số đầu tiên của hàm, `first_name`, sau đó một dấu chấm (`.`) và sau đó ấn `Ctrl+Space` để kích hoạt bộ hoàn thành.
+
+Nhưng đáng buồn, bạn không nhận được điều gì hữu ích cả:
+
+<img src="/img/python-types/image01.png">
+
+### Thêm kiểu dữ liệu
+
+Hãy sửa một dòng từ phiên bản trước.
+
+Chúng ta sẽ thay đổi chính xác đoạn này, tham số của hàm, từ:
+
+```Python
+    first_name, last_name
+```
+
+sang:
+
+```Python
+    first_name: str, last_name: str
+```
+
+Chính là nó.
+
+Những thứ đó là "type hints":
+
+```Python hl_lines="1"
+{!../../../docs_src/python_types/tutorial002.py!}
+```
+
+Đó không giống như khai báo những giá trị mặc định giống như:
+
+```Python
+    first_name="john", last_name="doe"
+```
+
+Nó là một thứ khác.
+
+Chúng ta sử dụng dấu hai chấm (`:`), không phải dấu bằng (`=`).
+
+Và việc thêm gợi ý kiểu dữ liệu không làm thay đổi những gì xảy ra so với khi chưa thêm chúng.
+
+But now, imagine you are again in the middle of creating that function, but with type hints.
+
+Tại cùng một điểm, bạn thử kích hoạt autocomplete với `Ctrl+Space` và bạn thấy:
+
+<img src="/img/python-types/image02.png">
+
+Với cái đó, bạn có thể cuộn, nhìn thấy các lựa chọn, cho đến khi bạn tìm thấy một "tiếng chuông":
+
+<img src="/img/python-types/image03.png">
+
+## Động lực nhiều hơn
+
+Kiểm tra hàm này, nó đã có gợi ý kiểu dữ liệu:
+
+```Python hl_lines="1"
+{!../../../docs_src/python_types/tutorial003.py!}
+```
+
+Bởi vì trình soạn thảo biết kiểu dữ liệu của các biến, bạn không chỉ có được completion, bạn cũng được kiểm tra lỗi:
+
+<img src="/img/python-types/image04.png">
+
+Bây giờ bạn biết rằng bạn phải sửa nó, chuyển `age` sang một xâu với `str(age)`:
+
+```Python hl_lines="2"
+{!../../../docs_src/python_types/tutorial004.py!}
+```
+
+## Khai báo các kiểu dữ liệu
+
+Bạn mới chỉ nhìn thấy những nơi chủ yếu để đặt khai báo kiểu dữ liệu. Như là các tham số của hàm.
+
+Đây cũng là nơi chủ yếu để bạn sử dụng chúng với **FastAPI**.
+
+### Kiểu dữ liệu đơn giản
+
+Bạn có thể khai báo tất cả các kiểu dữ liệu chuẩn của Python, không chỉ là `str`.
+
+Bạn có thể sử dụng, ví dụ:
+
+* `int`
+* `float`
+* `bool`
+* `bytes`
+
+```Python hl_lines="1"
+{!../../../docs_src/python_types/tutorial005.py!}
+```
+
+### Các kiểu dữ liệu tổng quát với tham số kiểu dữ liệu
+
+Có một vài cấu trúc dữ liệu có thể chứa các giá trị khác nhau như `dict`, `list`, `set` và `tuple`. Và những giá trị nội tại cũng có thể có kiểu dữ liệu của chúng.
+
+Những kiểu dữ liệu nội bộ này được gọi là những kiểu dữ liệu "**tổng quát**". Và có khả năng khai báo chúng, thậm chí với các kiểu dữ liệu nội bộ của chúng.
+
+Để khai báo những kiểu dữ liệu và những kiểu dữ liệu nội bộ đó, bạn có thể sử dụng mô đun chuẩn của Python là `typing`. Nó có hỗ trợ những gợi ý kiểu dữ liệu này.
+
+#### Những phiên bản mới hơn của Python
+
+Cú pháp sử dụng `typing` **tương thích** với tất cả các phiên bản, từ Python 3.6 tới những phiên bản cuối cùng, bao gồm Python 3.9, Python 3.10,...
+
+As Python advances, **những phiên bản mới** mang tới sự hỗ trợ được cải tiến cho những chú thích kiểu dữ liệu và trong nhiều trường hợp bạn thậm chí sẽ không cần import và sử dụng mô đun `typing` để khai báo chú thích kiểu dữ liệu.
+
+Nếu bạn có thể chọn một phiên bản Python gần đây hơn cho dự án của bạn, ban sẽ có được những ưu điểm của những cải tiến đơn giản đó.
+
+Trong tất cả các tài liệu tồn tại những ví dụ tương thích với mỗi phiên bản Python (khi có một sự khác nhau).
+
+Cho ví dụ "**Python 3.6+**" có nghĩa là nó tương thích với Python 3.7 hoặc lớn hơn (bao gồm 3.7, 3.8, 3.9, 3.10,...). và "**Python 3.9+**" nghĩa là nó tương thích với Python 3.9 trở lên (bao gồm 3.10,...).
+
+Nếu bạn có thể sử dụng **phiên bản cuối cùng của Python**, sử dụng những ví dụ cho phiên bản cuối, những cái đó sẽ có **cú pháp đơn giản và tốt nhât**, ví dụ, "**Python 3.10+**".
+
+#### List
+
+Ví dụ, hãy định nghĩa một biến là `list` các `str`.
+
+=== "Python 3.9+"
+
+    Khai báo biến với cùng dấu hai chấm (`:`).
+
+    Tương tự kiểu dữ liệu `list`.
+
+    Như danh sách là một kiểu dữ liệu chứa một vài kiểu dữ liệu có sẵn, bạn đặt chúng trong các dấu ngoặc vuông:
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial006_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    Từ `typing`, import `List` (với chữ cái `L` viết hoa):
+
+    ``` Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial006.py!}
+    ```
+
+    Khai báo biến với cùng dấu hai chấm (`:`).
+
+    Tương tự như kiểu dữ liệu, `List` bạn import từ `typing`.
+
+    Như danh sách là một kiểu dữ liệu chứa các kiểu dữ liệu có sẵn, bạn đặt chúng bên trong dấu ngoặc vuông:
+
+    ```Python hl_lines="4"
+    {!> ../../../docs_src/python_types/tutorial006.py!}
+    ```
+
+!!! info
+    Các kiểu dữ liệu có sẵn bên trong dấu ngoặc vuông được gọi là "tham số kiểu dữ liệu".
+
+    Trong trường hợp này, `str` là tham số kiểu dữ liệu được truyền tới `List` (hoặc `list` trong Python 3.9 trở lên).
+
+Có nghĩa là: "biến `items` là một `list`, và mỗi phần tử trong danh sách này là một `str`".
+
+!!! tip
+    Nếu bạn sử dụng Python 3.9 hoặc lớn hơn, bạn không phải import `List` từ `typing`, bạn có thể sử dụng `list` để thay thế.
+
+Bằng cách này, trình soạn thảo của bạn có thể hỗ trợ trong khi xử lí các phần tử trong danh sách:
+
+<img src="/img/python-types/image05.png">
+
+Đa phần đều không thể đạt được nếu không có các kiểu dữ liệu.
+
+Chú ý rằng, biến `item` là một trong các phần tử trong danh sách `items`.
+
+Và do vậy, trình soạn thảo biết nó là một `str`, và cung cấp sự hỗ trợ cho nó.
+
+#### Tuple and Set
+
+Bạn sẽ làm điều tương tự để khai báo các `tuple` và  các `set`:
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial007_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial007.py!}
+    ```
+
+Điều này có nghĩa là:
+
+* Biến `items_t` là một `tuple` với 3 phần tử, một `int`, một `int` nữa, và một `str`.
+* Biến `items_s` là một `set`, và mỗi phần tử của nó có kiểu `bytes`.
+
+#### Dict
+
+Để định nghĩa một `dict`, bạn truyền 2 tham số kiểu dữ liệu, phân cách bởi dấu phẩy.
+
+Tham số kiểu dữ liệu đầu tiên dành cho khóa của `dict`.
+
+Tham số kiểu dữ liệu thứ hai dành cho giá trị của `dict`.
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial008_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial008.py!}
+    ```
+
+Điều này có nghĩa là:
+
+* Biến `prices` là một `dict`:
+    * Khóa của `dict` này là kiểu `str` (đó là tên của mỗi vật phẩm).
+    * Giá trị của `dict` này là kiểu `float` (đó là giá của mỗi vật phẩm).
+
+#### Union
+
+Bạn có thể khai báo rằng một biến có thể là **một vài kiểu dữ liệu" bất kì, ví dụ, một `int` hoặc một `str`.
+
+Trong Python 3.6 hoặc lớn hơn (bao gồm Python 3.10) bạn có thể sử dụng kiểu `Union` từ `typing` và đặt trong dấu ngoặc vuông những giá trị được chấp nhận.
+
+In Python 3.10 there's also a **new syntax** where you can put the possible types separated by a <abbr title='also called "bitwise or operator", but that meaning is not relevant here'>vertical bar (`|`)</abbr>.
+
+Trong Python 3.10 cũng có một **cú pháp mới** mà bạn có thể đặt những kiểu giá trị khả thi phân cách bởi một dấu <abbr title='cũng được gọi là "toán tử nhị phân"'>sổ dọc (`|`)</abbr>.
+
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial008b_py310.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial008b.py!}
+    ```
+
+Trong cả hai trường hợp có nghĩa là `item` có thể là một `int` hoặc `str`.
+
+#### Khả năng `None`
+
+Bạn có thể khai báo một giá trị có thể có một kiểu dữ liệu, giống như `str`, nhưng nó cũng có thể là `None`.
+
+Trong Python 3.6 hoặc lớn hơn (bao gồm Python 3.10) bạn có thể khai báo nó bằng các import và sử dụng `Optional` từ mô đun `typing`.
+
+```Python hl_lines="1  4"
+{!../../../docs_src/python_types/tutorial009.py!}
+```
+
+Sử dụng `Optional[str]` thay cho `str` sẽ cho phép trình soạn thảo giúp bạn phát hiện các lỗi mà bạn có thể gặp như một giá trị luôn là một `str`, trong khi thực tế nó rất có thể là `None`.
+
+`Optional[Something]` là một cách viết ngắn gọn của `Union[Something, None]`, chúng là tương đương nhau.
+
+Điều này cũng có nghĩa là trong Python 3.10, bạn có thể sử dụng `Something | None`:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial009_py310.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial009.py!}
+    ```
+
+=== "Python 3.6+ alternative"
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial009b.py!}
+    ```
+
+#### Sử dụng `Union` hay `Optional`
+
+If you are using a Python version below 3.10, here's a tip from my very **subjective** point of view:
+
+Nếu bạn đang sử dụng phiên bản Python dưới 3.10, đây là một mẹo từ ý kiến rất "chủ quan" của tôi:
+
+* 🚨 Tránh sử dụng `Optional[SomeType]`
+* Thay vào đó ✨ **sử dụng `Union[SomeType, None]`** ✨.
+
+Cả hai là tương đương và bên dưới chúng giống nhau, nhưng tôi sẽ đễ xuất `Union` thay cho `Optional` vì từ "**tùy chọn**" có vẻ ngầm định giá trị là tùy chọn, và nó thực sự có nghĩa rằng "nó có thể là `None`", do đó nó không phải là tùy chọn và nó vẫn được yêu cầu.
+
+Tôi nghĩ `Union[SomeType, None]` là rõ ràng hơn về ý nghĩa của nó.
+
+Nó chỉ là về các từ và tên. Nhưng những từ đó có thể ảnh hưởng cách bạn và những đồng đội của bạn suy nghĩ về code.
+
+Cho một ví dụ, hãy để ý hàm này:
+
+```Python hl_lines="1  4"
+{!../../../docs_src/python_types/tutorial009c.py!}
+```
+
+Tham số `name` được định nghĩa là `Optional[str]`, nhưng nó **không phải là tùy chọn**, bạn không thể gọi hàm mà không có tham số:
+
+```Python
+say_hi()  # Oh, no, this throws an error! 😱
+```
+
+Tham số `name` **vẫn được yêu cầu** (không phải là *tùy chọn*) vì nó không có giá trị mặc định. Trong khi đó, `name` chấp nhận `None` như là giá trị:
+
+```Python
+say_hi(name=None)  # This works, None is valid 🎉
+```
+
+Tin tốt là, khi bạn sử dụng Python 3.10, bạn sẽ không phải lo lắng về điều đó, bạn sẽ có thể sử dụng `|` để định nghĩa hợp của các kiểu dữ liệu một cách đơn giản:
+
+```Python hl_lines="1  4"
+{!../../../docs_src/python_types/tutorial009c_py310.py!}
+```
+
+Và sau đó, bạn sẽ không phải lo rằng những cái tên như `Optional` và `Union`. 😎
+
+
+#### Những kiểu dữ liệu tổng quát
+
+Những kiểu dữ liệu này lấy tham số kiểu dữ liệu trong dấu ngoặc vuông được gọi là **Kiểu dữ liệu tổng quát**, cho ví dụ:
+
+=== "Python 3.10+"
+
+    Bạn có thể sử dụng các kiểu dữ liệu có sẵn như là kiểu dữ liệu tổng quát (với ngoặc vuông và kiểu dữ liệu bên trong):
+
+    * `list`
+    * `tuple`
+    * `set`
+    * `dict`
+
+    Và tương tự với Python 3.6, từ mô đun `typing`:
+
+    * `Union`
+    * `Optional` (tương tự như Python 3.6)
+    * ...và các kiểu dữ liệu khác.
+
+    Trong Python 3.10, thay vì sử dụng `Union` và `Optional`, bạn có thể sử dụng <abbr title='cũng gọi là "toán tử nhị phân", nhưng ý nghĩa không liên quan ở đây'>sổ dọc ('|')</abbr> để khai báo hợp của các kiểu dữ liệu, điều đó tốt hơn và đơn giản hơn nhiều.
+
+=== "Python 3.9+"
+
+    Bạn có thể sử dụng các kiểu dữ liệu có sẵn tương tự như (với ngoặc vuông và kiểu dữ liệu bên trong):
+
+    * `list`
+    * `tuple`
+    * `set`
+    * `dict`
+
+    Và tương tự với Python 3.6, từ mô đun `typing`:
+
+    * `Union`
+    * `Optional`
+    * ...and others.
+
+=== "Python 3.6+"
+
+    * `List`
+    * `Tuple`
+    * `Set`
+    * `Dict`
+    * `Union`
+    * `Optional`
+    * ...và các kiểu khác.
+
+### Lớp như kiểu dữ liệu
+
+Bạn cũng có thể khai báo một lớp như là kiểu dữ liệu của một biến.
+
+Hãy nói rằng bạn muốn có một lớp `Person` với một tên:
+
+```Python hl_lines="1-3"
+{!../../../docs_src/python_types/tutorial010.py!}
+```
+
+Sau đó bạn có thể khai báo một biến có kiểu là `Person`:
+
+```Python hl_lines="6"
+{!../../../docs_src/python_types/tutorial010.py!}
+```
+
+Và lại một lần nữa, bạn có được tất cả sự hỗ trợ từ trình soạn thảo:
+
+<img src="/img/python-types/image06.png">
+
+Lưu ý rằng, điều này có nghĩa rằng "`one_person`" là một **thực thể** của lớp `Person`.
+
+Nó không có nghĩa "`one_person`" là một **lớp** gọi là `Person`.
+
+## Pydantic models
+
+<a href="https://pydantic-docs.helpmanual.io/" class="external-link" target="_blank">Pydantic</a> là một thư viện Python để validate dữ liệu hiệu năng cao.
+
+Bạn có thể khai báo "hình dạng" của dữa liệu như là các lớp với các thuộc tính.
+
+Và mỗi thuộc tính có một kiểu dữ liệu.
+
+Sau đó bạn tạo một thực thể của lớp đó với một vài giá trị và nó sẽ validate các giá trị, chuyển đổi chúng sang kiểu dữ liệu phù hợp (nếu đó là trường hợp) và cho bạn một object với toàn bộ dữ liệu.
+
+Và bạn nhận được tất cả sự hỗ trợ của trình soạn thảo với object kết quả đó.
+
+Một ví dụ từ tài liệu chính thức của Pydantic:
+
+=== "Python 3.10+"
+
+    ```Python
+    {!> ../../../docs_src/python_types/tutorial011_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python
+    {!> ../../../docs_src/python_types/tutorial011_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python
+    {!> ../../../docs_src/python_types/tutorial011.py!}
+    ```
+
+!!! info
+    Để học nhiều hơn về <a href="https://pydantic-docs.helpmanual.io/" class="external-link" target="_blank">Pydantic, tham khảo tài liệu của nó</a>.
+
+**FastAPI** được dựa hoàn toàn trên Pydantic.
+
+Bạn sẽ thấy nhiều ví dụ thực tế hơn trong [Hướng dẫn sử dụng](tutorial/index.md){.internal-link target=_blank}.
+
+!!! tip
+    Pydantic có một hành vi đặc biệt khi bạn sử dụng `Optional` hoặc `Union[Something, None]` mà không có giá trị mặc dịnh, bạn có thể đọc nhiều hơn về nó trong tài liệu của Pydantic về <a href="https://pydantic-docs.helpmanual.io/usage/models/#required-optional-fields" class="external-link" target="_blank">Required Optional fields</a>.
+
+
+## Type Hints với Metadata Annotations
+
+Python cũng có một tính năng cho phép đặt **metadata bổ sung** trong những gợi ý kiểu dữ liệu này bằng cách sử dụng `Annotated`.
+
+=== "Python 3.9+"
+
+    Trong Python 3.9, `Annotated` là một phần của thư viện chuẩn, do đó bạn có thể import nó từ `typing`.
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial013_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    Ở phiên bản dưới Python 3.9, bạn import `Annotated` từ `typing_extensions`.
+
+    Nó đã được cài đặt sẵng cùng với **FastAPI**.
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial013.py!}
+    ```
+
+Python bản thân nó không làm bất kì điều gì với `Annotated`. Với các trình soạn thảo và các công cụ khác, kiểu dữ liệu vẫn là `str`.
+
+Nhưng bạn có thể sử dụng `Annotated` để cung cấp cho **FastAPI** metadata bổ sung về cách mà bạn muốn ứng dụng của bạn xử lí.
+
+Điều quan trọng cần nhớ là ***tham số kiểu dữ liệu* đầu tiên** bạn truyền tới `Annotated` là **kiểu giá trị thực sự**. Phần còn lại chỉ là metadata cho các công cụ khác.
+
+Bây giờ, bạn chỉ cần biết rằng `Annotated` tồn tại, và nó là tiêu chuẩn của Python. 😎
+
+
+Sau đó, bạn sẽ thấy sự **mạnh mẽ** mà nó có thể làm.
+
+!!! tip
+    Thực tế, cái này là **tiêu chuẩn của Python**, nghĩa là bạn vẫn sẽ có được **trải nghiệm phát triển tốt nhất có thể** với trình soạn thảo của bạn, với các công cụ bạn sử dụng để phân tích và tái cấu trúc code của bạn, etc. ✨
+
+    Và code của bạn sẽ tương thích với nhiều công cụ và thư viện khác của Python. 🚀
+
+## Các gợi ý kiểu dữ liệu trong **FastAPI**
+
+**FastAPI** lấy các ưu điểm của các gợi ý kiểu dữ liệu để thực hiện một số thứ.
+
+Với **FastAPI**, bạn khai báo các tham số với gợi ý kiểu và bạn có được:
+
+* **Sự hỗ trợ từ các trình soạn thảo**.
+* **Kiểm tra kiểu dữ liệu (type checking)**.
+
+...và **FastAPI** sử dụng các khia báo để:
+
+* **Định nghĩa các yêu cầu**: từ tham số đường dẫn của request, tham số query, headers, bodies, các phụ thuộc (dependencies),...
+* **Chuyển dổi dữ liệu*: từ request sang kiểu dữ liệu được yêu cầu.
+* **Kiểm tra tính đúng đắn của dữ liệu**: tới từ mỗi request:
+    * Sinh **lỗi tự động** để trả về máy khác khi dữ liệu không hợp lệ.
+* **Tài liệu hóa** API sử dụng OpenAPI:
+    * cái mà sau được được sử dụng bởi tài liệu tương tác người dùng.
+
+Điều này có thể nghe trừu tượng. Đừng lo lắng. Bạn sẽ thấy tất cả chúng trong [Hướng dẫn sử dụng](tutorial/index.md){.internal-link target=_blank}.
+
+Điều quan trọng là bằng việc sử dụng các kiểu dữ liệu chuẩn của Python (thay vì thêm các lớp, decorators,...), **FastAPI** sẽ thực hiện nhiều công việc cho bạn.
+
+!!! info
+    Nếu bạn đã đi qua toàn bộ các hướng dẫn và quay trở lại để tìm hiểu nhiều hơn về các kiểu dữ liệu, một tài nguyên tốt như <a href="https://mypy.readthedocs.io/en/latest/cheat_sheet_py3.html" class="external-link" target="_blank">"cheat sheet" từ `mypy`</a>.

From 1f0d9086b35096f2b508dea8544bb2bd86074eef Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 10 Aug 2023 15:53:06 +0000
Subject: [PATCH 093/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 39e04ca98..8ee9d1af5 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Vietnamese translation for `docs/vi/docs/python-types.md`. PR [#10047](https://github.com/tiangolo/fastapi/pull/10047) by [@magiskboy](https://github.com/magiskboy).
 * 🔧 Add sponsor Porter. PR [#10051](https://github.com/tiangolo/fastapi/pull/10051) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, add Jina back as bronze sponsor. PR [#10050](https://github.com/tiangolo/fastapi/pull/10050) by [@tiangolo](https://github.com/tiangolo).
 * ✏️ Fix typo in deprecation warnings in `fastapi/params.py`. PR [#9854](https://github.com/tiangolo/fastapi/pull/9854) by [@russbiggs](https://github.com/russbiggs).

From fe3eaf63e643ba178c7266aeb78a7751b8ca4171 Mon Sep 17 00:00:00 2001
From: Vladislav Kramorenko <85196001+Xewus@users.noreply.github.com>
Date: Thu, 10 Aug 2023 18:53:26 +0300
Subject: [PATCH 094/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Russian=20translat?=
 =?UTF-8?q?ion=20for=20`docs/ru/docs/deployment/docker.md`=20(#9971)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Yois4101 <119609381+Yois4101@users.noreply.github.com>
---
 docs/ru/docs/deployment/docker.md | 700 ++++++++++++++++++++++++++++++
 1 file changed, 700 insertions(+)
 create mode 100644 docs/ru/docs/deployment/docker.md

diff --git a/docs/ru/docs/deployment/docker.md b/docs/ru/docs/deployment/docker.md
new file mode 100644
index 000000000..f045ca944
--- /dev/null
+++ b/docs/ru/docs/deployment/docker.md
@@ -0,0 +1,700 @@
+# FastAPI и Docker-контейнеры
+
+При развёртывании приложений FastAPI, часто начинают с создания **образа контейнера на основе Linux**. Обычно для этого используют <a href="https://www.docker.com/" class="external-link" target="_blank">**Docker**</a>. Затем можно развернуть такой контейнер на сервере одним из нескольких способов.
+
+Использование контейнеров на основе Linux имеет ряд преимуществ, включая  **безопасность**, **воспроизводимость**, **простоту** и прочие.
+
+!!! tip "Подсказка"
+    Торопитесь или уже знакомы с этой технологией? Перепрыгните на раздел [Создать Docker-образ для FastAPI 👇](#docker-fastapi)
+
+<details>
+<summary>Развернуть Dockerfile 👀</summary>
+
+```Dockerfile
+FROM python:3.9
+
+WORKDIR /code
+
+COPY ./requirements.txt /code/requirements.txt
+
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
+
+COPY ./app /code/app
+
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
+
+# Если используете прокси-сервер, такой как Nginx или Traefik, добавьте --proxy-headers
+# CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80", "--proxy-headers"]
+```
+
+</details>
+
+## Что такое "контейнер"
+
+Контейнеризация - это **легковесный** способ упаковать приложение, включая все его зависимости и необходимые файлы, чтобы изолировать его от других контейнеров (других приложений и компонентов) работающих на этой же системе.
+
+Контейнеры, основанные на Linux, запускаются используя ядро Linux хоста (машины, виртуальной машины, облачного сервера и т.п.). Это значит, что они очень легковесные (по сравнению с полноценными виртуальными машинами, полностью эмулирующими работу операционной системы).
+
+Благодаря этому, контейнеры потребляют **малое количество ресурсов**, сравнимое с процессом запущенным напрямую (виртуальная машина потребует гораздо больше ресурсов).
+
+Контейнеры также имеют собственные запущенные **изолированные** процессы (но часто только один процесс), файловую систему и сеть, что упрощает развёртывание, разработку, управление доступом и т.п.
+
+## Что такое "образ контейнера"
+
+Для запуска **контейнера** нужен **образ контейнера**.
+
+Образ контейнера - это **замороженная** версия всех файлов, переменных окружения, программ и команд по умолчанию, необходимых для работы приложения. **Замороженный** - означает, что **образ** не запущен и не выполняется, это всего лишь упакованные вместе файлы и метаданные.
+
+В отличие от **образа контейнера**, хранящего неизменное содержимое, под термином **контейнер** подразумевают запущенный образ, то есть объёкт, который **исполняется**.
+
+Когда **контейнер** запущен (на основании **образа**), он может создавать и изменять файлы, переменные окружения и т.д. Эти изменения будут существовать только внутри контейнера, но не будут сохраняться в образе контейнера (не будут сохранены на диск).
+
+Образ контейнера можно сравнить с файлом, содержащем **программу**, например, как файл `main.py`.
+
+И **контейнер** (в отличие от **образа**) - это на самом деле выполняемый экземпляр образа, примерно как **процесс**. По факту, контейнер запущен только когда запущены его процессы (чаще, всего один процесс) и остановлен, когда запущенных процессов нет.
+
+## Образы контейнеров
+
+Docker является одним оз основных инструментов для создания **образов** и  **контейнеров** и управления ими.
+
+Существует общедоступный <a href="https://hub.docker.com/" class="external-link" target="_blank">Docker Hub</a> с подготовленными **официальными образами** многих инструментов, окружений, баз данных и приложений.
+
+К примеру, есть официальный <a href="https://hub.docker.com/_/python" class="external-link" target="_blank">образ Python</a>.
+
+Также там представлены и другие полезные образы, такие как базы данных:
+
+* <a href="https://hub.docker.com/_/postgres" class="external-link" target="_blank">PostgreSQL</a>
+* <a href="https://hub.docker.com/_/mysql" class="external-link" target="_blank">MySQL</a>
+* <a href="https://hub.docker.com/_/mongo" class="external-link" target="_blank">MongoDB</a>
+* <a href="https://hub.docker.com/_/redis" class="external-link" target="_blank">Redis</a>
+
+и т.п.
+
+Использование подготовленных образов значительно упрощает **комбинирование** и использование разных инструментов. Например, Вы можете попытаться использовать новую базу данных. В большинстве случаев можно использовать **официальный образ** и всего лишь указать переменные окружения.
+
+Таким образом, Вы можете изучить, что такое контейнеризация и Docker, и использовать полученные знания с разными инструментами и компонентами.
+
+Так, Вы можете запустить одновременно **множество контейнеров** с базой данных, Python-приложением, веб-сервером, React-приложением и соединить их вместе через внутреннюю сеть.
+
+Все системы управления контейнерами (такие, как Docker или Kubernetes) имеют встроенные возможности для организации такого сетевого взаимодействия.
+
+## Контейнеры и процессы
+
+Обычно **образ контейнера** содержит метаданные предустановленной программы или команду, которую следует выполнить при запуске **контейнера**. Также он может содержать параметры, передаваемые предустановленной программе. Похоже на то, как если бы Вы запускали такую программу через терминал.
+
+Когда **контейнер** запущен, он будет выполнять прописанные в нём команды и программы. Но Вы можете изменить его так, чтоб он выполнял другие команды и программы.
+
+Контейнер буде работать до тех пор, пока выполняется его **главный процесс** (команда или программа).
+
+В контейнере обычно выполняется **только один процесс**, но от его имени можно запустить другие процессы, тогда в этом же в контейнере будет выполняться **множество процессов**.
+
+Контейнер не считается запущенным, если в нём **не выполняется хотя бы один процесс**. Если главный процесс остановлен, значит и контейнер остановлен.
+
+## Создать Docker-образ для FastAPI
+
+Что ж, давайте ужё создадим что-нибудь! 🚀
+
+Я покажу Вам, как собирать **Docker-образ** для FastAPI **с нуля**, основываясь на **официальном образе Python**.
+
+Такой подход сгодится для **большинства случаев**, например:
+
+* Использование с **Kubernetes** или аналогичным инструментом
+* Запуск в **Raspberry Pi**
+* Использование в облачных сервисах, запускающих образы контейнеров для Вас и т.п.
+
+### Установить зависимости
+
+Обычно Вашему приложению необходимы **дополнительные библиотеки**, список которых находится в отдельном файле.
+
+На название и содержание такого файла влияет выбранный Вами инструмент **установки** этих библиотек (зависимостей).
+
+Чаще всего это простой файл `requirements.txt` с построчным перечислением библиотек и их версий.
+
+При этом Вы, для выбора версий, будете использовать те же идеи, что упомянуты на странице [О версиях FastAPI](./versions.md){.internal-link target=_blank}.
+
+Ваш файл `requirements.txt` может выглядеть как-то так:
+
+```
+fastapi>=0.68.0,<0.69.0
+pydantic>=1.8.0,<2.0.0
+uvicorn>=0.15.0,<0.16.0
+```
+
+Устанавливать зависимости проще всего с помощью `pip`:
+
+<div class="termy">
+
+```console
+$ pip install -r requirements.txt
+---> 100%
+Successfully installed fastapi pydantic uvicorn
+```
+
+</div>
+
+!!! info "Информация"
+    Существуют и другие инструменты управления зависимостями.
+
+    В этом же разделе, но позже, я покажу Вам пример использования Poetry. 👇
+
+### Создать приложение **FastAPI**
+
+* Создайте директорию `app` и перейдите в неё.
+* Создайте пустой файл `__init__.py`.
+* Создайте файл `main.py` и заполните его:
+
+```Python
+from typing import Union
+
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+def read_root():
+    return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+def read_item(item_id: int, q: Union[str, None] = None):
+    return {"item_id": item_id, "q": q}
+```
+
+### Dockerfile
+
+В этой же директории создайте файл `Dockerfile` и заполните его:
+
+```{ .dockerfile .annotate }
+# (1)
+FROM python:3.9
+
+# (2)
+WORKDIR /code
+
+# (3)
+COPY ./requirements.txt /code/requirements.txt
+
+# (4)
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
+
+# (5)
+COPY ./app /code/app
+
+# (6)
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
+```
+
+1. Начните с официального образа Python, который будет основой для образа приложения.
+
+2. Укажите, что в дальнейшем команды запускаемые в контейнере, будут выполняться в директории `/code`.
+
+    Инструкция создаст эту директорию внутри контейнера и мы поместим в неё файл `requirements.txt` и директорию `app`.
+
+3. Скопируете файл с зависимостями из текущей директории в `/code`.
+
+    Сначала копируйте **только** файл с зависимостями.
+
+    Этот файл **изменяется довольно редко**, Docker ищет изменения при постройке образа и если не находит, то использует **кэш**, в котором хранятся предыдущии версии сборки образа.
+
+4. Установите библиотеки перечисленные в файле с зависимостями.
+
+    Опция `--no-cache-dir` указывает `pip` не сохранять загружаемые библиотеки на локальной машине для использования их в случае повторной загрузки. В контейнере, в случае пересборки этого шага, они всё равно будут удалены.
+
+    !!! note "Заметка"
+        Опция `--no-cache-dir` нужна только для `pip`, она никак не влияет на Docker или контейнеры.
+
+    Опция `--upgrade` указывает `pip` обновить библиотеки, емли они уже установлены.
+
+    Ка и в предыдущем шаге с копированием файла, этот шаг также будет использовать **кэш Docker** в случае отсутствия изменений.
+
+    Использрвание кэша, особенно на этом шаге, позволит Вам **сэкономить** кучу времени при повторной сборке образа, так как зависимости будут сохранены в кеше, а не **загружаться и устанавливаться каждый раз**.
+
+5. Скопируйте директорию `./app` внутрь директории `/code` (в контейнере).
+
+    Так как в этой директории расположен код, который **часто изменяется**, то использование **кэша** на этом шаге будет наименее эффективно, а значит лучше поместить этот шаг **ближе к концу** `Dockerfile`, дабы не терять выгоду от оптимизации предыдущих шагов.
+
+6. Укажите **команду**, запускающую сервер `uvicorn`.
+
+    `CMD` принимает список строк, разделённых запятыми, но при выполнении объединит их через пробел, собрав из них одну команду, которую Вы могли бы написать в терминале.
+
+    Эта команда будет выполнена в **текущей рабочей директории**, а именно в директории `/code`, котоая указана командой `WORKDIR /code`.
+
+    Так как команда выполняется внутрии директории `/code`, в которую мы поместили папку `./app` с приложением, то **Uvicorn** сможет найти и **импортировать** объект `app` из файла `app.main`.
+
+!!! tip "Подсказка"
+    Если ткнёте на кружок с плюсом, то увидите пояснения. 👆
+
+На данном этапе структура проекта должны выглядеть так:
+
+```
+.
+├── app
+│   ├── __init__.py
+│   └── main.py
+├── Dockerfile
+└── requirements.txt
+```
+
+#### Использование прокси-сервера
+
+Если Вы запускаете контейнер за прокси-сервером завершения TLS (балансирующего нагрузку), таким как Nginx или Traefik, добавьте опцию `--proxy-headers`, которая укажет Uvicorn, что он работает позади прокси-сервера и может доверять заголовкам отправляемым им.
+
+```Dockerfile
+CMD ["uvicorn", "app.main:app", "--proxy-headers", "--host", "0.0.0.0", "--port", "80"]
+```
+
+#### Кэш Docker'а
+
+В нашем `Dockerfile` использована полезная хитрость, когда сначала копируется **только файл с зависимостями**, а не вся папка с кодом приложения.
+
+```Dockerfile
+COPY ./requirements.txt /code/requirements.txt
+```
+
+Docker и подобные ему инструменты **создают** образы контейнеров **пошагово**, добавляя **один слой над другим**, начиная с первой строки `Dockerfile` и добавляя файлы, создаваемые при выполнении каждой инструкции из `Dockerfile`.
+
+При создании образа используется **внутренний кэш** и если в файлах нет изменений с момента последней сборки образа, то будет **переиспользован** ранее созданный слой образа, а не повторное копирование файлов и создание слоя с нуля.
+Заметьте, что так как слой следующего шага зависит от слоя предыдущего, то изменения внесённые в промежуточный слой, также повлияют на последующие.
+
+Избегание копирования файлов не обязательно улучшит ситуацию, но использование кэша на одном шаге, позволит **использовать кэш и на следующих шагах**. Например, можно использовать кэш при установке зависимостей:
+
+```Dockerfile
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
+```
+
+Файл со списком зависимостей **изменяется довольно редко**. Так что выполнив команду копирования только этого файла, Docker сможет **использовать кэш** на этом шаге.
+
+А затем **использовать кэш и на следующем шаге**, загружающем и устанавливающем зависимости.  И вот тут-то мы и **сэкономим много времени**. ✨ ...а не будем томиться в тягостном ожидании. 😪😆
+
+Для загрузки и установки необходимых библиотек **может понадобиться несколько минут**, но использование **кэша** занимает несколько **секунд** максимум.
+
+И так как во время разработки Вы будете часто пересобирать контейнер для проверки работоспособности внесённых изменений, то сэкономленные минуты сложатся в часы, а то и дни.
+
+Так как папка с кодом приложения **изменяется чаще всего**, то мы расположили её в конце `Dockerfile`, ведь после внесённых в код изменений кэш не будет использован на этом и следующих шагах.
+
+```Dockerfile
+COPY ./app /code/app
+```
+
+### Создать Docker-образ
+
+Теперь, когда все файлы на своих местах, давайте создадим образ контейнера.
+
+* Перейдите в директорию проекта (в ту, где расположены `Dockerfile` и папка `app` с приложением).
+* Создай образ приложения FastAPI:
+
+<div class="termy">
+
+```console
+$ docker build -t myimage .
+
+---> 100%
+```
+
+</div>
+
+!!! tip "Подсказка"
+    Обратите внимание, что в конце написана точка -  `.`, это то же самое что и `./`, тем самым мы указываем Docker директорию, из которой нужно выполнять сборку образа контейнера.
+
+    В данном случае это та же самая директория (`.`).
+
+### Запуск Docker-контейнера
+
+* Запустите контейнер, основанный на Вашем образе:
+
+<div class="termy">
+
+```console
+$ docker run -d --name mycontainer -p 80:80 myimage
+```
+
+</div>
+
+## Проверка
+
+Вы можете проверить, что Ваш Docker-контейнер работает перейдя по ссылке: <a href="http://192.168.99.100/items/5?q=somequery" class="external-link" target="_blank">http://192.168.99.100/items/5?q=somequery</a> или <a href="http://127.0.0.1/items/5?q=somequery" class="external-link" target="_blank">http://127.0.0.1/items/5?q=somequery</a> (или похожей, которую использует Ваш Docker-хост).
+
+Там Вы увидите:
+
+```JSON
+{"item_id": 5, "q": "somequery"}
+```
+
+## Интерактивная документация API
+
+Теперь перейдите по ссылке <a href="http://192.168.99.100/docs" class="external-link" target="_blank">http://192.168.99.100/docs</a> или <a href="http://127.0.0.1/docs" class="external-link" target="_blank">http://127.0.0.1/docs</a> (или похожей, которую использует Ваш Docker-хост).
+
+Здесь Вы увидите автоматическую интерактивную документацию API (предоставляемую <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Swagger UI</a>):
+
+![Swagger UI](https://fastapi.tiangolo.com/img/index/index-01-swagger-ui-simple.png)
+
+## Альтернативная документация API
+
+Также Вы можете перейти по ссылке <a href="http://192.168.99.100/redoc" class="external-link" target="_blank">http://192.168.99.100/redoc</a> or <a href="http://127.0.0.1/redoc" class="external-link" target="_blank">http://127.0.0.1/redoc</a> (или похожей, которую использует Ваш Docker-хост).
+
+Здесь Вы увидите альтернативную автоматическую документацию API (предоставляемую <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a>):
+
+![ReDoc](https://fastapi.tiangolo.com/img/index/index-02-redoc-simple.png)
+
+## Создание Docker-образа на основе однофайлового приложения FastAPI
+
+Если Ваше приложение FastAPI помещено в один файл, например, `main.py` и структура Ваших файлов похожа на эту:
+
+```
+.
+├── Dockerfile
+├── main.py
+└── requirements.txt
+```
+
+Вам нужно изменить в `Dockerfile` соответствующие пути копирования файлов:
+
+```{ .dockerfile .annotate hl_lines="10  13" }
+FROM python:3.9
+
+WORKDIR /code
+
+COPY ./requirements.txt /code/requirements.txt
+
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
+
+# (1)
+COPY ./main.py /code/
+
+# (2)
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
+```
+
+1. Скопируйте непосредственно файл `main.py` в директорию `/code` (не указывайте `./app`).
+
+2. При запуске Uvicorn укажите ему, что объект `app` нужно импортировать из файла `main` (вместо импортирования из `app.main`).
+
+Настройте Uvicorn на использование `main` вместо `app.main` для импорта объекта `app`.
+
+## Концепции развёртывания
+
+Давайте вспомним о [Концепциях развёртывания](./concepts.md){.internal-link target=_blank} и применим их к контейнерам.
+
+Контейнеры - это, в основном, инструмент упрощающий **сборку и развёртывание** приложения и они не обязыают к применению какой-то определённой **концепции развёртывания**, а значит мы можем выбирать нужную стратегию.
+
+**Хорошая новость** в том, что независимо от выбранной стратегии, мы всё равно можем покрыть все концепции развёртывания. 🎉
+
+Рассмотрим эти **концепции развёртывания** применительно к контейнерам:
+
+* Использование более безопасного протокола HTTPS
+* Настройки запуска приложения
+* Перезагрузка приложения
+* Запуск нескольких экземпляров приложения
+* Управление памятью
+* Использование перечисленных функций перед запуском приложения
+
+## Использование более безопасного протокола HTTPS
+
+Если мы определимся, что **образ контейнера** будет содержать только приложение FastAPI, то работу с HTTPS можно организовать **снаружи** контейнера при помощи другого инструмента.
+
+Это может быть другой контейнер, в котором есть, например, <a href="https://traefik.io/" class="external-link" target="_blank">Traefik</a>, работающий с **HTTPS** и **самостоятельно** обновляющий **сертификаты**.
+
+!!! tip "Подсказка"
+    Traefik совместим с Docker, Kubernetes и им подобными инструментами. Он очень прост в установке и настройке использования HTTPS для Ваших контейнеров.
+
+В качестве альтернативы, работу с HTTPS можно доверить облачному провайдеру, если он предоставляет такую услугу.
+
+## Настройки запуска и перезагрузки приложения
+
+Обычно **запуском контейнера с приложением** занимается какой-то отдельный инструмент.
+
+Это может быть сам **Docker**, **Docker Compose**, **Kubernetes**, **облачный провайдер** и т.п.
+
+В большинстве случаев это простейшие настройки запуска и перезагрузки приложения (при падении). Например, команде запуска Docker-контейнера можно добавить опцию `--restart`.
+
+Управление запуском и перезагрузкой приложений без использования контейнеров - весьма затруднительно. Но при **работе с контейнерами** - это всего лишь функционал доступный по умолчанию. ✨
+
+## Запуск нескольких экземпляров приложения - Указание количества процессов
+
+Если у Вас есть <abbr title="Несколько серверов настроенных для совместной работы.">кластер</abbr> машин под управлением **Kubernetes**, Docker Swarm Mode, Nomad или аналогичной сложной системой оркестрации контейнеров, скорее всего, вместо использования менеджера процессов (типа Gunicorn и его воркеры) в каждом контейнере, Вы захотите **управлять количеством запущенных экземпляров приложения** на **уровне кластера**.
+
+В любую из этих систем управления контейнерами обычно встроен способ управления **количеством запущенных контейнеров** для распределения **нагрузки** от входящих запросов на **уровне кластера**.
+
+В такой ситуации Вы, вероятно, захотите создать **образ Docker**, как [описано выше](#dockerfile), с установленными зависимостями и запускающий **один процесс Uvicorn** вместо того, чтобы запускать Gunicorn управляющий несколькими воркерами Uvicorn.
+
+### Балансировщик нагрузки
+
+Обычно при использовании контейнеров один компонент **прослушивает главный порт**. Это может быть контейнер содержащий **прокси-сервер завершения работы TLS** для работы с **HTTPS** или что-то подобное.
+
+Поскольку этот компонент **принимает запросы** и равномерно **распределяет** их между компонентами, его также называют **балансировщиком нагрузки**.
+
+!!! tip "Подсказка"
+    **Прокси-сервер завершения работы TLS** одновременно может быть **балансировщиком нагрузки**.
+
+Система оркестрации, которую Вы используете для запуска и управления контейнерами, имеет встроенный инструмент **сетевого взаимодействия** (например, для передачи HTTP-запросов) между контейнерами с Вашими приложениями и **балансировщиком нагрузки** (который также может быть **прокси-сервером**).
+
+### Один балансировщик - Множество контейнеров
+
+При работе с **Kubernetes** или аналогичными системами оркестрации использование их внутреннней сети позволяет иметь один **балансировщик нагрузки**, который прослушивает **главный** порт и передаёт запросы **множеству запущенных контейнеров** с Вашими приложениями.
+
+В каждом из контейнеров обычно работает **только один процесс** (например, процесс Uvicorn управляющий Вашим приложением FastAPI). Контейнеры могут быть **идентичными**, запущенными на основе одного и того же образа, но у каждого будут свои отдельные процесс, память и т.п. Таким образом мы получаем преимущества **распараллеливания** работы по **разным ядрам** процессора или даже **разным машинам**.
+
+Система управления контейнерами с **балансировщиком нагрузки** будет **распределять запросы** к контейнерам с приложениями **по очереди**. То есть каждый запрос будет обработан одним из множества **одинаковых контейнеров** с одним и тем же приложением.
+
+**Балансировщик нагрузки** может обрабатывать запросы к *разным* приложениям, расположенным в Вашем кластере (например, если у них разные домены или префиксы пути) и передавать запросы нужному контейнеру с требуемым приложением.
+
+### Один процесс на контейнер
+
+В этом варианте **в одном контейнере будет запущен только один процесс (Uvicorn)**, а управление изменением количества запущенных копий приложения происходит на уровне кластера.
+
+Здесь **не нужен** менеджер процессов типа Gunicorn, управляющий процессами Uvicorn, или же Uvicorn, управляющий другими процессами Uvicorn. Достаточно **только одного процесса Uvicorn** на контейнер (но запуск нескольких процессов не запрещён).
+
+Использование менеджера процессов (Gunicorn или Uvicorn) внутри контейнера только добавляет **излишнее усложнение**, так как управление следует осуществлять системой оркестрации.
+
+### <a name="special-cases"></a>Множество процессов внутри контейнера для особых случаев</a>
+
+Безусловно, бывают **особые случаи**, когда может понадобится внутри контейнера запускать **менеджер процессов Gunicorn**, управляющий несколькими **процессами Uvicorn**.
+
+Для таких случаев Вы можете использовать **официальный Docker-образ** (прим. пер: - *здесь и далее на этой странице, если Вы встретите сочетание "официальный Docker-образ" без уточнений, то автор имеет в виду именно предоставляемый им образ*), где в качестве менеджера процессов используется **Gunicorn**, запускающий несколько **процессов Uvicorn** и некоторые настройки по умолчанию, автоматически устанавливающие количество запущенных процессов в зависимости от количества ядер Вашего процессора. Я расскажу Вам об этом подробнее тут: [Официальный Docker-образ со встроенными Gunicorn и Uvicorn](#docker-gunicorn-uvicorn).
+
+Некоторые примеры подобных случаев:
+
+#### Простое приложение
+
+Вы можете использовать менеджер процессов внутри контейнера, если Ваше приложение **настолько простое**, что у Вас нет необходимости (по крайней мере, пока нет) в тщательных настройках количества процессов и Вам достаточно имеющихся настроек по умолчанию (если используется официальный Docker-образ) для запуска приложения **только на одном сервере**, а не в кластере.
+
+#### Docker Compose
+
+С помощью **Docker Compose** можно разворачивать несколько контейнеров на **одном сервере** (не кластере), но при это у Вас не будет простого способа управления количеством запущенных контейнеров с одновременным сохранением общей сети и **балансировки нагрузки**.
+
+В этом случае можно использовать **менеджер процессов**, управляющий **несколькими процессами**, внутри **одного контейнера**.
+
+#### Prometheus и прочие причины
+
+У Вас могут быть и **другие причины**, когда использование **множества процессов** внутри **одного контейнера** будет проще, нежели запуск **нескольких контейнеров** с **единственным процессом** в каждом из них.
+
+Например (в зависимости от конфигурации), у Вас могут быть инструменты подобные экспортёру Prometheus, которые должны иметь доступ к **каждому запросу** приходящему в контейнер.
+
+Если у Вас будет **несколько контейнеров**, то Prometheus, по умолчанию,  **при сборе метрик** получит их **только с одного контейнера**, который обрабатывает конкретный запрос, вместо **сбора метрик** со всех работающих контейнеров.
+
+В таком случае может быть проще иметь **один контейнер** со **множеством процессов**, с нужным инструментом (таким как экспортёр Prometheus) в этом же контейнере и собирающем метрики со всех внутренних процессов этого контейнера.
+
+---
+
+Самое главное - **ни одно** из перечисленных правил не является **высеченным в камне** и Вы не обязаны слепо их повторять. Вы можете использовать эти идеи при **рассмотрении Вашего конкретного случая** и самостоятельно решать, какая из концепции подходит лучше:
+
+* Использование более безопасного протокола HTTPS
+* Настройки запуска приложения
+* Перезагрузка приложения
+* Запуск нескольких экземпляров приложения
+* Управление памятью
+* Использование перечисленных функций перед запуском приложения
+
+## Управление памятью
+
+При **запуске одного процесса на контейнер** Вы получаете относительно понятный, стабильный и ограниченный объём памяти, потребляемый одним контейнером.
+
+Вы можете установить аналогичные ограничения по памяти при конфигурировании своей системы управления контейнерами (например, **Kubernetes**). Таким образом система сможет **изменять количество контейнеров** на **доступных ей машинах** приводя в соответствие количество памяти нужной контейнерам с количеством памяти доступной в кластере (наборе доступных машин).
+
+Если у Вас **простенькое** приложение, вероятно у Вас не будет **необходимости** устанавливать жёсткие ограничения на выделяемую ему память. Но если приложение **использует много памяти** (например, оно использует модели **машинного обучения**), Вам следует проверить, как много памяти ему требуется и отрегулировать **количество контейнеров** запущенных на **каждой машине** (может быть даже добавить машин в кластер).
+
+Если Вы запускаете **несколько процессов в контейнере**, то должны быть уверены, что эти процессы не **займут памяти больше**, чем доступно для контейнера.
+
+## Подготовительные шаги при запуске контейнеров
+
+Есть два основных подхода, которые Вы можете использовать при запуске контейнеров (Docker, Kubernetes и т.п.).
+
+### Множество контейнеров
+
+Когда Вы запускаете **множество контейнеров**, в каждом из которых работает **только один процесс** (например, в кластере **Kubernetes**), может возникнуть необходимость иметь **отдельный контейнер**, который осуществит **предварительные шаги перед запуском** остальных контейнеров (например, применяет миграции к базе данных).
+
+!!! info "Информация"
+    При использовании Kubernetes, это может быть <a href="https://kubernetes.io/docs/concepts/workloads/pods/init-containers/" class="external-link" target="_blank">Инициализирующий контейнер</a>.
+
+При отсутствии такой необходимости (допустим, не нужно применять миграции к базе данных, а только проверить, что она готова принимать соединения), Вы можете проводить такую проверку в каждом контейнере перед запуском его основного процесса и запускать все контейнеры **одновременно**.
+
+### Только один контейнер
+
+Если у Вас несложное приложение для работы которого достаточно **одного контейнера**, но в котором работает **несколько процессов** (или один процесс), то прохождение предварительных шагов можно осуществить в этом же контейнере до запуска основного процесса. Официальный Docker-образ поддерживает такие действия.
+
+## Официальный Docker-образ с Gunicorn и Uvicorn
+
+Я подготовил для Вас Docker-образ, в который включён Gunicorn управляющий процессами (воркерами) Uvicorn, в соответствии с концепциями рассмотренными в предыдущей главе: [Рабочие процессы сервера (воркеры) - Gunicorn совместно с Uvicorn](./server-workers.md){.internal-link target=_blank}.
+
+Этот образ может быть полезен для ситуаций описанных тут: [Множество процессов внутри контейнера для особых случаев](#special-cases).
+
+* <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
+
+!!! warning "Предупреждение"
+    Скорее всего у Вас **нет необходимости** в использовании этого образа или подобного ему и лучше создать свой образ с нуля как описано тут: [Создать Docker-образ для FastAPI](#docker-fastapi).
+
+В этом образе есть **автоматический** механизм подстройки для запуска **необходимого количества процессов** в соответствии с доступным количеством ядер процессора.
+
+В нём установлены **разумные значения по умолчанию**, но можно изменять и обновлять конфигурацию с помощью **переменных окружения** или конфигурационных файлов.
+
+Он также поддерживает прохождение <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker#pre_start_path" class="external-link" target="_blank">**Подготовительных шагов при запуске контейнеров**</a> при помощи скрипта.
+
+!!! tip "Подсказка"
+    Для просмотра всех возможных настроек перейдите на страницу этого Docker-образа: <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
+
+### Количество процессов в официальном Docker-образе
+
+**Количество процессов** в этом образе **вычисляется автоматически** и зависит от доступного количества **ядер** центрального процессора.
+
+Это означает, что он будет пытаться **выжать** из процессора как можно больше **производительности**.
+
+Но Вы можете изменять и обновлять конфигурацию с помощью **переменных окружения** и т.п.
+
+Поскольку количество процессов зависит от процессора, на котором работает контейнер, **объём потребляемой памяти** также будет зависеть от этого.
+
+А значит, если Вашему приложению требуется много оперативной памяти (например, оно использует модели машинного обучения) и Ваш сервер имеет центральный процессор с большим количеством ядер, но **не слишком большим объёмом оперативной памяти**, то может дойти до того, что контейнер попытается занять памяти больше, чем доступно, из-за чего будет падение производительности (или сервер вовсе упадёт). 🚨
+
+
+### Написание  `Dockerfile`
+
+Итак, теперь мы можем написать  `Dockerfile` основанный на этом официальном Docker-образе:
+
+```Dockerfile
+FROM tiangolo/uvicorn-gunicorn-fastapi:python3.9
+
+COPY ./requirements.txt /app/requirements.txt
+
+RUN pip install --no-cache-dir --upgrade -r /app/requirements.txt
+
+COPY ./app /app
+```
+
+### Большие приложения
+
+Если Вы успели ознакомиться с разделом [Приложения содержащие много файлов](../tutorial/bigger-applications.md){.internal-link target=_blank}, состоящие из множества файлов, Ваш Dockerfile может выглядеть так:
+
+```Dockerfile hl_lines="7"
+FROM tiangolo/uvicorn-gunicorn-fastapi:python3.9
+
+COPY ./requirements.txt /app/requirements.txt
+
+RUN pip install --no-cache-dir --upgrade -r /app/requirements.txt
+
+COPY ./app /app/app
+```
+
+### Как им пользоваться
+
+Если Вы используете **Kubernetes** (или что-то вроде того), скорее всего Вам **не нужно** использовать официальный Docker-образ (или другой похожий) в качестве основы, так как управление **количеством запущенных контейнеров** должно быть настроено на уровне кластера. В таком случае лучше **создать образ с нуля**, как описано в разделе Создать [Docker-образ для FastAPI](#docker-fastapi).
+
+Официальный образ может быть полезен в отдельных случаях, описанных выше в разделе [Множество процессов внутри контейнера для особых случаев](#special-cases). Например, если Ваше приложение **достаточно простое**, не требует запуска в кластере и способно уместиться в один контейнер, то его настройки по умолчанию будут работать довольно хорошо. Или же Вы развертываете его с помощью **Docker Compose**, работаете на одном сервере и т. д
+
+## Развёртывание образа контейнера
+
+После создания образа контейнера существует несколько способов его развёртывания.
+
+Например:
+
+* С использованием **Docker Compose** при развёртывании на одном сервере
+* С использованием **Kubernetes** в кластере
+* С использованием режима Docker Swarm в кластере
+* С использованием других инструментов, таких как Nomad
+* С использованием облачного сервиса, который будет управлять разворачиванием Вашего контейнера
+
+## Docker-образ и Poetry
+
+Если Вы пользуетесь <a href="https://python-poetry.org/" class="external-link" target="_blank">Poetry</a> для управления зависимостями Вашего проекта, то можете использовать многоэтапную сборку образа:
+
+```{ .dockerfile .annotate }
+# (1)
+FROM python:3.9 as requirements-stage
+
+# (2)
+WORKDIR /tmp
+
+# (3)
+RUN pip install poetry
+
+# (4)
+COPY ./pyproject.toml ./poetry.lock* /tmp/
+
+# (5)
+RUN poetry export -f requirements.txt --output requirements.txt --without-hashes
+
+# (6)
+FROM python:3.9
+
+# (7)
+WORKDIR /code
+
+# (8)
+COPY --from=requirements-stage /tmp/requirements.txt /code/requirements.txt
+
+# (9)
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
+
+# (10)
+COPY ./app /code/app
+
+# (11)
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
+```
+
+1. Это первый этап, которому мы дадим имя `requirements-stage`.
+
+2. Установите директорию `/tmp` в качестве рабочей директории.
+
+    В ней будет создан файл `requirements.txt`
+
+3. На этом шаге установите Poetry.
+
+4. Скопируйте файлы `pyproject.toml` и `poetry.lock` в директорию `/tmp`.
+
+    Поскольку название файла написано как `./poetry.lock*` (с `*` в конце), то ничего не сломается, если такой файл не будет найден.
+
+5. Создайте файл `requirements.txt`.
+
+6. Это второй (и последний) этап сборки, который и создаст окончательный образ контейнера.
+
+7. Установите директорию `/code` в качестве рабочей.
+
+8. Скопируйте файл `requirements.txt` в директорию `/code`.
+
+    Этот файл находится в образе, созданном на предыдущем этапе, которому мы дали имя requirements-stage, потому при копировании нужно написать `--from-requirements-stage`.
+
+9.  Установите зависимости, указанные в файле `requirements.txt`.
+
+10. Скопируйте папку `app` в папку `/code`.
+
+11. Запустите `uvicorn`, указав ему использовать объект `app`, расположенный в `app.main`.
+
+!!! tip "Подсказка"
+    Если ткнёте на кружок с плюсом, то увидите объяснения, что происходит в этой строке.
+
+**Этапы сборки Docker-образа** являются частью `Dockerfile` и работают как **временные образы контейнеров**. Они нужны только для создания файлов, используемых в дальнейших этапах.
+
+Первый этап был нужен только для **установки Poetry** и **создания файла `requirements.txt`**, в которым прописаны зависимости Вашего проекта, взятые из файла `pyproject.toml`.
+
+На **следующем этапе** `pip` будет использовать файл `requirements.txt`.
+
+В итоговом образе будет содержаться **только последний этап сборки**, предыдущие этапы будут отброшены.
+
+При использовании Poetry, имеет смысл использовать **многоэтапную сборку Docker-образа**, потому что на самом деле Вам не нужен Poetry и его зависимости в окончательном образе контейнера, Вам **нужен только** сгенерированный файл `requirements.txt` для установки зависимостей Вашего проекта.
+
+А на последнем этапе, придерживаясь описанных ранее правил, создаётся итоговый образ
+
+### Использование прокси-сервера завершения TLS и Poetry
+
+И снова повторюсь, если используете прокси-сервер (балансировщик нагрузки), такой, как Nginx или Traefik, добавьте в команду запуска опцию `--proxy-headers`:
+
+```Dockerfile
+CMD ["uvicorn", "app.main:app", "--proxy-headers", "--host", "0.0.0.0", "--port", "80"]
+```
+
+## Резюме
+
+При помощи систем контейнеризации (таких, как **Docker** и **Kubernetes**), становится довольно просто обрабатывать все **концепции развертывания**:
+
+* Использование более безопасного протокола HTTPS
+* Настройки запуска приложения
+* Перезагрузка приложения
+* Запуск нескольких экземпляров приложения
+* Управление памятью
+* Использование перечисленных функций перед запуском приложения
+
+В большинстве случаев Вам, вероятно, не нужно использовать какой-либо базовый образ, **лучше создать образ контейнера с нуля** на основе официального Docker-образа Python.
+
+Позаботившись о **порядке написания** инструкций в `Dockerfile`, Вы сможете использовать **кэш Docker'а**, **минимизировав время сборки**, максимально повысив свою производительность (и избежать скуки). 😎
+
+В некоторых особых случаях вы можете использовать официальный образ Docker для FastAPI. 🤓

From 5c2a155809aced43e6eae6b90ac08daaa2ca4e4f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 10 Aug 2023 15:55:32 +0000
Subject: [PATCH 095/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 8ee9d1af5..b40b68ba3 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Russian translation for `docs/ru/docs/deployment/docker.md`. PR [#9971](https://github.com/tiangolo/fastapi/pull/9971) by [@Xewus](https://github.com/Xewus).
 * 🌐 Add Vietnamese translation for `docs/vi/docs/python-types.md`. PR [#10047](https://github.com/tiangolo/fastapi/pull/10047) by [@magiskboy](https://github.com/magiskboy).
 * 🔧 Add sponsor Porter. PR [#10051](https://github.com/tiangolo/fastapi/pull/10051) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, add Jina back as bronze sponsor. PR [#10050](https://github.com/tiangolo/fastapi/pull/10050) by [@tiangolo](https://github.com/tiangolo).

From e6afc5911b98bfa2ad2240864929a3c3e43929a2 Mon Sep 17 00:00:00 2001
From: Rostyslav <rostik1410@users.noreply.github.com>
Date: Thu, 10 Aug 2023 18:58:13 +0300
Subject: [PATCH 096/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Ukrainian=20transl?=
 =?UTF-8?q?ation=20for=20`docs/uk/docs/tutorial/cookie-params.md`=20(#1003?=
 =?UTF-8?q?2)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/uk/docs/tutorial/cookie-params.md | 96 ++++++++++++++++++++++++++
 1 file changed, 96 insertions(+)
 create mode 100644 docs/uk/docs/tutorial/cookie-params.md

diff --git a/docs/uk/docs/tutorial/cookie-params.md b/docs/uk/docs/tutorial/cookie-params.md
new file mode 100644
index 000000000..2b0e8993c
--- /dev/null
+++ b/docs/uk/docs/tutorial/cookie-params.md
@@ -0,0 +1,96 @@
+# Параметри Cookie
+
+Ви можете визначити параметри Cookie таким же чином, як визначаються параметри `Query` і `Path`.
+
+## Імпорт `Cookie`
+
+Спочатку імпортуйте `Cookie`:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        Бажано використовувати `Annotated` версію, якщо це можливо.
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        Бажано використовувати `Annotated` версію, якщо це можливо.
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001.py!}
+    ```
+
+## Визначення параметрів `Cookie`
+
+Потім визначте параметри cookie, використовуючи таку ж конструкцію як для `Path` і `Query`.
+
+Перше значення це значення за замовчуванням, ви можете також передати всі додаткові параметри валідації чи анотації:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        Бажано використовувати `Annotated` версію, якщо це можливо.
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        Бажано використовувати `Annotated` версію, якщо це можливо.
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/cookie_params/tutorial001.py!}
+    ```
+
+!!! note "Технічні Деталі"
+    `Cookie` це "сестра" класів `Path` і `Query`. Вони наслідуються від одного батьківського класу `Param`.
+    Але пам'ятайте, що коли ви імпортуєте `Query`, `Path`, `Cookie` та інше з `fastapi`, це фактично функції, що повертають спеціальні класи.
+
+!!! info
+    Для визначення cookies ви маєте використовувати `Cookie`, тому що в іншому випадку параметри будуть інтерпритовані, як параметри запиту.
+
+## Підсумки
+
+Визначайте cookies за допомогою `Cookie`, використовуючи той же спільний шаблон, що і `Query` та `Path`.

From 78f38c6bfda67b16d1f84ad6981ffb90a2936679 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 10 Aug 2023 15:59:15 +0000
Subject: [PATCH 097/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b40b68ba3..868628ae8 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/cookie-params.md`. PR [#10032](https://github.com/tiangolo/fastapi/pull/10032) by [@rostik1410](https://github.com/rostik1410).
 * 🌐 Add Russian translation for `docs/ru/docs/deployment/docker.md`. PR [#9971](https://github.com/tiangolo/fastapi/pull/9971) by [@Xewus](https://github.com/Xewus).
 * 🌐 Add Vietnamese translation for `docs/vi/docs/python-types.md`. PR [#10047](https://github.com/tiangolo/fastapi/pull/10047) by [@magiskboy](https://github.com/magiskboy).
 * 🔧 Add sponsor Porter. PR [#10051](https://github.com/tiangolo/fastapi/pull/10051) by [@tiangolo](https://github.com/tiangolo).

From 47166ed56c4b431bf9449b83ebfbb96ad10dd230 Mon Sep 17 00:00:00 2001
From: Rostyslav <rostik1410@users.noreply.github.com>
Date: Mon, 14 Aug 2023 12:10:06 +0300
Subject: [PATCH 098/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Ukrainian=20transl?=
 =?UTF-8?q?ation=20for=20`docs/uk/docs/fastapi-people.md`=20(#10059)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/uk/docs/fastapi-people.md | 178 +++++++++++++++++++++++++++++++++
 1 file changed, 178 insertions(+)
 create mode 100644 docs/uk/docs/fastapi-people.md

diff --git a/docs/uk/docs/fastapi-people.md b/docs/uk/docs/fastapi-people.md
new file mode 100644
index 000000000..b32f0e5ce
--- /dev/null
+++ b/docs/uk/docs/fastapi-people.md
@@ -0,0 +1,178 @@
+# Люди FastAPI
+
+FastAPI має дивовижну спільноту, яка вітає людей різного походження.
+
+## Творець – Супроводжувач
+
+Привіт! 👋
+
+Це я:
+
+{% if people %}
+<div class="user-list user-list-center">
+{% for user in people.maintainers %}
+
+<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a> <div class="count">Answers: {{ user.answers }}</div><div class="count">Pull Requests: {{ user.prs }}</div></div>
+{% endfor %}
+
+</div>
+{% endif %}
+
+Я - творець і супроводжувач **FastAPI**. Детальніше про це можна прочитати в [Довідка FastAPI - Отримати довідку - Зв'язатися з автором](help-fastapi.md#connect-with-the-author){.internal-link target=_blank}.
+
+...Але тут я хочу показати вам спільноту.
+
+---
+
+**FastAPI** отримує велику підтримку від спільноти. І я хочу відзначити їхній внесок.
+
+Це люди, які:
+
+* [Допомагають іншим із проблемами (запитаннями) у GitHub](help-fastapi.md#help-others-with-issues-in-github){.internal-link target=_blank}.
+* [Створюють пул реквести](help-fastapi.md#create-a-pull-request){.internal-link target=_blank}.
+* Переглядають пул реквести, [особливо важливо для перекладів](contributing.md#translations){.internal-link target=_blank}.
+
+Оплески їм. 👏 🙇
+
+## Найбільш активні користувачі минулого місяця
+
+Це користувачі, які [найбільше допомагали іншим із проблемами (запитаннями) у GitHub](help-fastapi.md#help-others-with-issues-in-github){.internal-link target=_blank} протягом минулого місяця. ☕
+
+{% if people %}
+<div class="user-list user-list-center">
+{% for user in people.last_month_active %}
+
+<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a> <div class="count">Issues replied: {{ user.count }}</div></div>
+{% endfor %}
+
+</div>
+{% endif %}
+
+## Експерти
+
+Ось **експерти FastAPI**. 🤓
+
+Це користувачі, які [найбільше допомагали іншим із проблемами (запитаннями) у GitHub](help-fastapi.md#help-others-with-issues-in-github){.internal-link target=_blank} протягом *всього часу*.
+
+Вони зарекомендували себе як експерти, допомагаючи багатьом іншим. ✨
+
+{% if people %}
+<div class="user-list user-list-center">
+{% for user in people.experts %}
+
+<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a> <div class="count">Issues replied: {{ user.count }}</div></div>
+{% endfor %}
+
+</div>
+{% endif %}
+
+## Найкращі контрибютори
+
+Ось **Найкращі контрибютори**. 👷
+
+Ці користувачі [створили найбільшу кількість пул реквестів](help-fastapi.md#create-a-pull-request){.internal-link target=_blank} які були *змержені*.
+
+Вони надали програмний код, документацію, переклади тощо. 📦
+
+{% if people %}
+<div class="user-list user-list-center">
+{% for user in people.top_contributors %}
+
+<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a> <div class="count">Pull Requests: {{ user.count }}</div></div>
+{% endfor %}
+
+</div>
+{% endif %}
+
+Є багато інших контрибюторів (більше сотні), їх усіх можна побачити на сторінці <a href="https://github.com/tiangolo/fastapi/graphs/contributors" class="external-link" target="_blank">FastAPI GitHub Contributors</a>. 👷
+
+## Найкращі рецензенти
+
+Ці користувачі є **Найкращими рецензентами**. 🕵️
+
+### Рецензенти на переклади
+
+Я розмовляю лише кількома мовами (і не дуже добре 😅). Отже, рецензенти – це ті, хто має [**повноваження схвалювати переклади**](contributing.md#translations){.internal-link target=_blank} документації. Без них не було б документації кількома іншими мовами.
+
+---
+
+**Найкращі рецензенти** 🕵️ переглянули більшість пул реквестів від інших, забезпечуючи якість коду, документації і особливо **перекладів**.
+
+{% if people %}
+<div class="user-list user-list-center">
+{% for user in people.top_reviewers %}
+
+<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a> <div class="count">Reviews: {{ user.count }}</div></div>
+{% endfor %}
+
+</div>
+{% endif %}
+
+## Спонсори
+
+Це **Спонсори**. 😎
+
+Вони підтримують мою роботу з **FastAPI** (та іншими), переважно через <a href="https://github.com/sponsors/tiangolo" class="external-link" target="_blank">GitHub Sponsors</a>.
+
+{% if sponsors %}
+
+{% if sponsors.gold %}
+
+### Золоті спонсори
+
+{% for sponsor in sponsors.gold -%}
+<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a>
+{% endfor %}
+{% endif %}
+
+{% if sponsors.silver %}
+
+### Срібні спонсори
+
+{% for sponsor in sponsors.silver -%}
+<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a>
+{% endfor %}
+{% endif %}
+
+{% if sponsors.bronze %}
+
+### Бронзові спонсори
+
+{% for sponsor in sponsors.bronze -%}
+<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a>
+{% endfor %}
+{% endif %}
+
+{% endif %}
+
+### Індивідуальні спонсори
+
+{% if github_sponsors %}
+{% for group in github_sponsors.sponsors %}
+
+<div class="user-list user-list-center">
+
+{% for user in group %}
+{% if user.login not in sponsors_badge.logins %}
+
+<div class="user"><a href="{{ user.url }}" target="_blank"><div class="avatar-wrapper"><img src="{{ user.avatarUrl }}"/></div><div class="title">@{{ user.login }}</div></a></div>
+
+{% endif %}
+{% endfor %}
+
+</div>
+
+{% endfor %}
+{% endif %}
+
+## Про дані - технічні деталі
+
+Основна мета цієї сторінки – висвітлити зусилля спільноти, щоб допомогти іншим.
+
+Особливо враховуючи зусилля, які зазвичай менш помітні, а в багатьох випадках більш важкі, як-от допомога іншим із проблемами та перегляд пул реквестів перекладів.
+
+Дані розраховуються щомісяця, ви можете ознайомитися з <a href="https://github.com/tiangolo/fastapi/blob/master/.github/actions/people/app/main.py" class="external-link" target="_blank">вихідним кодом тут</a>.
+
+Тут я також підкреслюю внески спонсорів.
+
+Я також залишаю за собою право оновлювати алгоритми підрахунку, види рейтингів, порогові значення тощо (про всяк випадок 🤷).

From 48d203a1e7936e3af4b243dba0b3588cba9fbd06 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 14 Aug 2023 09:10:51 +0000
Subject: [PATCH 099/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 868628ae8..9fe64b1c8 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Ukrainian translation for `docs/uk/docs/fastapi-people.md`. PR [#10059](https://github.com/tiangolo/fastapi/pull/10059) by [@rostik1410](https://github.com/rostik1410).
 * 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/cookie-params.md`. PR [#10032](https://github.com/tiangolo/fastapi/pull/10032) by [@rostik1410](https://github.com/rostik1410).
 * 🌐 Add Russian translation for `docs/ru/docs/deployment/docker.md`. PR [#9971](https://github.com/tiangolo/fastapi/pull/9971) by [@Xewus](https://github.com/Xewus).
 * 🌐 Add Vietnamese translation for `docs/vi/docs/python-types.md`. PR [#10047](https://github.com/tiangolo/fastapi/pull/10047) by [@magiskboy](https://github.com/magiskboy).

From 9d6ce823c1d498a00df8531b6c44da1200258f55 Mon Sep 17 00:00:00 2001
From: Yusuke Tamura <62091034+tamtam-fitness@users.noreply.github.com>
Date: Mon, 14 Aug 2023 18:12:14 +0900
Subject: [PATCH 100/317] =?UTF-8?q?=F0=9F=8C=90=20Update=20Japanese=20tran?=
 =?UTF-8?q?slation=20for=20`docs/ja/docs/deployment/docker.md`=20(#10073)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
 docs/ja/docs/deployment/docker.md | 680 ++++++++++++++++++++++++++----
 1 file changed, 608 insertions(+), 72 deletions(-)

diff --git a/docs/ja/docs/deployment/docker.md b/docs/ja/docs/deployment/docker.md
index f10312b51..ca9dedc3c 100644
--- a/docs/ja/docs/deployment/docker.md
+++ b/docs/ja/docs/deployment/docker.md
@@ -1,71 +1,157 @@
-# Dockerを使用したデプロイ
+# コンテナ内のFastAPI - Docker
 
-このセクションでは以下の使い方の紹介とガイドへのリンクが確認できます:
+FastAPIアプリケーションをデプロイする場合、一般的なアプローチは**Linuxコンテナ・イメージ**をビルドすることです。
 
-* **5分**程度で、**FastAPI** のアプリケーションを、パフォーマンスを最大限に発揮するDockerイメージ (コンテナ)にする。
-* (オプション) 開発者として必要な範囲でHTTPSを理解する。
-* **20分**程度で、自動的なHTTPS生成とともにDockerのSwarmモード クラスタをセットアップする (月5ドルのシンプルなサーバー上で)。
-* **10分**程度で、DockerのSwarmモード クラスタを使って、HTTPSなどを使用した完全な**FastAPI** アプリケーションの作成とデプロイ。
+基本的には <a href="https://www.docker.com/" class="external-link" target="_blank">**Docker**</a>を用いて行われます。生成されたコンテナ・イメージは、いくつかの方法のいずれかでデプロイできます。
 
-デプロイのために、<a href="https://www.docker.com/" class="external-link" target="_blank">**Docker**</a> を利用できます。セキュリティ、再現性、開発のシンプルさなどに利点があります。
+Linuxコンテナの使用には、**セキュリティ**、**反復可能性（レプリカビリティ）**、**シンプリシティ**など、いくつかの利点があります。
 
-Dockerを使う場合、公式のDockerイメージが利用できます:
+!!! tip
+    TODO: なぜか遷移できない
+    お急ぎで、すでにこれらの情報をご存じですか？ [以下の`Dockerfile`の箇所👇](#build-a-docker-image-for-fastapi)へジャンプしてください。
 
-## <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>
+<details>
+<summary>Dockerfile プレビュー 👀</summary>
 
-このイメージは「自動チューニング」機構を含んでいます。犠牲を払うことなく、ただコードを加えるだけで自動的に高パフォーマンスを実現できます。
+```Dockerfile
+FROM python:3.9
 
-ただし、環境変数や設定ファイルを使って全ての設定の変更や更新を行えます。
+WORKDIR /code
 
-!!! tip "豆知識"
-    全ての設定とオプションを確認するには、Dockerイメージページを開いて下さい: <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
+COPY ./requirements.txt /code/requirements.txt
 
-## `Dockerfile` の作成
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
 
-* プロジェクトディレクトリへ移動。
-* 以下の`Dockerfile` を作成:
+COPY ./app /code/app
 
-```Dockerfile
-FROM tiangolo/uvicorn-gunicorn-fastapi:python3.7
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
 
-COPY ./app /app
+# If running behind a proxy like Nginx or Traefik add --proxy-headers
+# CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80", "--proxy-headers"]
 ```
 
-### より大きなアプリケーション
+</details>
 
-[Bigger Applications with Multiple Files](tutorial/bigger-applications.md){.internal-link target=_blank} セクションに倣う場合は、`Dockerfile` は上記の代わりに、以下の様になるかもしれません:
+## コンテナとは何か
 
-```Dockerfile
-FROM tiangolo/uvicorn-gunicorn-fastapi:python3.7
+コンテナ（主にLinuxコンテナ）は、同じシステム内の他のコンテナ（他のアプリケーションやコンポーネント）から隔離された状態を保ちながら、すべての依存関係や必要なファイルを含むアプリケーションをパッケージ化する非常に**軽量**な方法です。
 
-COPY ./app /app/app
-```
+Linuxコンテナは、ホスト（マシン、仮想マシン、クラウドサーバーなど）の同じLinuxカーネルを使用して実行されます。これは、（OS全体をエミュレートする完全な仮想マシンと比べて）非常に軽量であることを意味します。
 
-### Raspberry Piなどのアーキテクチャ
+このように、コンテナは**リソースをほとんど消費しません**が、プロセスを直接実行するのに匹敵する量です（仮想マシンはもっと消費します）。
 
-Raspberry Pi (ARMプロセッサ搭載)やそれ以外のアーキテクチャでDockerが作動している場合、(マルチアーキテクチャである) Pythonベースイメージを使って、一から`Dockerfile`を作成し、Uvicornを単体で使用できます。
+コンテナはまた、独自の**分離された**実行プロセス（通常は1つのプロセスのみ）や、ファイルシステム、ネットワークを持ちます。 このことはデプロイ、セキュリティ、開発などを簡素化させます。
 
-この場合、`Dockerfile` は以下の様になるかもしれません:
+## コンテナ・イメージとは何か
 
-```Dockerfile
-FROM python:3.7
+**コンテナ**は、**コンテナ・イメージ**から実行されます。
 
-RUN pip install fastapi uvicorn
+コンテナ・イメージは、コンテナ内に存在すべきすべてのファイルや環境変数、そしてデフォルトのコマンド/プログラムを**静的に**バージョン化したものです。 ここでの**静的**とは、コンテナ**イメージ**は実行されておらず、パッケージ化されたファイルとメタデータのみであることを意味します。
 
-EXPOSE 80
+保存された静的コンテンツである「**コンテナイメージ**」とは対照的に、「**コンテナ**」は通常、実行中のインスタンス、つまり**実行**されているものを指します。
 
-COPY ./app /app
+**コンテナ**が起動され実行されるとき（**コンテナイメージ**から起動されるとき）、ファイルや環境変数などが作成されたり変更されたりする可能性があります。
 
-CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
+これらの変更はそのコンテナ内にのみ存在しますが、基盤となるコンテナ・イメージには残りません（ディスクに保存されません）。
+
+コンテナイメージは **プログラム** ファイルやその内容、例えば `python` と `main.py` ファイルに匹敵します。
+
+そして、**コンテナ**自体は（**コンテナイメージ**とは対照的に）イメージをもとにした実際の実行中のインスタンスであり、**プロセス**に匹敵します。
+
+実際、コンテナが実行されているのは、**プロセスが実行されている**ときだけです（通常は単一のプロセスだけです）。 コンテナ内で実行中のプロセスがない場合、コンテナは停止します。
+
+## コンテナ・イメージ
+
+Dockerは、**コンテナ・イメージ**と**コンテナ**を作成・管理するための主要なツールの1つです。
+
+そして、DockerにはDockerイメージ（コンテナ）を共有する<a href="https://hub.docker.com/" class="external-link" target="_blank">Docker Hub</a>というものがあります。
+
+Docker Hubは 多くのツールや環境、データベース、アプリケーションに対応している予め作成された**公式のコンテナ・イメージ**をパブリックに提供しています。
+
+例えば、公式イメージの1つに<a href="https://hub.docker.com/_/python" class="external-link" target="_blank">Python Image</a>があります。
+
+その他にも、データベースなどさまざまなイメージがあります：
+
+* <a href="https://hub.docker.com/_/postgres" class="external-link" target="_blank">PostgreSQL</a>
+* <a href="https://hub.docker.com/_/mysql" class="external-link" target="_blank">MySQL</a>
+* <a href="https://hub.docker.com/_/mongo" class="external-link" target="_blank">MongoDB</a>
+* <a href="https://hub.docker.com/_/redis" class="external-link" target="_blank">Redis</a>, etc.
+
+予め作成されたコンテナ・イメージを使用することで、異なるツールを**組み合わせて**使用することが非常に簡単になります。例えば、新しいデータベースを試す場合に特に便利です。ほとんどの場合、**公式イメージ**を使い、環境変数で設定するだけで良いです。
+
+そうすれば多くの場合、コンテナとDockerについて学び、その知識をさまざまなツールやコンポーネントによって再利用することができます。
+
+つまり、データベース、Pythonアプリケーション、Reactフロントエンド・アプリケーションを備えたウェブ・サーバーなど、さまざまなものを**複数のコンテナ**で実行し、それらを内部ネットワーク経由で接続します。
+
+すべてのコンテナ管理システム（DockerやKubernetesなど）には、こうしたネットワーキング機能が統合されています。
+
+## コンテナとプロセス
+
+通常、**コンテナ・イメージ**はそのメタデータに**コンテナ**の起動時に実行されるデフォルトのプログラムまたはコマンドと、そのプログラムに渡されるパラメータを含みます。コマンドラインでの操作とよく似ています。
+
+**コンテナ**が起動されると、そのコマンド/プログラムが実行されます（ただし、別のコマンド/プログラムをオーバーライドして実行させることもできます）。
+
+コンテナは、**メイン・プロセス**（コマンドまたはプログラム）が実行されている限り実行されます。
+
+コンテナは通常**1つのプロセス**を持ちますが、メイン・プロセスからサブ・プロセスを起動することも可能で、そうすれば同じコンテナ内に**複数のプロセス**を持つことになります。
+
+しかし、**少なくとも1つの実行中のプロセス**がなければ、実行中のコンテナを持つことはできないです。メイン・プロセスが停止すれば、コンテナも停止します。
+
+## Build a Docker Image for FastAPI
+
+ということで、何か作りましょう！🚀
+
+FastAPI用の**Dockerイメージ**を、**公式Python**イメージに基づいて**ゼロから**ビルドする方法をお見せします。
+
+これは**ほとんどの場合**にやりたいことです。例えば：
+
+* **Kubernetes**または同様のツールを使用する場合
+* **Raspberry Pi**で実行する場合
+* コンテナ・イメージを実行してくれるクラウド・サービスなどを利用する場合
+
+### パッケージ要件（package requirements）
+
+アプリケーションの**パッケージ要件**は通常、何らかのファイルに記述されているはずです。
+
+パッケージ要件は主に**インストール**するために使用するツールに依存するでしょう。
+
+最も一般的な方法は、`requirements.txt` ファイルにパッケージ名とそのバージョンを 1 行ずつ書くことです。
+
+もちろん、[FastAPI バージョンについて](./versions.md){.internal-link target=_blank}で読んだのと同じアイデアを使用して、バージョンの範囲を設定します。
+
+例えば、`requirements.txt` は次のようになります：
+
+```
+fastapi>=0.68.0,<0.69.0
+pydantic>=1.8.0,<2.0.0
+uvicorn>=0.15.0,<0.16.0
 ```
 
-## **FastAPI** コードの作成
+そして通常、例えば `pip` を使ってこれらのパッケージの依存関係をインストールします：
+
+<div class="termy">
 
-* `app` ディレクトリを作成し、移動。
-* 以下の`main.py` ファイルを作成:
+```console
+$ pip install -r requirements.txt
+---> 100%
+Successfully installed fastapi pydantic uvicorn
+```
+
+</div>
+
+!!! info
+    パッケージの依存関係を定義しインストールするためのフォーマットやツールは他にもあります。
+
+    Poetryを使った例は、後述するセクションでご紹介します。👇
+
+### **FastAPI**コードを作成する
+
+* `app` ディレクトリを作成し、その中に入ります
+* 空のファイル `__init__.py` を作成します
+* `main.py` ファイルを作成します：
 
 ```Python
-from typing import Optional
+from typing import Union
 
 from fastapi import FastAPI
 
@@ -78,23 +164,136 @@ def read_root():
 
 
 @app.get("/items/{item_id}")
-def read_item(item_id: int, q: Optional[str] = None):
+def read_item(item_id: int, q: Union[str, None] = None):
     return {"item_id": item_id, "q": q}
 ```
 
-* ここでは、以下の様なディレクトリ構造になっているはずです:
+### Dockerfile
+
+同じプロジェクト・ディレクトリに`Dockerfile`というファイルを作成します：
+
+```{ .dockerfile .annotate }
+# (1)
+FROM python:3.9
+
+# (2)
+WORKDIR /code
+
+# (3)
+COPY ./requirements.txt /code/requirements.txt
+
+# (4)
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
+
+# (5)
+COPY ./app /code/app
+
+# (6)
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
+```
+
+1. 公式のPythonベースイメージから始めます
+
+2. 現在の作業ディレクトリを `/code` に設定します
+
+    ここに `requirements.txt` ファイルと `app` ディレクトリを置きます。
+
+3. 要件が書かれたファイルを `/code` ディレクトリにコピーします
+
+    残りのコードではなく、最初に必要なファイルだけをコピーしてください。
+
+    このファイルは**頻繁には変更されない**ので、Dockerはこのステップではそれを検知し**キャッシュ**を使用し、次のステップでもキャッシュを有効にします。
+
+4. 要件ファイルにあるパッケージの依存関係をインストールします
+    `--no-cache-dir` オプションはダウンロードしたパッケージをローカルに保存しないように `pip` に指示します。これは、同じパッケージをインストールするために `pip` を再度実行する場合にのみ有効ですが、コンテナで作業する場合はそうではないです。
+
+    !!! note
+        `--no-cache-dir`は`pip`に関連しているだけで、Dockerやコンテナとは何の関係もないです。
+
+    `--upgrade` オプションは、パッケージが既にインストールされている場合、`pip` にアップグレードするように指示します。
+
+    何故ならファイルをコピーする前のステップは**Dockerキャッシュ**によって検出される可能性があるためであり、このステップも利用可能な場合は**Dockerキャッシュ**を使用します。
+
+    このステップでキャッシュを使用すると、開発中にイメージを何度もビルドする際に、**毎回**すべての依存関係を**ダウンロードしてインストールする**代わりに多くの**時間**を**節約**できます。
+
+5. ./app` ディレクトリを `/code` ディレクトリの中にコピーする。
+
+    これには**最も頻繁に変更される**すべてのコードが含まれているため、Dockerの**キャッシュ**は**これ以降のステップ**に簡単に使用されることはありません。
+
+    そのため、コンテナイメージのビルド時間を最適化するために、`Dockerfile`の **最後** にこれを置くことが重要です。
+
+6. `uvicorn`サーバーを実行するための**コマンド**を設定します
+
+    `CMD` は文字列のリストを取り、それぞれの文字列はスペースで区切られたコマンドラインに入力するものです。
+
+    このコマンドは **現在の作業ディレクトリ**から実行され、上記の `WORKDIR /code` にて設定した `/code` ディレクトリと同じです。
+
+    そのためプログラムは `/code` で開始しその中にあなたのコードがある `./app` ディレクトリがあるので、**Uvicorn** は `app.main` から `app` を参照し、**インポート** することができます。
+
+!!! tip
+    コード内の"+"の吹き出しをクリックして、各行が何をするのかをレビューしてください。👆
+
+これで、次のようなディレクトリ構造になるはずです：
 
 ```
 .
 ├── app
+│   ├── __init__.py
 │   └── main.py
-└── Dockerfile
+├── Dockerfile
+└── requirements.txt
+```
+
+#### TLS Termination Proxyの裏側
+
+Nginx や Traefik のような TLS Termination Proxy (ロードバランサ) の後ろでコンテナを動かしている場合は、`--proxy-headers`オプションを追加します。
+
+このオプションは、Uvicornにプロキシ経由でHTTPSで動作しているアプリケーションに対して、送信されるヘッダを信頼するよう指示します。
+
+```Dockerfile
+CMD ["uvicorn", "app.main:app", "--proxy-headers", "--host", "0.0.0.0", "--port", "80"]
+```
+
+#### Dockerキャッシュ
+
+この`Dockerfile`には重要なトリックがあり、まず**依存関係だけのファイル**をコピーします。その理由を説明します。
+
+```Dockerfile
+COPY ./requirements.txt /code/requirements.txt
+```
+
+Dockerや他のツールは、これらのコンテナイメージを**段階的に**ビルドし、**1つのレイヤーを他のレイヤーの上に**追加します。`Dockerfile`の先頭から開始し、`Dockerfile`の各命令によって作成されたファイルを追加していきます。
+
+Dockerや同様のツールは、イメージをビルドする際に**内部キャッシュ**も使用します。前回コンテナイメージを構築したときからファイルが変更されていない場合、ファイルを再度コピーしてゼロから新しいレイヤーを作成する代わりに、**前回作成した同じレイヤーを再利用**します。
+
+ただファイルのコピーを避けるだけではあまり改善されませんが、そのステップでキャッシュを利用したため、**次のステップ**でキャッシュを使うことができます。
+
+例えば、依存関係をインストールする命令のためにキャッシュを使うことができます：
+
+```Dockerfile
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
 ```
 
-## Dockerイメージをビルド
+パッケージ要件のファイルは**頻繁に変更されることはありません**。そのため、そのファイルだけをコピーすることで、Dockerはそのステップでは**キャッシュ**を使用することができます。
+
+そして、Dockerは**次のステップのためにキャッシュ**を使用し、それらの依存関係をダウンロードしてインストールすることができます。そして、ここで**多くの時間を節約**します。✨ ...そして退屈な待ち時間を避けることができます。😪😆
+
+パッケージの依存関係をダウンロードしてインストールするには**数分**かかりますが、**キャッシュ**を使えば**せいぜい数秒**です。
 
-* プロジェクトディレクトリ (`app` ディレクトリを含んだ、`Dockerfile` のある場所) へ移動
-* FastAPIイメージのビルド:
+加えて、開発中にコンテナ・イメージを何度もビルドして、コードの変更が機能しているかどうかをチェックすることになるため、多くの時間を節約することができます。
+
+そして`Dockerfile`の最終行の近くですべてのコードをコピーします。この理由は、**最も頻繁に**変更されるものなので、このステップの後にあるものはほとんどキャッシュを使用することができないのためです。
+
+```Dockerfile
+COPY ./app /code/app
+```
+
+### Dockerイメージをビルドする
+
+すべてのファイルが揃ったので、コンテナ・イメージをビルドしましょう。
+
+* プロジェクトディレクトリに移動します（`Dockerfile`がある場所で、`app`ディレクトリがあります）
+* FastAPI イメージをビルドします：
 
 <div class="termy">
 
@@ -106,9 +305,14 @@ $ docker build -t myimage .
 
 </div>
 
-## Dockerコンテナを起動
+!!! tip
+   末尾の `.` に注目してほしいです。これは `./` と同じ意味です。 これはDockerにコンテナイメージのビルドに使用するディレクトリを指示します。
+
+    この場合、同じカレント・ディレクトリ(`.`)です。
 
-* 用意したイメージを基にしたコンテナの起動:
+### Dockerコンテナの起動する
+
+* イメージに基づいてコンテナを実行します：
 
 <div class="termy">
 
@@ -118,62 +322,394 @@ $ docker run -d --name mycontainer -p 80:80 myimage
 
 </div>
 
-これで、Dockerコンテナ内に最適化されたFastAPIサーバが動作しています。使用しているサーバ (そしてCPUコア数) に沿った自動チューニングが行われています。
-
-## 確認
+## 確認する
 
-DockerコンテナのURLで確認できるはずです。例えば: <a href="http://192.168.99.100/items/5?q=somequery" class="external-link" target="_blank">http://192.168.99.100/items/5?q=somequery</a> や <a href="http://127.0.0.1/items/5?q=somequery" class="external-link" target="_blank">http://127.0.0.1/items/5?q=somequery</a> (もしくはDockerホストを使用したこれらと同等のもの)。
+Dockerコンテナの<a href="http://192.168.99.100/items/5?q=somequery" class="external-link" target="_blank">http://192.168.99.100/items/5?q=somequery</a> や <a href="http://127.0.0.1/items/5?q=somequery" class="external-link" target="_blank">http://127.0.0.1/items/5?q=somequery</a> (またはそれに相当するDockerホストを使用したもの）といったURLで確認できるはずです。
 
-以下の様なものが返されます:
+アクセスすると以下のようなものが表示されます：
 
 ```JSON
 {"item_id": 5, "q": "somequery"}
 ```
 
-## 対話的APIドキュメント
+## インタラクティブなAPIドキュメント
 
-ここで、<a href="http://192.168.99.100/docs" class="external-link" target="_blank">http://192.168.99.100/docs</a> や <a href="http://127.0.0.1/docs" class="external-link" target="_blank">http://127.0.0.1/docs</a> (もしくはDockerホストを使用したこれらと同等のもの) を開いて下さい。
+これらのURLにもアクセスできます:  <a href="http://192.168.99.100/docs" class="external-link" target="_blank">http://192.168.99.100/docs</a> や <a href="http://127.0.0.1/docs" class="external-link" target="_blank">http://127.0.0.1/docs</a> (またはそれに相当するDockerホストを使用したもの）
 
-自動生成された対話的APIドキュメントが確認できます (<a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Swagger UI</a>によって提供されます):
+アクセスすると、自動対話型APIドキュメント（<a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Swagger UI</a>が提供）が表示されます：
 
 ![Swagger UI](https://fastapi.tiangolo.com/img/index/index-01-swagger-ui-simple.png)
 
-## その他のAPIドキュメント
+## 代替のAPIドキュメント
 
-また同様に、<a href="http://192.168.99.100/redoc" class="external-link" target="_blank">http://192.168.99.100/redoc</a> や <a href="http://127.0.0.1/redoc" class="external-link" target="_blank">http://127.0.0.1/redoc</a> (もしくはDockerホストを使用したこれらと同等のもの) を開いて下さい。
+また、<a href="http://192.168.99.100/redoc" class="external-link" target="_blank">http://192.168.99.100/redoc</a> や <a href="http://127.0.0.1/redoc" class="external-link" target="_blank">http://127.0.0.1/redoc</a> (またはそれに相当するDockerホストを使用したもの）にもアクセスできます。
 
-他の自動生成された対話的なAPIドキュメントが確認できます (<a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a>によって提供されます):
+代替の自動ドキュメント（<a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a>によって提供される）が表示されます：
 
 ![ReDoc](https://fastapi.tiangolo.com/img/index/index-02-redoc-simple.png)
 
-## Traefik
+## 単一ファイルのFastAPIでDockerイメージをビルドする
+
+FastAPI が単一のファイル、例えば `./app` ディレクトリのない `main.py` の場合、ファイル構造は次のようになります：
+```
+.
+├── Dockerfile
+├── main.py
+└── requirements.txt
+```
+
+そうすれば、`Dockerfile`の中にファイルをコピーするために、対応するパスを変更するだけでよいです：
+
+```{ .dockerfile .annotate hl_lines="10  13" }
+FROM python:3.9
+
+WORKDIR /code
+
+COPY ./requirements.txt /code/requirements.txt
+
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
+
+# (1)
+COPY ./main.py /code/
+
+# (2)
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
+```
+
+1. main.py`ファイルを `/code` ディレクトリに直接コピーします。
+
+2. Uvicornを実行し、`main`から`app`オブジェクトをインポートするように指示します（`app.main`からインポートするのではなく）。
+
+次にUvicornコマンドを調整して、`app.main` の代わりに新しいモジュール `main` を使用し、FastAPIオブジェクトである `app` をインポートします。
+
+## デプロイメントのコンセプト
+
+コンテナという観点から、[デプロイのコンセプト](./concepts.md){.internal-link target=_blank}に共通するいくつかについて、もう一度説明しましょう。
+
+コンテナは主に、アプリケーションの**ビルドとデプロイ**のプロセスを簡素化するためのツールですが、これらの**デプロイのコンセプト**を扱うための特定のアプローチを強制するものではないです。
 
-<a href="https://traefik.io/" class="external-link" target="_blank">Traefik</a>は、高性能なリバースプロキシ/ロードバランサーです。「TLSターミネーションプロキシ」ジョブを実行できます（他の機能と切り離して）。
+**良いニュース**は、それぞれの異なる戦略には、すべてのデプロイメントのコンセプトをカバーする方法があるということです。🎉
 
-Let's Encryptと統合されています。そのため、証明書の取得と更新を含むHTTPSに関するすべての処理を実行できます。
+これらの**デプロイメントのコンセプト**をコンテナの観点から見直してみましょう：
 
-また、Dockerとも統合されています。したがって、各アプリケーション構成でドメインを宣言し、それらの構成を読み取って、HTTPS証明書を生成し、構成に変更を加えることなく、アプリケーションにHTTPSを自動的に提供できます。
+* セキュリティ - HTTPS
+* 起動時の実行
+* 再起動
+* **レプリケーション（実行中のプロセス数）**
+* メモリ
+* 開始前の事前ステップ
+
+## HTTPS
+
+FastAPI アプリケーションの **コンテナ・イメージ**（および後で実行中の **コンテナ**）だけに焦点を当てると、通常、HTTPSは別のツールを用いて**外部で**処理されます。
+
+例えば<a href="https://traefik.io/" class="external-link" target="_blank">Traefik</a>のように、**HTTPS**と**証明書**の**自動**取得を扱う別のコンテナである可能性もあります。
+
+!!! tip
+    TraefikはDockerやKubernetesなどと統合されているので、コンテナ用のHTTPSの設定や構成はとても簡単です。
+
+あるいは、（コンテナ内でアプリケーションを実行しながら）クラウド・プロバイダーがサービスの1つとしてHTTPSを処理することもできます。
+
+## 起動時および再起動時の実行
+
+通常、コンテナの**起動と実行**を担当する別のツールがあります。
+
+それは直接**Docker**であったり、**Docker Compose**であったり、**Kubernetes**であったり、**クラウドサービス**であったりします。
+
+ほとんどの場合（またはすべての場合）、起動時にコンテナを実行し、失敗時に再起動を有効にする簡単なオプションがあります。例えばDockerでは、コマンドラインオプションの`--restart`が該当します。
+
+コンテナを使わなければ、アプリケーションを起動時や再起動時に実行させるのは面倒で難しいかもしれません。しかし、**コンテナ**で作業する場合、ほとんどのケースでその機能はデフォルトで含まれています。✨
+
+## レプリケーション - プロセス数
+
+**Kubernetes** や Docker Swarm モード、Nomad、あるいは複数のマシン上で分散コンテナを管理するための同様の複雑なシステムを使ってマシンの<abbr title="何らかの方法で接続され、一緒に動作するように構成されたマシンのグループ">クラスター</abbr>を構成している場合、 各コンテナで（Workerを持つGunicornのような）**プロセスマネージャ**を使用する代わりに、**クラスター・レベル**で**レプリケーション**を処理したいと思うでしょう。
+
+Kubernetesのような分散コンテナ管理システムの1つは通常、入ってくるリクエストの**ロードバランシング**をサポートしながら、**コンテナのレプリケーション**を処理する統合された方法を持っています。このことはすべて**クラスタレベル**にてです。
+
+そのような場合、UvicornワーカーでGunicornのようなものを実行するのではなく、[上記の説明](#dockerfile)のように**Dockerイメージをゼロから**ビルドし、依存関係をインストールして、**単一のUvicornプロセス**を実行したいでしょう。
+
+### ロードバランサー
+
+コンテナを使用する場合、通常はメイン・ポート**でリスニング**しているコンポーネントがあるはずです。それはおそらく、**HTTPS**を処理するための**TLS Termination Proxy**でもある別のコンテナであったり、同様のツールであったりするでしょう。
+
+このコンポーネントはリクエストの **負荷** を受け、 (うまくいけば) その負荷を**バランスよく** ワーカーに分配するので、一般に **ロードバランサ** とも呼ばれます。
+
+!!! tip
+　　HTTPSに使われるものと同じ**TLS Termination Proxy**コンポーネントは、おそらく**ロードバランサー**にもなるでしょう。
+
+そしてコンテナで作業する場合、コンテナの起動と管理に使用する同じシステムには、**ロードバランサー**（**TLS Termination Proxy**の可能性もある）から**ネットワーク通信**（HTTPリクエストなど）をアプリのあるコンテナ（複数可）に送信するための内部ツールが既にあるはずです。
+
+### 1つのロードバランサー - 複数のワーカーコンテナー
+
+**Kubernetes**や同様の分散コンテナ管理システムで作業する場合、その内部のネットワーキングのメカニズムを使用することで、メインの**ポート**でリッスンしている単一の**ロードバランサー**が、アプリを実行している可能性のある**複数のコンテナ**に通信（リクエスト）を送信できるようになります。
+
+アプリを実行するこれらのコンテナには、通常**1つのプロセス**（たとえば、FastAPIアプリケーションを実行するUvicornプロセス）があります。これらはすべて**同一のコンテナ**であり同じものを実行しますが、それぞれが独自のプロセスやメモリなどを持ちます。そうすることで、CPUの**異なるコア**、あるいは**異なるマシン**での**並列化**を利用できます。
+
+そして、**ロードバランサー**を備えた分散コンテナシステムは、**順番に**あなたのアプリを含む各コンテナに**リクエストを分配**します。つまり、各リクエストは、あなたのアプリを実行している複数の**レプリケートされたコンテナ**の1つによって処理されます。
+
+そして通常、この**ロードバランサー**は、クラスタ内の*他の*アプリケーション（例えば、異なるドメインや異なるURLパスのプレフィックスの配下）へのリクエストを処理することができ、その通信をクラスタ内で実行されている*他の*アプリケーションのための適切なコンテナに送信します。
+
+### 1コンテナにつき1プロセス
+
+この種のシナリオでは、すでにクラスタ・レベルでレプリケーションを処理しているため、おそらくコンテナごとに**単一の（Uvicorn）プロセス**を持ちたいでしょう。
+
+この場合、Uvicornワーカーを持つGunicornのようなプロセスマネージャーや、Uvicornワーカーを使うUvicornは**避けたい**でしょう。**コンテナごとにUvicornのプロセスは1つだけ**にしたいでしょう（おそらく複数のコンテナが必要でしょう）。
+
+（GunicornやUvicornがUvicornワーカーを管理するように）コンテナ内に別のプロセスマネージャーを持つことは、クラスターシステムですでに対処しているであろう**不要な複雑さ**を追加するだけです。
+
+### Containers with Multiple Processes and Special Cases
+
+もちろん、**特殊なケース**として、**Gunicornプロセスマネージャ**を持つ**コンテナ**内で複数の**Uvicornワーカープロセス**を起動させたい場合があります。
+
+このような場合、**公式のDockerイメージ**を使用することができます。このイメージには、複数の**Uvicornワーカープロセス**を実行するプロセスマネージャとして**Gunicorn**が含まれており、現在のCPUコアに基づいてワーカーの数を自動的に調整するためのデフォルト設定がいくつか含まれています。詳しくは後述の[Gunicornによる公式Dockerイメージ - Uvicorn](#gunicornによる公式dockerイメージ---Uvicorn)で説明します。
+
+以下は、それが理にかなっている場合の例です：
+
+#### シンプルなアプリケーション
+
+アプリケーションを**シンプル**な形で実行する場合、プロセス数の細かい調整が必要ない場合、自動化されたデフォルトを使用するだけで、コンテナ内にプロセスマネージャが必要かもしれません。例えば、公式Dockerイメージでシンプルな設定が可能です。
+
+#### Docker Compose
+
+Docker Composeで**シングルサーバ**（クラスタではない）にデプロイすることもできますので、共有ネットワークと**ロードバランシング**を維持しながら（Docker Composeで）コンテナのレプリケーションを管理する簡単な方法はないでしょう。
+
+その場合、**単一のコンテナ**で、**プロセスマネージャ**が内部で**複数のワーカープロセス**を起動するようにします。
+
+#### Prometheusとその他の理由
+
+また、**1つのコンテナ**に**1つのプロセス**を持たせるのではなく、**1つのコンテナ**に**複数のプロセス**を持たせる方が簡単だという**他の理由**もあるでしょう。
+
+例えば、(セットアップにもよりますが)Prometheusエクスポーターのようなツールを同じコンテナ内に持つことができます。
+
+この場合、**複数のコンテナ**があると、デフォルトでは、Prometheusが**メトリクスを**読みに来たとき、すべてのレプリケートされたコンテナの**蓄積されたメトリクス**を取得するのではなく、毎回**単一のコンテナ**（その特定のリクエストを処理したコンテナ）のものを取得することになります。
+
+その場合、**複数のプロセス**を持つ**1つのコンテナ**を用意し、同じコンテナ上のローカルツール（例えばPrometheusエクスポーター）がすべての内部プロセスのPrometheusメトリクスを収集し、その1つのコンテナ上でそれらのメトリクスを公開する方がシンプルかもしれません。
 
 ---
 
-次のセクションに進み、この情報とツールを使用して、すべてを組み合わせます。
+重要なのは、盲目的に従わなければならない普遍のルールはないということです。
+
+これらのアイデアは、**あなた自身のユースケース**を評価し、あなたのシステムに最適なアプローチを決定するために使用することができます：
+
+* セキュリティ - HTTPS
+* 起動時の実行
+* 再起動
+* **レプリケーション（実行中のプロセス数）**
+* メモリ
+* 開始前の事前ステップ
+
+## メモリー
+
+コンテナごとに**単一のプロセスを実行する**と、それらのコンテナ（レプリケートされている場合は1つ以上）によって消費される多かれ少なかれ明確に定義された、安定し制限された量のメモリを持つことになります。
+
+そして、コンテナ管理システム（**Kubernetes**など）の設定で、同じメモリ制限と要件を設定することができます。
+
+そうすれば、コンテナが必要とするメモリ量とクラスタ内のマシンで利用可能なメモリ量を考慮して、**利用可能なマシン**に**コンテナ**をレプリケートできるようになります。
+
+アプリケーションが**シンプル**なものであれば、これはおそらく**問題にはならない**でしょうし、ハードなメモリ制限を指定する必要はないかもしれないです。
+
+しかし、**多くのメモリを使用**している場合（たとえば**機械学習**モデルなど）、どれだけのメモリを消費しているかを確認し、**各マシンで実行するコンテナの数**を調整する必要があります（そしておそらくクラスタにマシンを追加します）。
+
+**コンテナごとに複数のプロセス**を実行する場合（たとえば公式のDockerイメージで）、起動するプロセスの数が**利用可能なメモリ以上に消費しない**ようにする必要があります。
+
+## 開始前の事前ステップとコンテナ
+
+コンテナ（DockerやKubernetesなど）を使っている場合、主に2つのアプローチがあります。
+
+### 複数のコンテナ
+
+複数の**コンテナ**があり、おそらくそれぞれが**単一のプロセス**を実行している場合（**Kubernetes**クラスタなど）、レプリケートされたワーカーコンテナを実行する**前に**、単一のコンテナで**事前のステップ**の作業を行う**別のコンテナ**を持ちたいと思うでしょう。
+
+!!! info
+    もしKubernetesを使用している場合, これはおそらく<a href="https://kubernetes.io/docs/concepts/workloads/pods/init-containers/" class="external-link" target="_blank">Init コンテナ</a>でしょう。
+
+ユースケースが事前のステップを**並列で複数回**実行するのに問題がない場合（例：データベースの準備チェック）、メインプロセスを開始する前に、それらのステップを各コンテナに入れることが可能です。
+
+### 単一コンテナ
+
+単純なセットアップで、**単一のコンテナ**で複数の**ワーカー・プロセス**（または1つのプロセスのみ）を起動する場合、アプリでプロセスを開始する直前に、同じコンテナで事前のステップを実行できます。公式Dockerイメージは、内部的にこれをサポートしています。
+
+## Gunicornによる公式Dockerイメージ - Uvicorn
+
+前の章で詳しく説明したように、Uvicornワーカーで動作するGunicornを含む公式のDockerイメージがあります： [Server Workers - Gunicorn と Uvicorn](./server-workers.md){.internal-link target=_blank}で詳しく説明しています。
+
+このイメージは、主に上記で説明した状況で役に立つでしょう： [複数のプロセスと特殊なケースを持つコンテナ（Containers with Multiple Processes and Special Cases）](#containers-with-multiple-processes-and-special-cases)
+
+* <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
+
+!!! warning
+    このベースイメージや類似のイメージは**必要ない**可能性が高いので、[上記の: FastAPI用のDockerイメージをビルドする（Build a Docker Image for FastAPI）](#build-a-docker-image-for-fastapi)のようにゼロからイメージをビルドする方が良いでしょう。
+
+このイメージには、利用可能なCPUコアに基づいて**ワーカー・プロセスの数**を設定する**オートチューニング**メカニズムが含まれています。
+
+これは**賢明なデフォルト**を備えていますが、**環境変数**や設定ファイルを使ってすべての設定を変更したり更新したりすることができます。
 
-## TraefikとHTTPSを使用したDocker Swarmモードのクラスタ
+また、スクリプトで<a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker#pre_start_path" class="external-link" target="_blank">**開始前の事前ステップ**</a>を実行することもサポートしている。
 
-HTTPSを処理する（証明書の取得と更新を含む）Traefikを使用して、Docker Swarmモードのクラスタを数分（20分程度）でセットアップできます。
+!!! tip
+    すべての設定とオプションを見るには、Dockerイメージのページをご覧ください: <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>
 
-Docker Swarmモードを使用することで、1台のマシンの「クラスタ」から開始でき（1か月あたり5ドルのサーバーでもできます）、後から必要なだけサーバーを拡張できます。
+### 公式Dockerイメージのプロセス数
 
-TraefikおよびHTTPS処理を備えたDocker Swarm Modeクラスターをセットアップするには、次のガイドに従います:
+このイメージの**プロセス数**は、利用可能なCPU**コア**から**自動的に計算**されます。
+
+つまり、CPUから可能な限り**パフォーマンス**を**引き出そう**とします。
+
+また、**環境変数**などを使った設定で調整することもできます。
+
+しかし、プロセスの数はコンテナが実行しているCPUに依存するため、**消費されるメモリの量**もそれに依存することになります。
+
+そのため、（機械学習モデルなどで）大量のメモリを消費するアプリケーションで、サーバーのCPUコアが多いが**メモリが少ない**場合、コンテナは利用可能なメモリよりも多くのメモリを使おうとすることになります。
+
+その結果、パフォーマンスが大幅に低下する（あるいはクラッシュする）可能性があります。🚨
+
+### Dockerfileを作成する
+
+この画像に基づいて`Dockerfile`を作成する方法を以下に示します：
+
+```Dockerfile
+FROM tiangolo/uvicorn-gunicorn-fastapi:python3.9
+
+COPY ./requirements.txt /app/requirements.txt
+
+RUN pip install --no-cache-dir --upgrade -r /app/requirements.txt
+
+COPY ./app /app
+```
+
+### より大きなアプリケーション
+
+[複数のファイルを持つ大きなアプリケーション](../tutorial/bigger-applications.md){.internal-link target=_blank}を作成するセクションに従った場合、`Dockerfile`は次のようになります：
+
+```Dockerfile hl_lines="7"
+FROM tiangolo/uvicorn-gunicorn-fastapi:python3.9
+
+COPY ./requirements.txt /app/requirements.txt
+
+RUN pip install --no-cache-dir --upgrade -r /app/requirements.txt
+
+COPY ./app /app/app
+```
+
+### いつ使うのか
+
+おそらく、**Kubernetes**（または他のもの）を使用していて、すでにクラスタレベルで複数の**コンテナ**で**レプリケーション**を設定している場合は、この公式ベースイメージ（または他の類似のもの）は**使用すべきではありません**。
+
+そのような場合は、上記のように**ゼロから**イメージを構築する方がよいでしょう： [FastAPI用のDockerイメージをビルドする（Build a Docker Image for FastAPI）](#build-a-docker-image-for-fastapi) を参照してください。
+
+このイメージは、主に上記の[複数のプロセスと特殊なケースを持つコンテナ（Containers with Multiple Processes and Special Cases）](#containers-with-multiple-processes-and-special-cases)で説明したような特殊なケースで役に立ちます。
+
+例えば、アプリケーションが**シンプル**で、CPUに応じたデフォルトのプロセス数を設定すればうまくいく場合や、クラスタレベルでレプリケーションを手動で設定する手間を省きたい場合、アプリで複数のコンテナを実行しない場合などです。
+
+または、**Docker Compose**でデプロイし、単一のサーバで実行している場合などです。
+
+## コンテナ・イメージのデプロイ
+
+コンテナ（Docker）イメージを手に入れた後、それをデプロイするにはいくつかの方法があります。
+
+例えば以下のリストの方法です:
+
+* 単一サーバーの**Docker Compose**
+* **Kubernetes**クラスタ
+* Docker Swarmモードのクラスター
+* Nomadのような別のツール
+* コンテナ・イメージをデプロイするクラウド・サービス
+
+## Poetryを利用したDockerイメージ
+
+もしプロジェクトの依存関係を管理するために<a href="https://python-poetry.org/" class="external-link" target="_blank">Poetry</a>を利用する場合、マルチステージビルドを使うと良いでしょう。
+
+```{ .dockerfile .annotate }
+# (1)
+FROM python:3.9 as requirements-stage
+
+# (2)
+WORKDIR /tmp
+
+# (3)
+RUN pip install poetry
+
+# (4)
+COPY ./pyproject.toml ./poetry.lock* /tmp/
+
+# (5)
+RUN poetry export -f requirements.txt --output requirements.txt --without-hashes
+
+# (6)
+FROM python:3.9
+
+# (7)
+WORKDIR /code
+
+# (8)
+COPY --from=requirements-stage /tmp/requirements.txt /code/requirements.txt
+
+# (9)
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
+
+# (10)
+COPY ./app /code/app
+
+# (11)
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
+```
+
+1. これは最初のステージで、`requirements-stage`と名付けられます
+2. `/tmp` を現在の作業ディレクトリに設定します
+    ここで `requirements.txt` というファイルを生成します。
+
+3. このDockerステージにPoetryをインストールします
+
+4. pyproject.toml`と`poetry.lock`ファイルを`/tmp` ディレクトリにコピーします
+
+    `./poetry.lock*`（末尾に`*`）を使用するため、そのファイルがまだ利用できない場合でもクラッシュすることはないです。
+5. requirements.txt`ファイルを生成します
+
+6. これは最後のステージであり、ここにあるものはすべて最終的なコンテナ・イメージに保存されます
+7. 現在の作業ディレクトリを `/code` に設定します
+8. `requirements.txt`ファイルを `/code` ディレクトリにコピーします
+    このファイルは前のDockerステージにしか存在しないため、`--from-requirements-stage`を使ってコピーします。
+9. 生成された `requirements.txt` ファイルにあるパッケージの依存関係をインストールします
+10. app` ディレクトリを `/code` ディレクトリにコピーします
+11. uvicorn` コマンドを実行して、`app.main` からインポートした `app` オブジェクトを使用するように指示します
+!!! tip
+    "+"の吹き出しをクリックすると、それぞれの行が何をするのかを見ることができます
+
+**Dockerステージ**は`Dockerfile`の一部で、**一時的なコンテナイメージ**として動作します。
+
+最初のステージは **Poetryのインストール**と Poetry の `pyproject.toml` ファイルからプロジェクトの依存関係を含む**`requirements.txt`を生成**するためだけに使用されます。
+
+この `requirements.txt` ファイルは後半の **次のステージ**で `pip` と共に使用されます。
+
+最終的なコンテナイメージでは、**最終ステージ**のみが保存されます。前のステージは破棄されます。
+
+Poetryを使用する場合、**Dockerマルチステージビルド**を使用することは理にかなっています。
+
+なぜなら、最終的なコンテナイメージにPoetryとその依存関係がインストールされている必要はなく、**必要なのは**プロジェクトの依存関係をインストールするために生成された `requirements.txt` ファイルだけだからです。
+
+そして次の（そして最終的な）ステージでは、前述とほぼ同じ方法でイメージをビルドします。
+
+### TLS Termination Proxyの裏側 - Poetry
+
+繰り返しになりますが、NginxやTraefikのようなTLS Termination Proxy（ロードバランサー）の後ろでコンテナを動かしている場合は、`--proxy-headers`オプションをコマンドに追加します：
+
+```Dockerfile
+CMD ["uvicorn", "app.main:app", "--proxy-headers", "--host", "0.0.0.0", "--port", "80"]
+```
 
-### <a href="https://medium.com/@tiangolo/docker-swarm-mode-and-traefik-for-a-https-cluster-20328dba6232" class="external-link" target="_blank">Docker Swarm Mode and Traefik for an HTTPS cluster</a>
+## まとめ
 
-### FastAPIアプリケーションのデプロイ
+コンテナ・システム（例えば**Docker**や**Kubernetes**など）を使えば、すべての**デプロイメントのコンセプト**を扱うのがかなり簡単になります：
 
-すべてを設定するための最も簡単な方法は、[**FastAPI** Project Generators](../project-generation.md){.internal-link target=_blank}を使用することでしょう。
+* セキュリティ - HTTPS
+* 起動時の実行
+* 再起動
+* **レプリケーション（実行中のプロセス数）**
+* メモリ
+* 開始前の事前ステップ
 
-上述したTraefikとHTTPSを備えたDocker Swarm クラスタが統合されるように設計されています。
+ほとんどの場合、ベースとなるイメージは使用せず、公式のPython Dockerイメージをベースにした**コンテナイメージをゼロからビルド**します。
 
-2分程度でプロジェクトが生成されます。
+`Dockerfile`と**Dockerキャッシュ**内の命令の**順番**に注意することで、**ビルド時間を最小化**することができ、生産性を最大化することができます（そして退屈を避けることができます）。😎
 
-生成されたプロジェクトはデプロイの指示がありますが、それを実行するとさらに2分かかります。
+特別なケースでは、FastAPI用の公式Dockerイメージを使いたいかもしれません。🤓

From 014262c2030b686878d3e72ebddf3fb7d7928b37 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 14 Aug 2023 09:13:05 +0000
Subject: [PATCH 101/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 9fe64b1c8..00d04c44f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Update Japanese translation for `docs/ja/docs/deployment/docker.md`. PR [#10073](https://github.com/tiangolo/fastapi/pull/10073) by [@tamtam-fitness](https://github.com/tamtam-fitness).
 * 🌐 Add Ukrainian translation for `docs/uk/docs/fastapi-people.md`. PR [#10059](https://github.com/tiangolo/fastapi/pull/10059) by [@rostik1410](https://github.com/rostik1410).
 * 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/cookie-params.md`. PR [#10032](https://github.com/tiangolo/fastapi/pull/10032) by [@rostik1410](https://github.com/rostik1410).
 * 🌐 Add Russian translation for `docs/ru/docs/deployment/docker.md`. PR [#9971](https://github.com/tiangolo/fastapi/pull/9971) by [@Xewus](https://github.com/Xewus).

From 2a5cc5fff38fad76969bde0a630952d8ac174496 Mon Sep 17 00:00:00 2001
From: Yusuke Tamura <62091034+tamtam-fitness@users.noreply.github.com>
Date: Mon, 14 Aug 2023 18:13:28 +0900
Subject: [PATCH 102/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Japanese=20transla?=
 =?UTF-8?q?tion=20for=20`docs/ja/docs/deployment/server-workers.md`=20(#10?=
 =?UTF-8?q?064)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
 docs/ja/docs/deployment/server-workers.md | 182 ++++++++++++++++++++++
 1 file changed, 182 insertions(+)
 create mode 100644 docs/ja/docs/deployment/server-workers.md

diff --git a/docs/ja/docs/deployment/server-workers.md b/docs/ja/docs/deployment/server-workers.md
new file mode 100644
index 000000000..e1ea165a2
--- /dev/null
+++ b/docs/ja/docs/deployment/server-workers.md
@@ -0,0 +1,182 @@
+# Server Workers - Gunicorn と Uvicorn
+
+前回のデプロイメントのコンセプトを振り返ってみましょう：
+
+* セキュリティ - HTTPS
+* 起動時の実行
+* 再起動
+* **レプリケーション（実行中のプロセス数）**
+* メモリ
+* 開始前の事前ステップ
+
+ここまでのドキュメントのチュートリアルでは、おそらくUvicornのような**サーバープログラム**を**単一のプロセス**で実行しています。
+
+アプリケーションをデプロイする際には、**複数のコア**を利用し、そしてより多くのリクエストを処理できるようにするために、プロセスの**レプリケーション**を持つことを望むでしょう。
+
+前のチャプターである[デプロイメントのコンセプト](./concepts.md){.internal-link target=_blank}にて見てきたように、有効な戦略がいくつかあります。
+
+ここでは<a href="https://gunicorn.org/" class="external-link" target="_blank">**Gunicorn**</a>が**Uvicornのワーカー・プロセス**を管理する場合の使い方について紹介していきます。
+
+!!! info
+    <!-- NOTE: the current version of docker.md is outdated compared to English one.  -->
+    DockerやKubernetesなどのコンテナを使用している場合は、次の章で詳しく説明します： [コンテナ内のFastAPI - Docker](./docker.md){.internal-link target=_blank}
+
+    特に**Kubernetes**上で実行する場合は、おそらく**Gunicornを使用せず**、**コンテナごとに単一のUvicornプロセス**を実行することになりますが、それについてはこの章の後半で説明します。
+
+## GunicornによるUvicornのワーカー・プロセスの管理
+
+**Gunicorn**は**WSGI標準**のアプリケーションサーバーです。このことは、GunicornはFlaskやDjangoのようなアプリケーションにサービスを提供できることを意味します。Gunicornそれ自体は**FastAPI**と互換性がないですが、というのもFastAPIは最新の**<a href="https://asgi.readthedocs.io/en/latest/" class="external-link" target="_blank">ASGI 標準</a>**を使用しているためです。
+
+しかし、Gunicornは**プロセスマネージャー**として動作し、ユーザーが特定の**ワーカー・プロセスクラス**を使用するように指示することができます。するとGunicornはそのクラスを使い1つ以上の**ワーカー・プロセス**を開始します。
+
+そして**Uvicorn**には**Gunicorn互換のワーカークラス**があります。
+
+この組み合わせで、Gunicornは**プロセスマネージャー**として動作し、**ポート**と**IP**をリッスンします。そして、**Uvicornクラス**を実行しているワーカー・プロセスに通信を**転送**します。
+
+そして、Gunicorn互換の**Uvicornワーカー**クラスが、FastAPIが使えるように、Gunicornから送られてきたデータをASGI標準に変換する役割を担います。
+
+## GunicornとUvicornをインストールする
+
+<div class="termy">
+
+```console
+$ pip install "uvicorn[standard]" gunicorn
+
+---> 100%
+```
+
+</div>
+
+これによりUvicornと（高性能を得るための）標準（`standard`）の追加パッケージとGunicornの両方がインストールされます。
+
+## UvicornのワーカーとともにGunicornを実行する
+
+Gunicornを以下のように起動させることができます:
+
+<div class="termy">
+
+```console
+$ gunicorn main:app --workers 4 --worker-class uvicorn.workers.UvicornWorker --bind 0.0.0.0:80
+
+[19499] [INFO] Starting gunicorn 20.1.0
+[19499] [INFO] Listening at: http://0.0.0.0:80 (19499)
+[19499] [INFO] Using worker: uvicorn.workers.UvicornWorker
+[19511] [INFO] Booting worker with pid: 19511
+[19513] [INFO] Booting worker with pid: 19513
+[19514] [INFO] Booting worker with pid: 19514
+[19515] [INFO] Booting worker with pid: 19515
+[19511] [INFO] Started server process [19511]
+[19511] [INFO] Waiting for application startup.
+[19511] [INFO] Application startup complete.
+[19513] [INFO] Started server process [19513]
+[19513] [INFO] Waiting for application startup.
+[19513] [INFO] Application startup complete.
+[19514] [INFO] Started server process [19514]
+[19514] [INFO] Waiting for application startup.
+[19514] [INFO] Application startup complete.
+[19515] [INFO] Started server process [19515]
+[19515] [INFO] Waiting for application startup.
+[19515] [INFO] Application startup complete.
+```
+
+</div>
+
+それぞれのオプションの意味を見てみましょう：
+
+* `main:app`： `main`は"`main`"という名前のPythonモジュール、つまりファイル`main.py`を意味します。そして `app` は **FastAPI** アプリケーションの変数名です。
+    * main:app`はPythonの`import`文と同じようなものだと想像できます：
+
+        ```Python
+        from main import app
+        ```
+
+    * つまり、`main:app`のコロンは、`from main import app`のPythonの`import`の部分と同じになります。
+
+* `--workers`： 使用するワーカー・プロセスの数で、それぞれがUvicornのワーカーを実行します。
+
+* `--worker-class`： ワーカー・プロセスで使用するGunicorn互換のワーカークラスです。
+    * ここではGunicornがインポートして使用できるクラスを渡します：
+
+        ```Python
+        import uvicorn.workers.UvicornWorker
+        ```
+
+* `--bind`： GunicornにリッスンするIPとポートを伝えます。コロン(`:`)でIPとポートを区切ります。
+    * Uvicornを直接実行している場合は、`--bind 0.0.0.0:80` （Gunicornのオプション）の代わりに、`--host 0.0.0.0`と `--port 80`を使います。
+
+出力では、各プロセスの**PID**（プロセスID）が表示されているのがわかります（単なる数字です）。
+
+以下の通りです：
+
+* Gunicornの**プロセス・マネージャー**はPID `19499`（あなたの場合は違う番号でしょう）で始まります。
+* 次に、`Listening at: http://0.0.0.0:80`を開始します。
+* それから `uvicorn.workers.UvicornWorker` でワーカークラスを使用することを検出します。
+* そして、**4つのワーカー**を起動します。それぞれのワーカーのPIDは、`19511`、`19513`、`19514`、`19515`です。
+
+Gunicornはまた、ワーカーの数を維持するために必要であれば、**ダウンしたプロセス**を管理し、**新しいプロセスを**再起動**させます。そのため、上記のリストにある**再起動**の概念に一部役立ちます。
+
+しかしながら、必要であればGunicornを**再起動**させ、**起動時に実行**させるなど、外部のコンポーネントを持たせることも必要かもしれません。
+
+## Uvicornとワーカー
+
+Uvicornには複数の**ワーカー・プロセス**を起動し実行するオプションもあります。
+
+とはいうものの、今のところUvicornのワーカー・プロセスを扱う機能はGunicornよりも制限されています。そのため、このレベル（Pythonレベル）でプロセスマネージャーを持ちたいのであれば、Gunicornをプロセスマネージャーとして使ってみた方が賢明かもしれないです。
+
+どんな場合であれ、以下のように実行します：
+
+<div class="termy">
+
+```console
+$ uvicorn main:app --host 0.0.0.0 --port 8080 --workers 4
+<font color="#A6E22E">INFO</font>:     Uvicorn running on <b>http://0.0.0.0:8080</b> (Press CTRL+C to quit)
+<font color="#A6E22E">INFO</font>:     Started parent process [<font color="#A1EFE4"><b>27365</b></font>]
+<font color="#A6E22E">INFO</font>:     Started server process [<font color="#A1EFE4">27368</font>]
+<font color="#A6E22E">INFO</font>:     Waiting for application startup.
+<font color="#A6E22E">INFO</font>:     Application startup complete.
+<font color="#A6E22E">INFO</font>:     Started server process [<font color="#A1EFE4">27369</font>]
+<font color="#A6E22E">INFO</font>:     Waiting for application startup.
+<font color="#A6E22E">INFO</font>:     Application startup complete.
+<font color="#A6E22E">INFO</font>:     Started server process [<font color="#A1EFE4">27370</font>]
+<font color="#A6E22E">INFO</font>:     Waiting for application startup.
+<font color="#A6E22E">INFO</font>:     Application startup complete.
+<font color="#A6E22E">INFO</font>:     Started server process [<font color="#A1EFE4">27367</font>]
+<font color="#A6E22E">INFO</font>:     Waiting for application startup.
+<font color="#A6E22E">INFO</font>:     Application startup complete.
+```
+
+</div>
+
+ここで唯一の新しいオプションは `--workers` で、Uvicornに4つのワーカー・プロセスを起動するように指示しています。
+
+各プロセスの **PID** が表示され、親プロセスの `27365` (これは **プロセスマネージャ**) と、各ワーカー・プロセスの **PID** が表示されます： `27368`、`27369`、`27370`、`27367`になります。
+
+## デプロイメントのコンセプト
+
+ここでは、アプリケーションの実行を**並列化**し、CPUの**マルチコア**を活用し、**より多くのリクエスト**に対応できるようにするために、**Gunicorn**（またはUvicorn）を使用して**Uvicornワーカー・プロセス**を管理する方法を見ていきました。
+
+上記のデプロイのコンセプトのリストから、ワーカーを使うことは主に**レプリケーション**の部分と、**再起動**を少し助けてくれます：
+
+* セキュリティ - HTTPS
+* 起動時の実行
+* 再起動
+* レプリケーション（実行中のプロセス数）
+* メモリー
+* 開始前の事前のステップ
+
+
+## コンテナとDocker
+<!-- NOTE: the current version of docker.md is outdated compared to English one.  -->
+次章の[コンテナ内のFastAPI - Docker](./docker.md){.internal-link target=_blank}では、その他の**デプロイのコンセプト**を扱うために実施するであろう戦略をいくつか紹介します。
+
+また、**GunicornとUvicornワーカー**を含む**公式Dockerイメージ**と、簡単なケースに役立ついくつかのデフォルト設定も紹介します。
+
+また、(Gunicornを使わずに)Uvicornプロセスを1つだけ実行するために、**ゼロから独自のイメージを**構築する方法も紹介します。これは簡単なプロセスで、おそらく**Kubernetes**のような分散コンテナ管理システムを使うときにやりたいことでしょう。
+
+## まとめ
+
+Uvicornワーカーを使ったプロセスマネージャとして**Gunicorn**（またはUvicorn）を使えば、**マルチコアCPU**を活用して**複数のプロセスを並列実行**できます。
+
+これらのツールやアイデアは、**あなた自身のデプロイシステム**をセットアップしながら、他のデプロイコンセプトを自分で行う場合にも使えます。
+
+次の章では、コンテナ（DockerやKubernetesなど）を使った**FastAPI**について学んでいきましょう。これらのツールには、他の**デプロイのコンセプト**も解決する簡単な方法があることがわかるでしょう。✨

From 25059a7717e27a1fce3070ab48dba83fca7d89d6 Mon Sep 17 00:00:00 2001
From: Yusuke Tamura <62091034+tamtam-fitness@users.noreply.github.com>
Date: Mon, 14 Aug 2023 18:14:37 +0900
Subject: [PATCH 103/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Japanese=20transla?=
 =?UTF-8?q?tion=20for=20`docs/ja/docs/deployment/concepts.md`=20(#10062)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
 docs/ja/docs/deployment/concepts.md | 323 ++++++++++++++++++++++++++++
 1 file changed, 323 insertions(+)
 create mode 100644 docs/ja/docs/deployment/concepts.md

diff --git a/docs/ja/docs/deployment/concepts.md b/docs/ja/docs/deployment/concepts.md
new file mode 100644
index 000000000..38cbca219
--- /dev/null
+++ b/docs/ja/docs/deployment/concepts.md
@@ -0,0 +1,323 @@
+# デプロイメントのコンセプト
+
+**FastAPI**を用いたアプリケーションをデプロイするとき、もしくはどのようなタイプのWeb APIであっても、おそらく気になるコンセプトがいくつかあります。
+
+それらを活用することでアプリケーションを**デプロイするための最適な方法**を見つけることができます。
+
+重要なコンセプトのいくつかを紹介します:
+
+* セキュリティ - HTTPS
+* 起動時の実行
+* 再起動
+* レプリケーション（実行中のプロセス数）
+* メモリー
+* 開始前の事前のステップ
+
+これらが**デプロイメント**にどのような影響を与えるかを見ていきましょう。
+
+最終的な目的は、**安全な方法で**APIクライアントに**サービスを提供**し、**中断を回避**するだけでなく、**計算リソース**（例えばリモートサーバー/仮想マシン）を可能な限り効率的に使用することです。🚀
+
+この章では前述した**コンセプト**についてそれぞれ説明します。
+
+この説明を通して、普段とは非常に異なる環境や存在しないであろう**将来の**環境に対し、デプロイの方法を決める上で必要な**直感**を与えてくれることを願っています。
+
+これらのコンセプトを意識することにより、**あなた自身のAPI**をデプロイするための最適な方法を**評価**し、**設計**することができるようになるでしょう。
+
+次の章では、FastAPIアプリケーションをデプロイするための**具体的なレシピ**を紹介します。
+
+しかし、今はこれらの重要な**コンセプトに基づくアイデア**を確認しましょう。これらのコンセプトは、他のどのタイプのWeb APIにも当てはまります。💡
+
+## セキュリティ - HTTPS
+
+<!-- NOTE: https.md written in Japanese does not exist, so it redirects to English one  -->
+[前チャプターのHTTPSについて](./https.md){.internal-link target=_blank}では、HTTPSがどのようにAPIを暗号化するのかについて学びました。
+
+通常、アプリケーションサーバにとって**外部の**コンポーネントである**TLS Termination Proxy**によって提供されることが一般的です。このプロキシは通信の暗号化を担当します。
+
+さらにセキュアな通信において、HTTPS証明書の定期的な更新を行いますが、これはTLS Termination Proxyと同じコンポーネントが担当することもあれば、別のコンポーネントが担当することもあります。
+
+### HTTPS 用ツールの例
+TLS Termination Proxyとして使用できるツールには以下のようなものがあります：
+
+* Traefik
+    * 証明書の更新を自動的に処理 ✨
+* Caddy
+    * 証明書の更新を自動的に処理 ✨
+* Nginx
+    * 証明書更新のためにCertbotのような外部コンポーネントを使用
+* HAProxy
+    * 証明書更新のためにCertbotのような外部コンポーネントを使用
+* Nginx のような Ingress Controller を持つ Kubernetes
+    * 証明書の更新に cert-manager のような外部コンポーネントを使用
+* クラウド・プロバイダーがサービスの一部として内部的に処理（下記を参照👇）
+
+もう1つの選択肢は、HTTPSのセットアップを含んだより多くの作業を行う**クラウド・サービス**を利用することです。 このサービスには制限があったり、料金が高くなったりする可能性があります。しかしその場合、TLS Termination Proxyを自分でセットアップする必要はないです。
+
+次の章で具体例をいくつか紹介します。
+
+---
+
+次に考慮すべきコンセプトは、実際のAPIを実行するプログラム（例：Uvicorn）に関連するものすべてです。
+
+## プログラム と プロセス
+
+私たちは「**プロセス**」という言葉についてたくさん話すので、その意味や「**プログラム**」という言葉との違いを明確にしておくと便利です。
+
+### プログラムとは何か
+
+**プログラム**という言葉は、一般的にいろいろなものを表現するのに使われます：
+
+* プログラマが書く**コード**、**Pythonファイル**
+* OSによって実行することができるファイル（例: `python`, `python.exe` or `uvicorn`）
+* OS上で**実行**している間、CPUを使用し、メモリ上に何かを保存する特定のプログラム（**プロセス**とも呼ばれる）
+
+### プロセスとは何か
+
+**プロセス**という言葉は通常、より具体的な意味で使われ、OSで実行されているものだけを指します（先ほどの最後の説明のように）：
+
+* OS上で**実行**している特定のプログラム
+    * これはファイルやコードを指すのではなく、OSによって**実行**され、管理されているものを指します。
+* どんなプログラムやコードも、それが**実行されているときにだけ機能**します。つまり、**プロセスとして実行されているときだけ**です。
+* プロセスは、ユーザーにあるいはOSによって、 **終了**（あるいは "kill"）させることができます。その時点で、プロセスは実行/実行されることを停止し、それ以降は**何もできなくなります**。
+* コンピュータで実行されている各アプリケーションは、実行中のプログラムや各ウィンドウなど、その背後にいくつかのプロセスを持っています。そして通常、コンピュータが起動している間、**多くのプロセスが**同時に実行されています。
+* **同じプログラム**の**複数のプロセス**が同時に実行されていることがあります。
+
+OSの「タスク・マネージャー」や「システム・モニター」（または同様のツール）を確認すれば、これらのプロセスの多くが実行されているの見ることができるでしょう。
+
+例えば、同じブラウザプログラム（Firefox、Chrome、Edgeなど）を実行しているプロセスが複数あることがわかります。通常、1つのタブにつき1つのプロセスが実行され、さらに他のプロセスも実行されます。
+
+<img class="shadow" src="/img/deployment/concepts/image01.png">
+
+---
+
+さて、**プロセス**と**プログラム**という用語の違いを確認したところで、デプロイメントについて話を続けます。
+
+## 起動時の実行
+
+ほとんどの場合、Web APIを作成するときは、クライアントがいつでもアクセスできるように、**常に**中断されることなく**実行される**ことを望みます。もちろん、特定の状況でのみ実行させたい特別な理由がある場合は別ですが、その時間のほとんどは、常に実行され、**利用可能**であることを望みます。
+
+### リモートサーバー上での実行
+
+リモートサーバー（クラウドサーバー、仮想マシンなど）をセットアップするときにできる最も簡単なことは、ローカルで開発するときと同じように、Uvicorn（または同様のもの）を手動で実行することです。 この方法は**開発中**には役に立つと思われます。
+
+しかし、サーバーへの接続が切れた場合、**実行中のプロセス**はおそらくダウンしてしまうでしょう。
+
+そしてサーバーが再起動された場合（アップデートやクラウドプロバイダーからのマイグレーションの後など）、おそらくあなたはそれに**気づかないでしょう**。そのため、プロセスを手動で再起動しなければならないことすら気づかないでしょう。つまり、APIはダウンしたままなのです。😱
+
+### 起動時に自動的に実行
+
+一般的に、サーバープログラム（Uvicornなど）はサーバー起動時に自動的に開始され、**人の介入**を必要とせずに、APIと一緒にプロセスが常に実行されるようにしたいと思われます（UvicornがFastAPIアプリを実行するなど）。
+
+### 別のプログラムの用意
+
+これを実現するために、通常は**別のプログラム**を用意し、起動時にアプリケーションが実行されるようにします。そして多くの場合、他のコンポーネントやアプリケーション、例えばデータベースも実行されるようにします。
+
+### 起動時に実行するツールの例
+
+実行するツールの例をいくつか挙げます:
+
+* Docker
+* Kubernetes
+* Docker Compose
+* Swarm モードによる Docker
+* Systemd
+* Supervisor
+* クラウドプロバイダーがサービスの一部として内部的に処理
+* そのほか...
+
+次の章で、より具体的な例を挙げていきます。
+
+## 再起動
+
+起動時にアプリケーションが実行されることを確認するのと同様に、失敗後にアプリケーションが**再起動**されることも確認したいと思われます。
+
+### 我々は間違いを犯す
+
+私たち人間は常に**間違い**を犯します。ソフトウェアには、ほとんど常に**バグ**があらゆる箇所に隠されています。🐛
+
+### 小さなエラーは自動的に処理される
+
+FastAPIでWeb APIを構築する際に、コードにエラーがある場合、FastAPIは通常、エラーを引き起こした単一のリクエストにエラーを含めます。🛡
+
+クライアントはそのリクエストに対して**500 Internal Server Error**を受け取りますが、アプリケーションは完全にクラッシュするのではなく、次のリクエストのために動作を続けます。
+
+### 重大なエラー - クラッシュ
+
+しかしながら、**アプリケーション全体をクラッシュさせるようなコードを書いて**UvicornとPythonをクラッシュさせるようなケースもあるかもしれません。💥
+
+それでも、ある箇所でエラーが発生したからといって、アプリケーションを停止させたままにしたくないでしょう。 少なくとも壊れていない*パスオペレーション*については、**実行し続けたい**はずです。
+
+### クラッシュ後の再起動
+
+しかし、実行中の**プロセス**をクラッシュさせるような本当にひどいエラーの場合、少なくとも2〜3回ほどプロセスを**再起動**させる外部コンポーネントが必要でしょう。
+
+!!! tip
+    ...とはいえ、アプリケーション全体が**すぐにクラッシュする**のであれば、いつまでも再起動し続けるのは意味がないでしょう。しかし、その場合はおそらく開発中か少なくともデプロイ直後に気づくと思われます。
+
+    そこで、**将来**クラッシュする可能性があり、それでも再スタートさせることに意味があるような、主なケースに焦点を当ててみます。
+
+あなたはおそらく**外部コンポーネント**がアプリケーションの再起動を担当することを望むと考えます。 なぜなら、その時点でUvicornとPythonを使った同じアプリケーションはすでにクラッシュしており、同じアプリケーションの同じコードに対して何もできないためです。
+
+### 自動的に再起動するツールの例
+
+ほとんどの場合、前述した**起動時にプログラムを実行する**ために使用されるツールは、自動で**再起動**することにも利用されます。
+
+例えば、次のようなものがあります：
+
+* Docker
+* Kubernetes
+* Docker Compose
+* Swarm モードによる Docker
+* Systemd
+* Supervisor
+* クラウドプロバイダーがサービスの一部として内部的に処理
+* そのほか...
+
+## レプリケーション - プロセスとメモリー
+
+FastAPI アプリケーションでは、Uvicorn のようなサーバープログラムを使用し、**1つのプロセス**で1度に複数のクライアントに同時に対応できます。
+
+しかし、多くの場合、複数のワーカー・プロセスを同時に実行したいと考えるでしょう。
+
+### 複数のプロセス - Worker
+
+クライアントの数が単一のプロセスで処理できる数を超えており（たとえば仮想マシンがそれほど大きくない場合）、かつサーバーの CPU に**複数のコア**がある場合、同じアプリケーションで同時に**複数のプロセス**を実行させ、すべてのリクエストを分散させることができます。
+
+同じAPIプログラムの**複数のプロセス**を実行する場合、それらは一般的に**Worker／ワーカー**と呼ばれます。
+
+### ワーカー・プロセス と ポート
+<!-- NOTE: https.md written in Japanese does not exist, so it redirects to English one  -->
+
+[HTTPSについて](./https.md){.internal-link target=_blank}のドキュメントで、1つのサーバーで1つのポートとIPアドレスの組み合わせでリッスンできるのは1つのプロセスだけであることを覚えていますでしょうか？
+
+これはいまだに同じです。
+
+そのため、**複数のプロセス**を同時に持つには**ポートでリッスンしている単一のプロセス**が必要であり、それが何らかの方法で各ワーカー・プロセスに通信を送信することが求められます。
+
+### プロセスあたりのメモリー
+
+さて、プログラムがメモリにロードする際には、例えば機械学習モデルや大きなファイルの内容を変数に入れたりする場合では、**サーバーのメモリ（RAM）**を少し消費します。
+
+そして複数のプロセスは通常、**メモリを共有しません**。これは、実行中の各プロセスがそれぞれ独自の変数やメモリ等を持っていることを意味します。つまり、コード内で大量のメモリを消費している場合、**各プロセス**は同等の量のメモリを消費することになります。
+
+### サーバーメモリー
+
+例えば、あなたのコードが **1GBのサイズの機械学習モデル**をロードする場合、APIで1つのプロセスを実行すると、少なくとも1GBのRAMを消費します。
+
+また、**4つのプロセス**（4つのワーカー）を起動すると、それぞれが1GBのRAMを消費します。つまり、合計でAPIは**4GBのRAM**を消費することになります。
+
+リモートサーバーや仮想マシンのRAMが3GBしかない場合、4GB以上のRAMをロードしようとすると問題が発生します。🚨
+
+### 複数プロセス - 例
+
+この例では、2つの**ワーカー・プロセス**を起動し制御する**マネージャー・ プロセス**があります。
+
+このマネージャー・ プロセスは、おそらくIPの**ポート**でリッスンしているものです。そして、すべての通信をワーカー・プロセスに転送します。
+
+これらのワーカー・プロセスは、アプリケーションを実行するものであり、**リクエスト**を受けて**レスポンス**を返すための主要な計算を行い、あなたが変数に入れたものは何でもRAMにロードします。
+
+<img src="/img/deployment/concepts/process-ram.svg">
+
+そしてもちろん、同じマシンでは、あなたのアプリケーションとは別に、**他のプロセス**も実行されているでしょう。
+
+興味深いことに、各プロセスが使用する**CPU**の割合は時間とともに大きく**変動**する可能性がありますが、**メモリ（RAM）**は通常、多かれ少なかれ**安定**します。
+
+毎回同程度の計算を行うAPIがあり、多くのクライアントがいるのであれば、**CPU使用率**もおそらく**安定**するでしょう（常に急激に上下するのではなく）。
+
+### レプリケーション・ツールと戦略の例
+
+これを実現するにはいくつかのアプローチがありますが、具体的な戦略については次の章(Dockerやコンテナの章など)で詳しく説明します。
+
+考慮すべき主な制約は、**パブリックIP**の**ポート**を処理する**単一の**コンポーネントが存在しなければならないということです。
+
+そして、レプリケートされた**プロセス/ワーカー**に通信を**送信**する方法を持つ必要があります。
+
+考えられる組み合わせと戦略をいくつか紹介します：
+
+* **Gunicorn**が**Uvicornワーカー**を管理
+    * Gunicornは**IP**と**ポート**をリッスンする**プロセスマネージャ**で、レプリケーションは**複数のUvicornワーカー・プロセス**を持つことによって行われる。
+* **Uvicorn**が**Uvicornワーカー**を管理
+    * 1つのUvicornの**プロセスマネージャー**が**IP**と**ポート**をリッスンし、**複数のUvicornワーカー・プロセス**を起動する。
+* **Kubernetes**やその他の分散**コンテナ・システム**
+    * **Kubernetes**レイヤーの何かが**IP**と**ポート**をリッスンする。レプリケーションは、**複数のコンテナ**にそれぞれ**1つのUvicornプロセス**を実行させることで行われる。
+* **クラウド・サービス**によるレプリケーション
+    * クラウド・サービスはおそらく**あなたのためにレプリケーションを処理**します。**実行するプロセス**や使用する**コンテナイメージ**を定義できるかもしれませんが、いずれにせよ、それはおそらく**単一のUvicornプロセス**であり、クラウドサービスはそのレプリケーションを担当するでしょう。
+
+!!! tip
+    これらの**コンテナ**やDockerそしてKubernetesに関する項目が、まだあまり意味をなしていなくても心配しないでください。
+    <!-- NOTE: the current version of docker.md is outdated compared to English one. -->
+
+    コンテナ・イメージ、Docker、Kubernetesなどについては、次の章で詳しく説明します: [コンテナ内のFastAPI - Docker](./docker.md){.internal-link target=_blank}.
+
+## 開始前の事前のステップ
+
+アプリケーションを**開始する前**に、いくつかのステップを実行したい場合が多くあります。
+
+例えば、**データベース・マイグレーション** を実行したいかもしれません。
+
+しかしほとんどの場合、これらの手順を**1度**に実行したいと考えるでしょう。
+
+そのため、アプリケーションを開始する前の**事前のステップ**を実行する**単一のプロセス**を用意したいと思われます。
+
+そして、それらの事前のステップを実行しているのが単一のプロセスであることを確認する必要があります。このことはその後アプリケーション自体のために**複数のプロセス**（複数のワーカー）を起動した場合も同様です。
+
+これらのステップが**複数のプロセス**によって実行された場合、**並列**に実行されることによって作業が**重複**することになります。そして、もしそのステップがデータベースのマイグレーションのような繊細なものであった場合、互いに競合を引き起こす可能性があります。
+
+もちろん、事前のステップを何度も実行しても問題がない場合もあり、その際は対処がかなり楽になります。
+
+!!! tip
+    また、セットアップによっては、アプリケーションを開始する前の**事前のステップ**が必要ない場合もあることを覚えておいてください。
+
+    その場合は、このようなことを心配する必要はないです。🤷
+
+### 事前ステップの戦略例
+
+これは**システムを**デプロイする方法に**大きく依存**するだろうし、おそらくプログラムの起動方法や再起動の処理などにも関係してくるでしょう。
+
+考えられるアイデアをいくつか挙げてみます：
+
+* アプリコンテナの前に実行されるKubernetesのInitコンテナ
+* 事前のステップを実行し、アプリケーションを起動するbashスクリプト
+    * 利用するbashスクリプトを起動／再起動したり、エラーを検出したりする方法は以前として必要になるでしょう。
+
+!!! tip
+   <!-- NOTE: the current version of docker.md is outdated compared to English one. -->
+   コンテナを使った具体的な例については、次の章で紹介します: [コンテナ内のFastAPI - Docker](./docker.md){.internal-link target=_blank}.
+
+## リソースの利用
+
+あなたのサーバーは**リソース**であり、プログラムを実行しCPUの計算時間や利用可能なRAMメモリを消費または**利用**することができます。
+
+システムリソースをどれくらい消費／利用したいですか？ 「少ない方が良い」と考えるのは簡単かもしれないですが、実際には、**クラッシュせずに可能な限り**最大限に活用したいでしょう。
+
+3台のサーバーにお金を払っているにも関わらず、そのRAMとCPUを少ししか使っていないとしたら、おそらく**お金を無駄にしている** 💸、おそらく**サーバーの電力を無駄にしている** 🌎ことになるでしょう。
+
+その場合は、サーバーを2台だけにして、そのリソース（CPU、メモリ、ディスク、ネットワーク帯域幅など）をより高い割合で使用する方がよいでしょう。
+
+一方、2台のサーバーがあり、そのCPUとRAMの**100%を使用している**場合、ある時点で1つのプロセスがより多くのメモリを要求し、サーバーはディスクを「メモリ」として使用しないといけません。（何千倍も遅くなる可能性があります。）
+もしくは**クラッシュ**することもあれば、あるいはあるプロセスが何らかの計算をする必要があり、そしてCPUが再び空くまで待たなければならないかもしれません。
+
+この場合、**1つ余分なサーバー**を用意し、その上でいくつかのプロセスを実行し、すべてのサーバーが**十分なRAMとCPU時間を持つようにする**のがよいでしょう。
+
+また、何らかの理由でAPIの利用が急増する可能性もあります。もしかしたらそれが流行ったのかもしれないし、他のサービスやボットが使い始めたのかもしれないです。そのような場合に備えて、余分なリソースを用意しておくと安心でしょう。
+
+例えば、リソース使用率の**50%から90%の範囲**で**任意の数字**をターゲットとすることができます。
+
+重要なのは、デプロイメントを微調整するためにターゲットを設定し測定することが、おそらく使用したい主要な要素であることです。
+
+`htop`のような単純なツールを使って、サーバーで使用されているCPUやRAM、あるいは各プロセスで使用されている量を見ることができます。あるいは、より複雑な監視ツールを使って、サーバに分散して使用することもできます。
+
+## まとめ
+
+アプリケーションのデプロイ方法を決定する際に、考慮すべきであろう主要なコンセプトのいくつかを紹介していきました：
+
+* セキュリティ - HTTPS
+* 起動時の実行
+* 再起動
+* レプリケーション（実行中のプロセス数）
+* メモリー
+* 開始前の事前ステップ
+
+これらの考え方とその適用方法を理解することで、デプロイメントを設定したり調整したりする際に必要な直感的な判断ができるようになるはずです。🤓
+
+次のセクションでは、あなたが取り得る戦略について、より具体的な例を挙げます。🚀

From 87cc40e483790f1226022a9b69162507c056d198 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 14 Aug 2023 09:15:26 +0000
Subject: [PATCH 104/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 00d04c44f..ed67dbca8 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Japanese translation for `docs/ja/docs/deployment/server-workers.md`. PR [#10064](https://github.com/tiangolo/fastapi/pull/10064) by [@tamtam-fitness](https://github.com/tamtam-fitness).
 * 🌐 Update Japanese translation for `docs/ja/docs/deployment/docker.md`. PR [#10073](https://github.com/tiangolo/fastapi/pull/10073) by [@tamtam-fitness](https://github.com/tamtam-fitness).
 * 🌐 Add Ukrainian translation for `docs/uk/docs/fastapi-people.md`. PR [#10059](https://github.com/tiangolo/fastapi/pull/10059) by [@rostik1410](https://github.com/rostik1410).
 * 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/cookie-params.md`. PR [#10032](https://github.com/tiangolo/fastapi/pull/10032) by [@rostik1410](https://github.com/rostik1410).

From dafaf6a34c7ed8723400d16b15926cb06ad926fb Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 14 Aug 2023 09:17:05 +0000
Subject: [PATCH 105/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ed67dbca8..e8539075d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Japanese translation for `docs/ja/docs/deployment/concepts.md`. PR [#10062](https://github.com/tiangolo/fastapi/pull/10062) by [@tamtam-fitness](https://github.com/tamtam-fitness).
 * 🌐 Add Japanese translation for `docs/ja/docs/deployment/server-workers.md`. PR [#10064](https://github.com/tiangolo/fastapi/pull/10064) by [@tamtam-fitness](https://github.com/tamtam-fitness).
 * 🌐 Update Japanese translation for `docs/ja/docs/deployment/docker.md`. PR [#10073](https://github.com/tiangolo/fastapi/pull/10073) by [@tamtam-fitness](https://github.com/tamtam-fitness).
 * 🌐 Add Ukrainian translation for `docs/uk/docs/fastapi-people.md`. PR [#10059](https://github.com/tiangolo/fastapi/pull/10059) by [@rostik1410](https://github.com/rostik1410).

From 5e8f7f13d704734b8d75b3a0645360e4f77a6a24 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Mon, 14 Aug 2023 11:49:57 +0200
Subject: [PATCH 106/317] =?UTF-8?q?=E2=9C=A8=20Add=20`ResponseValidationEr?=
 =?UTF-8?q?ror`=20printable=20details,=20to=20show=20up=20in=20server=20er?=
 =?UTF-8?q?ror=20logs=20(#10078)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 fastapi/exceptions.py                          |  6 ++++++
 ...test_response_model_as_return_annotation.py | 18 ++++++++++++------
 2 files changed, 18 insertions(+), 6 deletions(-)

diff --git a/fastapi/exceptions.py b/fastapi/exceptions.py
index c1692f396..42f4709fb 100644
--- a/fastapi/exceptions.py
+++ b/fastapi/exceptions.py
@@ -47,3 +47,9 @@ class ResponseValidationError(ValidationException):
     def __init__(self, errors: Sequence[Any], *, body: Any = None) -> None:
         super().__init__(errors)
         self.body = body
+
+    def __str__(self) -> str:
+        message = f"{len(self._errors)} validation errors:\n"
+        for err in self._errors:
+            message += f"  {err}\n"
+        return message
diff --git a/tests/test_response_model_as_return_annotation.py b/tests/test_response_model_as_return_annotation.py
index 85dd450eb..6948430a1 100644
--- a/tests/test_response_model_as_return_annotation.py
+++ b/tests/test_response_model_as_return_annotation.py
@@ -277,13 +277,15 @@ def test_response_model_no_annotation_return_exact_dict():
 
 
 def test_response_model_no_annotation_return_invalid_dict():
-    with pytest.raises(ResponseValidationError):
+    with pytest.raises(ResponseValidationError) as excinfo:
         client.get("/response_model-no_annotation-return_invalid_dict")
+    assert "missing" in str(excinfo.value)
 
 
 def test_response_model_no_annotation_return_invalid_model():
-    with pytest.raises(ResponseValidationError):
+    with pytest.raises(ResponseValidationError) as excinfo:
         client.get("/response_model-no_annotation-return_invalid_model")
+    assert "missing" in str(excinfo.value)
 
 
 def test_response_model_no_annotation_return_dict_with_extra_data():
@@ -313,13 +315,15 @@ def test_no_response_model_annotation_return_exact_dict():
 
 
 def test_no_response_model_annotation_return_invalid_dict():
-    with pytest.raises(ResponseValidationError):
+    with pytest.raises(ResponseValidationError) as excinfo:
         client.get("/no_response_model-annotation-return_invalid_dict")
+    assert "missing" in str(excinfo.value)
 
 
 def test_no_response_model_annotation_return_invalid_model():
-    with pytest.raises(ResponseValidationError):
+    with pytest.raises(ResponseValidationError) as excinfo:
         client.get("/no_response_model-annotation-return_invalid_model")
+    assert "missing" in str(excinfo.value)
 
 
 def test_no_response_model_annotation_return_dict_with_extra_data():
@@ -395,13 +399,15 @@ def test_response_model_model1_annotation_model2_return_exact_dict():
 
 
 def test_response_model_model1_annotation_model2_return_invalid_dict():
-    with pytest.raises(ResponseValidationError):
+    with pytest.raises(ResponseValidationError) as excinfo:
         client.get("/response_model_model1-annotation_model2-return_invalid_dict")
+    assert "missing" in str(excinfo.value)
 
 
 def test_response_model_model1_annotation_model2_return_invalid_model():
-    with pytest.raises(ResponseValidationError):
+    with pytest.raises(ResponseValidationError) as excinfo:
         client.get("/response_model_model1-annotation_model2-return_invalid_model")
+    assert "missing" in str(excinfo.value)
 
 
 def test_response_model_model1_annotation_model2_return_dict_with_extra_data():

From d46cd0b1f0f5ef246286a011959cd6a6b6b98fd6 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 14 Aug 2023 09:50:40 +0000
Subject: [PATCH 107/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index e8539075d..2d09fc400 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ✨ Add `ResponseValidationError` printable details, to show up in server error logs. PR [#10078](https://github.com/tiangolo/fastapi/pull/10078) by [@tiangolo](https://github.com/tiangolo).
 * 🌐 Add Japanese translation for `docs/ja/docs/deployment/concepts.md`. PR [#10062](https://github.com/tiangolo/fastapi/pull/10062) by [@tamtam-fitness](https://github.com/tamtam-fitness).
 * 🌐 Add Japanese translation for `docs/ja/docs/deployment/server-workers.md`. PR [#10064](https://github.com/tiangolo/fastapi/pull/10064) by [@tamtam-fitness](https://github.com/tamtam-fitness).
 * 🌐 Update Japanese translation for `docs/ja/docs/deployment/docker.md`. PR [#10073](https://github.com/tiangolo/fastapi/pull/10073) by [@tamtam-fitness](https://github.com/tamtam-fitness).

From 50b6ff7da65bbd0074f2ae56c688db0115a64c36 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Mon, 14 Aug 2023 12:02:43 +0200
Subject: [PATCH 108/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 32 ++++++++++++++++++++++++--------
 1 file changed, 24 insertions(+), 8 deletions(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2d09fc400..9570bef36 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,7 +2,26 @@
 
 ## Latest Changes
 
+## 0.101.1
+
+### Fixes
+
 * ✨ Add `ResponseValidationError` printable details, to show up in server error logs. PR [#10078](https://github.com/tiangolo/fastapi/pull/10078) by [@tiangolo](https://github.com/tiangolo).
+
+### Refactors
+
+* ✏️ Fix typo in deprecation warnings in `fastapi/params.py`. PR [#9854](https://github.com/tiangolo/fastapi/pull/9854) by [@russbiggs](https://github.com/russbiggs).
+* ✏️ Fix typos in comments on internal code in `fastapi/concurrency.py` and `fastapi/routing.py`. PR [#9590](https://github.com/tiangolo/fastapi/pull/9590) by [@ElliottLarsen](https://github.com/ElliottLarsen).
+
+### Docs
+
+* ✏️ Fix typo in release notes. PR [#9835](https://github.com/tiangolo/fastapi/pull/9835) by [@francisbergin](https://github.com/francisbergin).
+* 📝 Add external article: Build an SMS Spam Classifier Serverless Database with FaunaDB and FastAPI. PR [#9847](https://github.com/tiangolo/fastapi/pull/9847) by [@adejumoridwan](https://github.com/adejumoridwan).
+* 📝 Fix typo in `docs/en/docs/contributing.md`. PR [#9878](https://github.com/tiangolo/fastapi/pull/9878) by [@VicenteMerino](https://github.com/VicenteMerino).
+* 📝 Fix code highlighting in `docs/en/docs/tutorial/bigger-applications.md`. PR [#9806](https://github.com/tiangolo/fastapi/pull/9806) by [@theonlykingpin](https://github.com/theonlykingpin).
+
+### Translations
+
 * 🌐 Add Japanese translation for `docs/ja/docs/deployment/concepts.md`. PR [#10062](https://github.com/tiangolo/fastapi/pull/10062) by [@tamtam-fitness](https://github.com/tamtam-fitness).
 * 🌐 Add Japanese translation for `docs/ja/docs/deployment/server-workers.md`. PR [#10064](https://github.com/tiangolo/fastapi/pull/10064) by [@tamtam-fitness](https://github.com/tamtam-fitness).
 * 🌐 Update Japanese translation for `docs/ja/docs/deployment/docker.md`. PR [#10073](https://github.com/tiangolo/fastapi/pull/10073) by [@tamtam-fitness](https://github.com/tamtam-fitness).
@@ -10,16 +29,13 @@
 * 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/cookie-params.md`. PR [#10032](https://github.com/tiangolo/fastapi/pull/10032) by [@rostik1410](https://github.com/rostik1410).
 * 🌐 Add Russian translation for `docs/ru/docs/deployment/docker.md`. PR [#9971](https://github.com/tiangolo/fastapi/pull/9971) by [@Xewus](https://github.com/Xewus).
 * 🌐 Add Vietnamese translation for `docs/vi/docs/python-types.md`. PR [#10047](https://github.com/tiangolo/fastapi/pull/10047) by [@magiskboy](https://github.com/magiskboy).
-* 🔧 Add sponsor Porter. PR [#10051](https://github.com/tiangolo/fastapi/pull/10051) by [@tiangolo](https://github.com/tiangolo).
-* 🔧 Update sponsors, add Jina back as bronze sponsor. PR [#10050](https://github.com/tiangolo/fastapi/pull/10050) by [@tiangolo](https://github.com/tiangolo).
-* ✏️ Fix typo in deprecation warnings in `fastapi/params.py`. PR [#9854](https://github.com/tiangolo/fastapi/pull/9854) by [@russbiggs](https://github.com/russbiggs).
-* ✏️ Fix typo in release notes. PR [#9835](https://github.com/tiangolo/fastapi/pull/9835) by [@francisbergin](https://github.com/francisbergin).
-* ✏️ Fix typos in comments on internal code in `fastapi/concurrency.py` and `fastapi/routing.py`. PR [#9590](https://github.com/tiangolo/fastapi/pull/9590) by [@ElliottLarsen](https://github.com/ElliottLarsen).
-* 📝 Add external article: Build an SMS Spam Classifier Serverless Database with FaunaDB and FastAPI. PR [#9847](https://github.com/tiangolo/fastapi/pull/9847) by [@adejumoridwan](https://github.com/adejumoridwan).
-* 📝 Fix typo in `docs/en/docs/contributing.md`. PR [#9878](https://github.com/tiangolo/fastapi/pull/9878) by [@VicenteMerino](https://github.com/VicenteMerino).
-* 📝 Fix code highlighting in `docs/en/docs/tutorial/bigger-applications.md`. PR [#9806](https://github.com/tiangolo/fastapi/pull/9806) by [@theonlykingpin](https://github.com/theonlykingpin).
 * 🌐 Add Russian translation for `docs/ru/docs/tutorial/dependencies/global-dependencies.md`. PR [#9970](https://github.com/tiangolo/fastapi/pull/9970) by [@dudyaosuplayer](https://github.com/dudyaosuplayer).
 * 🌐 Add Urdu translation for `docs/ur/docs/benchmarks.md`. PR [#9974](https://github.com/tiangolo/fastapi/pull/9974) by [@AhsanSheraz](https://github.com/AhsanSheraz).
+
+### Internal
+
+* 🔧 Add sponsor Porter. PR [#10051](https://github.com/tiangolo/fastapi/pull/10051) by [@tiangolo](https://github.com/tiangolo).
+* 🔧 Update sponsors, add Jina back as bronze sponsor. PR [#10050](https://github.com/tiangolo/fastapi/pull/10050) by [@tiangolo](https://github.com/tiangolo).
 * ⬆ Bump mypy from 1.4.0 to 1.4.1. PR [#9756](https://github.com/tiangolo/fastapi/pull/9756) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ Bump mkdocs-material from 9.1.17 to 9.1.21. PR [#9960](https://github.com/tiangolo/fastapi/pull/9960) by [@dependabot[bot]](https://github.com/apps/dependabot).
 

From 63e7edb2951b36b494176e2f6a22819fcd3feb17 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Mon, 14 Aug 2023 12:03:14 +0200
Subject: [PATCH 109/317] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.10?=
 =?UTF-8?q?1.1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 fastapi/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index c113ac1fd..d8abf2103 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.101.0"
+__version__ = "0.101.1"
 
 from starlette import status as status
 

From e93d15cf9a4820cfa69e6d2f62094720a71d619d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 17 Aug 2023 10:51:58 +0200
Subject: [PATCH 110/317] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors,=20add?=
 =?UTF-8?q?=20Speakeasy=20(#10098)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                               |   2 ++
 docs/en/data/sponsors.yml               |   3 +++
 docs/en/data/sponsors_badge.yml         |   1 +
 docs/en/docs/img/sponsors/speakeasy.png | Bin 0 -> 4790 bytes
 4 files changed, 6 insertions(+)
 create mode 100644 docs/en/docs/img/sponsors/speakeasy.png

diff --git a/README.md b/README.md
index 50f80ded6..266213426 100644
--- a/README.md
+++ b/README.md
@@ -49,6 +49,7 @@ The key features are:
 <a href="https://cryptapi.io/" target="_blank" title="CryptAPI: Your easy to use, secure and privacy oriented payment gateway."><img src="https://fastapi.tiangolo.com/img/sponsors/cryptapi.svg"></a>
 <a href="https://platform.sh/try-it-now/?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023" target="_blank" title="Build, run and scale your apps on a modern, reliable, and secure PaaS."><img src="https://fastapi.tiangolo.com/img/sponsors/platform-sh.png"></a>
 <a href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=main-badge" target="_blank" title="Fern | SDKs and API docs"><img src="https://fastapi.tiangolo.com/img/sponsors/fern.svg"></a>
+<a href="https://www.porter.run" target="_blank" title="Deploy FastAPI on AWS with a few clicks"><img src="https://fastapi.tiangolo.com/img/sponsors/porter.png"></a>
 <a href="https://www.deta.sh/?ref=fastapi" target="_blank" title="The launchpad for all your (team's) ideas"><img src="https://fastapi.tiangolo.com/img/sponsors/deta.svg"></a>
 <a href="https://training.talkpython.fm/fastapi-courses" target="_blank" title="FastAPI video courses on demand from people you trust"><img src="https://fastapi.tiangolo.com/img/sponsors/talkpython.png"></a>
 <a href="https://testdriven.io/courses/tdd-fastapi/" target="_blank" title="Learn to build high-quality web apps with best practices"><img src="https://fastapi.tiangolo.com/img/sponsors/testdriven.svg"></a>
@@ -56,6 +57,7 @@ The key features are:
 <a href="https://careers.powens.com/" target="_blank" title="Powens is hiring!"><img src="https://fastapi.tiangolo.com/img/sponsors/powens.png"></a>
 <a href="https://www.svix.com/" target="_blank" title="Svix - Webhooks as a service"><img src="https://fastapi.tiangolo.com/img/sponsors/svix.svg"></a>
 <a href="https://databento.com/" target="_blank" title="Pay as you go for market data"><img src="https://fastapi.tiangolo.com/img/sponsors/databento.svg"></a>
+<a href="https://speakeasyapi.dev?utm_source=fastapi+repo&utm_medium=github+sponsorship" target="_blank" title="SDKs for your API | Speakeasy"><img src="https://fastapi.tiangolo.com/img/sponsors/speakeasy.png"></a>
 
 <!-- /sponsors -->
 
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index 6d9119520..0d9597f07 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -33,6 +33,9 @@ silver:
   - url: https://databento.com/
     title: Pay as you go for market data
     img: https://fastapi.tiangolo.com/img/sponsors/databento.svg
+  - url: https://speakeasyapi.dev?utm_source=fastapi+repo&utm_medium=github+sponsorship
+    title: SDKs for your API | Speakeasy
+    img: https://fastapi.tiangolo.com/img/sponsors/speakeasy.png
 bronze:
   - url: https://www.exoflare.com/open-source/?utm_source=FastAPI&utm_campaign=open_source
     title: Biosecurity risk assessments made easy.
diff --git a/docs/en/data/sponsors_badge.yml b/docs/en/data/sponsors_badge.yml
index 7c3bb2f47..7b605e0ff 100644
--- a/docs/en/data/sponsors_badge.yml
+++ b/docs/en/data/sponsors_badge.yml
@@ -19,3 +19,4 @@ logins:
   - Flint-company
   - porter-dev
   - fern-api
+  - ndimares
diff --git a/docs/en/docs/img/sponsors/speakeasy.png b/docs/en/docs/img/sponsors/speakeasy.png
new file mode 100644
index 0000000000000000000000000000000000000000..001b4b4caffe26d75892dd040064c5d5f4c1ff22
GIT binary patch
literal 4790
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
JRI6we`aev(U(5gi

literal 0
HcmV?d00001


From a6ae5af7d6c9e7e33490307cccff66a49671433b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 17 Aug 2023 08:52:40 +0000
Subject: [PATCH 111/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 9570bef36..6ef2e6a45 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🔧 Update sponsors, add Speakeasy. PR [#10098](https://github.com/tiangolo/fastapi/pull/10098) by [@tiangolo](https://github.com/tiangolo).
 ## 0.101.1
 
 ### Fixes

From d4201a49bc2e693afba554c1d73d9ce06a042383 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 19 Aug 2023 15:11:35 +0200
Subject: [PATCH 112/317] =?UTF-8?q?=F0=9F=93=9D=20Restructure=20docs=20for?=
 =?UTF-8?q?=20cloud=20providers,=20include=20links=20to=20sponsors=20(#101?=
 =?UTF-8?q?10)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .gitignore                       |   3 +
 docs/em/docs/deployment/deta.md  | 258 --------------------
 docs/en/docs/deployment/cloud.md |  17 ++
 docs/en/docs/deployment/deta.md  | 391 -------------------------------
 docs/en/mkdocs.yml               |   2 +-
 docs/fr/docs/deployment/deta.md  | 245 -------------------
 docs/ja/docs/deployment/deta.md  | 240 -------------------
 docs/pt/docs/deployment/deta.md  | 258 --------------------
 8 files changed, 21 insertions(+), 1393 deletions(-)
 delete mode 100644 docs/em/docs/deployment/deta.md
 create mode 100644 docs/en/docs/deployment/cloud.md
 delete mode 100644 docs/en/docs/deployment/deta.md
 delete mode 100644 docs/fr/docs/deployment/deta.md
 delete mode 100644 docs/ja/docs/deployment/deta.md
 delete mode 100644 docs/pt/docs/deployment/deta.md

diff --git a/.gitignore b/.gitignore
index d380d16b7..9be494cec 100644
--- a/.gitignore
+++ b/.gitignore
@@ -25,3 +25,6 @@ archive.zip
 *~
 .*.sw?
 .cache
+
+# macOS
+.DS_Store
diff --git a/docs/em/docs/deployment/deta.md b/docs/em/docs/deployment/deta.md
deleted file mode 100644
index 89b6c4bdb..000000000
--- a/docs/em/docs/deployment/deta.md
+++ /dev/null
@@ -1,258 +0,0 @@
-# 🛠️ FastAPI 🔛 🪔
-
-👉 📄 👆 🔜 💡 ❔ 💪 🛠️ **FastAPI** 🈸 🔛 <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">🪔</a> ⚙️ 🆓 📄. 👶
-
-⚫️ 🔜 ✊ 👆 🔃 **1️⃣0️⃣ ⏲**.
-
-!!! info
-    <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">🪔</a> **FastAPI** 💰. 👶
-
-## 🔰 **FastAPI** 📱
-
-* ✍ 📁 👆 📱, 🖼, `./fastapideta/` &amp; ⛔ 🔘 ⚫️.
-
-### FastAPI 📟
-
-* ✍ `main.py` 📁 ⏮️:
-
-```Python
-from fastapi import FastAPI
-
-app = FastAPI()
-
-
-@app.get("/")
-def read_root():
-    return {"Hello": "World"}
-
-
-@app.get("/items/{item_id}")
-def read_item(item_id: int):
-    return {"item_id": item_id}
-```
-
-### 📄
-
-🔜, 🎏 📁 ✍ 📁 `requirements.txt` ⏮️:
-
-```text
-fastapi
-```
-
-!!! tip
-    👆 🚫 💪 ❎ Uvicorn 🛠️ 🔛 🪔, 👐 👆 🔜 🎲 💚 ❎ ⚫️ 🌐 💯 👆 📱.
-
-### 📁 📊
-
-👆 🔜 🔜 ✔️ 1️⃣ 📁 `./fastapideta/` ⏮️ 2️⃣ 📁:
-
-```
-.
-└── main.py
-└── requirements.txt
-```
-
-## ✍ 🆓 🪔 🏧
-
-🔜 ✍ <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">🆓 🏧 🔛 🪔</a>, 👆 💪 📧 &amp; 🔐.
-
-👆 🚫 💪 💳.
-
-## ❎ ✳
-
-🕐 👆 ✔️ 👆 🏧, ❎ 🪔 <abbr title="Command Line Interface application">✳</abbr>:
-
-=== "💾, 🇸🇻"
-
-    <div class="termy">
-
-    ```console
-    $ curl -fsSL https://get.deta.dev/cli.sh | sh
-    ```
-
-    </div>
-
-=== "🚪 📋"
-
-    <div class="termy">
-
-    ```console
-    $ iwr https://get.deta.dev/cli.ps1 -useb | iex
-    ```
-
-    </div>
-
-⏮️ ❎ ⚫️, 📂 🆕 📶 👈 ❎ ✳ 🔍.
-
-🆕 📶, ✔ 👈 ⚫️ ☑ ❎ ⏮️:
-
-<div class="termy">
-
-```console
-$ deta --help
-
-Deta command line interface for managing deta micros.
-Complete documentation available at https://docs.deta.sh
-
-Usage:
-  deta [flags]
-  deta [command]
-
-Available Commands:
-  auth        Change auth settings for a deta micro
-
-...
-```
-
-</div>
-
-!!! tip
-    🚥 👆 ✔️ ⚠ ❎ ✳, ✅ <a href="https://docs.deta.sh/docs/micros/getting_started?ref=fastapi" class="external-link" target="_blank">🛂 🪔 🩺</a>.
-
-## 💳 ⏮️ ✳
-
-🔜 💳 🪔 ⚪️➡️ ✳ ⏮️:
-
-<div class="termy">
-
-```console
-$ deta login
-
-Please, log in from the web page. Waiting..
-Logged in successfully.
-```
-
-</div>
-
-👉 🔜 📂 🕸 🖥 &amp; 🔓 🔁.
-
-## 🛠️ ⏮️ 🪔
-
-⏭, 🛠️ 👆 🈸 ⏮️ 🪔 ✳:
-
-<div class="termy">
-
-```console
-$ deta new
-
-Successfully created a new micro
-
-// Notice the "endpoint" 🔍
-
-{
-    "name": "fastapideta",
-    "runtime": "python3.7",
-    "endpoint": "https://qltnci.deta.dev",
-    "visor": "enabled",
-    "http_auth": "enabled"
-}
-
-Adding dependencies...
-
-
----> 100%
-
-
-Successfully installed fastapi-0.61.1 pydantic-1.7.2 starlette-0.13.6
-```
-
-</div>
-
-👆 🔜 👀 🎻 📧 🎏:
-
-```JSON hl_lines="4"
-{
-        "name": "fastapideta",
-        "runtime": "python3.7",
-        "endpoint": "https://qltnci.deta.dev",
-        "visor": "enabled",
-        "http_auth": "enabled"
-}
-```
-
-!!! tip
-    👆 🛠️ 🔜 ✔️ 🎏 `"endpoint"` 📛.
-
-## ✅ ⚫️
-
-🔜 📂 👆 🖥 👆 `endpoint` 📛. 🖼 🔛 ⚫️ `https://qltnci.deta.dev`, ✋️ 👆 🔜 🎏.
-
-👆 🔜 👀 🎻 📨 ⚪️➡️ 👆 FastAPI 📱:
-
-```JSON
-{
-    "Hello": "World"
-}
-```
-
-&amp; 🔜 🚶 `/docs` 👆 🛠️, 🖼 🔛 ⚫️ 🔜 `https://qltnci.deta.dev/docs`.
-
-⚫️ 🔜 🎦 👆 🩺 💖:
-
-<img src="/img/deployment/deta/image01.png">
-
-## 🛠️ 📢 🔐
-
-🔢, 🪔 🔜 🍵 🤝 ⚙️ 🍪 👆 🏧.
-
-✋️ 🕐 👆 🔜, 👆 💪 ⚒ ⚫️ 📢 ⏮️:
-
-<div class="termy">
-
-```console
-$ deta auth disable
-
-Successfully disabled http auth
-```
-
-</div>
-
-🔜 👆 💪 💰 👈 📛 ⏮️ 🙆 &amp; 👫 🔜 💪 🔐 👆 🛠️. 👶
-
-## 🇺🇸🔍
-
-㊗ ❗ 👆 🛠️ 👆 FastAPI 📱 🪔 ❗ 👶 👶
-
-, 👀 👈 🪔 ☑ 🍵 🇺🇸🔍 👆, 👆 🚫 ✔️ ✊ 💅 👈 &amp; 💪 💭 👈 👆 👩‍💻 🔜 ✔️ 🔐 🗜 🔗. 👶 👶
-
-## ✅ 🕶
-
-⚪️➡️ 👆 🩺 🎚 (👫 🔜 📛 💖 `https://qltnci.deta.dev/docs`) 📨 📨 👆 *➡ 🛠️* `/items/{item_id}`.
-
-🖼 ⏮️ 🆔 `5`.
-
-🔜 🚶 <a href="https://web.deta.sh/" class="external-link" target="_blank">https://web.deta.sh</a>.
-
-👆 🔜 👀 📤 📄 ◀️ 🤙 <abbr title="it comes from Micro(server)">"◾"</abbr> ⏮️ 🔠 👆 📱.
-
-👆 🔜 👀 📑 ⏮️ "ℹ", &amp; 📑 "🕶", 🚶 📑 "🕶".
-
-📤 👆 💪 ✔ ⏮️ 📨 📨 👆 📱.
-
-👆 💪 ✍ 👫 &amp; 🏤-🤾 👫.
-
-<img src="/img/deployment/deta/image02.png">
-
-## 💡 🌅
-
-☝, 👆 🔜 🎲 💚 🏪 💽 👆 📱 🌌 👈 😣 🔘 🕰. 👈 👆 💪 ⚙️ <a href="https://docs.deta.sh/docs/base/py_tutorial?ref=fastapi" class="external-link" target="_blank">🪔 🧢</a>, ⚫️ ✔️ 👍 **🆓 🎚**.
-
-👆 💪 ✍ 🌅 <a href="https://docs.deta.sh?ref=fastapi" class="external-link" target="_blank">🪔 🩺</a>.
-
-## 🛠️ 🔧
-
-👟 🔙 🔧 👥 🔬 [🛠️ 🔧](./concepts.md){.internal-link target=_blank}, 📥 ❔ 🔠 👫 🔜 🍵 ⏮️ 🪔:
-
-* **🇺🇸🔍**: 🍵 🪔, 👫 🔜 🤝 👆 📁 &amp; 🍵 🇺🇸🔍 🔁.
-* **🏃‍♂ 🔛 🕴**: 🍵 🪔, 🍕 👫 🐕‍🦺.
-* **⏏**: 🍵 🪔, 🍕 👫 🐕‍🦺.
-* **🧬**: 🍵 🪔, 🍕 👫 🐕‍🦺.
-* **💾**: 📉 🔁 🪔, 👆 💪 📧 👫 📈 ⚫️.
-* **⏮️ 🔁 ⏭ ▶️**: 🚫 🔗 🐕‍🦺, 👆 💪 ⚒ ⚫️ 👷 ⏮️ 👫 💾 ⚙️ ⚖️ 🌖 ✍.
-
-!!! note
-    🪔 🔧 ⚒ ⚫️ ⏩ (&amp; 🆓) 🛠️ 🙅 🈸 🔜.
-
-    ⚫️ 💪 📉 📚 ⚙️ 💼, ✋️ 🎏 🕰, ⚫️ 🚫 🐕‍🦺 🎏, 💖 ⚙️ 🔢 💽 (↖️ ⚪️➡️ 🪔 👍 ☁ 💽 ⚙️), 🛃 🕹 🎰, ♒️.
-
-    👆 💪 ✍ 🌅 ℹ <a href="https://docs.deta.sh/docs/micros/about/" class="external-link" target="_blank">🪔 🩺</a> 👀 🚥 ⚫️ ▶️️ ⚒ 👆.
diff --git a/docs/en/docs/deployment/cloud.md b/docs/en/docs/deployment/cloud.md
new file mode 100644
index 000000000..b2836aeb4
--- /dev/null
+++ b/docs/en/docs/deployment/cloud.md
@@ -0,0 +1,17 @@
+# Deploy FastAPI on Cloud Providers
+
+You can use virtually **any cloud provider** to deploy your FastAPI application.
+
+In most of the cases, the main cloud providers have guides to deploy FastAPI with them.
+
+## Cloud Providers - Sponsors
+
+Some cloud providers ✨ [**sponsor FastAPI**](../help-fastapi.md#sponsor-the-author){.internal-link target=_blank} ✨, this ensures the continued and healthy **development** of FastAPI and its **ecosystem**.
+
+And it shows their true commitment to FastAPI and its **community** (you), as they not only want to provide you a **good service** but also want to make sure you have a **good and healthy framework**, FastAPI. 🙇
+
+You might want to try their services and follow their guides:
+
+* <a href="https://docs.platform.sh/languages/python.html?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023" class="external-link" target="_blank">Platform.sh</a>
+* <a href="https://docs.porter.run/language-specific-guides/fastapi" class="external-link" target="_blank">Porter</a>
+* <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Deta</a>
diff --git a/docs/en/docs/deployment/deta.md b/docs/en/docs/deployment/deta.md
deleted file mode 100644
index 229d7fd5d..000000000
--- a/docs/en/docs/deployment/deta.md
+++ /dev/null
@@ -1,391 +0,0 @@
-# Deploy FastAPI on Deta Space
-
-In this section you will learn how to easily deploy a **FastAPI** application on <a href="https://deta.space?ref=fastapi" class="external-link" target="_blank">Deta Space</a>, for free. 🎁
-
-It will take you about **10 minutes** to deploy an API that you can use. After that, you can optionally release it to anyone.
-
-Let's dive in.
-
-!!! info
-    <a href="https://deta.space?ref=fastapi" class="external-link" target="_blank">Deta</a> is a **FastAPI** sponsor. 🎉
-
-## A simple **FastAPI** app
-
-* To start, create an empty directory with the name of your app, for example `./fastapi-deta/`, and then navigate into it.
-
-```console
-$ mkdir fastapi-deta
-$ cd fastapi-deta
-```
-
-### FastAPI code
-
-* Create a `main.py` file with:
-
-```Python
-from fastapi import FastAPI
-
-app = FastAPI()
-
-
-@app.get("/")
-def read_root():
-    return {"Hello": "World"}
-
-
-@app.get("/items/{item_id}")
-def read_item(item_id: int):
-    return {"item_id": item_id}
-```
-
-### Requirements
-
-Now, in the same directory create a file `requirements.txt` with:
-
-```text
-fastapi
-uvicorn[standard]
-```
-
-### Directory structure
-
-You will now have a directory `./fastapi-deta/` with two files:
-
-```
-.
-└── main.py
-└── requirements.txt
-```
-
-## Create a free **Deta Space** account
-
-Next, create a free account on <a href="https://deta.space/signup?dev_mode=true&ref=fastapi" class="external-link" target="_blank">Deta Space</a>, you just need an email and password.
-
-You don't even need a credit card, but make sure **Developer Mode** is enabled when you sign up.
-
-
-## Install the CLI
-
-Once you have your account, install the Deta Space <abbr title="Command Line Interface application">CLI</abbr>:
-
-=== "Linux, macOS"
-
-    <div class="termy">
-
-    ```console
-    $ curl -fsSL https://get.deta.dev/space-cli.sh | sh
-    ```
-
-    </div>
-
-=== "Windows PowerShell"
-
-    <div class="termy">
-
-    ```console
-    $ iwr https://get.deta.dev/space-cli.ps1 -useb | iex
-    ```
-
-    </div>
-
-After installing it, open a new terminal so that the installed CLI is detected.
-
-In a new terminal, confirm that it was correctly installed with:
-
-<div class="termy">
-
-```console
-$ space --help
-
-Deta command line interface for managing deta micros.
-Complete documentation available at https://deta.space/docs
-
-Usage:
-  space [flags]
-  space [command]
-
-Available Commands:
-  help        Help about any command
-  link        link code to project
-  login       login to space
-  new         create new project
-  push        push code for project
-  release     create release for a project
-  validate    validate spacefile in dir
-  version     Space CLI version
-...
-```
-
-</div>
-
-!!! tip
-    If you have problems installing the CLI, check the official <a href="https://deta.space/docs/en/basics/cli?ref=fastapi" class="external-link" target="_blank">Deta Space Documentation</a>.
-
-## Login with the CLI
-
-In order to authenticate your CLI with Deta Space, you will need an access token.
-
-To obtain this token, open your <a href="https://deta.space/login?ref=fastapi" class="external-link" target="_blank">Deta Space Canvas</a>, open the **Teletype** (command bar at the bottom of the Canvas), and then click on **Settings**. From there, select **Generate Token** and copy the resulting token.
-
-<img src="/img/deployment/deta/image03.png">
-
-Now run `space login` from the Space CLI. Upon pasting the token into the CLI prompt and pressing enter, you should see a confirmation message.
-
-<div class="termy">
-
-```console
-$ space login
-
-To authenticate the Space CLI with your Space account, generate a new access token in your Space settings and paste it below:
-
-# Enter access token (41 chars) >$ *****************************************
-
-👍 Login Successful!
-```
-
-</div>
-
-## Create a new project in Space
-
-Now that you've authenticated with the Space CLI, use it to create a new <a href="https://deta.space/docs/en/basics/projects" class="external-link" target="_blank">Space Project</a>:
-
-```console
-$ space new
-
-# What is your project's name? >$ fastapi-deta
-```
-
-The Space CLI will ask you to name the project, we will call ours `fastapi-deta`.
-
-Then, it will try to automatically detect which framework or language you are using, showing you what it finds. In our case it will identify the Python app with the following message, prompting you to confirm:
-
-```console
-⚙️ No Spacefile found, trying to auto-detect configuration ...
-👇 Deta detected the following configuration:
-
-Micros:
-name: fastapi-deta
- L src: .
- L engine: python3.9
-
-# Do you want to bootstrap "fastapi-deta" with this configuration? (y/n)$ y
-```
-
-After you confirm, your project will be created in Deta Space inside a special app called <a href="https://deta.space/docs/en/basics/projects#projects-in-builder?ref=fastapi" class="external-link" target="_blank">Builder</a>. Builder is a toolbox that helps you to create and manage your apps in Deta Space.
-
-The CLI will also create a `Spacefile` locally in the `fastapi-deta` directory. The <a href="https://deta.space/docs/en/reference/spacefile?ref=fastapi" class="external-link" target="_blank">Spacefile</a> is a configuration file which tells Deta Space how to run your app. The `Spacefile` for your app will be as follows:
-
-```yaml
-v: 0
-micros:
-  - name: fastapi-deta
-    src: .
-    engine: python3.9
-```
-
-It is a `yaml` file, and you can use it to add features like scheduled tasks or modify how your app functions, which we'll do later. To learn more, read <a href="https://deta.space/docs/en/reference/spacefile" class="external-link" target="_blank">the `Spacefile` documentation</a>.
-
-!!! tip
-    The Space CLI will also create a hidden `.space` folder in your local directory to link your local environment with Deta Space. This folder should not be included in your version control and will automatically be added to your `.gitignore` file, if you have initialized a Git repository.
-
-## Define the run command in the Spacefile
-
-The `run` command in the Spacefile tells Space what command should be executed to start your app. In this case it would be `uvicorn main:app`.
-
-```diff
-v: 0
-micros:
-  - name: fastapi-deta
-    src: .
-    engine: python3.9
-+   run: uvicorn main:app
-```
-
-## Deploy to Deta Space
-
-To get your FastAPI live in the cloud, use one more CLI command:
-
-<div class="termy">
-
-```console
-$ space push
-
----> 100%
-
-build complete... created revision: satyr-jvjk
-
-✔ Successfully pushed your code and created a new Revision!
-ℹ Updating your development instance with the latest Revision, it will be available on your Canvas shortly.
-```
-</div>
-
-This command will package your code, upload all the necessary files to Deta Space, and run a remote build of your app, resulting in a **revision**. Whenever you run `space push` successfully, a live instance of your API is automatically updated with the latest revision.
-
-!!! tip
-    You can manage your <a href="https://deta.space/docs/en/basics/revisions#whats-a-revision" class="external-link" target="_blank">revisions</a> by opening your project in the Builder app. The live copy of your API will be visible under the **Develop** tab in Builder.
-
-## Check it
-
-The live instance of your API will also be added automatically to your Canvas (the dashboard) on Deta Space.
-
-<img src="/img/deployment/deta/image04.png">
-
-Click on the new app called `fastapi-deta`, and it will open your API in a new browser tab on a URL like `https://fastapi-deta-gj7ka8.deta.app/`.
-
-You will get a JSON response from your FastAPI app:
-
-```JSON
-{
-    "Hello": "World"
-}
-```
-
-And now you can head over to the `/docs` of your API. For this example, it would be `https://fastapi-deta-gj7ka8.deta.app/docs`.
-
-<img src="/img/deployment/deta/image05.png">
-
-## Enable public access
-
-Deta will handle authentication for your account using cookies. By default, every app or API that you `push` or install to your Space is personal - it's only accessible to you.
-
-But you can also make your API public using the `Spacefile` from earlier.
-
-With a `public_routes` parameter, you can specify which paths of your API should be available to the public.
-
-Set your `public_routes` to `"*"` to open every route of your API to the public:
-
-```yaml
-v: 0
-micros:
-  - name: fastapi-deta
-    src: .
-    engine: python3.9
-    public_routes:
-      - "/*"
-```
-
-Then run `space push` again to update your live API on Deta Space.
-
-Once it deploys, you can share your URL with anyone and they will be able to access your API. 🚀
-
-## HTTPS
-
-Congrats! You deployed your FastAPI app to Deta Space! 🎉 🍰
-
-Also, notice that Deta Space correctly handles HTTPS for you, so you don't have to take care of that and can be sure that your users will have a secure encrypted connection. ✅ 🔒
-
-## Create a release
-
-Space also allows you to publish your API. When you publish it, anyone else can install their own copy of your API, in their own Deta Space cloud.
-
-To do so, run `space release` in the Space CLI to create an **unlisted release**:
-
-<div class="termy">
-
-```console
-$ space release
-
-# Do you want to use the latest revision (buzzard-hczt)? (y/n)$ y
-
-~ Creating a Release with the latest Revision
-
----> 100%
-
-creating release...
-publishing release in edge locations..
-completed...
-released: fastapi-deta-exp-msbu
-https://deta.space/discovery/r/5kjhgyxewkdmtotx
-
- Lift off -- successfully created a new Release!
- Your Release is available globally on 5 Deta Edges
- Anyone can install their own copy of your app.
-```
-</div>
-
-This command publishes your revision as a release and gives you a link. Anyone you give this link to can install your API.
-
-
-You can also make your app publicly discoverable by creating a **listed release** with `space release --listed` in the Space CLI:
-
-<div class="termy">
-
-```console
-$ space release --listed
-
-# Do you want to use the latest revision (buzzard-hczt)? (y/n)$ y
-
-~ Creating a listed Release with the latest Revision ...
-
-creating release...
-publishing release in edge locations..
-completed...
-released: fastapi-deta-exp-msbu
-https://deta.space/discovery/@user/fastapi-deta
-
- Lift off -- successfully created a new Release!
- Your Release is available globally on 5 Deta Edges
- Anyone can install their own copy of your app.
- Listed on Discovery for others to find!
-```
-</div>
-
-This will allow anyone to find and install your app via <a href="https://deta.space/discovery?ref=fastapi" class="external-link" target="_blank">Deta Discovery</a>. Read more about <a href="https://deta.space/docs/en/basics/releases?ref=fastapi" class="external-link" target="_blank">releasing your app in the docs</a>.
-
-## Check runtime logs
-
-Deta Space also lets you inspect the logs of every app you build or install.
-
-Add some logging functionality to your app by adding a `print` statement to your `main.py` file.
-
-```py
-from fastapi import FastAPI
-
-app = FastAPI()
-
-
-@app.get("/")
-def read_root():
-    return {"Hello": "World"}
-
-
-@app.get("/items/{item_id}")
-def read_item(item_id: int):
-    print(item_id)
-    return {"item_id": item_id}
-```
-
-The code within the `read_item` function includes a print statement that will output the `item_id` that is included in the URL. Send a request to your _path operation_ `/items/{item_id}` from the docs UI (which will have a URL like `https://fastapi-deta-gj7ka8.deta.app/docs`), using an ID like `5` as an example.
-
-Now go to your <a href="https://deta.space?ref=fastapi" class="external-link" target="_blank">Space's Canvas</a>. Click on the context menu (`...`) of your live app instance, and then click on **View Logs**. Here you can view your app's logs, sorted by time.
-
-<img src="/img/deployment/deta/image06.png">
-
-## Learn more
-
-At some point, you will probably want to store some data for your app in a way that persists through time. For that you can use <a href="https://deta.space/docs/en/basics/data#deta-base?ref=fastapi" class="external-link" target="_blank">Deta Base</a> and <a href="https://deta.space/docs/en/basics/data#deta-drive?ref=fastapi" class="external-link" target="_blank">Deta Drive</a>, both of which have a generous **free tier**.
-
-You can also read more in the <a href="https://deta.space/docs/?ref=fastapi" class="external-link" target="_blank">Deta Space Documentation</a>.
-
-!!! tip
-    If you have any Deta related questions, comments, or feedback, head to the <a href="https://go.deta.dev/discord" class="external-link" target="_blank">Deta Discord server</a>.
-
-
-## Deployment Concepts
-
-Coming back to the concepts we discussed in [Deployments Concepts](./concepts.md){.internal-link target=_blank}, here's how each of them would be handled with Deta Space:
-
-- **HTTPS**: Handled by Deta Space, they will give you a subdomain and handle HTTPS automatically.
-- **Running on startup**: Handled by Deta Space, as part of their service.
-- **Restarts**: Handled by Deta Space, as part of their service.
-- **Replication**: Handled by Deta Space, as part of their service.
-- **Authentication**: Handled by Deta Space, as part of their service.
-- **Memory**: Limit predefined by Deta Space, you could contact them to increase it.
-- **Previous steps before starting**: Can be configured using the <a href="https://deta.space/docs/en/reference/spacefile?ref=fastapi" class="external-link" target="_blank">`Spacefile`</a>.
-
-!!! note
-    Deta Space is designed to make it easy and free to build cloud applications for yourself. Then you can optionally share them with anyone.
-
-    It can simplify several use cases, but at the same time, it doesn't support others, like using external databases (apart from Deta's own NoSQL database system), custom virtual machines, etc.
-
-    You can read more details in the <a href="https://deta.space/docs/en/basics/micros?ref=fastapi" class="external-link" target="_blank">Deta Space Documentation</a> to see if it's the right choice for you.
diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index a66b6c147..2a59be4b0 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -159,7 +159,7 @@ nav:
   - deployment/https.md
   - deployment/manually.md
   - deployment/concepts.md
-  - deployment/deta.md
+  - deployment/cloud.md
   - deployment/server-workers.md
   - deployment/docker.md
 - project-generation.md
diff --git a/docs/fr/docs/deployment/deta.md b/docs/fr/docs/deployment/deta.md
deleted file mode 100644
index cceb7b058..000000000
--- a/docs/fr/docs/deployment/deta.md
+++ /dev/null
@@ -1,245 +0,0 @@
-# Déployer FastAPI sur Deta
-
-Dans cette section, vous apprendrez à déployer facilement une application **FastAPI** sur <a href="https://www.deta.
-sh/?ref=fastapi" class="external-link" target="_blank">Deta</a> en utilisant le plan tarifaire gratuit. 🎁
-
-Cela vous prendra environ **10 minutes**.
-
-!!! info
-    <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Deta</a> sponsorise **FastAPI**. 🎉
-
-## Une application **FastAPI** de base
-
-* Créez un répertoire pour votre application, par exemple `./fastapideta/` et déplacez-vous dedans.
-
-### Le code FastAPI
-
-* Créer un fichier `main.py` avec :
-
-```Python
-from fastapi import FastAPI
-
-app = FastAPI()
-
-
-@app.get("/")
-def read_root():
-    return {"Hello": "World"}
-
-
-@app.get("/items/{item_id}")
-def read_item(item_id: int):
-    return {"item_id": item_id}
-```
-
-### Dépendances
-
-Maintenant, dans le même répertoire, créez un fichier `requirements.txt` avec :
-
-```text
-fastapi
-```
-
-!!! tip "Astuce"
-    Il n'est pas nécessaire d'installer Uvicorn pour déployer sur Deta, bien qu'il soit probablement souhaitable de l'installer localement pour tester votre application.
-
-### Structure du répertoire
-
-Vous aurez maintenant un répertoire `./fastapideta/` avec deux fichiers :
-
-```
-.
-└── main.py
-└── requirements.txt
-```
-
-## Créer un compte gratuit sur Deta
-
-Créez maintenant un <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">compte gratuit
-sur Deta</a>, vous avez juste besoin d'une adresse email et d'un mot de passe.
-
-Vous n'avez même pas besoin d'une carte de crédit.
-
-## Installer le CLI (Interface en Ligne de Commande)
-
-Une fois que vous avez votre compte, installez le  <abbr title="Command Line Interface application">CLI</abbr> de Deta :
-
-=== "Linux, macOS"
-
-    <div class="termy">
-
-    ```console
-    $ curl -fsSL https://get.deta.dev/cli.sh | sh
-    ```
-
-    </div>
-
-=== "Windows PowerShell"
-
-    <div class="termy">
-
-    ```console
-    $ iwr https://get.deta.dev/cli.ps1 -useb | iex
-    ```
-
-    </div>
-
-Après l'avoir installé, ouvrez un nouveau terminal afin que la nouvelle installation soit détectée.
-
-Dans un nouveau terminal, confirmez qu'il a été correctement installé avec :
-
-<div class="termy">
-
-```console
-$ deta --help
-
-Deta command line interface for managing deta micros.
-Complete documentation available at https://docs.deta.sh
-
-Usage:
-  deta [flags]
-  deta [command]
-
-Available Commands:
-  auth        Change auth settings for a deta micro
-
-...
-```
-
-</div>
-
-!!! tip "Astuce"
-    Si vous rencontrez des problèmes pour installer le CLI, consultez la <a href="https://docs.deta. sh/docs/micros/getting_started?ref=fastapi" class="external-link" target="_blank">documentation officielle de Deta (en anglais)</a>.
-
-## Connexion avec le CLI
-
-Maintenant, connectez-vous à Deta depuis le CLI avec :
-
-<div class="termy">
-
-```console
-$ deta login
-
-Please, log in from the web page. Waiting..
-Logged in successfully.
-```
-
-</div>
-
-Cela ouvrira un navigateur web et permettra une authentification automatique.
-
-## Déployer avec Deta
-
-Ensuite, déployez votre application avec le CLI de Deta :
-
-<div class="termy">
-
-```console
-$ deta new
-
-Successfully created a new micro
-
-// Notice the "endpoint" 🔍
-
-{
-    "name": "fastapideta",
-    "runtime": "python3.7",
-    "endpoint": "https://qltnci.deta.dev",
-    "visor": "enabled",
-    "http_auth": "enabled"
-}
-
-Adding dependencies...
-
-
----> 100%
-
-
-Successfully installed fastapi-0.61.1 pydantic-1.7.2 starlette-0.13.6
-```
-
-</div>
-
-Vous verrez un message JSON similaire à :
-
-```JSON hl_lines="4"
-{
-        "name": "fastapideta",
-        "runtime": "python3.7",
-        "endpoint": "https://qltnci.deta.dev",
-        "visor": "enabled",
-        "http_auth": "enabled"
-}
-```
-
-!!! tip "Astuce"
-    Votre déploiement aura une URL `"endpoint"` différente.
-
-## Vérifiez
-
-Maintenant, dans votre navigateur ouvrez votre URL `endpoint`. Dans l'exemple ci-dessus, c'était
-`https://qltnci.deta.dev`, mais la vôtre sera différente.
-
-Vous verrez la réponse JSON de votre application FastAPI :
-
-```JSON
-{
-    "Hello": "World"
-}
-```
-
-Et maintenant naviguez vers `/docs` dans votre API, dans l'exemple ci-dessus ce serait `https://qltnci.deta.dev/docs`.
-
-Vous verrez votre documentation comme suit :
-
-<img src="/img/deployment/deta/image01.png">
-
-## Activer l'accès public
-
-Par défaut, Deta va gérer l'authentification en utilisant des cookies pour votre compte.
-
-Mais une fois que vous êtes prêt, vous pouvez le rendre public avec :
-
-<div class="termy">
-
-```console
-$ deta auth disable
-
-Successfully disabled http auth
-```
-
-</div>
-
-Maintenant, vous pouvez partager cette URL avec n'importe qui et ils seront en mesure d'accéder à votre API. 🚀
-
-## HTTPS
-
-Félicitations ! Vous avez déployé votre application FastAPI sur Deta ! 🎉 🍰
-
-Remarquez également que Deta gère correctement HTTPS pour vous, vous n'avez donc pas à vous en occuper et pouvez être sûr que vos clients auront une connexion cryptée sécurisée. ✅ 🔒
-
-## Vérifiez le Visor
-
-À partir de l'interface graphique de votre documentation (dans une URL telle que `https://qltnci.deta.dev/docs`)
-envoyez une requête à votre *opération de chemin* `/items/{item_id}`.
-
-Par exemple avec l'ID `5`.
-
-Allez maintenant sur <a href="https://web.deta.sh/" class="external-link" target="_blank">https://web.deta.sh</a>.
-
-Vous verrez qu'il y a une section à gauche appelée <abbr title="ça vient de Micro(server)">"Micros"</abbr> avec chacune de vos applications.
-
-Vous verrez un onglet avec "Details", et aussi un onglet "Visor", allez à l'onglet "Visor".
-
-Vous pouvez y consulter les requêtes récentes envoyées à votre application.
-
-Vous pouvez également les modifier et les relancer.
-
-<img src="/img/deployment/deta/image02.png">
-
-## En savoir plus
-
-À un moment donné, vous voudrez probablement stocker certaines données pour votre application d'une manière qui
-persiste dans le temps. Pour cela, vous pouvez utiliser <a href="https://docs.deta.sh/docs/base/py_tutorial?ref=fastapi" class="external-link" target="_blank">Deta Base</a>, il dispose également d'un généreux **plan gratuit**.
-
-Vous pouvez également en lire plus dans la <a href="https://docs.deta.sh?ref=fastapi" class="external-link" target="_blank">documentation Deta</a>.
diff --git a/docs/ja/docs/deployment/deta.md b/docs/ja/docs/deployment/deta.md
deleted file mode 100644
index 723f169a0..000000000
--- a/docs/ja/docs/deployment/deta.md
+++ /dev/null
@@ -1,240 +0,0 @@
-# Deta にデプロイ
-
-このセクションでは、**FastAPI** アプリケーションを <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Deta</a> の無料プランを利用して、簡単にデプロイする方法を学習します。🎁
-
-所要時間は約**10分**です。
-
-!!! info "備考"
-    <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Deta</a> は **FastAPI** のスポンサーです。🎉
-
-## ベーシックな **FastAPI** アプリ
-
-* アプリのためのディレクトリ (例えば `./fastapideta/`) を作成し、その中に入ってください。
-
-### FastAPI のコード
-
-* 以下の `main.py` ファイルを作成してください:
-
-```Python
-from fastapi import FastAPI
-
-app = FastAPI()
-
-
-@app.get("/")
-def read_root():
-    return {"Hello": "World"}
-
-
-@app.get("/items/{item_id}")
-def read_item(item_id: int):
-    return {"item_id": item_id}
-```
-
-### Requirements
-
-では、同じディレクトリに以下の `requirements.txt` ファイルを作成してください:
-
-```text
-fastapi
-```
-
-!!! tip "豆知識"
-    アプリのローカルテストのために Uvicorn をインストールしたくなるかもしれませんが、Deta へのデプロイには不要です。
-
-### ディレクトリ構造
-
-以下の2つのファイルと1つの `./fastapideta/` ディレクトリがあるはずです:
-
-```
-.
-└── main.py
-└── requirements.txt
-```
-
-## Detaの無料アカウントの作成
-
-それでは、<a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Detaの無料アカウント</a>を作成しましょう。必要なものはメールアドレスとパスワードだけです。
-
-クレジットカードさえ必要ありません。
-
-## CLIのインストール
-
-アカウントを取得したら、Deta <abbr title="Command Line Interface application">CLI</abbr> をインストールしてください:
-
-=== "Linux, macOS"
-
-    <div class="termy">
-
-    ```console
-    $ curl -fsSL https://get.deta.dev/cli.sh | sh
-    ```
-
-    </div>
-
-=== "Windows PowerShell"
-
-    <div class="termy">
-
-    ```console
-    $ iwr https://get.deta.dev/cli.ps1 -useb | iex
-    ```
-
-    </div>
-
-インストールしたら、インストールした CLI を有効にするために新たなターミナルを開いてください。
-
-新たなターミナル上で、正しくインストールされたか確認します:
-
-<div class="termy">
-
-```console
-$ deta --help
-
-Deta command line interface for managing deta micros.
-Complete documentation available at https://docs.deta.sh
-
-Usage:
-  deta [flags]
-  deta [command]
-
-Available Commands:
-  auth        Change auth settings for a deta micro
-
-...
-```
-
-</div>
-
-!!! tip "豆知識"
-    CLI のインストールに問題が発生した場合は、<a href="https://docs.deta.sh/docs/micros/getting_started?ref=fastapi" class="external-link" target="_blank">Deta 公式ドキュメント</a>を参照してください。
-
-## CLIでログイン
-
-CLI から Deta にログインしてみましょう:
-
-<div class="termy">
-
-```console
-$ deta login
-
-Please, log in from the web page. Waiting..
-Logged in successfully.
-```
-
-</div>
-
-自動的にウェブブラウザが開いて、認証処理が行われます。
-
-## Deta でデプロイ
-
-次に、アプリケーションを Deta CLIでデプロイしましょう:
-
-<div class="termy">
-
-```console
-$ deta new
-
-Successfully created a new micro
-
-// Notice the "endpoint" 🔍
-
-{
-    "name": "fastapideta",
-    "runtime": "python3.7",
-    "endpoint": "https://qltnci.deta.dev",
-    "visor": "enabled",
-    "http_auth": "enabled"
-}
-
-Adding dependencies...
-
-
----> 100%
-
-
-Successfully installed fastapi-0.61.1 pydantic-1.7.2 starlette-0.13.6
-```
-
-</div>
-
-次のようなJSONメッセージが表示されます:
-
-```JSON hl_lines="4"
-{
-        "name": "fastapideta",
-        "runtime": "python3.7",
-        "endpoint": "https://qltnci.deta.dev",
-        "visor": "enabled",
-        "http_auth": "enabled"
-}
-```
-
-!!! tip "豆知識"
-    あなたのデプロイでは異なる `"endpoint"` URLが表示されるでしょう。
-
-## 確認
-
-それでは、`endpoint` URLをブラウザで開いてみましょう。上記の例では `https://qltnci.deta.dev` ですが、あなたのURLは異なるはずです。
-
-FastAPIアプリから返ってきたJSONレスポンスが表示されます:
-
-```JSON
-{
-    "Hello": "World"
-}
-```
-
-そして `/docs` へ移動してください。上記の例では、`https://qltnci.deta.dev/docs` です。
-
-次のようなドキュメントが表示されます:
-
-<img src="/img/deployment/deta/image01.png">
-
-## パブリックアクセスの有効化
-
-デフォルトでは、Deta はクッキーを用いてアカウントの認証を行います。
-
-しかし、準備が整えば、以下の様に公開できます:
-
-<div class="termy">
-
-```console
-$ deta auth disable
-
-Successfully disabled http auth
-```
-
-</div>
-
-ここで、URLを共有するとAPIにアクセスできるようになります。🚀
-
-## HTTPS
-
-おめでとうございます！あなたの FastAPI アプリが Deta へデプロイされました！🎉 🍰
-
-また、DetaがHTTPSを正しく処理するため、その処理を行う必要がなく、クライアントは暗号化された安全な通信が利用できます。✅ 🔒
-
-## Visor を確認
-
-ドキュメントUI (`https://qltnci.deta.dev/docs` のようなURLにある) は *path operation* `/items/{item_id}` へリクエストを送ることができます。
-
-ID `5` の例を示します。
-
-まず、<a href="https://web.deta.sh/" class="external-link" target="_blank">https://web.deta.sh</a> へアクセスします。
-
-左側に各アプリの <abbr title="it comes from Micro(server)">「Micros」</abbr> というセクションが表示されます。
-
-また、「Details」や「Visor」タブが表示されています。「Visor」タブへ移動してください。
-
-そこでアプリに送られた直近のリクエストが調べられます。
-
-また、それらを編集してリプレイできます。
-
-<img src="/img/deployment/deta/image02.png">
-
-## さらに詳しく知る
-
-様々な箇所で永続的にデータを保存したくなるでしょう。そのためには <a href="https://docs.deta.sh/docs/base/py_tutorial?ref=fastapi" class="external-link" target="_blank">Deta Base</a> を使用できます。惜しみない **無料利用枠** もあります。
-
-詳しくは <a href="https://docs.deta.sh?ref=fastapi" class="external-link" target="_blank">Deta ドキュメント</a>を参照してください。
diff --git a/docs/pt/docs/deployment/deta.md b/docs/pt/docs/deployment/deta.md
deleted file mode 100644
index 9271bba42..000000000
--- a/docs/pt/docs/deployment/deta.md
+++ /dev/null
@@ -1,258 +0,0 @@
-# Implantação FastAPI na Deta
-
-Nessa seção você aprenderá sobre como realizar a implantação de uma aplicação **FastAPI** na <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Deta</a> utilizando o plano gratuito. 🎁
-
-Isso tudo levará aproximadamente **10 minutos**.
-
-!!! info "Informação"
-    <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Deta</a> é uma  patrocinadora do **FastAPI**. 🎉
-
-## Uma aplicação **FastAPI** simples
-
-* Crie e entre em um diretório para a sua aplicação, por exemplo, `./fastapideta/`.
-
-### Código FastAPI
-
-* Crie o arquivo `main.py` com:
-
-```Python
-from fastapi import FastAPI
-
-app = FastAPI()
-
-
-@app.get("/")
-def read_root():
-    return {"Hello": "World"}
-
-
-@app.get("/items/{item_id}")
-def read_item(item_id: int):
-    return {"item_id": item_id}
-```
-
-### Requisitos
-
-Agora, no mesmo diretório crie o arquivo `requirements.txt` com:
-
-```text
-fastapi
-```
-
-!!! tip "Dica"
-    Você não precisa instalar Uvicorn para realizar a implantação na Deta, embora provavelmente queira instalá-lo para testar seu aplicativo localmente.
-
-### Estrutura de diretório
-
-Agora você terá o diretório `./fastapideta/` com dois arquivos:
-
-```
-.
-└── main.py
-└── requirements.txt
-```
-
-## Crie uma conta gratuita na Deta
-
-Agora crie <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">uma conta gratuita na Deta</a>, você precisará apenas de um email e senha.
-
-Você nem precisa de um cartão de crédito.
-
-## Instale a CLI
-
-Depois de ter sua conta criada, instale Deta <abbr title="Interface de Linha de Comando">CLI</abbr>:
-
-=== "Linux, macOS"
-
-    <div class="termy">
-
-    ```console
-    $ curl -fsSL https://get.deta.dev/cli.sh | sh
-    ```
-
-    </div>
-
-=== "Windows PowerShell"
-
-    <div class="termy">
-
-    ```console
-    $ iwr https://get.deta.dev/cli.ps1 -useb | iex
-    ```
-
-    </div>
-
-Após a instalação, abra um novo terminal para que a CLI seja detectada.
-
-Em um novo terminal, confirme se foi instalado corretamente com:
-
-<div class="termy">
-
-```console
-$ deta --help
-
-Deta command line interface for managing deta micros.
-Complete documentation available at https://docs.deta.sh
-
-Usage:
-  deta [flags]
-  deta [command]
-
-Available Commands:
-  auth        Change auth settings for a deta micro
-
-...
-```
-
-</div>
-
-!!! tip "Dica"
-    Se você tiver problemas ao instalar a CLI, verifique a <a href="https://docs.deta.sh/docs/micros/getting_started?ref=fastapi" class="external-link" target="_blank">documentação oficial da Deta</a>.
-
-## Login pela CLI
-
-Agora faça login na Deta pela CLI com:
-
-<div class="termy">
-
-```console
-$ deta login
-
-Please, log in from the web page. Waiting..
-Logged in successfully.
-```
-
-</div>
-
-Isso abrirá um navegador da Web e autenticará automaticamente.
-
-## Implantação com Deta
-
-Em seguida, implante seu aplicativo com a Deta CLI:
-
-<div class="termy">
-
-```console
-$ deta new
-
-Successfully created a new micro
-
-// Notice the "endpoint" 🔍
-
-{
-    "name": "fastapideta",
-    "runtime": "python3.7",
-    "endpoint": "https://qltnci.deta.dev",
-    "visor": "enabled",
-    "http_auth": "enabled"
-}
-
-Adding dependencies...
-
-
----> 100%
-
-
-Successfully installed fastapi-0.61.1 pydantic-1.7.2 starlette-0.13.6
-```
-
-</div>
-
-Você verá uma mensagem JSON semelhante a:
-
-```JSON hl_lines="4"
-{
-        "name": "fastapideta",
-        "runtime": "python3.7",
-        "endpoint": "https://qltnci.deta.dev",
-        "visor": "enabled",
-        "http_auth": "enabled"
-}
-```
-
-!!! tip "Dica"
-    Sua implantação terá um URL `"endpoint"` diferente.
-
-## Confira
-
-Agora, abra seu navegador na URL do `endpoint`. No exemplo acima foi `https://qltnci.deta.dev`, mas o seu será diferente.
-
-Você verá a resposta JSON do seu aplicativo FastAPI:
-
-```JSON
-{
-    "Hello": "World"
-}
-```
-
-Agora vá para o `/docs` da sua API, no exemplo acima seria `https://qltnci.deta.dev/docs`.
-
-Ele mostrará sua documentação como:
-
-<img src="/img/deployment/deta/image01.png">
-
-## Permitir acesso público
-
-Por padrão, a Deta lidará com a autenticação usando cookies para sua conta.
-
-Mas quando estiver pronto, você pode torná-lo público com:
-
-<div class="termy">
-
-```console
-$ deta auth disable
-
-Successfully disabled http auth
-```
-
-</div>
-
-Agora você pode compartilhar essa URL com qualquer pessoa e elas conseguirão acessar sua API. 🚀
-
-## HTTPS
-
-Parabéns! Você realizou a implantação do seu app FastAPI na Deta! 🎉 🍰
-
-Além disso, observe que a Deta lida corretamente com HTTPS para você, para que você não precise cuidar disso e tenha a certeza de que seus clientes terão uma conexão criptografada segura. ✅ 🔒
-
-## Verifique o Visor
-
-Na UI da sua documentação (você estará em um URL como `https://qltnci.deta.dev/docs`) envie um request para *operação de rota* `/items/{item_id}`.
-
-Por exemplo com ID `5`.
-
-Agora vá para <a href="https://web.deta.sh/" class="external-link" target="_blank">https://web.deta.sh</a>.
-
-Você verá que há uma seção à esquerda chamada <abbr title="it comes from Micro(server)">"Micros"</abbr> com cada um dos seus apps.
-
-Você verá uma aba com "Detalhes", e também a aba "Visor", vá para "Visor".
-
-Lá você pode inspecionar as solicitações recentes enviadas ao seu aplicativo.
-
-Você também pode editá-los e reproduzi-los novamente.
-
-<img src="/img/deployment/deta/image02.png">
-
-## Saiba mais
-
-Em algum momento, você provavelmente desejará armazenar alguns dados para seu aplicativo de uma forma que persista ao longo do tempo. Para isso você pode usar <a href="https://docs.deta.sh/docs/base/py_tutorial?ref=fastapi" class="external-link" target="_blank">Deta Base</a>, que também tem um generoso **nível gratuito**.
-
-Você também pode ler mais na <a href="https://docs.deta.sh?ref=fastapi" class="external-link" target="_blank">documentação da Deta</a>.
-
-## Conceitos de implantação
-
-Voltando aos conceitos que discutimos em [Deployments Concepts](./concepts.md){.internal-link target=_blank}, veja como cada um deles seria tratado com a Deta:
-
-* **HTTPS**: Realizado pela Deta, eles fornecerão um subdomínio e lidarão com HTTPS automaticamente.
-* **Executando na inicialização**: Realizado pela Deta, como parte de seu serviço.
-* **Reinicialização**: Realizado pela Deta, como parte de seu serviço.
-* **Replicação**: Realizado pela Deta, como parte de seu serviço.
-* **Memória**: Limite predefinido pela Deta, você pode contatá-los para aumentá-lo.
-* **Etapas anteriores a inicialização**: Não suportado diretamente, você pode fazê-lo funcionar com o sistema Cron ou scripts adicionais.
-
-!!! note "Nota"
-    O Deta foi projetado para facilitar (e gratuitamente) a implantação rápida de aplicativos simples.
-
-    Ele pode simplificar vários casos de uso, mas, ao mesmo tempo, não suporta outros, como o uso de bancos de dados externos (além do próprio sistema de banco de dados NoSQL da Deta), máquinas virtuais personalizadas, etc.
-
-    Você pode ler mais detalhes na <a href="https://docs.deta.sh/docs/micros/about/" class="external-link" target="_blank">documentação da Deta</a> para ver se é a escolha certa para você.

From e04953a9e0c60a4afdf78652ac9f62bfce5a9349 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 19 Aug 2023 13:12:09 +0000
Subject: [PATCH 113/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 6ef2e6a45..f55d8281a 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 📝 Restructure docs for cloud providers, include links to sponsors. PR [#10110](https://github.com/tiangolo/fastapi/pull/10110) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, add Speakeasy. PR [#10098](https://github.com/tiangolo/fastapi/pull/10098) by [@tiangolo](https://github.com/tiangolo).
 ## 0.101.1
 

From d1c0e5a89f07311384c4ea579d421dfa02f9f6eb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 19 Aug 2023 15:33:32 +0200
Subject: [PATCH 114/317] =?UTF-8?q?=F0=9F=93=9D=20Tweak=20MkDocs=20and=20a?=
 =?UTF-8?q?dd=20redirects=20(#10111)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/mkdocs.yml    | 16 +++++++++++-----
 requirements-docs.txt |  1 +
 2 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index 2a59be4b0..22babe745 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -42,6 +42,9 @@ plugins:
   search: null
   markdownextradata:
     data: ../en/data
+  redirects:
+    redirect_maps:
+      deployment/deta.md: deployment/cloud.md
 nav:
 - FastAPI: index.md
 - Languages:
@@ -60,6 +63,7 @@ nav:
   - ru: /ru/
   - tr: /tr/
   - uk: /uk/
+  - ur: /ur/
   - vi: /vi/
   - zh: /zh/
 - features.md
@@ -178,9 +182,9 @@ markdown_extensions:
     guess_lang: false
   mdx_include:
     base_path: docs
-  admonition:
-  codehilite:
-  extra:
+  admonition: null
+  codehilite: null
+  extra: null
   pymdownx.superfences:
     custom_fences:
     - name: mermaid
@@ -188,8 +192,8 @@ markdown_extensions:
       format: !!python/name:pymdownx.superfences.fence_code_format ''
   pymdownx.tabbed:
     alternate_style: true
-  attr_list:
-  md_in_html:
+  attr_list: null
+  md_in_html: null
 extra:
   analytics:
     provider: google
@@ -240,6 +244,8 @@ extra:
     name: tr - Türkçe
   - link: /uk/
     name: uk
+  - link: /ur/
+    name: ur
   - link: /vi/
     name: vi - Tiếng Việt
   - link: /zh/
diff --git a/requirements-docs.txt b/requirements-docs.txt
index 220d1ec3a..2e667720e 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -2,6 +2,7 @@
 mkdocs-material==9.1.21
 mdx-include >=1.4.1,<2.0.0
 mkdocs-markdownextradata-plugin >=0.1.7,<0.3.0
+mkdocs-redirects>=1.2.1,<1.3.0
 typer-cli >=0.0.13,<0.0.14
 typer[all] >=0.6.1,<0.8.0
 pyyaml >=5.3.1,<7.0.0

From 0fe434ca683e4c1786e4f190a62eaad7aea71240 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 19 Aug 2023 13:34:10 +0000
Subject: [PATCH 115/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f55d8281a..fe1153254 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 📝 Tweak MkDocs and add redirects. PR [#10111](https://github.com/tiangolo/fastapi/pull/10111) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Restructure docs for cloud providers, include links to sponsors. PR [#10110](https://github.com/tiangolo/fastapi/pull/10110) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, add Speakeasy. PR [#10098](https://github.com/tiangolo/fastapi/pull/10098) by [@tiangolo](https://github.com/tiangolo).
 ## 0.101.1

From 08feaf0cc43a76feef2bb02170792cb79dda7c86 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 19 Aug 2023 15:49:54 +0200
Subject: [PATCH 116/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20docs=20for=20ge?=
 =?UTF-8?q?nerating=20clients=20(#10112)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/advanced/generate-clients.md | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/docs/en/docs/advanced/generate-clients.md b/docs/en/docs/advanced/generate-clients.md
index 3fed48b0b..f439ed93a 100644
--- a/docs/en/docs/advanced/generate-clients.md
+++ b/docs/en/docs/advanced/generate-clients.md
@@ -12,10 +12,18 @@ A common tool is <a href="https://openapi-generator.tech/" class="external-link"
 
 If you are building a **frontend**, a very interesting alternative is <a href="https://github.com/ferdikoomen/openapi-typescript-codegen" class="external-link" target="_blank">openapi-typescript-codegen</a>.
 
-Another option you could consider for several languages is <a href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=docs-generate-clients" class="external-link" target="_blank">Fern</a>.
+## Client and SDK Generators - Sponsor
 
-!!! info
-    <a href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=docs-generate-clients" class="external-link" target="_blank">Fern</a> is also a FastAPI sponsor. 😎🎉
+There are also some **company-backed** Client and SDK generators based on OpenAPI (FastAPI), in some cases they can offer you **additional features** on top of high-quality generated SDKs/clients.
+
+Some of them also ✨ [**sponsor FastAPI**](../help-fastapi.md#sponsor-the-author){.internal-link target=_blank} ✨, this ensures the continued and healthy **development** of FastAPI and its **ecosystem**.
+
+And it shows their true commitment to FastAPI and its **community** (you), as they not only want to provide you a **good service** but also want to make sure you have a **good and healthy framework**, FastAPI. 🙇
+
+You might want to try their services and follow their guides:
+
+* <a href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=docs-generate-clients" class="external-link" target="_blank">Fern</a>
+* <a href="https://speakeasyapi.dev/?utm_source=fastapi+repo&utm_medium=github+sponsorship" class="external-link" target="_blank">Speakeasy</a>
 
 ## Generate a TypeScript Frontend Client
 

From 486cd139a94668a0a5a5b24aedb6c763aa26857e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 19 Aug 2023 13:51:12 +0000
Subject: [PATCH 117/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index fe1153254..d7915d079 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 📝 Update docs for generating clients. PR [#10112](https://github.com/tiangolo/fastapi/pull/10112) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Tweak MkDocs and add redirects. PR [#10111](https://github.com/tiangolo/fastapi/pull/10111) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Restructure docs for cloud providers, include links to sponsors. PR [#10110](https://github.com/tiangolo/fastapi/pull/10110) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, add Speakeasy. PR [#10098](https://github.com/tiangolo/fastapi/pull/10098) by [@tiangolo](https://github.com/tiangolo).

From 8e382617873665cc7f2323e8742aa5eb04292600 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 19 Aug 2023 16:08:16 +0200
Subject: [PATCH 118/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20Advanced=20docs?=
 =?UTF-8?q?,=20add=20links=20to=20sponsor=20courses=20(#10113)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/advanced/index.md | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/docs/en/docs/advanced/index.md b/docs/en/docs/advanced/index.md
index 467f0833e..d8dcd4ca6 100644
--- a/docs/en/docs/advanced/index.md
+++ b/docs/en/docs/advanced/index.md
@@ -17,8 +17,17 @@ You could still use most of the features in **FastAPI** with the knowledge from
 
 And the next sections assume you already read it, and assume that you know those main ideas.
 
-## TestDriven.io course
+## External Courses
 
-If you would like to take an advanced-beginner course to complement this section of the docs, you might want to check: <a href="https://testdriven.io/courses/tdd-fastapi/" class="external-link" target="_blank">Test-Driven Development with FastAPI and Docker</a> by **TestDriven.io**.
+Although the [Tutorial - User Guide](../tutorial/){.internal-link target=_blank} and this **Advanced User Guide** are written as a guided tutorial (like a book) and should be enough for you to **learn FastAPI**, you might want to complement it with additional courses.
 
-They are currently donating 10% of all profits to the development of **FastAPI**. 🎉 😄
+Or it might be the case that you just prefer to take other courses because they adapt better to your learning style.
+
+Some course providers ✨ [**sponsor FastAPI**](../help-fastapi.md#sponsor-the-author){.internal-link target=_blank} ✨, this ensures the continued and healthy **development** of FastAPI and its **ecosystem**.
+
+And it shows their true commitment to FastAPI and its **community** (you), as they not only want to provide you a **good learning experience** but also want to make sure you have a **good and healthy framework**, FastAPI. 🙇
+
+You might want to try their courses:
+
+* <a href="https://training.talkpython.fm/fastapi-courses" class="external-link" target="_blank">Talk Python Training</a>
+* <a href="https://testdriven.io/courses/tdd-fastapi/" class="external-link" target="_blank">Test-Driven Development</a>

From b406dd917486cbb429541930370b6a20d906cf99 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 19 Aug 2023 14:09:02 +0000
Subject: [PATCH 119/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d7915d079..1916564ae 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 📝 Update Advanced docs, add links to sponsor courses. PR [#10113](https://github.com/tiangolo/fastapi/pull/10113) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Update docs for generating clients. PR [#10112](https://github.com/tiangolo/fastapi/pull/10112) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Tweak MkDocs and add redirects. PR [#10111](https://github.com/tiangolo/fastapi/pull/10111) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Restructure docs for cloud providers, include links to sponsors. PR [#10110](https://github.com/tiangolo/fastapi/pull/10110) by [@tiangolo](https://github.com/tiangolo).

From 7a06de2bb9de12727fe544b602f9d74f7a1b0bae Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 19 Aug 2023 20:47:59 +0200
Subject: [PATCH 120/317] =?UTF-8?q?=E2=99=BB=EF=B8=8F=20Refactor=20tests?=
 =?UTF-8?q?=20for=20new=20Pydantic=202.2.1=20(#10115)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/workflows/test.yml                    |  4 +--
 tests/test_multi_body_errors.py               | 36 +++----------------
 .../test_body_updates/test_tutorial001.py     | 10 +++---
 .../test_tutorial001_py310.py                 | 10 +++---
 .../test_tutorial001_py39.py                  | 10 +++---
 .../test_dataclasses/test_tutorial003.py      | 10 +++---
 .../test_tutorial004.py                       |  8 ++---
 .../test_tutorial005.py                       |  8 ++---
 .../test_tutorial005_py310.py                 |  8 ++---
 .../test_tutorial005_py39.py                  |  8 ++---
 10 files changed, 44 insertions(+), 68 deletions(-)

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 6a512a019..c9723b25b 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -29,7 +29,7 @@ jobs:
         id: cache
         with:
           path: ${{ env.pythonLocation }}
-          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-pydantic-v2-${{ hashFiles('pyproject.toml', 'requirements-tests.txt') }}-test-v04
+          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-pydantic-v2-${{ hashFiles('pyproject.toml', 'requirements-tests.txt') }}-test-v05
       - name: Install Dependencies
         if: steps.cache.outputs.cache-hit != 'true'
         run: pip install -r requirements-tests.txt
@@ -62,7 +62,7 @@ jobs:
         id: cache
         with:
           path: ${{ env.pythonLocation }}
-          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-${{ matrix.pydantic-version }}-${{ hashFiles('pyproject.toml', 'requirements-tests.txt') }}-test-v04
+          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-${{ matrix.pydantic-version }}-${{ hashFiles('pyproject.toml', 'requirements-tests.txt') }}-test-v05
       - name: Install Dependencies
         if: steps.cache.outputs.cache-hit != 'true'
         run: pip install -r requirements-tests.txt
diff --git a/tests/test_multi_body_errors.py b/tests/test_multi_body_errors.py
index 931f08fc1..a51ca7253 100644
--- a/tests/test_multi_body_errors.py
+++ b/tests/test_multi_body_errors.py
@@ -51,7 +51,7 @@ def test_jsonable_encoder_requiring_error():
                     "loc": ["body", 0, "age"],
                     "msg": "Input should be greater than 0",
                     "input": -1.0,
-                    "ctx": {"gt": "0"},
+                    "ctx": {"gt": 0},
                     "url": match_pydantic_error_url("greater_than"),
                 }
             ]
@@ -84,25 +84,12 @@ def test_put_incorrect_body_multiple():
                     "input": {"age": "five"},
                     "url": match_pydantic_error_url("missing"),
                 },
-                {
-                    "ctx": {"class": "Decimal"},
-                    "input": "five",
-                    "loc": ["body", 0, "age", "is-instance[Decimal]"],
-                    "msg": "Input should be an instance of Decimal",
-                    "type": "is_instance_of",
-                    "url": match_pydantic_error_url("is_instance_of"),
-                },
                 {
                     "type": "decimal_parsing",
-                    "loc": [
-                        "body",
-                        0,
-                        "age",
-                        "function-after[to_decimal(), "
-                        "union[int,constrained-str,function-plain[str()]]]",
-                    ],
+                    "loc": ["body", 0, "age"],
                     "msg": "Input should be a valid decimal",
                     "input": "five",
+                    "url": match_pydantic_error_url("decimal_parsing"),
                 },
                 {
                     "type": "missing",
@@ -111,25 +98,12 @@ def test_put_incorrect_body_multiple():
                     "input": {"age": "six"},
                     "url": match_pydantic_error_url("missing"),
                 },
-                {
-                    "ctx": {"class": "Decimal"},
-                    "input": "six",
-                    "loc": ["body", 1, "age", "is-instance[Decimal]"],
-                    "msg": "Input should be an instance of Decimal",
-                    "type": "is_instance_of",
-                    "url": match_pydantic_error_url("is_instance_of"),
-                },
                 {
                     "type": "decimal_parsing",
-                    "loc": [
-                        "body",
-                        1,
-                        "age",
-                        "function-after[to_decimal(), "
-                        "union[int,constrained-str,function-plain[str()]]]",
-                    ],
+                    "loc": ["body", 1, "age"],
                     "msg": "Input should be a valid decimal",
                     "input": "six",
+                    "url": match_pydantic_error_url("decimal_parsing"),
                 },
             ]
         }
diff --git a/tests/test_tutorial/test_body_updates/test_tutorial001.py b/tests/test_tutorial/test_body_updates/test_tutorial001.py
index f1a46210a..58587885e 100644
--- a/tests/test_tutorial/test_body_updates/test_tutorial001.py
+++ b/tests/test_tutorial/test_body_updates/test_tutorial001.py
@@ -53,7 +53,7 @@ def test_openapi_schema(client: TestClient):
                             "content": {
                                 "application/json": {
                                     "schema": {
-                                        "$ref": "#/components/schemas/ItemOutput"
+                                        "$ref": "#/components/schemas/Item-Output"
                                     }
                                 }
                             },
@@ -87,7 +87,7 @@ def test_openapi_schema(client: TestClient):
                             "content": {
                                 "application/json": {
                                     "schema": {
-                                        "$ref": "#/components/schemas/ItemOutput"
+                                        "$ref": "#/components/schemas/Item-Output"
                                     }
                                 }
                             },
@@ -116,7 +116,7 @@ def test_openapi_schema(client: TestClient):
                     "requestBody": {
                         "content": {
                             "application/json": {
-                                "schema": {"$ref": "#/components/schemas/ItemInput"}
+                                "schema": {"$ref": "#/components/schemas/Item-Input"}
                             }
                         },
                         "required": True,
@@ -126,7 +126,7 @@ def test_openapi_schema(client: TestClient):
         },
         "components": {
             "schemas": {
-                "ItemInput": {
+                "Item-Input": {
                     "title": "Item",
                     "type": "object",
                     "properties": {
@@ -151,7 +151,7 @@ def test_openapi_schema(client: TestClient):
                         },
                     },
                 },
-                "ItemOutput": {
+                "Item-Output": {
                     "title": "Item",
                     "type": "object",
                     "required": ["name", "description", "price", "tax", "tags"],
diff --git a/tests/test_tutorial/test_body_updates/test_tutorial001_py310.py b/tests/test_tutorial/test_body_updates/test_tutorial001_py310.py
index ab696e4c8..d8a62502f 100644
--- a/tests/test_tutorial/test_body_updates/test_tutorial001_py310.py
+++ b/tests/test_tutorial/test_body_updates/test_tutorial001_py310.py
@@ -56,7 +56,7 @@ def test_openapi_schema(client: TestClient):
                             "content": {
                                 "application/json": {
                                     "schema": {
-                                        "$ref": "#/components/schemas/ItemOutput"
+                                        "$ref": "#/components/schemas/Item-Output"
                                     }
                                 }
                             },
@@ -90,7 +90,7 @@ def test_openapi_schema(client: TestClient):
                             "content": {
                                 "application/json": {
                                     "schema": {
-                                        "$ref": "#/components/schemas/ItemOutput"
+                                        "$ref": "#/components/schemas/Item-Output"
                                     }
                                 }
                             },
@@ -119,7 +119,7 @@ def test_openapi_schema(client: TestClient):
                     "requestBody": {
                         "content": {
                             "application/json": {
-                                "schema": {"$ref": "#/components/schemas/ItemInput"}
+                                "schema": {"$ref": "#/components/schemas/Item-Input"}
                             }
                         },
                         "required": True,
@@ -129,7 +129,7 @@ def test_openapi_schema(client: TestClient):
         },
         "components": {
             "schemas": {
-                "ItemInput": {
+                "Item-Input": {
                     "title": "Item",
                     "type": "object",
                     "properties": {
@@ -154,7 +154,7 @@ def test_openapi_schema(client: TestClient):
                         },
                     },
                 },
-                "ItemOutput": {
+                "Item-Output": {
                     "title": "Item",
                     "type": "object",
                     "required": ["name", "description", "price", "tax", "tags"],
diff --git a/tests/test_tutorial/test_body_updates/test_tutorial001_py39.py b/tests/test_tutorial/test_body_updates/test_tutorial001_py39.py
index 2ee6a5cb4..c604df6ec 100644
--- a/tests/test_tutorial/test_body_updates/test_tutorial001_py39.py
+++ b/tests/test_tutorial/test_body_updates/test_tutorial001_py39.py
@@ -56,7 +56,7 @@ def test_openapi_schema(client: TestClient):
                             "content": {
                                 "application/json": {
                                     "schema": {
-                                        "$ref": "#/components/schemas/ItemOutput"
+                                        "$ref": "#/components/schemas/Item-Output"
                                     }
                                 }
                             },
@@ -90,7 +90,7 @@ def test_openapi_schema(client: TestClient):
                             "content": {
                                 "application/json": {
                                     "schema": {
-                                        "$ref": "#/components/schemas/ItemOutput"
+                                        "$ref": "#/components/schemas/Item-Output"
                                     }
                                 }
                             },
@@ -119,7 +119,7 @@ def test_openapi_schema(client: TestClient):
                     "requestBody": {
                         "content": {
                             "application/json": {
-                                "schema": {"$ref": "#/components/schemas/ItemInput"}
+                                "schema": {"$ref": "#/components/schemas/Item-Input"}
                             }
                         },
                         "required": True,
@@ -129,7 +129,7 @@ def test_openapi_schema(client: TestClient):
         },
         "components": {
             "schemas": {
-                "ItemInput": {
+                "Item-Input": {
                     "title": "Item",
                     "type": "object",
                     "properties": {
@@ -154,7 +154,7 @@ def test_openapi_schema(client: TestClient):
                         },
                     },
                 },
-                "ItemOutput": {
+                "Item-Output": {
                     "title": "Item",
                     "type": "object",
                     "required": ["name", "description", "price", "tax", "tags"],
diff --git a/tests/test_tutorial/test_dataclasses/test_tutorial003.py b/tests/test_tutorial/test_dataclasses/test_tutorial003.py
index 2e5809914..f2ca85823 100644
--- a/tests/test_tutorial/test_dataclasses/test_tutorial003.py
+++ b/tests/test_tutorial/test_dataclasses/test_tutorial003.py
@@ -79,7 +79,9 @@ def test_openapi_schema():
                                 "schema": {
                                     "title": "Items",
                                     "type": "array",
-                                    "items": {"$ref": "#/components/schemas/ItemInput"},
+                                    "items": {
+                                        "$ref": "#/components/schemas/Item-Input"
+                                    },
                                 }
                             }
                         },
@@ -141,7 +143,7 @@ def test_openapi_schema():
                         "items": {
                             "title": "Items",
                             "type": "array",
-                            "items": {"$ref": "#/components/schemas/ItemOutput"},
+                            "items": {"$ref": "#/components/schemas/Item-Output"},
                         },
                     },
                 },
@@ -156,7 +158,7 @@ def test_openapi_schema():
                         }
                     },
                 },
-                "ItemInput": {
+                "Item-Input": {
                     "title": "Item",
                     "required": ["name"],
                     "type": "object",
@@ -168,7 +170,7 @@ def test_openapi_schema():
                         },
                     },
                 },
-                "ItemOutput": {
+                "Item-Output": {
                     "title": "Item",
                     "required": ["name", "description"],
                     "type": "object",
diff --git a/tests/test_tutorial/test_path_operation_advanced_configurations/test_tutorial004.py b/tests/test_tutorial/test_path_operation_advanced_configurations/test_tutorial004.py
index 3ffc0bca7..c5b2fb670 100644
--- a/tests/test_tutorial/test_path_operation_advanced_configurations/test_tutorial004.py
+++ b/tests/test_tutorial/test_path_operation_advanced_configurations/test_tutorial004.py
@@ -35,7 +35,7 @@ def test_openapi_schema():
                             "content": {
                                 "application/json": {
                                     "schema": {
-                                        "$ref": "#/components/schemas/ItemOutput"
+                                        "$ref": "#/components/schemas/Item-Output"
                                     }
                                 }
                             },
@@ -57,7 +57,7 @@ def test_openapi_schema():
                     "requestBody": {
                         "content": {
                             "application/json": {
-                                "schema": {"$ref": "#/components/schemas/ItemInput"}
+                                "schema": {"$ref": "#/components/schemas/Item-Input"}
                             }
                         },
                         "required": True,
@@ -67,7 +67,7 @@ def test_openapi_schema():
         },
         "components": {
             "schemas": {
-                "ItemInput": {
+                "Item-Input": {
                     "title": "Item",
                     "required": ["name", "price"],
                     "type": "object",
@@ -91,7 +91,7 @@ def test_openapi_schema():
                         },
                     },
                 },
-                "ItemOutput": {
+                "Item-Output": {
                     "title": "Item",
                     "required": ["name", "description", "price", "tax", "tags"],
                     "type": "object",
diff --git a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005.py b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005.py
index ff98295a6..458923b5a 100644
--- a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005.py
+++ b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005.py
@@ -35,7 +35,7 @@ def test_openapi_schema():
                             "content": {
                                 "application/json": {
                                     "schema": {
-                                        "$ref": "#/components/schemas/ItemOutput"
+                                        "$ref": "#/components/schemas/Item-Output"
                                     }
                                 }
                             },
@@ -57,7 +57,7 @@ def test_openapi_schema():
                     "requestBody": {
                         "content": {
                             "application/json": {
-                                "schema": {"$ref": "#/components/schemas/ItemInput"}
+                                "schema": {"$ref": "#/components/schemas/Item-Input"}
                             }
                         },
                         "required": True,
@@ -67,7 +67,7 @@ def test_openapi_schema():
         },
         "components": {
             "schemas": {
-                "ItemInput": {
+                "Item-Input": {
                     "title": "Item",
                     "required": ["name", "price"],
                     "type": "object",
@@ -91,7 +91,7 @@ def test_openapi_schema():
                         },
                     },
                 },
-                "ItemOutput": {
+                "Item-Output": {
                     "title": "Item",
                     "required": ["name", "description", "price", "tax", "tags"],
                     "type": "object",
diff --git a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py310.py b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py310.py
index ad1c09eae..1fcc5c4e0 100644
--- a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py310.py
+++ b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py310.py
@@ -42,7 +42,7 @@ def test_openapi_schema(client: TestClient):
                             "content": {
                                 "application/json": {
                                     "schema": {
-                                        "$ref": "#/components/schemas/ItemOutput"
+                                        "$ref": "#/components/schemas/Item-Output"
                                     }
                                 }
                             },
@@ -64,7 +64,7 @@ def test_openapi_schema(client: TestClient):
                     "requestBody": {
                         "content": {
                             "application/json": {
-                                "schema": {"$ref": "#/components/schemas/ItemInput"}
+                                "schema": {"$ref": "#/components/schemas/Item-Input"}
                             }
                         },
                         "required": True,
@@ -74,7 +74,7 @@ def test_openapi_schema(client: TestClient):
         },
         "components": {
             "schemas": {
-                "ItemInput": {
+                "Item-Input": {
                     "title": "Item",
                     "required": ["name", "price"],
                     "type": "object",
@@ -98,7 +98,7 @@ def test_openapi_schema(client: TestClient):
                         },
                     },
                 },
-                "ItemOutput": {
+                "Item-Output": {
                     "title": "Item",
                     "required": ["name", "description", "price", "tax", "tags"],
                     "type": "object",
diff --git a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py39.py b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py39.py
index 045d1d402..470fe032b 100644
--- a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py39.py
+++ b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py39.py
@@ -42,7 +42,7 @@ def test_openapi_schema(client: TestClient):
                             "content": {
                                 "application/json": {
                                     "schema": {
-                                        "$ref": "#/components/schemas/ItemOutput"
+                                        "$ref": "#/components/schemas/Item-Output"
                                     }
                                 }
                             },
@@ -64,7 +64,7 @@ def test_openapi_schema(client: TestClient):
                     "requestBody": {
                         "content": {
                             "application/json": {
-                                "schema": {"$ref": "#/components/schemas/ItemInput"}
+                                "schema": {"$ref": "#/components/schemas/Item-Input"}
                             }
                         },
                         "required": True,
@@ -74,7 +74,7 @@ def test_openapi_schema(client: TestClient):
         },
         "components": {
             "schemas": {
-                "ItemInput": {
+                "Item-Input": {
                     "title": "Item",
                     "required": ["name", "price"],
                     "type": "object",
@@ -98,7 +98,7 @@ def test_openapi_schema(client: TestClient):
                         },
                     },
                 },
-                "ItemOutput": {
+                "Item-Output": {
                     "title": "Item",
                     "required": ["name", "description", "price", "tax", "tags"],
                     "type": "object",

From 3971c44a38fa703f56eb1801765d3f076a5c1b2c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 19 Aug 2023 18:48:35 +0000
Subject: [PATCH 121/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 1916564ae..48a809021 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ♻️ Refactor tests for new Pydantic 2.2.1. PR [#10115](https://github.com/tiangolo/fastapi/pull/10115) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Update Advanced docs, add links to sponsor courses. PR [#10113](https://github.com/tiangolo/fastapi/pull/10113) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Update docs for generating clients. PR [#10112](https://github.com/tiangolo/fastapi/pull/10112) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Tweak MkDocs and add redirects. PR [#10111](https://github.com/tiangolo/fastapi/pull/10111) by [@tiangolo](https://github.com/tiangolo).

From 8cd7cfc2b622fad03455c324e2ae87014a3fd166 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 19 Aug 2023 21:54:04 +0200
Subject: [PATCH 122/317] =?UTF-8?q?=F0=9F=93=9D=20Add=20new=20docs=20secti?=
 =?UTF-8?q?on,=20How=20To=20-=20Recipes,=20move=20docs=20that=20don't=20ha?=
 =?UTF-8?q?ve=20to=20be=20read=20by=20everyone=20to=20How=20To=20(#10114)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 📝 Start How To docs section, move Peewee, remove Peewee from dependencies

* 🚚 Move em files to new locations

* 🚚 Move and re-structure advanced docs, move relevant to How To

* 🔧 Update MkDocs config, new files in How To

* 📝 Move docs for Conditional OpenAPI for Japanese to How To

* 📝 Move example source files for Extending OpenAPI into each of the new sections

* ✅ Update tests with new locations for source files

* 🔥 Remove init from Peewee examples
---
 docs/em/docs/advanced/extending-openapi.md    | 314 ------------
 .../conditional-openapi.md                    |   0
 .../custom-request-and-route.md               |   0
 docs/em/docs/how-to/extending-openapi.md      |  90 ++++
 docs/em/docs/{advanced => how-to}/graphql.md  |   0
 .../sql-databases-peewee.md                   |   0
 docs/en/docs/advanced/extending-openapi.md    | 318 ------------
 .../async-sql-encode-databases.md}            |   2 +-
 .../conditional-openapi.md                    |   0
 docs/en/docs/how-to/configure-swagger-ui.md   |  78 +++
 docs/en/docs/how-to/custom-docs-ui-assets.md  | 199 ++++++++
 .../custom-request-and-route.md               |   0
 docs/en/docs/how-to/extending-openapi.md      |  87 ++++
 docs/en/docs/how-to/general.md                |  39 ++
 docs/en/docs/{advanced => how-to}/graphql.md  |   0
 docs/en/docs/how-to/index.md                  |  11 +
 .../nosql-databases-couchbase.md}             |   2 +-
 .../sql-databases-peewee.md                   |   2 +
 docs/en/mkdocs.yml                            |  26 +-
 .../conditional-openapi.md                    |   0
 .../tutorial001.py}                           |   0
 .../tutorial002.py}                           |   0
 .../tutorial003.py}                           |   0
 docs_src/custom_docs_ui/tutorial001.py        |  38 ++
 .../tutorial002.py                            |   0
 requirements-tests.txt                        |   1 -
 .../test_configure_swagger_ui}/__init__.py    |   0
 .../test_tutorial001.py}                      |   2 +-
 .../test_tutorial002.py}                      |   2 +-
 .../test_tutorial003.py}                      |   2 +-
 .../__init__.py                               |   0
 .../test_custom_docs_ui/test_tutorial001.py   |  42 ++
 .../test_tutorial002.py                       |   2 +-
 .../test_sql_databases_peewee.py              | 454 ------------------
 34 files changed, 611 insertions(+), 1100 deletions(-)
 delete mode 100644 docs/em/docs/advanced/extending-openapi.md
 rename docs/em/docs/{advanced => how-to}/conditional-openapi.md (100%)
 rename docs/em/docs/{advanced => how-to}/custom-request-and-route.md (100%)
 create mode 100644 docs/em/docs/how-to/extending-openapi.md
 rename docs/em/docs/{advanced => how-to}/graphql.md (100%)
 rename docs/em/docs/{advanced => how-to}/sql-databases-peewee.md (100%)
 delete mode 100644 docs/en/docs/advanced/extending-openapi.md
 rename docs/en/docs/{advanced/async-sql-databases.md => how-to/async-sql-encode-databases.md} (98%)
 rename docs/en/docs/{advanced => how-to}/conditional-openapi.md (100%)
 create mode 100644 docs/en/docs/how-to/configure-swagger-ui.md
 create mode 100644 docs/en/docs/how-to/custom-docs-ui-assets.md
 rename docs/en/docs/{advanced => how-to}/custom-request-and-route.md (100%)
 create mode 100644 docs/en/docs/how-to/extending-openapi.md
 create mode 100644 docs/en/docs/how-to/general.md
 rename docs/en/docs/{advanced => how-to}/graphql.md (100%)
 create mode 100644 docs/en/docs/how-to/index.md
 rename docs/en/docs/{advanced/nosql-databases.md => how-to/nosql-databases-couchbase.md} (99%)
 rename docs/en/docs/{advanced => how-to}/sql-databases-peewee.md (99%)
 rename docs/ja/docs/{advanced => how-to}/conditional-openapi.md (100%)
 rename docs_src/{extending_openapi/tutorial003.py => configure_swagger_ui/tutorial001.py} (100%)
 rename docs_src/{extending_openapi/tutorial004.py => configure_swagger_ui/tutorial002.py} (100%)
 rename docs_src/{extending_openapi/tutorial005.py => configure_swagger_ui/tutorial003.py} (100%)
 create mode 100644 docs_src/custom_docs_ui/tutorial001.py
 rename docs_src/{extending_openapi => custom_docs_ui}/tutorial002.py (100%)
 rename {docs_src/sql_databases_peewee => tests/test_tutorial/test_configure_swagger_ui}/__init__.py (100%)
 rename tests/test_tutorial/{test_extending_openapi/test_tutorial003.py => test_configure_swagger_ui/test_tutorial001.py} (95%)
 rename tests/test_tutorial/{test_extending_openapi/test_tutorial004.py => test_configure_swagger_ui/test_tutorial002.py} (96%)
 rename tests/test_tutorial/{test_extending_openapi/test_tutorial005.py => test_configure_swagger_ui/test_tutorial003.py} (96%)
 rename tests/test_tutorial/{test_sql_databases_peewee => test_custom_docs_ui}/__init__.py (100%)
 create mode 100644 tests/test_tutorial/test_custom_docs_ui/test_tutorial001.py
 rename tests/test_tutorial/{test_extending_openapi => test_custom_docs_ui}/test_tutorial002.py (95%)
 delete mode 100644 tests/test_tutorial/test_sql_databases_peewee/test_sql_databases_peewee.py

diff --git a/docs/em/docs/advanced/extending-openapi.md b/docs/em/docs/advanced/extending-openapi.md
deleted file mode 100644
index 496a8d9de..000000000
--- a/docs/em/docs/advanced/extending-openapi.md
+++ /dev/null
@@ -1,314 +0,0 @@
-# ↔ 🗄
-
-!!! warning
-    👉 👍 🏧 ⚒. 👆 🎲 💪 🚶 ⚫️.
-
-    🚥 👆 📄 🔰 - 👩‍💻 🦮, 👆 💪 🎲 🚶 👉 📄.
-
-    🚥 👆 ⏪ 💭 👈 👆 💪 🔀 🏗 🗄 🔗, 😣 👂.
-
-📤 💼 🌐❔ 👆 💪 💪 🔀 🏗 🗄 🔗.
-
-👉 📄 👆 🔜 👀 ❔.
-
-## 😐 🛠️
-
-😐 (🔢) 🛠️, ⏩.
-
-`FastAPI` 🈸 (👐) ✔️ `.openapi()` 👩‍🔬 👈 📈 📨 🗄 🔗.
-
-🍕 🈸 🎚 🏗, *➡ 🛠️* `/openapi.json` (⚖️ ⚫️❔ 👆 ⚒ 👆 `openapi_url`) ®.
-
-⚫️ 📨 🎻 📨 ⏮️ 🏁 🈸 `.openapi()` 👩‍🔬.
-
-🔢, ⚫️❔ 👩‍🔬 `.openapi()` 🔨 ✅ 🏠 `.openapi_schema` 👀 🚥 ⚫️ ✔️ 🎚 &amp; 📨 👫.
-
-🚥 ⚫️ 🚫, ⚫️ 🏗 👫 ⚙️ 🚙 🔢 `fastapi.openapi.utils.get_openapi`.
-
-&amp; 👈 🔢 `get_openapi()` 📨 🔢:
-
-* `title`: 🗄 📛, 🎦 🩺.
-* `version`: ⏬ 👆 🛠️, ✅ `2.5.0`.
-* `openapi_version`: ⏬ 🗄 🔧 ⚙️. 🔢, ⏪: `3.0.2`.
-* `description`: 📛 👆 🛠️.
-* `routes`: 📇 🛣, 👫 🔠 ® *➡ 🛠️*. 👫 ✊ ⚪️➡️ `app.routes`.
-
-## 🔑 🔢
-
-⚙️ ℹ 🔛, 👆 💪 ⚙️ 🎏 🚙 🔢 🏗 🗄 🔗 &amp; 🔐 🔠 🍕 👈 👆 💪.
-
-🖼, ➡️ 🚮 <a href="https://github.com/Rebilly/ReDoc/blob/master/docs/redoc-vendor-extensions.md#x-logo" class="external-link" target="_blank">📄 🗄 ↔ 🔌 🛃 🔱</a>.
-
-### 😐 **FastAPI**
-
-🥇, ✍ 🌐 👆 **FastAPI** 🈸 🛎:
-
-```Python hl_lines="1  4  7-9"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
-```
-
-### 🏗 🗄 🔗
-
-⤴️, ⚙️ 🎏 🚙 🔢 🏗 🗄 🔗, 🔘 `custom_openapi()` 🔢:
-
-```Python hl_lines="2  15-20"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
-```
-
-### 🔀 🗄 🔗
-
-🔜 👆 💪 🚮 📄 ↔, ❎ 🛃 `x-logo` `info` "🎚" 🗄 🔗:
-
-```Python hl_lines="21-23"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
-```
-
-### 💾 🗄 🔗
-
-👆 💪 ⚙️ 🏠 `.openapi_schema` "💾", 🏪 👆 🏗 🔗.
-
-👈 🌌, 👆 🈸 🏆 🚫 ✔️ 🏗 🔗 🔠 🕰 👩‍💻 📂 👆 🛠️ 🩺.
-
-⚫️ 🔜 🏗 🕴 🕐, &amp; ⤴️ 🎏 💾 🔗 🔜 ⚙️ ⏭ 📨.
-
-```Python hl_lines="13-14  24-25"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
-```
-
-### 🔐 👩‍🔬
-
-🔜 👆 💪 ❎ `.openapi()` 👩‍🔬 ⏮️ 👆 🆕 🔢.
-
-```Python hl_lines="28"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
-```
-
-### ✅ ⚫️
-
-🕐 👆 🚶 <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a> 👆 🔜 👀 👈 👆 ⚙️ 👆 🛃 🔱 (👉 🖼, **FastAPI**'Ⓜ 🔱):
-
-<img src="/img/tutorial/extending-openapi/image01.png">
-
-## 👤-🕸 🕸 &amp; 🎚 🩺
-
-🛠️ 🩺 ⚙️ **🦁 🎚** &amp; **📄**, &amp; 🔠 👈 💪 🕸 &amp; 🎚 📁.
-
-🔢, 👈 📁 🍦 ⚪️➡️ <abbr title="Content Delivery Network: A service, normally composed of several servers, that provides static files, like JavaScript and CSS. It's commonly used to serve those files from the server closer to the client, improving performance.">💲</abbr>.
-
-✋️ ⚫️ 💪 🛃 ⚫️, 👆 💪 ⚒ 🎯 💲, ⚖️ 🍦 📁 👆.
-
-👈 ⚠, 🖼, 🚥 👆 💪 👆 📱 🚧 👷 ⏪ 📱, 🍵 📂 🕸 🔐, ⚖️ 🇧🇿 🕸.
-
-📥 👆 🔜 👀 ❔ 🍦 👈 📁 👆, 🎏 FastAPI 📱, &amp; 🔗 🩺 ⚙️ 👫.
-
-### 🏗 📁 📊
-
-➡️ 💬 👆 🏗 📁 📊 👀 💖 👉:
-
-```
-.
-├── app
-│   ├── __init__.py
-│   ├── main.py
-```
-
-🔜 ✍ 📁 🏪 📚 🎻 📁.
-
-👆 🆕 📁 📊 💪 👀 💖 👉:
-
-```
-.
-├── app
-│   ├── __init__.py
-│   ├── main.py
-└── static/
-```
-
-### ⏬ 📁
-
-⏬ 🎻 📁 💪 🩺 &amp; 🚮 👫 🔛 👈 `static/` 📁.
-
-👆 💪 🎲 ▶️️-🖊 🔠 🔗 &amp; 🖊 🎛 🎏 `Save link as...`.
-
-**🦁 🎚** ⚙️ 📁:
-
-* <a href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@4/swagger-ui-bundle.js" class="external-link" target="_blank">`swagger-ui-bundle.js`</a>
-* <a href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@4/swagger-ui.css" class="external-link" target="_blank">`swagger-ui.css`</a>
-
-&amp; **📄** ⚙️ 📁:
-
-* <a href="https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js" class="external-link" target="_blank">`redoc.standalone.js`</a>
-
-⏮️ 👈, 👆 📁 📊 💪 👀 💖:
-
-```
-.
-├── app
-│   ├── __init__.py
-│   ├── main.py
-└── static
-    ├── redoc.standalone.js
-    ├── swagger-ui-bundle.js
-    └── swagger-ui.css
-```
-
-### 🍦 🎻 📁
-
-* 🗄 `StaticFiles`.
-* "🗻" `StaticFiles()` 👐 🎯 ➡.
-
-```Python hl_lines="7  11"
-{!../../../docs_src/extending_openapi/tutorial002.py!}
-```
-
-### 💯 🎻 📁
-
-▶️ 👆 🈸 &amp; 🚶 <a href="http://127.0.0.1:8000/static/redoc.standalone.js" class="external-link" target="_blank">http://127.0.0.1:8000/static/redoc.standalone.js</a>.
-
-👆 🔜 👀 📶 📏 🕸 📁 **📄**.
-
-⚫️ 💪 ▶️ ⏮️ 🕳 💖:
-
-```JavaScript
-/*!
- * ReDoc - OpenAPI/Swagger-generated API Reference Documentation
- * -------------------------------------------------------------
- *   Version: "2.0.0-rc.18"
- *   Repo: https://github.com/Redocly/redoc
- */
-!function(e,t){"object"==typeof exports&&"object"==typeof m
-
-...
-```
-
-👈 ✔ 👈 👆 💆‍♂ 💪 🍦 🎻 📁 ⚪️➡️ 👆 📱, &amp; 👈 👆 🥉 🎻 📁 🩺 ☑ 🥉.
-
-🔜 👥 💪 🔗 📱 ⚙️ 📚 🎻 📁 🩺.
-
-### ❎ 🏧 🩺
-
-🥇 🔁 ❎ 🏧 🩺, 📚 ⚙️ 💲 🔢.
-
-❎ 👫, ⚒ 👫 📛 `None` 🕐❔ 🏗 👆 `FastAPI` 📱:
-
-```Python hl_lines="9"
-{!../../../docs_src/extending_openapi/tutorial002.py!}
-```
-
-### 🔌 🛃 🩺
-
-🔜 👆 💪 ✍ *➡ 🛠️* 🛃 🩺.
-
-👆 💪 🏤-⚙️ FastAPI 🔗 🔢 ✍ 🕸 📃 🩺, &amp; 🚶‍♀️ 👫 💪 ❌:
-
-* `openapi_url`: 📛 🌐❔ 🕸 📃 🩺 💪 🤚 🗄 🔗 👆 🛠️. 👆 💪 ⚙️ 📥 🔢 `app.openapi_url`.
-* `title`: 📛 👆 🛠️.
-* `oauth2_redirect_url`: 👆 💪 ⚙️ `app.swagger_ui_oauth2_redirect_url` 📥 ⚙️ 🔢.
-* `swagger_js_url`: 📛 🌐❔ 🕸 👆 🦁 🎚 🩺 💪 🤚 **🕸** 📁. 👉 1️⃣ 👈 👆 👍 📱 🔜 🍦.
-* `swagger_css_url`: 📛 🌐❔ 🕸 👆 🦁 🎚 🩺 💪 🤚 **🎚** 📁. 👉 1️⃣ 👈 👆 👍 📱 🔜 🍦.
-
-&amp; ➡ 📄...
-
-```Python hl_lines="2-6  14-22  25-27  30-36"
-{!../../../docs_src/extending_openapi/tutorial002.py!}
-```
-
-!!! tip
-     *➡ 🛠️* `swagger_ui_redirect` 👩‍🎓 🕐❔ 👆 ⚙️ Oauth2️⃣.
-
-    🚥 👆 🛠️ 👆 🛠️ ⏮️ Oauth2️⃣ 🐕‍🦺, 👆 🔜 💪 🔓 &amp; 👟 🔙 🛠️ 🩺 ⏮️ 📎 🎓. &amp; 🔗 ⏮️ ⚫️ ⚙️ 🎰 Oauth2️⃣ 🤝.
-
-    🦁 🎚 🔜 🍵 ⚫️ ⛅ 🎑 👆, ✋️ ⚫️ 💪 👉 "❎" 👩‍🎓.
-
-### ✍ *➡ 🛠️* 💯 ⚫️
-
-🔜, 💪 💯 👈 🌐 👷, ✍ *➡ 🛠️*:
-
-```Python hl_lines="39-41"
-{!../../../docs_src/extending_openapi/tutorial002.py!}
-```
-
-### 💯 ⚫️
-
-🔜, 👆 🔜 💪 🔌 👆 📻, 🚶 👆 🩺 <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>, &amp; 🔃 📃.
-
-&amp; 🍵 🕸, 👆 🔜 💪 👀 🩺 👆 🛠️ &amp; 🔗 ⏮️ ⚫️.
-
-## 🛠️ 🦁 🎚
-
-👆 💪 🔗 ➕ <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">🦁 🎚 🔢</a>.
-
-🔗 👫, 🚶‍♀️ `swagger_ui_parameters` ❌ 🕐❔ 🏗 `FastAPI()` 📱 🎚 ⚖️ `get_swagger_ui_html()` 🔢.
-
-`swagger_ui_parameters` 📨 📖 ⏮️ 📳 🚶‍♀️ 🦁 🎚 🔗.
-
-FastAPI 🗜 📳 **🎻** ⚒ 👫 🔗 ⏮️ 🕸, 👈 ⚫️❔ 🦁 🎚 💪.
-
-### ❎ ❕ 🎦
-
-🖼, 👆 💪 ❎ ❕ 🎦 🦁 🎚.
-
-🍵 🔀 ⚒, ❕ 🎦 🛠️ 🔢:
-
-<img src="/img/tutorial/extending-openapi/image02.png">
-
-✋️ 👆 💪 ❎ ⚫️ ⚒ `syntaxHighlight` `False`:
-
-```Python hl_lines="3"
-{!../../../docs_src/extending_openapi/tutorial003.py!}
-```
-
-...&amp; ⤴️ 🦁 🎚 🏆 🚫 🎦 ❕ 🎦 🚫🔜:
-
-<img src="/img/tutorial/extending-openapi/image03.png">
-
-### 🔀 🎢
-
-🎏 🌌 👆 💪 ⚒ ❕ 🎦 🎢 ⏮️ 🔑 `"syntaxHighlight.theme"` (👀 👈 ⚫️ ✔️ ❣ 🖕):
-
-```Python hl_lines="3"
-{!../../../docs_src/extending_openapi/tutorial004.py!}
-```
-
-👈 📳 🔜 🔀 ❕ 🎦 🎨 🎢:
-
-<img src="/img/tutorial/extending-openapi/image04.png">
-
-### 🔀 🔢 🦁 🎚 🔢
-
-FastAPI 🔌 🔢 📳 🔢 ☑ 🌅 ⚙️ 💼.
-
-⚫️ 🔌 👫 🔢 📳:
-
-```Python
-{!../../../fastapi/openapi/docs.py[ln:7-13]!}
-```
-
-👆 💪 🔐 🙆 👫 ⚒ 🎏 💲 ❌ `swagger_ui_parameters`.
-
-🖼, ❎ `deepLinking` 👆 💪 🚶‍♀️ 👉 ⚒ `swagger_ui_parameters`:
-
-```Python hl_lines="3"
-{!../../../docs_src/extending_openapi/tutorial005.py!}
-```
-
-### 🎏 🦁 🎚 🔢
-
-👀 🌐 🎏 💪 📳 👆 💪 ⚙️, ✍ 🛂 <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">🩺 🦁 🎚 🔢</a>.
-
-### 🕸-🕴 ⚒
-
-🦁 🎚 ✔ 🎏 📳 **🕸-🕴** 🎚 (🖼, 🕸 🔢).
-
-FastAPI 🔌 👫 🕸-🕴 `presets` ⚒:
-
-```JavaScript
-presets: [
-    SwaggerUIBundle.presets.apis,
-    SwaggerUIBundle.SwaggerUIStandalonePreset
-]
-```
-
-👫 **🕸** 🎚, 🚫 🎻, 👆 💪 🚫 🚶‍♀️ 👫 ⚪️➡️ 🐍 📟 🔗.
-
-🚥 👆 💪 ⚙️ 🕸-🕴 📳 💖 📚, 👆 💪 ⚙️ 1️⃣ 👩‍🔬 🔛. 🔐 🌐 🦁 🎚 *➡ 🛠️* &amp; ❎ ✍ 🙆 🕸 👆 💪.
diff --git a/docs/em/docs/advanced/conditional-openapi.md b/docs/em/docs/how-to/conditional-openapi.md
similarity index 100%
rename from docs/em/docs/advanced/conditional-openapi.md
rename to docs/em/docs/how-to/conditional-openapi.md
diff --git a/docs/em/docs/advanced/custom-request-and-route.md b/docs/em/docs/how-to/custom-request-and-route.md
similarity index 100%
rename from docs/em/docs/advanced/custom-request-and-route.md
rename to docs/em/docs/how-to/custom-request-and-route.md
diff --git a/docs/em/docs/how-to/extending-openapi.md b/docs/em/docs/how-to/extending-openapi.md
new file mode 100644
index 000000000..6b3bc0075
--- /dev/null
+++ b/docs/em/docs/how-to/extending-openapi.md
@@ -0,0 +1,90 @@
+# ↔ 🗄
+
+!!! warning
+    👉 👍 🏧 ⚒. 👆 🎲 💪 🚶 ⚫️.
+
+    🚥 👆 📄 🔰 - 👩‍💻 🦮, 👆 💪 🎲 🚶 👉 📄.
+
+    🚥 👆 ⏪ 💭 👈 👆 💪 🔀 🏗 🗄 🔗, 😣 👂.
+
+📤 💼 🌐❔ 👆 💪 💪 🔀 🏗 🗄 🔗.
+
+👉 📄 👆 🔜 👀 ❔.
+
+## 😐 🛠️
+
+😐 (🔢) 🛠️, ⏩.
+
+`FastAPI` 🈸 (👐) ✔️ `.openapi()` 👩‍🔬 👈 📈 📨 🗄 🔗.
+
+🍕 🈸 🎚 🏗, *➡ 🛠️* `/openapi.json` (⚖️ ⚫️❔ 👆 ⚒ 👆 `openapi_url`) ®.
+
+⚫️ 📨 🎻 📨 ⏮️ 🏁 🈸 `.openapi()` 👩‍🔬.
+
+🔢, ⚫️❔ 👩‍🔬 `.openapi()` 🔨 ✅ 🏠 `.openapi_schema` 👀 🚥 ⚫️ ✔️ 🎚 &amp; 📨 👫.
+
+🚥 ⚫️ 🚫, ⚫️ 🏗 👫 ⚙️ 🚙 🔢 `fastapi.openapi.utils.get_openapi`.
+
+&amp; 👈 🔢 `get_openapi()` 📨 🔢:
+
+* `title`: 🗄 📛, 🎦 🩺.
+* `version`: ⏬ 👆 🛠️, ✅ `2.5.0`.
+* `openapi_version`: ⏬ 🗄 🔧 ⚙️. 🔢, ⏪: `3.0.2`.
+* `description`: 📛 👆 🛠️.
+* `routes`: 📇 🛣, 👫 🔠 ® *➡ 🛠️*. 👫 ✊ ⚪️➡️ `app.routes`.
+
+## 🔑 🔢
+
+⚙️ ℹ 🔛, 👆 💪 ⚙️ 🎏 🚙 🔢 🏗 🗄 🔗 &amp; 🔐 🔠 🍕 👈 👆 💪.
+
+🖼, ➡️ 🚮 <a href="https://github.com/Rebilly/ReDoc/blob/master/docs/redoc-vendor-extensions.md#x-logo" class="external-link" target="_blank">📄 🗄 ↔ 🔌 🛃 🔱</a>.
+
+### 😐 **FastAPI**
+
+🥇, ✍ 🌐 👆 **FastAPI** 🈸 🛎:
+
+```Python hl_lines="1  4  7-9"
+{!../../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### 🏗 🗄 🔗
+
+⤴️, ⚙️ 🎏 🚙 🔢 🏗 🗄 🔗, 🔘 `custom_openapi()` 🔢:
+
+```Python hl_lines="2  15-20"
+{!../../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### 🔀 🗄 🔗
+
+🔜 👆 💪 🚮 📄 ↔, ❎ 🛃 `x-logo` `info` "🎚" 🗄 🔗:
+
+```Python hl_lines="21-23"
+{!../../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### 💾 🗄 🔗
+
+👆 💪 ⚙️ 🏠 `.openapi_schema` "💾", 🏪 👆 🏗 🔗.
+
+👈 🌌, 👆 🈸 🏆 🚫 ✔️ 🏗 🔗 🔠 🕰 👩‍💻 📂 👆 🛠️ 🩺.
+
+⚫️ 🔜 🏗 🕴 🕐, &amp; ⤴️ 🎏 💾 🔗 🔜 ⚙️ ⏭ 📨.
+
+```Python hl_lines="13-14  24-25"
+{!../../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### 🔐 👩‍🔬
+
+🔜 👆 💪 ❎ `.openapi()` 👩‍🔬 ⏮️ 👆 🆕 🔢.
+
+```Python hl_lines="28"
+{!../../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### ✅ ⚫️
+
+🕐 👆 🚶 <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a> 👆 🔜 👀 👈 👆 ⚙️ 👆 🛃 🔱 (👉 🖼, **FastAPI**'Ⓜ 🔱):
+
+<img src="/img/tutorial/extending-openapi/image01.png">
diff --git a/docs/em/docs/advanced/graphql.md b/docs/em/docs/how-to/graphql.md
similarity index 100%
rename from docs/em/docs/advanced/graphql.md
rename to docs/em/docs/how-to/graphql.md
diff --git a/docs/em/docs/advanced/sql-databases-peewee.md b/docs/em/docs/how-to/sql-databases-peewee.md
similarity index 100%
rename from docs/em/docs/advanced/sql-databases-peewee.md
rename to docs/em/docs/how-to/sql-databases-peewee.md
diff --git a/docs/en/docs/advanced/extending-openapi.md b/docs/en/docs/advanced/extending-openapi.md
deleted file mode 100644
index bec184dee..000000000
--- a/docs/en/docs/advanced/extending-openapi.md
+++ /dev/null
@@ -1,318 +0,0 @@
-# Extending OpenAPI
-
-!!! warning
-    This is a rather advanced feature. You probably can skip it.
-
-    If you are just following the tutorial - user guide, you can probably skip this section.
-
-    If you already know that you need to modify the generated OpenAPI schema, continue reading.
-
-There are some cases where you might need to modify the generated OpenAPI schema.
-
-In this section you will see how.
-
-## The normal process
-
-The normal (default) process, is as follows.
-
-A `FastAPI` application (instance) has an `.openapi()` method that is expected to return the OpenAPI schema.
-
-As part of the application object creation, a *path operation* for `/openapi.json` (or for whatever you set your `openapi_url`) is registered.
-
-It just returns a JSON response with the result of the application's `.openapi()` method.
-
-By default, what the method `.openapi()` does is check the property `.openapi_schema` to see if it has contents and return them.
-
-If it doesn't, it generates them using the utility function at `fastapi.openapi.utils.get_openapi`.
-
-And that function `get_openapi()` receives as parameters:
-
-* `title`: The OpenAPI title, shown in the docs.
-* `version`: The version of your API, e.g. `2.5.0`.
-* `openapi_version`: The version of the OpenAPI specification used. By default, the latest: `3.1.0`.
-* `summary`: A short summary of the API.
-* `description`: The description of your API, this can include markdown and will be shown in the docs.
-* `routes`: A list of routes, these are each of the registered *path operations*. They are taken from `app.routes`.
-
-!!! info
-    The parameter `summary` is available in OpenAPI 3.1.0 and above, supported by FastAPI 0.99.0 and above.
-
-## Overriding the defaults
-
-Using the information above, you can use the same utility function to generate the OpenAPI schema and override each part that you need.
-
-For example, let's add <a href="https://github.com/Rebilly/ReDoc/blob/master/docs/redoc-vendor-extensions.md#x-logo" class="external-link" target="_blank">ReDoc's OpenAPI extension to include a custom logo</a>.
-
-### Normal **FastAPI**
-
-First, write all your **FastAPI** application as normally:
-
-```Python hl_lines="1  4  7-9"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
-```
-
-### Generate the OpenAPI schema
-
-Then, use the same utility function to generate the OpenAPI schema, inside a `custom_openapi()` function:
-
-```Python hl_lines="2  15-21"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
-```
-
-### Modify the OpenAPI schema
-
-Now you can add the ReDoc extension, adding a custom `x-logo` to the `info` "object" in the OpenAPI schema:
-
-```Python hl_lines="22-24"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
-```
-
-### Cache the OpenAPI schema
-
-You can use the property `.openapi_schema` as a "cache", to store your generated schema.
-
-That way, your application won't have to generate the schema every time a user opens your API docs.
-
-It will be generated only once, and then the same cached schema will be used for the next requests.
-
-```Python hl_lines="13-14  25-26"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
-```
-
-### Override the method
-
-Now you can replace the `.openapi()` method with your new function.
-
-```Python hl_lines="29"
-{!../../../docs_src/extending_openapi/tutorial001.py!}
-```
-
-### Check it
-
-Once you go to <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a> you will see that you are using your custom logo (in this example, **FastAPI**'s logo):
-
-<img src="/img/tutorial/extending-openapi/image01.png">
-
-## Self-hosting JavaScript and CSS for docs
-
-The API docs use **Swagger UI** and **ReDoc**, and each of those need some JavaScript and CSS files.
-
-By default, those files are served from a <abbr title="Content Delivery Network: A service, normally composed of several servers, that provides static files, like JavaScript and CSS. It's commonly used to serve those files from the server closer to the client, improving performance.">CDN</abbr>.
-
-But it's possible to customize it, you can set a specific CDN, or serve the files yourself.
-
-That's useful, for example, if you need your app to keep working even while offline, without open Internet access, or in a local network.
-
-Here you'll see how to serve those files yourself, in the same FastAPI app, and configure the docs to use them.
-
-### Project file structure
-
-Let's say your project file structure looks like this:
-
-```
-.
-├── app
-│   ├── __init__.py
-│   ├── main.py
-```
-
-Now create a directory to store those static files.
-
-Your new file structure could look like this:
-
-```
-.
-├── app
-│   ├── __init__.py
-│   ├── main.py
-└── static/
-```
-
-### Download the files
-
-Download the static files needed for the docs and put them on that `static/` directory.
-
-You can probably right-click each link and select an option similar to `Save link as...`.
-
-**Swagger UI** uses the files:
-
-* <a href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui-bundle.js" class="external-link" target="_blank">`swagger-ui-bundle.js`</a>
-* <a href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui.css" class="external-link" target="_blank">`swagger-ui.css`</a>
-
-And **ReDoc** uses the file:
-
-* <a href="https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js" class="external-link" target="_blank">`redoc.standalone.js`</a>
-
-After that, your file structure could look like:
-
-```
-.
-├── app
-│   ├── __init__.py
-│   ├── main.py
-└── static
-    ├── redoc.standalone.js
-    ├── swagger-ui-bundle.js
-    └── swagger-ui.css
-```
-
-### Serve the static files
-
-* Import `StaticFiles`.
-* "Mount" a `StaticFiles()` instance in a specific path.
-
-```Python hl_lines="7  11"
-{!../../../docs_src/extending_openapi/tutorial002.py!}
-```
-
-### Test the static files
-
-Start your application and go to <a href="http://127.0.0.1:8000/static/redoc.standalone.js" class="external-link" target="_blank">http://127.0.0.1:8000/static/redoc.standalone.js</a>.
-
-You should see a very long JavaScript file for **ReDoc**.
-
-It could start with something like:
-
-```JavaScript
-/*!
- * ReDoc - OpenAPI/Swagger-generated API Reference Documentation
- * -------------------------------------------------------------
- *   Version: "2.0.0-rc.18"
- *   Repo: https://github.com/Redocly/redoc
- */
-!function(e,t){"object"==typeof exports&&"object"==typeof m
-
-...
-```
-
-That confirms that you are being able to serve static files from your app, and that you placed the static files for the docs in the correct place.
-
-Now we can configure the app to use those static files for the docs.
-
-### Disable the automatic docs
-
-The first step is to disable the automatic docs, as those use the CDN by default.
-
-To disable them, set their URLs to `None` when creating your `FastAPI` app:
-
-```Python hl_lines="9"
-{!../../../docs_src/extending_openapi/tutorial002.py!}
-```
-
-### Include the custom docs
-
-Now you can create the *path operations* for the custom docs.
-
-You can re-use FastAPI's internal functions to create the HTML pages for the docs, and pass them the needed arguments:
-
-* `openapi_url`: the URL where the HTML page for the docs can get the OpenAPI schema for your API. You can use here the attribute `app.openapi_url`.
-* `title`: the title of your API.
-* `oauth2_redirect_url`: you can use `app.swagger_ui_oauth2_redirect_url` here to use the default.
-* `swagger_js_url`: the URL where the HTML for your Swagger UI docs can get the **JavaScript** file. This is the one that your own app is now serving.
-* `swagger_css_url`: the URL where the HTML for your Swagger UI docs can get the **CSS** file. This is the one that your own app is now serving.
-
-And similarly for ReDoc...
-
-```Python hl_lines="2-6  14-22  25-27  30-36"
-{!../../../docs_src/extending_openapi/tutorial002.py!}
-```
-
-!!! tip
-    The *path operation* for `swagger_ui_redirect` is a helper for when you use OAuth2.
-
-    If you integrate your API with an OAuth2 provider, you will be able to authenticate and come back to the API docs with the acquired credentials. And interact with it using the real OAuth2 authentication.
-
-    Swagger UI will handle it behind the scenes for you, but it needs this "redirect" helper.
-
-### Create a *path operation* to test it
-
-Now, to be able to test that everything works, create a *path operation*:
-
-```Python hl_lines="39-41"
-{!../../../docs_src/extending_openapi/tutorial002.py!}
-```
-
-### Test it
-
-Now, you should be able to disconnect your WiFi, go to your docs at <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>, and reload the page.
-
-And even without Internet, you would be able to see the docs for your API and interact with it.
-
-## Configuring Swagger UI
-
-You can configure some extra <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">Swagger UI parameters</a>.
-
-To configure them, pass the `swagger_ui_parameters` argument when creating the `FastAPI()` app object or to the `get_swagger_ui_html()` function.
-
-`swagger_ui_parameters` receives a dictionary with the configurations passed to Swagger UI directly.
-
-FastAPI converts the configurations to **JSON** to make them compatible with JavaScript, as that's what Swagger UI needs.
-
-### Disable Syntax Highlighting
-
-For example, you could disable syntax highlighting in Swagger UI.
-
-Without changing the settings, syntax highlighting is enabled by default:
-
-<img src="/img/tutorial/extending-openapi/image02.png">
-
-But you can disable it by setting `syntaxHighlight` to `False`:
-
-```Python hl_lines="3"
-{!../../../docs_src/extending_openapi/tutorial003.py!}
-```
-
-...and then Swagger UI won't show the syntax highlighting anymore:
-
-<img src="/img/tutorial/extending-openapi/image03.png">
-
-### Change the Theme
-
-The same way you could set the syntax highlighting theme with the key `"syntaxHighlight.theme"` (notice that it has a dot in the middle):
-
-```Python hl_lines="3"
-{!../../../docs_src/extending_openapi/tutorial004.py!}
-```
-
-That configuration would change the syntax highlighting color theme:
-
-<img src="/img/tutorial/extending-openapi/image04.png">
-
-### Change Default Swagger UI Parameters
-
-FastAPI includes some default configuration parameters appropriate for most of the use cases.
-
-It includes these default configurations:
-
-```Python
-{!../../../fastapi/openapi/docs.py[ln:7-13]!}
-```
-
-You can override any of them by setting a different value in the argument `swagger_ui_parameters`.
-
-For example, to disable `deepLinking` you could pass these settings to `swagger_ui_parameters`:
-
-```Python hl_lines="3"
-{!../../../docs_src/extending_openapi/tutorial005.py!}
-```
-
-### Other Swagger UI Parameters
-
-To see all the other possible configurations you can use, read the official <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">docs for Swagger UI parameters</a>.
-
-### JavaScript-only settings
-
-Swagger UI also allows other configurations to be **JavaScript-only** objects (for example, JavaScript functions).
-
-FastAPI also includes these JavaScript-only `presets` settings:
-
-```JavaScript
-presets: [
-    SwaggerUIBundle.presets.apis,
-    SwaggerUIBundle.SwaggerUIStandalonePreset
-]
-```
-
-These are **JavaScript** objects, not strings, so you can't pass them from Python code directly.
-
-If you need to use JavaScript-only configurations like those, you can use one of the methods above. Override all the Swagger UI *path operation* and manually write any JavaScript you need.
diff --git a/docs/en/docs/advanced/async-sql-databases.md b/docs/en/docs/how-to/async-sql-encode-databases.md
similarity index 98%
rename from docs/en/docs/advanced/async-sql-databases.md
rename to docs/en/docs/how-to/async-sql-encode-databases.md
index 12549a190..697167f79 100644
--- a/docs/en/docs/advanced/async-sql-databases.md
+++ b/docs/en/docs/how-to/async-sql-encode-databases.md
@@ -1,4 +1,4 @@
-# Async SQL (Relational) Databases
+# Async SQL (Relational) Databases with Encode/Databases
 
 !!! info
     These docs are about to be updated. 🎉
diff --git a/docs/en/docs/advanced/conditional-openapi.md b/docs/en/docs/how-to/conditional-openapi.md
similarity index 100%
rename from docs/en/docs/advanced/conditional-openapi.md
rename to docs/en/docs/how-to/conditional-openapi.md
diff --git a/docs/en/docs/how-to/configure-swagger-ui.md b/docs/en/docs/how-to/configure-swagger-ui.md
new file mode 100644
index 000000000..f36ba5ba8
--- /dev/null
+++ b/docs/en/docs/how-to/configure-swagger-ui.md
@@ -0,0 +1,78 @@
+# Configure Swagger UI
+
+You can configure some extra <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">Swagger UI parameters</a>.
+
+To configure them, pass the `swagger_ui_parameters` argument when creating the `FastAPI()` app object or to the `get_swagger_ui_html()` function.
+
+`swagger_ui_parameters` receives a dictionary with the configurations passed to Swagger UI directly.
+
+FastAPI converts the configurations to **JSON** to make them compatible with JavaScript, as that's what Swagger UI needs.
+
+## Disable Syntax Highlighting
+
+For example, you could disable syntax highlighting in Swagger UI.
+
+Without changing the settings, syntax highlighting is enabled by default:
+
+<img src="/img/tutorial/extending-openapi/image02.png">
+
+But you can disable it by setting `syntaxHighlight` to `False`:
+
+```Python hl_lines="3"
+{!../../../docs_src/configure_swagger_ui/tutorial001.py!}
+```
+
+...and then Swagger UI won't show the syntax highlighting anymore:
+
+<img src="/img/tutorial/extending-openapi/image03.png">
+
+## Change the Theme
+
+The same way you could set the syntax highlighting theme with the key `"syntaxHighlight.theme"` (notice that it has a dot in the middle):
+
+```Python hl_lines="3"
+{!../../../docs_src/configure_swagger_ui/tutorial002.py!}
+```
+
+That configuration would change the syntax highlighting color theme:
+
+<img src="/img/tutorial/extending-openapi/image04.png">
+
+## Change Default Swagger UI Parameters
+
+FastAPI includes some default configuration parameters appropriate for most of the use cases.
+
+It includes these default configurations:
+
+```Python
+{!../../../fastapi/openapi/docs.py[ln:7-13]!}
+```
+
+You can override any of them by setting a different value in the argument `swagger_ui_parameters`.
+
+For example, to disable `deepLinking` you could pass these settings to `swagger_ui_parameters`:
+
+```Python hl_lines="3"
+{!../../../docs_src/configure_swagger_ui/tutorial003.py!}
+```
+
+## Other Swagger UI Parameters
+
+To see all the other possible configurations you can use, read the official <a href="https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration" class="external-link" target="_blank">docs for Swagger UI parameters</a>.
+
+## JavaScript-only settings
+
+Swagger UI also allows other configurations to be **JavaScript-only** objects (for example, JavaScript functions).
+
+FastAPI also includes these JavaScript-only `presets` settings:
+
+```JavaScript
+presets: [
+    SwaggerUIBundle.presets.apis,
+    SwaggerUIBundle.SwaggerUIStandalonePreset
+]
+```
+
+These are **JavaScript** objects, not strings, so you can't pass them from Python code directly.
+
+If you need to use JavaScript-only configurations like those, you can use one of the methods above. Override all the Swagger UI *path operation* and manually write any JavaScript you need.
diff --git a/docs/en/docs/how-to/custom-docs-ui-assets.md b/docs/en/docs/how-to/custom-docs-ui-assets.md
new file mode 100644
index 000000000..f26324869
--- /dev/null
+++ b/docs/en/docs/how-to/custom-docs-ui-assets.md
@@ -0,0 +1,199 @@
+# Custom Docs UI Static Assets (Self-Hosting)
+
+The API docs use **Swagger UI** and **ReDoc**, and each of those need some JavaScript and CSS files.
+
+By default, those files are served from a <abbr title="Content Delivery Network: A service, normally composed of several servers, that provides static files, like JavaScript and CSS. It's commonly used to serve those files from the server closer to the client, improving performance.">CDN</abbr>.
+
+But it's possible to customize it, you can set a specific CDN, or serve the files yourself.
+
+## Custom CDN for JavaScript and CSS
+
+Let's say that you want to use a different <abbr title="Content Delivery Network">CDN</abbr>, for example you want to use `https://unpkg.com/`.
+
+This could be useful if for example you live in a country that restricts some URLs.
+
+### Disable the automatic docs
+
+The first step is to disable the automatic docs, as by default, those use the default CDN.
+
+To disable them, set their URLs to `None` when creating your `FastAPI` app:
+
+```Python hl_lines="8"
+{!../../../docs_src/custom_docs_ui/tutorial001.py!}
+```
+
+### Include the custom docs
+
+Now you can create the *path operations* for the custom docs.
+
+You can re-use FastAPI's internal functions to create the HTML pages for the docs, and pass them the needed arguments:
+
+* `openapi_url`: the URL where the HTML page for the docs can get the OpenAPI schema for your API. You can use here the attribute `app.openapi_url`.
+* `title`: the title of your API.
+* `oauth2_redirect_url`: you can use `app.swagger_ui_oauth2_redirect_url` here to use the default.
+* `swagger_js_url`: the URL where the HTML for your Swagger UI docs can get the **JavaScript** file. This is the custom CDN URL.
+* `swagger_css_url`: the URL where the HTML for your Swagger UI docs can get the **CSS** file. This is the custom CDN URL.
+
+And similarly for ReDoc...
+
+```Python hl_lines="2-6  11-19  22-24  27-33"
+{!../../../docs_src/custom_docs_ui/tutorial001.py!}
+```
+
+!!! tip
+    The *path operation* for `swagger_ui_redirect` is a helper for when you use OAuth2.
+
+    If you integrate your API with an OAuth2 provider, you will be able to authenticate and come back to the API docs with the acquired credentials. And interact with it using the real OAuth2 authentication.
+
+    Swagger UI will handle it behind the scenes for you, but it needs this "redirect" helper.
+
+### Create a *path operation* to test it
+
+Now, to be able to test that everything works, create a *path operation*:
+
+```Python hl_lines="36-38"
+{!../../../docs_src/custom_docs_ui/tutorial001.py!}
+```
+
+### Test it
+
+Now, you should be able to go to your docs at <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>, and reload the page, it will load those assets from the new CDN.
+
+## Self-hosting JavaScript and CSS for docs
+
+Self-hosting the JavaScript and CSS could be useful if, for example, you need your app to keep working even while offline, without open Internet access, or in a local network.
+
+Here you'll see how to serve those files yourself, in the same FastAPI app, and configure the docs to use them.
+
+### Project file structure
+
+Let's say your project file structure looks like this:
+
+```
+.
+├── app
+│   ├── __init__.py
+│   ├── main.py
+```
+
+Now create a directory to store those static files.
+
+Your new file structure could look like this:
+
+```
+.
+├── app
+│   ├── __init__.py
+│   ├── main.py
+└── static/
+```
+
+### Download the files
+
+Download the static files needed for the docs and put them on that `static/` directory.
+
+You can probably right-click each link and select an option similar to `Save link as...`.
+
+**Swagger UI** uses the files:
+
+* <a href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui-bundle.js" class="external-link" target="_blank">`swagger-ui-bundle.js`</a>
+* <a href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui.css" class="external-link" target="_blank">`swagger-ui.css`</a>
+
+And **ReDoc** uses the file:
+
+* <a href="https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js" class="external-link" target="_blank">`redoc.standalone.js`</a>
+
+After that, your file structure could look like:
+
+```
+.
+├── app
+│   ├── __init__.py
+│   ├── main.py
+└── static
+    ├── redoc.standalone.js
+    ├── swagger-ui-bundle.js
+    └── swagger-ui.css
+```
+
+### Serve the static files
+
+* Import `StaticFiles`.
+* "Mount" a `StaticFiles()` instance in a specific path.
+
+```Python hl_lines="7  11"
+{!../../../docs_src/custom_docs_ui/tutorial002.py!}
+```
+
+### Test the static files
+
+Start your application and go to <a href="http://127.0.0.1:8000/static/redoc.standalone.js" class="external-link" target="_blank">http://127.0.0.1:8000/static/redoc.standalone.js</a>.
+
+You should see a very long JavaScript file for **ReDoc**.
+
+It could start with something like:
+
+```JavaScript
+/*!
+ * ReDoc - OpenAPI/Swagger-generated API Reference Documentation
+ * -------------------------------------------------------------
+ *   Version: "2.0.0-rc.18"
+ *   Repo: https://github.com/Redocly/redoc
+ */
+!function(e,t){"object"==typeof exports&&"object"==typeof m
+
+...
+```
+
+That confirms that you are being able to serve static files from your app, and that you placed the static files for the docs in the correct place.
+
+Now we can configure the app to use those static files for the docs.
+
+### Disable the automatic docs for static files
+
+The same as when using a custom CDN, the first step is to disable the automatic docs, as those use the CDN by default.
+
+To disable them, set their URLs to `None` when creating your `FastAPI` app:
+
+```Python hl_lines="9"
+{!../../../docs_src/custom_docs_ui/tutorial002.py!}
+```
+
+### Include the custom docs for static files
+
+And the same way as with a custom CDN, now you can create the *path operations* for the custom docs.
+
+Again, you can re-use FastAPI's internal functions to create the HTML pages for the docs, and pass them the needed arguments:
+
+* `openapi_url`: the URL where the HTML page for the docs can get the OpenAPI schema for your API. You can use here the attribute `app.openapi_url`.
+* `title`: the title of your API.
+* `oauth2_redirect_url`: you can use `app.swagger_ui_oauth2_redirect_url` here to use the default.
+* `swagger_js_url`: the URL where the HTML for your Swagger UI docs can get the **JavaScript** file. **This is the one that your own app is now serving**.
+* `swagger_css_url`: the URL where the HTML for your Swagger UI docs can get the **CSS** file. **This is the one that your own app is now serving**.
+
+And similarly for ReDoc...
+
+```Python hl_lines="2-6  14-22  25-27  30-36"
+{!../../../docs_src/custom_docs_ui/tutorial002.py!}
+```
+
+!!! tip
+    The *path operation* for `swagger_ui_redirect` is a helper for when you use OAuth2.
+
+    If you integrate your API with an OAuth2 provider, you will be able to authenticate and come back to the API docs with the acquired credentials. And interact with it using the real OAuth2 authentication.
+
+    Swagger UI will handle it behind the scenes for you, but it needs this "redirect" helper.
+
+### Create a *path operation* to test static files
+
+Now, to be able to test that everything works, create a *path operation*:
+
+```Python hl_lines="39-41"
+{!../../../docs_src/custom_docs_ui/tutorial002.py!}
+```
+
+### Test Static Files UI
+
+Now, you should be able to disconnect your WiFi, go to your docs at <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>, and reload the page.
+
+And even without Internet, you would be able to see the docs for your API and interact with it.
diff --git a/docs/en/docs/advanced/custom-request-and-route.md b/docs/en/docs/how-to/custom-request-and-route.md
similarity index 100%
rename from docs/en/docs/advanced/custom-request-and-route.md
rename to docs/en/docs/how-to/custom-request-and-route.md
diff --git a/docs/en/docs/how-to/extending-openapi.md b/docs/en/docs/how-to/extending-openapi.md
new file mode 100644
index 000000000..a18fd737e
--- /dev/null
+++ b/docs/en/docs/how-to/extending-openapi.md
@@ -0,0 +1,87 @@
+# Extending OpenAPI
+
+There are some cases where you might need to modify the generated OpenAPI schema.
+
+In this section you will see how.
+
+## The normal process
+
+The normal (default) process, is as follows.
+
+A `FastAPI` application (instance) has an `.openapi()` method that is expected to return the OpenAPI schema.
+
+As part of the application object creation, a *path operation* for `/openapi.json` (or for whatever you set your `openapi_url`) is registered.
+
+It just returns a JSON response with the result of the application's `.openapi()` method.
+
+By default, what the method `.openapi()` does is check the property `.openapi_schema` to see if it has contents and return them.
+
+If it doesn't, it generates them using the utility function at `fastapi.openapi.utils.get_openapi`.
+
+And that function `get_openapi()` receives as parameters:
+
+* `title`: The OpenAPI title, shown in the docs.
+* `version`: The version of your API, e.g. `2.5.0`.
+* `openapi_version`: The version of the OpenAPI specification used. By default, the latest: `3.1.0`.
+* `summary`: A short summary of the API.
+* `description`: The description of your API, this can include markdown and will be shown in the docs.
+* `routes`: A list of routes, these are each of the registered *path operations*. They are taken from `app.routes`.
+
+!!! info
+    The parameter `summary` is available in OpenAPI 3.1.0 and above, supported by FastAPI 0.99.0 and above.
+
+## Overriding the defaults
+
+Using the information above, you can use the same utility function to generate the OpenAPI schema and override each part that you need.
+
+For example, let's add <a href="https://github.com/Rebilly/ReDoc/blob/master/docs/redoc-vendor-extensions.md#x-logo" class="external-link" target="_blank">ReDoc's OpenAPI extension to include a custom logo</a>.
+
+### Normal **FastAPI**
+
+First, write all your **FastAPI** application as normally:
+
+```Python hl_lines="1  4  7-9"
+{!../../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### Generate the OpenAPI schema
+
+Then, use the same utility function to generate the OpenAPI schema, inside a `custom_openapi()` function:
+
+```Python hl_lines="2  15-21"
+{!../../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### Modify the OpenAPI schema
+
+Now you can add the ReDoc extension, adding a custom `x-logo` to the `info` "object" in the OpenAPI schema:
+
+```Python hl_lines="22-24"
+{!../../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### Cache the OpenAPI schema
+
+You can use the property `.openapi_schema` as a "cache", to store your generated schema.
+
+That way, your application won't have to generate the schema every time a user opens your API docs.
+
+It will be generated only once, and then the same cached schema will be used for the next requests.
+
+```Python hl_lines="13-14  25-26"
+{!../../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### Override the method
+
+Now you can replace the `.openapi()` method with your new function.
+
+```Python hl_lines="29"
+{!../../../docs_src/extending_openapi/tutorial001.py!}
+```
+
+### Check it
+
+Once you go to <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a> you will see that you are using your custom logo (in this example, **FastAPI**'s logo):
+
+<img src="/img/tutorial/extending-openapi/image01.png">
diff --git a/docs/en/docs/how-to/general.md b/docs/en/docs/how-to/general.md
new file mode 100644
index 000000000..04367c6b7
--- /dev/null
+++ b/docs/en/docs/how-to/general.md
@@ -0,0 +1,39 @@
+# General - How To - Recipes
+
+Here are several pointers to other places in the docs, for general or frequent questions.
+
+## Filter Data - Security
+
+To ensure that you don't return more data than you should, read the docs for [Tutorial - Response Model - Return Type](../tutorial/response-model.md){.internal-link target=_blank}.
+
+## Documentation Tags - OpenAPI
+
+To add tags to your *path operations*, and group them in the docs UI, read the docs for [Tutorial - Path Operation Configurations - Tags](../tutorial/path-operation-configuration.md#tags){.internal-link target=_blank}.
+
+## Documentation Summary and Description - OpenAPI
+
+To add a summary and description to your *path operations*, and show them in the docs UI, read the docs for [Tutorial - Path Operation Configurations - Summary and Description](../tutorial/path-operation-configuration.md#summary-and-description){.internal-link target=_blank}.
+
+## Documentation Response description - OpenAPI
+
+To define the description of the response, shown in the docs UI, read the docs for [Tutorial - Path Operation Configurations - Response description](../tutorial/path-operation-configuration.md#response-description){.internal-link target=_blank}.
+
+## Documentation Deprecate a *Path Operation* - OpenAPI
+
+To deprecate a *path operation*, and show it in the docs UI, read the docs for [Tutorial - Path Operation Configurations - Deprecation](../tutorial/path-operation-configuration.md#deprecate-a-path-operation){.internal-link target=_blank}.
+
+## Convert any Data to JSON-compatible
+
+To convert any data to JSON-compatible, read the docs for [Tutorial - JSON Compatible Encoder](../tutorial/encoder.md){.internal-link target=_blank}.
+
+## OpenAPI Metadata - Docs
+
+To add metadata to your OpenAPI schema, including a license, version, contact, etc, read the docs for [Tutorial - Metadata and Docs URLs](../tutorial/metadata.md){.internal-link target=_blank}.
+
+## OpenAPI Custom URL
+
+To customize the OpenAPI URL (or remove it), read the docs for [Tutorial - Metadata and Docs URLs](../tutorial/metadata.md#openapi-url){.internal-link target=_blank}.
+
+## OpenAPI Docs URLs
+
+To update the URLs used for the automatically generated docs user interfaces, read the docs for [Tutorial - Metadata and Docs URLs](../tutorial/metadata.md#docs-urls){.internal-link target=_blank}.
diff --git a/docs/en/docs/advanced/graphql.md b/docs/en/docs/how-to/graphql.md
similarity index 100%
rename from docs/en/docs/advanced/graphql.md
rename to docs/en/docs/how-to/graphql.md
diff --git a/docs/en/docs/how-to/index.md b/docs/en/docs/how-to/index.md
new file mode 100644
index 000000000..ec7fd38f8
--- /dev/null
+++ b/docs/en/docs/how-to/index.md
@@ -0,0 +1,11 @@
+# How To - Recipes
+
+Here you will see different recipes or "how to" guides for **several topics**.
+
+Most of these ideas would be more or less **independent**, and in most cases you should only need to study them if they apply directly to **your project**.
+
+If something seems interesting and useful to your project, go ahead and check it, but otherwise, you might probably just skip them.
+
+!!! tip
+
+    If you want to **learn FastAPI** in a structured way (recommended), go and read the [Tutorial - User Guide](../tutorial/index.md){.internal-link target=_blank} chapter by chapter instead.
diff --git a/docs/en/docs/advanced/nosql-databases.md b/docs/en/docs/how-to/nosql-databases-couchbase.md
similarity index 99%
rename from docs/en/docs/advanced/nosql-databases.md
rename to docs/en/docs/how-to/nosql-databases-couchbase.md
index 606db35c7..ae6ad604b 100644
--- a/docs/en/docs/advanced/nosql-databases.md
+++ b/docs/en/docs/how-to/nosql-databases-couchbase.md
@@ -1,4 +1,4 @@
-# NoSQL (Distributed / Big Data) Databases
+# NoSQL (Distributed / Big Data) Databases with Couchbase
 
 !!! info
     These docs are about to be updated. 🎉
diff --git a/docs/en/docs/advanced/sql-databases-peewee.md b/docs/en/docs/how-to/sql-databases-peewee.md
similarity index 99%
rename from docs/en/docs/advanced/sql-databases-peewee.md
rename to docs/en/docs/how-to/sql-databases-peewee.md
index 6a469634f..bf2f2e714 100644
--- a/docs/en/docs/advanced/sql-databases-peewee.md
+++ b/docs/en/docs/how-to/sql-databases-peewee.md
@@ -12,6 +12,8 @@
 
     Because Pewee doesn't play well with anything async and there are better alternatives, I won't update these docs for Pydantic v2, they are kept for now only for historical purposes.
 
+    The examples here are no longer tested in CI (as they were before).
+
 If you are starting a project from scratch, you are probably better off with SQLAlchemy ORM ([SQL (Relational) Databases](../tutorial/sql-databases.md){.internal-link target=_blank}), or any other async ORM.
 
 If you already have a code base that uses <a href="https://docs.peewee-orm.com/en/latest/" class="external-link" target="_blank">Peewee ORM</a>, you can check here how to use it with **FastAPI**.
diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index 22babe745..f75b84ff5 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -45,6 +45,13 @@ plugins:
   redirects:
     redirect_maps:
       deployment/deta.md: deployment/cloud.md
+      advanced/sql-databases-peewee.md: how-to/sql-databases-peewee.md
+      advanced/async-sql-databases.md: how-to/async-sql-encode-databases.md
+      advanced/nosql-databases.md: how-to/nosql-databases-couchbase.md
+      advanced/graphql.md: how-to/graphql.md
+      advanced/custom-request-and-route.md: how-to/custom-request-and-route.md
+      advanced/conditional-openapi.md: how-to/conditional-openapi.md
+      advanced/extending-openapi.md: how-to/extending-openapi.md
 nav:
 - FastAPI: index.md
 - Languages:
@@ -134,24 +141,17 @@ nav:
   - advanced/using-request-directly.md
   - advanced/dataclasses.md
   - advanced/middleware.md
-  - advanced/sql-databases-peewee.md
-  - advanced/async-sql-databases.md
-  - advanced/nosql-databases.md
   - advanced/sub-applications.md
   - advanced/behind-a-proxy.md
   - advanced/templates.md
-  - advanced/graphql.md
   - advanced/websockets.md
   - advanced/events.md
-  - advanced/custom-request-and-route.md
   - advanced/testing-websockets.md
   - advanced/testing-events.md
   - advanced/testing-dependencies.md
   - advanced/testing-database.md
   - advanced/async-tests.md
   - advanced/settings.md
-  - advanced/conditional-openapi.md
-  - advanced/extending-openapi.md
   - advanced/openapi-callbacks.md
   - advanced/openapi-webhooks.md
   - advanced/wsgi.md
@@ -166,6 +166,18 @@ nav:
   - deployment/cloud.md
   - deployment/server-workers.md
   - deployment/docker.md
+- How To - Recipes:
+  - how-to/index.md
+  - how-to/general.md
+  - how-to/sql-databases-peewee.md
+  - how-to/async-sql-encode-databases.md
+  - how-to/nosql-databases-couchbase.md
+  - how-to/graphql.md
+  - how-to/custom-request-and-route.md
+  - how-to/conditional-openapi.md
+  - how-to/extending-openapi.md
+  - how-to/custom-docs-ui-assets.md
+  - how-to/configure-swagger-ui.md
 - project-generation.md
 - alternatives.md
 - history-design-future.md
diff --git a/docs/ja/docs/advanced/conditional-openapi.md b/docs/ja/docs/how-to/conditional-openapi.md
similarity index 100%
rename from docs/ja/docs/advanced/conditional-openapi.md
rename to docs/ja/docs/how-to/conditional-openapi.md
diff --git a/docs_src/extending_openapi/tutorial003.py b/docs_src/configure_swagger_ui/tutorial001.py
similarity index 100%
rename from docs_src/extending_openapi/tutorial003.py
rename to docs_src/configure_swagger_ui/tutorial001.py
diff --git a/docs_src/extending_openapi/tutorial004.py b/docs_src/configure_swagger_ui/tutorial002.py
similarity index 100%
rename from docs_src/extending_openapi/tutorial004.py
rename to docs_src/configure_swagger_ui/tutorial002.py
diff --git a/docs_src/extending_openapi/tutorial005.py b/docs_src/configure_swagger_ui/tutorial003.py
similarity index 100%
rename from docs_src/extending_openapi/tutorial005.py
rename to docs_src/configure_swagger_ui/tutorial003.py
diff --git a/docs_src/custom_docs_ui/tutorial001.py b/docs_src/custom_docs_ui/tutorial001.py
new file mode 100644
index 000000000..f7ceb0c2f
--- /dev/null
+++ b/docs_src/custom_docs_ui/tutorial001.py
@@ -0,0 +1,38 @@
+from fastapi import FastAPI
+from fastapi.openapi.docs import (
+    get_redoc_html,
+    get_swagger_ui_html,
+    get_swagger_ui_oauth2_redirect_html,
+)
+
+app = FastAPI(docs_url=None, redoc_url=None)
+
+
+@app.get("/docs", include_in_schema=False)
+async def custom_swagger_ui_html():
+    return get_swagger_ui_html(
+        openapi_url=app.openapi_url,
+        title=app.title + " - Swagger UI",
+        oauth2_redirect_url=app.swagger_ui_oauth2_redirect_url,
+        swagger_js_url="https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js",
+        swagger_css_url="https://unpkg.com/swagger-ui-dist@5/swagger-ui.css",
+    )
+
+
+@app.get(app.swagger_ui_oauth2_redirect_url, include_in_schema=False)
+async def swagger_ui_redirect():
+    return get_swagger_ui_oauth2_redirect_html()
+
+
+@app.get("/redoc", include_in_schema=False)
+async def redoc_html():
+    return get_redoc_html(
+        openapi_url=app.openapi_url,
+        title=app.title + " - ReDoc",
+        redoc_js_url="https://unpkg.com/redoc@next/bundles/redoc.standalone.js",
+    )
+
+
+@app.get("/users/{username}")
+async def read_user(username: str):
+    return {"message": f"Hello {username}"}
diff --git a/docs_src/extending_openapi/tutorial002.py b/docs_src/custom_docs_ui/tutorial002.py
similarity index 100%
rename from docs_src/extending_openapi/tutorial002.py
rename to docs_src/custom_docs_ui/tutorial002.py
diff --git a/requirements-tests.txt b/requirements-tests.txt
index 0113b6f7a..6f7f4ac23 100644
--- a/requirements-tests.txt
+++ b/requirements-tests.txt
@@ -11,7 +11,6 @@ dirty-equals ==0.6.0
 # TODO: once removing databases from tutorial, upgrade SQLAlchemy
 # probably when including SQLModel
 sqlalchemy >=1.3.18,<1.4.43
-peewee >=3.13.3,<4.0.0
 databases[sqlite] >=0.3.2,<0.7.0
 orjson >=3.2.1,<4.0.0
 ujson >=4.0.1,!=4.0.2,!=4.1.0,!=4.2.0,!=4.3.0,!=5.0.0,!=5.1.0,<6.0.0
diff --git a/docs_src/sql_databases_peewee/__init__.py b/tests/test_tutorial/test_configure_swagger_ui/__init__.py
similarity index 100%
rename from docs_src/sql_databases_peewee/__init__.py
rename to tests/test_tutorial/test_configure_swagger_ui/__init__.py
diff --git a/tests/test_tutorial/test_extending_openapi/test_tutorial003.py b/tests/test_tutorial/test_configure_swagger_ui/test_tutorial001.py
similarity index 95%
rename from tests/test_tutorial/test_extending_openapi/test_tutorial003.py
rename to tests/test_tutorial/test_configure_swagger_ui/test_tutorial001.py
index 0184dd9f8..72db54bd2 100644
--- a/tests/test_tutorial/test_extending_openapi/test_tutorial003.py
+++ b/tests/test_tutorial/test_configure_swagger_ui/test_tutorial001.py
@@ -1,6 +1,6 @@
 from fastapi.testclient import TestClient
 
-from docs_src.extending_openapi.tutorial003 import app
+from docs_src.configure_swagger_ui.tutorial001 import app
 
 client = TestClient(app)
 
diff --git a/tests/test_tutorial/test_extending_openapi/test_tutorial004.py b/tests/test_tutorial/test_configure_swagger_ui/test_tutorial002.py
similarity index 96%
rename from tests/test_tutorial/test_extending_openapi/test_tutorial004.py
rename to tests/test_tutorial/test_configure_swagger_ui/test_tutorial002.py
index 4f7615126..166901188 100644
--- a/tests/test_tutorial/test_extending_openapi/test_tutorial004.py
+++ b/tests/test_tutorial/test_configure_swagger_ui/test_tutorial002.py
@@ -1,6 +1,6 @@
 from fastapi.testclient import TestClient
 
-from docs_src.extending_openapi.tutorial004 import app
+from docs_src.configure_swagger_ui.tutorial002 import app
 
 client = TestClient(app)
 
diff --git a/tests/test_tutorial/test_extending_openapi/test_tutorial005.py b/tests/test_tutorial/test_configure_swagger_ui/test_tutorial003.py
similarity index 96%
rename from tests/test_tutorial/test_extending_openapi/test_tutorial005.py
rename to tests/test_tutorial/test_configure_swagger_ui/test_tutorial003.py
index 24aeb93db..187e89ace 100644
--- a/tests/test_tutorial/test_extending_openapi/test_tutorial005.py
+++ b/tests/test_tutorial/test_configure_swagger_ui/test_tutorial003.py
@@ -1,6 +1,6 @@
 from fastapi.testclient import TestClient
 
-from docs_src.extending_openapi.tutorial005 import app
+from docs_src.configure_swagger_ui.tutorial003 import app
 
 client = TestClient(app)
 
diff --git a/tests/test_tutorial/test_sql_databases_peewee/__init__.py b/tests/test_tutorial/test_custom_docs_ui/__init__.py
similarity index 100%
rename from tests/test_tutorial/test_sql_databases_peewee/__init__.py
rename to tests/test_tutorial/test_custom_docs_ui/__init__.py
diff --git a/tests/test_tutorial/test_custom_docs_ui/test_tutorial001.py b/tests/test_tutorial/test_custom_docs_ui/test_tutorial001.py
new file mode 100644
index 000000000..aff070d74
--- /dev/null
+++ b/tests/test_tutorial/test_custom_docs_ui/test_tutorial001.py
@@ -0,0 +1,42 @@
+import os
+from pathlib import Path
+
+import pytest
+from fastapi.testclient import TestClient
+
+
+@pytest.fixture(scope="module")
+def client():
+    static_dir: Path = Path(os.getcwd()) / "static"
+    print(static_dir)
+    static_dir.mkdir(exist_ok=True)
+    from docs_src.custom_docs_ui.tutorial001 import app
+
+    with TestClient(app) as client:
+        yield client
+    static_dir.rmdir()
+
+
+def test_swagger_ui_html(client: TestClient):
+    response = client.get("/docs")
+    assert response.status_code == 200, response.text
+    assert "https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js" in response.text
+    assert "https://unpkg.com/swagger-ui-dist@5/swagger-ui.css" in response.text
+
+
+def test_swagger_ui_oauth2_redirect_html(client: TestClient):
+    response = client.get("/docs/oauth2-redirect")
+    assert response.status_code == 200, response.text
+    assert "window.opener.swaggerUIRedirectOauth2" in response.text
+
+
+def test_redoc_html(client: TestClient):
+    response = client.get("/redoc")
+    assert response.status_code == 200, response.text
+    assert "https://unpkg.com/redoc@next/bundles/redoc.standalone.js" in response.text
+
+
+def test_api(client: TestClient):
+    response = client.get("/users/john")
+    assert response.status_code == 200, response.text
+    assert response.json()["message"] == "Hello john"
diff --git a/tests/test_tutorial/test_extending_openapi/test_tutorial002.py b/tests/test_tutorial/test_custom_docs_ui/test_tutorial002.py
similarity index 95%
rename from tests/test_tutorial/test_extending_openapi/test_tutorial002.py
rename to tests/test_tutorial/test_custom_docs_ui/test_tutorial002.py
index 654db2e4c..712618807 100644
--- a/tests/test_tutorial/test_extending_openapi/test_tutorial002.py
+++ b/tests/test_tutorial/test_custom_docs_ui/test_tutorial002.py
@@ -10,7 +10,7 @@ def client():
     static_dir: Path = Path(os.getcwd()) / "static"
     print(static_dir)
     static_dir.mkdir(exist_ok=True)
-    from docs_src.extending_openapi.tutorial002 import app
+    from docs_src.custom_docs_ui.tutorial002 import app
 
     with TestClient(app) as client:
         yield client
diff --git a/tests/test_tutorial/test_sql_databases_peewee/test_sql_databases_peewee.py b/tests/test_tutorial/test_sql_databases_peewee/test_sql_databases_peewee.py
deleted file mode 100644
index 4350567d1..000000000
--- a/tests/test_tutorial/test_sql_databases_peewee/test_sql_databases_peewee.py
+++ /dev/null
@@ -1,454 +0,0 @@
-import time
-from pathlib import Path
-from unittest.mock import MagicMock
-
-import pytest
-from fastapi.testclient import TestClient
-
-from ...utils import needs_pydanticv1
-
-
-@pytest.fixture(scope="module")
-def client():
-    # Import while creating the client to create the DB after starting the test session
-    from docs_src.sql_databases_peewee.sql_app.main import app
-
-    test_db = Path("./test.db")
-    with TestClient(app) as c:
-        yield c
-    test_db.unlink()
-
-
-@needs_pydanticv1
-def test_create_user(client):
-    test_user = {"email": "johndoe@example.com", "password": "secret"}
-    response = client.post("/users/", json=test_user)
-    assert response.status_code == 200, response.text
-    data = response.json()
-    assert test_user["email"] == data["email"]
-    assert "id" in data
-    response = client.post("/users/", json=test_user)
-    assert response.status_code == 400, response.text
-
-
-@needs_pydanticv1
-def test_get_user(client):
-    response = client.get("/users/1")
-    assert response.status_code == 200, response.text
-    data = response.json()
-    assert "email" in data
-    assert "id" in data
-
-
-@needs_pydanticv1
-def test_inexistent_user(client):
-    response = client.get("/users/999")
-    assert response.status_code == 404, response.text
-
-
-@needs_pydanticv1
-def test_get_users(client):
-    response = client.get("/users/")
-    assert response.status_code == 200, response.text
-    data = response.json()
-    assert "email" in data[0]
-    assert "id" in data[0]
-
-
-time.sleep = MagicMock()
-
-
-@needs_pydanticv1
-def test_get_slowusers(client):
-    response = client.get("/slowusers/")
-    assert response.status_code == 200, response.text
-    data = response.json()
-    assert "email" in data[0]
-    assert "id" in data[0]
-
-
-@needs_pydanticv1
-def test_create_item(client):
-    item = {"title": "Foo", "description": "Something that fights"}
-    response = client.post("/users/1/items/", json=item)
-    assert response.status_code == 200, response.text
-    item_data = response.json()
-    assert item["title"] == item_data["title"]
-    assert item["description"] == item_data["description"]
-    assert "id" in item_data
-    assert "owner_id" in item_data
-    response = client.get("/users/1")
-    assert response.status_code == 200, response.text
-    user_data = response.json()
-    item_to_check = [it for it in user_data["items"] if it["id"] == item_data["id"]][0]
-    assert item_to_check["title"] == item["title"]
-    assert item_to_check["description"] == item["description"]
-    response = client.get("/users/1")
-    assert response.status_code == 200, response.text
-    user_data = response.json()
-    item_to_check = [it for it in user_data["items"] if it["id"] == item_data["id"]][0]
-    assert item_to_check["title"] == item["title"]
-    assert item_to_check["description"] == item["description"]
-
-
-@needs_pydanticv1
-def test_read_items(client):
-    response = client.get("/items/")
-    assert response.status_code == 200, response.text
-    data = response.json()
-    assert data
-    first_item = data[0]
-    assert "title" in first_item
-    assert "description" in first_item
-
-
-@needs_pydanticv1
-def test_openapi_schema(client):
-    response = client.get("/openapi.json")
-    assert response.status_code == 200, response.text
-    assert response.json() == {
-        "openapi": "3.1.0",
-        "info": {"title": "FastAPI", "version": "0.1.0"},
-        "paths": {
-            "/users/": {
-                "get": {
-                    "summary": "Read Users",
-                    "operationId": "read_users_users__get",
-                    "parameters": [
-                        {
-                            "required": False,
-                            "schema": {
-                                "title": "Skip",
-                                "type": "integer",
-                                "default": 0,
-                            },
-                            "name": "skip",
-                            "in": "query",
-                        },
-                        {
-                            "required": False,
-                            "schema": {
-                                "title": "Limit",
-                                "type": "integer",
-                                "default": 100,
-                            },
-                            "name": "limit",
-                            "in": "query",
-                        },
-                    ],
-                    "responses": {
-                        "200": {
-                            "description": "Successful Response",
-                            "content": {
-                                "application/json": {
-                                    "schema": {
-                                        "title": "Response Read Users Users  Get",
-                                        "type": "array",
-                                        "items": {"$ref": "#/components/schemas/User"},
-                                    }
-                                }
-                            },
-                        },
-                        "422": {
-                            "description": "Validation Error",
-                            "content": {
-                                "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/HTTPValidationError"
-                                    }
-                                }
-                            },
-                        },
-                    },
-                },
-                "post": {
-                    "summary": "Create User",
-                    "operationId": "create_user_users__post",
-                    "requestBody": {
-                        "content": {
-                            "application/json": {
-                                "schema": {"$ref": "#/components/schemas/UserCreate"}
-                            }
-                        },
-                        "required": True,
-                    },
-                    "responses": {
-                        "200": {
-                            "description": "Successful Response",
-                            "content": {
-                                "application/json": {
-                                    "schema": {"$ref": "#/components/schemas/User"}
-                                }
-                            },
-                        },
-                        "422": {
-                            "description": "Validation Error",
-                            "content": {
-                                "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/HTTPValidationError"
-                                    }
-                                }
-                            },
-                        },
-                    },
-                },
-            },
-            "/users/{user_id}": {
-                "get": {
-                    "summary": "Read User",
-                    "operationId": "read_user_users__user_id__get",
-                    "parameters": [
-                        {
-                            "required": True,
-                            "schema": {"title": "User Id", "type": "integer"},
-                            "name": "user_id",
-                            "in": "path",
-                        }
-                    ],
-                    "responses": {
-                        "200": {
-                            "description": "Successful Response",
-                            "content": {
-                                "application/json": {
-                                    "schema": {"$ref": "#/components/schemas/User"}
-                                }
-                            },
-                        },
-                        "422": {
-                            "description": "Validation Error",
-                            "content": {
-                                "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/HTTPValidationError"
-                                    }
-                                }
-                            },
-                        },
-                    },
-                }
-            },
-            "/users/{user_id}/items/": {
-                "post": {
-                    "summary": "Create Item For User",
-                    "operationId": "create_item_for_user_users__user_id__items__post",
-                    "parameters": [
-                        {
-                            "required": True,
-                            "schema": {"title": "User Id", "type": "integer"},
-                            "name": "user_id",
-                            "in": "path",
-                        }
-                    ],
-                    "requestBody": {
-                        "content": {
-                            "application/json": {
-                                "schema": {"$ref": "#/components/schemas/ItemCreate"}
-                            }
-                        },
-                        "required": True,
-                    },
-                    "responses": {
-                        "200": {
-                            "description": "Successful Response",
-                            "content": {
-                                "application/json": {
-                                    "schema": {"$ref": "#/components/schemas/Item"}
-                                }
-                            },
-                        },
-                        "422": {
-                            "description": "Validation Error",
-                            "content": {
-                                "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/HTTPValidationError"
-                                    }
-                                }
-                            },
-                        },
-                    },
-                }
-            },
-            "/items/": {
-                "get": {
-                    "summary": "Read Items",
-                    "operationId": "read_items_items__get",
-                    "parameters": [
-                        {
-                            "required": False,
-                            "schema": {
-                                "title": "Skip",
-                                "type": "integer",
-                                "default": 0,
-                            },
-                            "name": "skip",
-                            "in": "query",
-                        },
-                        {
-                            "required": False,
-                            "schema": {
-                                "title": "Limit",
-                                "type": "integer",
-                                "default": 100,
-                            },
-                            "name": "limit",
-                            "in": "query",
-                        },
-                    ],
-                    "responses": {
-                        "200": {
-                            "description": "Successful Response",
-                            "content": {
-                                "application/json": {
-                                    "schema": {
-                                        "title": "Response Read Items Items  Get",
-                                        "type": "array",
-                                        "items": {"$ref": "#/components/schemas/Item"},
-                                    }
-                                }
-                            },
-                        },
-                        "422": {
-                            "description": "Validation Error",
-                            "content": {
-                                "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/HTTPValidationError"
-                                    }
-                                }
-                            },
-                        },
-                    },
-                }
-            },
-            "/slowusers/": {
-                "get": {
-                    "summary": "Read Slow Users",
-                    "operationId": "read_slow_users_slowusers__get",
-                    "parameters": [
-                        {
-                            "required": False,
-                            "schema": {
-                                "title": "Skip",
-                                "type": "integer",
-                                "default": 0,
-                            },
-                            "name": "skip",
-                            "in": "query",
-                        },
-                        {
-                            "required": False,
-                            "schema": {
-                                "title": "Limit",
-                                "type": "integer",
-                                "default": 100,
-                            },
-                            "name": "limit",
-                            "in": "query",
-                        },
-                    ],
-                    "responses": {
-                        "200": {
-                            "description": "Successful Response",
-                            "content": {
-                                "application/json": {
-                                    "schema": {
-                                        "title": "Response Read Slow Users Slowusers  Get",
-                                        "type": "array",
-                                        "items": {"$ref": "#/components/schemas/User"},
-                                    }
-                                }
-                            },
-                        },
-                        "422": {
-                            "description": "Validation Error",
-                            "content": {
-                                "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/HTTPValidationError"
-                                    }
-                                }
-                            },
-                        },
-                    },
-                }
-            },
-        },
-        "components": {
-            "schemas": {
-                "HTTPValidationError": {
-                    "title": "HTTPValidationError",
-                    "type": "object",
-                    "properties": {
-                        "detail": {
-                            "title": "Detail",
-                            "type": "array",
-                            "items": {"$ref": "#/components/schemas/ValidationError"},
-                        }
-                    },
-                },
-                "Item": {
-                    "title": "Item",
-                    "required": ["title", "id", "owner_id"],
-                    "type": "object",
-                    "properties": {
-                        "title": {"title": "Title", "type": "string"},
-                        "description": {"title": "Description", "type": "string"},
-                        "id": {"title": "Id", "type": "integer"},
-                        "owner_id": {"title": "Owner Id", "type": "integer"},
-                    },
-                },
-                "ItemCreate": {
-                    "title": "ItemCreate",
-                    "required": ["title"],
-                    "type": "object",
-                    "properties": {
-                        "title": {"title": "Title", "type": "string"},
-                        "description": {"title": "Description", "type": "string"},
-                    },
-                },
-                "User": {
-                    "title": "User",
-                    "required": ["email", "id", "is_active"],
-                    "type": "object",
-                    "properties": {
-                        "email": {"title": "Email", "type": "string"},
-                        "id": {"title": "Id", "type": "integer"},
-                        "is_active": {"title": "Is Active", "type": "boolean"},
-                        "items": {
-                            "title": "Items",
-                            "type": "array",
-                            "items": {"$ref": "#/components/schemas/Item"},
-                            "default": [],
-                        },
-                    },
-                },
-                "UserCreate": {
-                    "title": "UserCreate",
-                    "required": ["email", "password"],
-                    "type": "object",
-                    "properties": {
-                        "email": {"title": "Email", "type": "string"},
-                        "password": {"title": "Password", "type": "string"},
-                    },
-                },
-                "ValidationError": {
-                    "title": "ValidationError",
-                    "required": ["loc", "msg", "type"],
-                    "type": "object",
-                    "properties": {
-                        "loc": {
-                            "title": "Location",
-                            "type": "array",
-                            "items": {
-                                "anyOf": [{"type": "string"}, {"type": "integer"}]
-                            },
-                        },
-                        "msg": {"title": "Message", "type": "string"},
-                        "type": {"title": "Error Type", "type": "string"},
-                    },
-                },
-            }
-        },
-    }

From 10a127ea4adfe59b7d275fa0bc764b23910aea5c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 19 Aug 2023 19:54:40 +0000
Subject: [PATCH 123/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 48a809021..61ec91b4a 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 📝 Add new docs section, How To - Recipes, move docs that don't have to be read by everyone to How To. PR [#10114](https://github.com/tiangolo/fastapi/pull/10114) by [@tiangolo](https://github.com/tiangolo).
 * ♻️ Refactor tests for new Pydantic 2.2.1. PR [#10115](https://github.com/tiangolo/fastapi/pull/10115) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Update Advanced docs, add links to sponsor courses. PR [#10113](https://github.com/tiangolo/fastapi/pull/10113) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Update docs for generating clients. PR [#10112](https://github.com/tiangolo/fastapi/pull/10112) by [@tiangolo](https://github.com/tiangolo).

From ea43f227e5c7128c09e3e2d5dceea212552b19dc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 25 Aug 2023 21:10:22 +0200
Subject: [PATCH 124/317] =?UTF-8?q?=E2=9C=A8=20Add=20support=20for=20disab?=
 =?UTF-8?q?ling=20the=20separation=20of=20input=20and=20output=20JSON=20Sc?=
 =?UTF-8?q?hemas=20in=20OpenAPI=20with=20Pydantic=20v2=20(#10145)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 📝 Add docs for Separate OpenAPI Schemas for Input and Output

* 🔧 Add new docs page to MkDocs config

* ✨ Add separate_input_output_schemas parameter to FastAPI class

* 📝 Add source examples for separating OpenAPI schemas

* ✅ Add tests for separated OpenAPI schemas

* 📝 Add source examples for Python 3.10, 3.9, and 3.7+

* 📝 Update docs for Separate OpenAPI Schemas with new multi-version examples

* ✅ Add and update tests for different Python versions

* ✅ Add tests for corner cases with separate_input_output_schemas

* 📝 Update tutorial to use Union instead of Optional

* 🐛 Fix type annotations

* 🐛 Fix correct import in test

* 💄 Add CSS to simulate browser windows for screenshots

* ➕ Add playwright as a dev dependency to automate generating screenshots

* 🔨 Add Playwright scripts to generate screenshots for new docs

* 📝 Update docs, tweak text to match screenshots

* 🍱 Add screenshots for new docs
---
 docs/en/docs/css/custom.css                   |  36 ++
 .../docs/how-to/separate-openapi-schemas.md   | 228 ++++++++
 .../separate-openapi-schemas/image01.png      | Bin 0 -> 81548 bytes
 .../separate-openapi-schemas/image02.png      | Bin 0 -> 92417 bytes
 .../separate-openapi-schemas/image03.png      | Bin 0 -> 85171 bytes
 .../separate-openapi-schemas/image04.png      | Bin 0 -> 58285 bytes
 .../separate-openapi-schemas/image05.png      | Bin 0 -> 45618 bytes
 docs/en/mkdocs.yml                            |   1 +
 .../separate_openapi_schemas/tutorial001.py   |  28 +
 .../tutorial001_py310.py                      |  26 +
 .../tutorial001_py39.py                       |  28 +
 .../separate_openapi_schemas/tutorial002.py   |  28 +
 .../tutorial002_py310.py                      |  26 +
 .../tutorial002_py39.py                       |  28 +
 fastapi/_compat.py                            |  15 +-
 fastapi/applications.py                       |   3 +
 fastapi/openapi/utils.py                      |  14 +
 requirements.txt                              |   2 +
 .../separate_openapi_schemas/image01.py       |  29 ++
 .../separate_openapi_schemas/image02.py       |  30 ++
 .../separate_openapi_schemas/image03.py       |  30 ++
 .../separate_openapi_schemas/image04.py       |  29 ++
 .../separate_openapi_schemas/image05.py       |  29 ++
 ...t_openapi_separate_input_output_schemas.py | 490 ++++++++++++++++++
 .../test_separate_openapi_schemas/__init__.py |   0
 .../test_tutorial001.py                       | 147 ++++++
 .../test_tutorial001_py310.py                 | 150 ++++++
 .../test_tutorial001_py39.py                  | 150 ++++++
 .../test_tutorial002.py                       | 133 +++++
 .../test_tutorial002_py310.py                 | 136 +++++
 .../test_tutorial002_py39.py                  | 136 +++++
 31 files changed, 1950 insertions(+), 2 deletions(-)
 create mode 100644 docs/en/docs/how-to/separate-openapi-schemas.md
 create mode 100644 docs/en/docs/img/tutorial/separate-openapi-schemas/image01.png
 create mode 100644 docs/en/docs/img/tutorial/separate-openapi-schemas/image02.png
 create mode 100644 docs/en/docs/img/tutorial/separate-openapi-schemas/image03.png
 create mode 100644 docs/en/docs/img/tutorial/separate-openapi-schemas/image04.png
 create mode 100644 docs/en/docs/img/tutorial/separate-openapi-schemas/image05.png
 create mode 100644 docs_src/separate_openapi_schemas/tutorial001.py
 create mode 100644 docs_src/separate_openapi_schemas/tutorial001_py310.py
 create mode 100644 docs_src/separate_openapi_schemas/tutorial001_py39.py
 create mode 100644 docs_src/separate_openapi_schemas/tutorial002.py
 create mode 100644 docs_src/separate_openapi_schemas/tutorial002_py310.py
 create mode 100644 docs_src/separate_openapi_schemas/tutorial002_py39.py
 create mode 100644 scripts/playwright/separate_openapi_schemas/image01.py
 create mode 100644 scripts/playwright/separate_openapi_schemas/image02.py
 create mode 100644 scripts/playwright/separate_openapi_schemas/image03.py
 create mode 100644 scripts/playwright/separate_openapi_schemas/image04.py
 create mode 100644 scripts/playwright/separate_openapi_schemas/image05.py
 create mode 100644 tests/test_openapi_separate_input_output_schemas.py
 create mode 100644 tests/test_tutorial/test_separate_openapi_schemas/__init__.py
 create mode 100644 tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001.py
 create mode 100644 tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py310.py
 create mode 100644 tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py39.py
 create mode 100644 tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002.py
 create mode 100644 tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002_py310.py
 create mode 100644 tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002_py39.py

diff --git a/docs/en/docs/css/custom.css b/docs/en/docs/css/custom.css
index 066b51725..187040792 100644
--- a/docs/en/docs/css/custom.css
+++ b/docs/en/docs/css/custom.css
@@ -144,3 +144,39 @@ code {
   margin-top: 2em;
   margin-bottom: 2em;
 }
+
+/* Screenshots */
+/*
+Simulate a browser window frame.
+Inspired by Termynal's CSS tricks with modifications
+*/
+
+.screenshot {
+  display: block;
+  background-color: #d3e0de;
+  border-radius: 4px;
+  padding: 45px 5px 5px;
+  position: relative;
+  -webkit-box-sizing: border-box;
+          box-sizing: border-box;
+}
+
+.screenshot img {
+  display: block;
+  border-radius: 2px;
+}
+
+.screenshot:before {
+  content: '';
+  position: absolute;
+  top: 15px;
+  left: 15px;
+  display: inline-block;
+  width: 15px;
+  height: 15px;
+  border-radius: 50%;
+  /* A little hack to display the window buttons in one pseudo element. */
+  background: #d9515d;
+  -webkit-box-shadow: 25px 0 0 #f4c025, 50px 0 0 #3ec930;
+          box-shadow: 25px 0 0 #f4c025, 50px 0 0 #3ec930;
+}
diff --git a/docs/en/docs/how-to/separate-openapi-schemas.md b/docs/en/docs/how-to/separate-openapi-schemas.md
new file mode 100644
index 000000000..39d96ea39
--- /dev/null
+++ b/docs/en/docs/how-to/separate-openapi-schemas.md
@@ -0,0 +1,228 @@
+# Separate OpenAPI Schemas for Input and Output or Not
+
+When using **Pydantic v2**, the generated OpenAPI is a bit more exact and **correct** than before. 😎
+
+In fact, in some cases, it will even have **two JSON Schemas** in OpenAPI for the same Pydantic model, for input and output, depending on if they have **default values**.
+
+Let's see how that works and how to change it if you need to do that.
+
+## Pydantic Models for Input and Output
+
+Let's say you have a Pydantic model with default values, like this one:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py310.py[ln:1-7]!}
+
+    # Code below omitted 👇
+    ```
+
+    <details>
+    <summary>👀 Full file preview</summary>
+
+    ```Python
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
+    ```
+
+    </details>
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py[ln:1-9]!}
+
+    # Code below omitted 👇
+    ```
+
+    <details>
+    <summary>👀 Full file preview</summary>
+
+    ```Python
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
+    ```
+
+    </details>
+
+=== "Python 3.7+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001.py[ln:1-9]!}
+
+    # Code below omitted 👇
+    ```
+
+    <details>
+    <summary>👀 Full file preview</summary>
+
+    ```Python
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001.py!}
+    ```
+
+    </details>
+
+### Model for Input
+
+If you use this model as an input like here:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="14"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py310.py[ln:1-15]!}
+
+    # Code below omitted 👇
+    ```
+
+    <details>
+    <summary>👀 Full file preview</summary>
+
+    ```Python
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
+    ```
+
+    </details>
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="16"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py[ln:1-17]!}
+
+    # Code below omitted 👇
+    ```
+
+    <details>
+    <summary>👀 Full file preview</summary>
+
+    ```Python
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
+    ```
+
+    </details>
+
+=== "Python 3.7+"
+
+    ```Python hl_lines="16"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001.py[ln:1-17]!}
+
+    # Code below omitted 👇
+    ```
+
+    <details>
+    <summary>👀 Full file preview</summary>
+
+    ```Python
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001.py!}
+    ```
+
+    </details>
+
+...then the `description` field will **not be required**. Because it has a default value of `None`.
+
+### Input Model in Docs
+
+You can confirm that in the docs, the `description` field doesn't have a **red asterisk**, it's not marked as required:
+
+<div class="screenshot">
+<img src="/img/tutorial/separate-openapi-schemas/image01.png">
+</div>
+
+### Model for Output
+
+But if you use the same model as an output, like here:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="19"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="21"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
+    ```
+
+=== "Python 3.7+"
+
+    ```Python hl_lines="21"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial001.py!}
+    ```
+
+...then because `description` has a default value, if you **don't return anything** for that field, it will still have that **default value**.
+
+### Model for Output Response Data
+
+If you interact with the docs and check the response, even though the code didn't add anything in one of the `description` fields, the JSON response contains the default value (`null`):
+
+<div class="screenshot">
+<img src="/img/tutorial/separate-openapi-schemas/image02.png">
+</div>
+
+This means that it will **always have a value**, it's just that sometimes the value could be `None` (or `null` in JSON).
+
+That means that, clients using your API don't have to check if the value exists or not, they can **asume the field will always be there**, but just that in some cases it will have the default value of `None`.
+
+The way to describe this in OpenAPI, is to mark that field as **required**, because it will always be there.
+
+Because of that, the JSON Schema for a model can be different depending on if it's used for **input or output**:
+
+* for **input** the `description` will **not be required**
+* for **output** it will be **required** (and possibly `None`, or in JSON terms, `null`)
+
+### Model for Output in Docs
+
+You can check the output model in the docs too, **both** `name` and `description` are marked as **required** with a **red asterisk**:
+
+<div class="screenshot">
+<img src="/img/tutorial/separate-openapi-schemas/image03.png">
+</div>
+
+### Model for Input and Output in Docs
+
+And if you check all the available Schemas (JSON Schemas) in OpenAPI, you will see that there are two, one `Item-Input` and one `Item-Output`.
+
+For `Item-Input`, `description` is **not required**, it doesn't have a red asterisk.
+
+But for `Item-Output`, `description` is **required**, it has a red asterisk.
+
+<div class="screenshot">
+<img src="/img/tutorial/separate-openapi-schemas/image04.png">
+</div>
+
+With this feature from **Pydantic v2**, your API documentation is more **precise**, and if you have autogenerated clients and SDKs, they will be more precise too, with a better **developer experience** and consistency. 🎉
+
+## Do not Separate Schemas
+
+Now, there are some cases where you might want to have the **same schema for input and output**.
+
+Probably the main use case for this is if you already have some autogenerated client code/SDKs and you don't want to update all the autogenerated client code/SDKs yet, you probably will want to do it at some point, but maybe not right now.
+
+In that case, you can disable this feature in **FastAPI**, with the parameter `separate_input_output_schemas=False`.
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial002_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="12"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial002_py39.py!}
+    ```
+
+=== "Python 3.7+"
+
+    ```Python hl_lines="12"
+    {!> ../../../docs_src/separate_openapi_schemas/tutorial002.py!}
+    ```
+
+### Same Schema for Input and Output Models in Docs
+
+And now there will be one single schema for input and output for the model, only `Item`, and it will have `description` as **not required**:
+
+<div class="screenshot">
+<img src="/img/tutorial/separate-openapi-schemas/image05.png">
+</div>
+
+This is the same behavior as in Pydantic v1. 🤓
diff --git a/docs/en/docs/img/tutorial/separate-openapi-schemas/image01.png b/docs/en/docs/img/tutorial/separate-openapi-schemas/image01.png
new file mode 100644
index 0000000000000000000000000000000000000000..aa085f88df45e53aaddb11e35b346075eeff2670
GIT binary patch
literal 81548
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
a?U-0cwD8d?>0<CJMDwoRor>GG&;AEaSdg3m

literal 0
HcmV?d00001

diff --git a/docs/en/docs/img/tutorial/separate-openapi-schemas/image02.png b/docs/en/docs/img/tutorial/separate-openapi-schemas/image02.png
new file mode 100644
index 0000000000000000000000000000000000000000..672ef1d2b71df96e9046fd3080ba5d2837721e41
GIT binary patch
literal 92417
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%0A=&HIJw6ofo2IQv*&ppKc@i)9TDSQ1L41B(-m
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
ZmdSXHb5bb@l<>c~vlh+_pKh`HKLGA#a;E?Q

literal 0
HcmV?d00001

diff --git a/docs/en/docs/img/tutorial/separate-openapi-schemas/image03.png b/docs/en/docs/img/tutorial/separate-openapi-schemas/image03.png
new file mode 100644
index 0000000000000000000000000000000000000000..81340fbece9420cb01981aeb401fc3a6f532e047
GIT binary patch
literal 85171
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

literal 0
HcmV?d00001

diff --git a/docs/en/docs/img/tutorial/separate-openapi-schemas/image04.png b/docs/en/docs/img/tutorial/separate-openapi-schemas/image04.png
new file mode 100644
index 0000000000000000000000000000000000000000..fc2302aa77ce27ef23caeb7ef0144725c919738a
GIT binary patch
literal 58285
zcmeEuXH-+`*Jso#T*ZC`1OzOA(v_xCMHC1~k={a7dVtVDN&<?CiVzJ=dhaE)5C|n8
z3esx`9jT#(9!elEC*J=%Gi%M)nKfVDwN45-b@#o0dp~^C)mA%un)5UW1Ud^=f2;=r
zou~(1Qhzf6zjzWgBY}@&9(rnzKt-Kb7eJtEAn;>lgI5X5V?M7845ymbeKh>|!}u=v
zt#Y3{rfjO4@e$!esV&G~F&kLPbA(jy>zCYH)=>L$?$JC%_PWCL>$Tc@^t;y2zk!cE
zy7X<8?E9*cJnGS<AX&e;HkaUE)BwkgoCNL(syFQ%96Z7J21>bpA?O(6i{)$38OG<@
z>A#*cK7)*}f&Ls)bNtv9#t*+)|E_0zf-nz33<5x}P9DF*_^cQH?@Rn&<;6EHe^C9$
z;bPwq@0D>(f4K-N8*7Vg*}cKqFxB8kZ-R+86jc-DDhwwqAv#rEg&fHaI-O5#E*I%P
z^UZVec2xMhwI#{<^z^o4>fo2d#S6Y4{eD=E45}OlWCgP>9-*9#;R(_&ezAE@)S}dE
z@8r8Mh0EE+-50_*@9t*2SsVD=Ren(4Cv;ox6{qUJ+9SI8LXC{hrMG~VbX#8xa#Q^#
z?eftGGd4Qdm^1MESgjPi{evtHTD-q%mQ3q(xcY2*fixus8C<6}@i6q{_j|jbo*8NC
znlLz@1Rp5y)m-e~b~;Bumn%}aMF;6S|Jz|1&Vx1S+LJibSKnG&TMf*NEVGd+D#13m
zAwv@b3&)XqP~aYoCL~TsY4QdxW)xuYG^{NZXB#kg_n-n*V?wzp{;Vv>yH#AXw{Em*
zIEo(8tau|BFC=E2!sp=9=@eze<L>wmyR5FlON@SHpgF5yhNJ&njD~DYPSd)kUa?Dp
zkkik+;{F5E{J(Y|w~#JpyxFiGqR80MY5hKzxq4Bv-2g@QdM3xi1SmwDV(xnEgkmio
zHdXmdf`dDhLqnr&Yg}z&(bW=(B}t(^_CjzLqWK+J*+=^Hr%s**Z{bxd5_|jmV03{|
zKJuF))Eu{3v>gX9U%|DDN=!N;7*Zffd(xZ%Tckr_qI@OFd?aCtn`S-s(A2po^>9vk
zg!SU!GxSZ}uES}8m`!%C*u10?QWZ5O0cQYpsi~i?lvUO0--SbeIc>%8&BkzdZ_srd
z&F9#ONVedHjQ#hsElyh`@>0m{+UH?yd%8zPczQxD(egY%mQ=ZF{4vGIi2RI<NWX=A
zkL>N!=g#HD)OGT)vPPLzk8dv9hwhqS;l#8~#4MTJek6P`cx*iY5pa1#-mJqaeb%ao
zj_GOY7%|k-ThwE}@*AUATW##$@xDV2c7~w*`dFO&;Uf+{*2`=y6B9bGj~(J?@oihZ
zT)cQJuY5`j-W!gQDV%cT#_)}KQZ55r%1uktn`LD^ed=8AY(z6`XPhr8#`sl@03k(}
zOJ;TLK1+@Cv?T5<CTr`Ug#%d@T5-GZIrgOrbB?bo?-M33VkD2!!bk_Z+z9jTW7$Rw
zpVz0jj3HUhpm^pTxAzmvQ-vBW&{U%rjjSB~hNmVQrEgCj;};+-N-#n7iv_%s1=1S|
zdRwo?o>4r#>5}dSQR;o&xM^tdb)i@BdO#(Uz-YG7<jsWFLlJLEgNNhRIm+r8x*@?S
z3KF-(YhVb{SWBAU?7L>q&J-lImlSL5HRY$U@gtO{i@GwTwOX_8l(;`!Lp`ssvCDEx
zI()Zs4!_*%7AJ-L9DqQ`SNP6Vks_lKr}ao8@=qm^2bIG}pOtawG$Q0I$F<;$jZdd*
zH|Cl@eg2zN>vLe((C`}gYOD=U(%e6W@XzsmYR#>r|M~cdtCK5XM~I@dsY?onzquvi
zwKydzF>Im`$aJN`$=?bOBq6QHxjWdfD>uQi-*AunWGv_9eS9&oFs{3*&Nozr+X-PC
zZRga{OgLILUyCj7m;IeK($&1mZe<N|^+-N!XwAI(d2d7sGDoP8U*gJVyl=Pn$-SoA
z62A}@!1-;!;jsK}bK#e>F7PZuVhn#v3fl{n(dd^r)Ya^BUt{{$C{;+?KanKvbkZ^S
z^Qw@|t%FdPYNFDsBg&_bA7xYPkaTBLELp~RsOWRM(@z<c;^f_=obs)wwR@dvaoZGe
zzqQwLi<FRyxelh%Nhs%)-8y#<?zTh^_f2cuh|QfVk=+uVq9DS~`aOyGr<_tLF=FyZ
zqn!J2qJ%cuy2LE8>lB&&vXI0Li}e!ez-(feT)JzbW|hj!EAl$v4J|sIwU2&qgqust
zLCt%WzVdlFBE$F=>L*XaF8YNZv`@<7s5fbDZPs8tzscd73RgTyUoKO+60^BYCl(uj
zB$W;cD}*}+uE-<Gvrs~XPfo8p=1x-bkghLD;|W7>O3d<p3{uC>vM%ewm>ax9DdYa3
zBqQ>MeFTlxYkbng3c1yqBVIgPKXvl=_wP4E%}Ps~WJ040`iaI*<pE9<6f9q*PfyxW
ziP<i>hL6T#pvKw7IXO+6fXSgVN;lHGewjJT#A*q=3wc+G#hDb8niS*}Y+d~e#mdIH
zJm2-wYrxRJ06)6(xEW%Qw5S)(!u?x*{3|uAtqKx?L|eyL>pJ}cIfIWLcN`xU9wc3C
zCuP=TwpQNo3a@+W9LJsbK=F$lbm*r!D|f#NKm_CG#B}ipYtrk{lQiFbLpYa(p_!&<
z&Z~I7h1Zi$08iN^&)aT3wS7>+H$*XtGT*SlnU8f6w_|}A6V&v>@k^(!rZL~Zu<by?
zyR&yL`E=FpMi&eWH}>S_4--0mBj+yfczak<#=UA=#5LV{LiTX(56FMx!{d$3xFx&E
z6^Ai^reX}t8eq;HyB26`8Ct$o|6gP*FJ>WsC~!0*@_;q3*yx>G@bKf$1FW^S#QRzO
zZzc>KM8EQ3Pb*DuR5G5UOgSR{*vfEKuvvwC$&sg;8j(`fS=KTNWhV{KJ=81RUeVOs
z_b$|-DUMZp>2<9@EEYd~(u_<<$kH;e@UO8Q*@l>{@0*=fa#;gU7^8u>?Kt{Z{_d|V
zvtw%B4$(8CXJy3+w57!xN581H5iO=<GFccbBqT<Cr4{w%_j44r0V!%B(*XFWN%<9S
zpHMamqT6(Z)hB)P{zCCIGe=^Y0N8!`Dq_{Q2&2gP&6VKI8&~vpZBpZJ-Xg#w(O`{x
z=#2T_N%$J_nUnii-OcAavkN^93aq>m>b^GnQqI%%?{=~M6!LOZ!}ES$=j7heL>zI~
z*YVP_&!R9RCk&$X&KzGmOR`M8PCl1YI|(ixazZy;OP}n|raF07Z=53wU#o{6J4Rf6
z>o03<%ia4v%zUZedvYo&`*KioxFR&-Ryg(5%5(QT9=|Om4Q;T89M0vaLH}I6=#&-g
zO#MP^NPm&mn;SR2^MTz;dL*vym1${%je#&ZWtDDdp_iwyf6iz`C#s^*Tu6#fJ$9%{
z_8VFZED`$@#>SI(aPWv+I=}TfE?EnHk$1X8Q6__+3F^FUaVx*@kw7}e@8?*`j~QdY
zVdsL9)v1ndA$-lY#x1^@{WqLG1azdLXEy2}&1C7@ik`)1m?C7KXz3kA@2Hmw=i5h=
zev%Qawhz@~G0OGWx{T^N=JVky=7n>z(L1cJOW_Co7rvjIwl!kUAWyG-Gzikk7=H3O
z3L-=KMQfTp#C|-x03}xd{HtFWm^to>FiWgdHm{(kW(4OBm+b^e=KOrDCL~r-<+nYb
z#-f&(eU38HpG)vsy0=8;Ai$1ZTXU;xcn>f$G2IrEQLXj!Chmr+<?A<Bz)3|K7MO#B
z@36+cG=5>M9mXnq;x*l0_{NQzVK)&oi_J1ZbDX40DjYwV=XZ+U>=@Pk=*Vv#KIYa%
z813ZemZut9c&!W?jU441DwGN%p_tU*{Z>-5+WAqB;N!=yN;drbnc1q4fDsns&gX&1
z<<-<Y>Z;waEZnJfno7QW=~4zAEJ)i8O*Swx5(^Ae8uMzC7Q*CwX|YB_dRISkIdbD}
zao-Sk8+tYb$H5v_2o6ulM-j;nEPT#_jZ9}>?8P?P+_`UC8bb+u#AY7b=}iB?r*;kL
z<?u!FZAEB}dJHu|42ZdwZuji1Xv~Wf8*nfaMCo~9t4IicHRMq7B09s68S2hO+HS{4
z6;S#%q~FbtZ=TETHCqli_e!4@0;qnf8-zRFmGVGp`kM_Ao4*9_0R-_-<-YI<*Jo}Y
zE&Vr7bi@;WOz#0c)5eBu-xp1xO)c>fbFJiR4-V2leRi5FLHMagj|Y%%issK%jiAwb
zl(CqM+I{p^pSTCH+U{QM+H&LRQxEW$w*yxLi+~;Smg3;#fWySi$_kQfN5W>jIV8Zs
zBkbzk$53q#gpHPwcX);KNN$n>z7nF(i}zZXFG21koyZ>b0TOtuYs(_c?se!VO{u_1
zjW8bR9}nalOU$Ty_xd2i+(+`R&M0Q%#G|Qr4*aBe#O%`2O(>Lih`%EV_t=J5bHW7u
z{gH}%-ElA)$no=MnUlO@PmV_(roN$1NoP>4fOy=Q0>h1z3(QIvD(;r@<$CR^17S)z
zt?kTmUBUw(G}%b)=C~YCh9hMRB`cu$cN33p0qM^{huV=g;G+vBB9eT#jFCgfL`RM?
z-eVCOw&_P-efEd3ic|=tEjC@dCx(X(pYh!$^%c101PWWe{tIv%0<#4y^$rWM`2AH>
zRjo&bK(+U3-`I{q5zf+I_1V{pVq^`?HqWEru2&Xw=81s6Txw8DCOL{L2?i<=hQ;q6
z^WWjGYF9L_dOqXJ=?)LXfkeP8Y+_2z#|G`UYEWhf=Qq-@AJ6GhR?1j%482a9a0_lQ
zA|q;OW|kFM{*+wh5}1(hB2A*i89K^15aYDqRB^)ISIxcW8u%pSB!s{GLsW7yW}8?2
zE753kW8&FOnB_LYGX9qIJ}TZ~(dg<f&PYH31C&pn&Mg)tpc6I3O{PmN_K2BD$->bY
z#?gP_BYmv3`oaqwKAl<2n`=NAn8oIQ{*DzYEI6F_u?p^TBsQ=Ug#s#{ss=VQnW=e)
zjz`hcEzOn>k>t~kUz=%GO2U9*c1I?7RX+?|>oLA{8JW+Qow2Yf9_X2Wv>MNwpu1aG
zYO};k+uB^!*~JeZRM=NF(<U34^8HELr?=KVB|RXB>1F=ZTebR{0i;DJDs`QcujMX_
z{Huo;&JmLWBg%OE%q8TKzB}yw_OhIb<1V*+iZQl~V8~Dvr09x!K5nECNaFhEwop-V
zgwkQ3?W7MtwK1HuhutQ3=HETwk$a!f7+NlF7e11Y);1up`P|)SVTd=or2|Ab+zz3+
z4|jRN<Xj)RK#oXliL=0SbR0RyHdnBtxHDw{w|$FTTya!lZeDRXIbho+L&5_IOh+v4
zS0Q8vp6EG^HO}+hygfV1zPLkN+L|S;NMb@`4vR+Mhh=;Y2bDdozuJ2z8~1o(Y*Dg-
zIWJ#ctv1Dd-l<`!=&<ekY`RjGdbj86VsCEk8K&T-&pfHgNVi0)h@c=b4jV5ulRz8$
z^2-*t1eoc{x<&ke=n_S7y6N*5zCz3Ds&QI@OEB}6dw7`)yLSMDQH&<`J;+e)!~BGF
zcKr>=Mv7lc43wQ|CnQ=6m-KCRxs3JSQAAOa5R1vOfxA^=UaNIGv30a2Y5UdTS{<9&
z*-o3b>b!;3L&8{EXX3D28^X^^KZrocLLOi>t7jsm0Dp5^KvpkCtIh-+iAJy71wnUW
z+F)aazMBI|p7+Hk3XxkU8xyN}&vVKC5(R07$4*C_s?S~EfOm<-L`DmVit0}s-Pe@!
zURi$yX=9`A9}c=%soqu;%WATF!=++k|3NkEip5g<>bltSF8-wotxDma009=NOXlXV
zd`r7HKvP_S0DF+mle`fAVt{j;GM-<|5l)--D8ywpHn|gP4c1+n$$_!!`73qPelfF6
zR$^CI+{n|VrKPfAwPI`rlGTXu?$@2ub+y&PckVpo=Pz2#OS~8Ok*9LU2&I|fC_x!n
z0P^vzVJ@ERKtj^304-<Q_F`TgP$4(YaSvDd6ZHB@4NMI9;tQi8g^OQ%>~+;$i_LyC
z=Xf+%+`1ZoBHr9KqkgD0GM7~BOG=1sy={@5wqY=|Ox--#TCkP+c6pifsN_1Gczxs2
zn?Ll_lnH^LiZ%%XT34s_>?AmCBx3ov0gg6iIr|+oiaS!o^Wq?>*<Ep%g|a!v=SSn5
z-Iy4^t@(mZ?vaHSwN*Ll`DbCDK55WtBYHTR?c|Ha@xrpQ<>~447b?uY2{x8hutKq`
z(#z#xC9NlR#`Az8ExYh2?^-}b&gt&}LqXaY;0fZN3fK*bii-BN8ZMQ4kSr;KRcdlR
z6t8&JLamXCLYO?kc1)nq)W`GQWW$O5`8Qw53pJ_1mpS$5MYXqXx=~b7(?@;p8pp=h
z<z5ax;5o5|VTn%K2FcGP9LC*$@sx6wk&UIimaYOFbnU}Qzm*Y7{W3Xmvo*=c^;*T<
z`FwpI%{Df-IC-~%W;>XIX{~L#5oRc-z8*xUuf%)yeEZsI=b>ZhwJH_<@ndgNZPDuJ
zSr(S{LGRf-FWH0`3_v$kBFhTvLNddRZP_LIYajXTw=>AoO^&kwg@=F2+1?w)zj9fO
zp&jJ&E;`Hmj3E<&%73e4M{+Sh3k=Rp3S4lej0EcXOt{enQK`kn>Oh6E^=hTiM@ccY
zE?UGq6Fj}7s4|k}^+wj)9*~txJnNMUDT9OdKs{&V<n&qA2evBn&soMzwZIW9_1Q0J
z1$)x(Ck_$*d73fj7Kds>g@i@@4i;j@hOZ`19?%awyAtosPnD!g*^S@$6V$calb-Iw
z@$Zx59wPR)?x%LS)z}DM(pjKc0WN3$?eVopFuTLXj}oePAmcXnB6fx#%M$m(W*YM<
z0b+F|rB_#{*oi;M5|gYuK^eggjQLn#<Xi~afGmkwS|eEGG+Utswy0@|P0ZA{^;ji-
zw(FJ^kmqY?wdscL4*D(q!?<qeUv^rciXqByu|vK&J&Xj&Jr#4%QiudHI~0A8Vn`UF
z{v;{2zH~$IYhidG{RF7E7iCo07;;w`09uA?Y(kI+HsR4?P|5(*YxPo5enEkX8SX`!
zAl0qriKfw_xG~fWgJ7U}5A}Tp{`%eiSp-$h7ZUOgPmGF+ah#lDmEN|yb7gDKSP4%Z
z0x}!K*0^wIDF%aL+FH#VudQC_6^6T+^EgX!E=e7>YJ@h^o@fT{m`pHa;{!9cO0KH%
z6{|Kdj+M5%{s;RFB0X?C?y8<cPDGL0%`-G_L1skQSy`8e_r{IgHR77LW#T)0M{z#q
z3wIF!ssyRtS;&UY!M^jSCt@tnS0%AYo=d$Y+S3zwM7FFKj9l@xf4Pc9q2g$N?4HBJ
zBTMORQ$4*rCCG*yjs`eN%5W_-QMRJ6Z;-*x-%hRok-t+OGSX&Yx#mn{bEg8HHe4<3
z`3nRv%$`AT-T6V70)D0n@H+5gCTL5<Gy<`;a1TbRh&q1a1j8nA`$h|X79gMw<{7Cy
z957(Kz`aM~ewGT=K0S4GW~>hsZ9W3n40U0wcDT#csXCQ>ZflnVX<n1?2O6)>?{`M5
zaJ-!PaGhr<Lcdpv;q4yyD~C-Qqa`HD5}RYRYt$9|J=X_UTrKMcoCnhY?aMz)pzm+@
z|GG%V_dij4GVm%8EF>oOH3JsofU0tR+fMvzVLI%J%%By0`2h>Wwwht-zny%HPX0EB
z<5f?IPA~OuPX>-Ilpu$3gq(sJMl~D1)o-<vZ~AKR6p9}RC^`yALYu@wp5oF5=Z*L=
zOUed$6U9Q5eqiUSgrbIQZeV@e!ew{<fcbWKRhD{U$MZOZHqx+ykeobzuqw%kXefq_
z+?OfwGmNnaNR{>SoOlcaT!UEGrVM~#?m!9I{;T+BuU{X-hF=H#{?52pdL3<<0t?<$
z@EK2$bE&RqIs_7B`A!j_YRS>Tz_H=!8js6dsVfUrh^gVQ&gto3d|6$%WCwPAbJHV#
z^T9hMM}}<gKVzz{UHqwJ7lYV858FwiYk;+kZ8D#9#H-~xlEW8!tLWezQy{4WD#6>r
z!fLUmL#^$ef6adTrY?>8X!O)G15l@1f#+Xz{Zl<wRC93L#*UnmQT|lXw(NjTzsyUr
zICkvtmV!3pUP0AmGXHioTnow;Ii53q1LdjwKj>vhnSqc9<)Wkm{^}Aq)XtcYoTp<v
z=U;H-?xlS5Gb6VExk|K$c}*MoYkD>RvJLavm)$21s{eeC57gQT3)gM4RSdgxgK=Da
zi+v<0A=>WQiz+RZ5oUXTv#O-{sPr1W{5Jt%c=8)t&VjqSEZ&zL2j*_<#hx9GHY(B$
zjNswr%@ixCLuYg$yGY_(EH+q;6C<>x)X*D-4pBw>ceL24X9n7}-jxn#oI<?un)aPU
zXFz4x7UQMg35k^D8NNmF)ZN!R)e*4O^u~fUYNY%~H&cQ|1oqEDzTGV~VUhYAhmR*Y
zdjxgYCmY0)C-=SH;Zq#HOf`1+QArk}6ObGE5YA!6hvzLX3pRe;M^s2aZP==(zPJ0i
z2Si@F5wO+JD{sSQ5}D-E(=e*>gejKVJKOW=ltX#4+8>%tG0&nO9^q?EDCr0rtmgTn
zZ=$>r%IBe%b9qD$w!SA^Wt^;UP3-)9I?8<6&($g8AmEIjjb%8W!*=uyElrW`95H3Q
zqk&}MI5aDUJl6`x<>!oMEpV}TEq$<saZ%D&NvwJ0y+x-(A^I`14kpbYg}aJoCv9YE
zt8eR|J@1gxSp7AK1T5juTlp>8Lzud^8gA3oQWe!IR*FZwpBdHQ7Am(V*6E3kn-(xP
zt1iYVr<&obAAj7}z={@HtcteiXPYP~Ai<FZG7Al>W!5o~hW0(JwVAM?b~V!3Q^wjQ
zPk6;VptgU)U5-+i#B8Of@kfEJa|3Bg8rCJl)H&%6)<u{8;_%m;JGP~4htF=LH}q`3
z6TG`2$<;6PUCk%pYwDDHd>zy{r?aFEzx3<UVt*qWy|hFZogUD2@**dZUzc2QzT0p$
zbFn`4^v}27yr#QdwN}{E3Lb?5l8|-H`Tihl{zAmc{RuaO_E$qm8P<iBXISwb?asnT
zqCk|<u&3$K1+TD8L(dPUydrJ-IfQ3NRZ?c?%WTj4PfXY@JlD?T6O`}HP!kJ}<a5>(
zHr|+Q_1l9p{1+%m`V~k_q)hPUMA|b*@Rrug*T)0SoTe(tUgQRdN_~|7@{!i*HR)en
z%j(}xT?{8X-^-3%axF3B*kgknsFrTZ22ai_T#AcLM1b{7Ga(I!s?K0hQva-P=?H&W
zOUkv0baw82d6)Rxyxd|Xt+0Ihrp2(hfu>K?Vw7(cLkFo&li9bL)C3i}(zfr`sqKIE
zylTfTYa5aNMyu1K0jbJwzKost)9!Tb<&+1BAEcXfsC1mB-pkW3z#zx%V~7H=pV1IK
z<ybAc*}m|sYo-v&)VD@5-2#329~e4$D8*8gzV+Lr`3wyH(J*#TjVt~$6SoVXeTBou
zd3FM-`7XkNT9D}MpK_szWKE&)tTBqiEC763<!QOYGY_T3^pLi}fLPN2$FPu3JPG5P
zO|KnNv-{>__aNNAVymyl`H9ye7lWC)ft>R1MGw*+H_DyVKzBOxUIWwYeUn6Fs^{RM
zXuh-XC2?@62_>#JQ=Okx27#A=3Z(bTepeftqL)9&v{=|<11xxJYfFXZ>T4Ocqwvi<
z7sMM(<J(=({rUuO9c{?=jHROX)7<wBa?9mI=Ul{%mefhyNun~<<1|XKW=>Q_Y<%d}
z+IdrShUWge+dn2U+(RMk-Yj~sq$h3OG3scf1vF>yPML@5pXco^=JaG5ghgyy8_uWR
zl*H8u1UK!R9?;=BP2FsIG(_oTJ@Lp!=E0-1hHG?}^%u3ZYsKvX!7E(c*8$NIAl*-Q
z0-|yWh(y7blDE6FZB}`;n4W8paV3LL?@0S8IYD&BYv<#Ul>`GoD?P$zJH;jWz{*Hf
z`qI>GGL;D&#pcjCa0824f3`oLt{E@Rbs-IkV_y>2@3X#hKN<p+zGHB)K>+({ttZfy
zJbzLp{4>)+iJRK~mXs=k+w}`pK!-H!aLvK;qhU*kD2#nJ{hCs9#@0Q@(_4-BM+k%?
z3q{Ew)w`!o?0S#bLVc=+p~>>%<)wW5j9PVuLM$sF%9{WsHJ9=a+Eo>{Jt`g@g!$P!
zWt5&4g_jYMEY<^a;|6b;1S;NoI?GnQZEKig`UULvqDV<!y{#-KrCn9%_UwPn0%V=*
zQS5xqXwHG`UujMKESr2S@Qyi7K1q@z^IWr&fZ@+;xy}X@W$Lb@tc=nyX?^F+nsmS5
zLEU=%bZvtu%Bg+UPA12^Cb_v{ebV-4a`){&_L;2`@ppaFmi=V*2GcOd-go%x4M`H+
zZT`c<h@`j+naa*5w5M|zHw961!6L62U0l#_&uJTZ#+U!@{{zhU?^y`Y|2Y@(9KL)k
z;Ztx+F3q{;w4E;iX7ran85P{A1~Tht%u@qD)ryTx7OCPu7l`aan*PepW9QKth~og<
zJ^F}7)|_1>lYUP#G%TpBfrC3J;#}5ZqfXX?wnRCs(k!UPX%EI|pNe@Qk#%90f^be_
zsXBz+PSYfbg&TGt#cv6DK)#(w7UPlA==k2q8St5LDc7v~=_l3}*2Y7i(%Tmntyk-U
zX%qX&a&0H}cLe^VgAdRCUEf?hM3Maxxh&HBSZ%Rr1Y^8pB+BV#@aF=Hs^M1!!Di+5
z&u*eJ))Vd?s|4E8`{%D3SX#cudoH9DcYl$Enwywp(3#Ou5%Jj-&X@Xyu3M_6?;k>K
zGHt|WzutTgl>90Re~O&Q{xdc<yn3#>DQRgp<i!XTW`%hL1)k9e`hm67l?0pkv7%2K
z8|h>OLLvN5cA!1*>+4PItM!-U65RXW0=z+@Z25;fhjz5NeGV}y`OIQ=5Br(?^<e<e
zuH9{wGXrY>k*bz|nij{aUC=<khHvcEh*BgvZl!lFe$~#tY561r0!a#-yAIY<wXI0<
zUl(;AtRxn8y^UU{ElI~L0u^<Fmq#F^;Hc&xyzF3msVfi2=sP#&I!3&95Gc7e9R+WK
z*i|n}Y_j0KZqZ=?T|r1t&?}d)UJ-a3s1C%B$j^WVcVS#U!`Hlu&s(du@3|prS!1H3
zL@y@+G;jwM8s+o6n&&7SDgH?r&HF($i>j;}cJ!f)XIHQKkBZ(l+H;^;WZGFT#NOi3
zef~UXV`D?1LR3)D(9P{5pP+(*K55K75Q`810MosgaU);fcLF+Bg~6pGl%lY3;p#-v
zx{WbgXy)*KOk`wU>36+pDnpbt%_WmN2b*0!hnx@GGmL>JsU7fc_&&?i=;93YvlvAq
zE@cqw!5p&zJd+=QcAzr=7|3zgHyF~{+$>G{by1~1+s6mo`<-7HLOXNjO!wL*Q$C`4
zK#W9R+f4X}#{+V5ci(ZaTN%EyJd_^#{w#NfZO7o>0A>mb^4~3VKinhB*#+k(v23$x
zc{2^#;;L(=)X^(-bUz3HVtvxopf>81jddEE*4=nEQnBhDtrmVIErh31rJ+F?z(NN^
zedKc*eSy9nfc^F+;vo6^hu&pEqHJLYeXL@nF}EdX;w+S1#EZuV02EvZhXn@*0sLUx
z7`=Eii5ZPHG_pjRjSq40@Z=pG?7t8-+o<LVq}kZf5j&#=+T0_=eL90r3BGwO1jD>X
z#kh{Y?hSzwB0Nk0EWgto=xRW`e*Oj4vsW*MS8ktn9;s`amY7%aUU3sVnq6!G#zoM4
z0Gu;0^U;dhlRcsCF2bd4QKsA&9#5yvG%XcHcGyPn0Rtp@fCUQ)2@MQT<RHg!e1=8_
zNzwmKpGoJ69vH1RT^O}K;i_sIt?9d#QU`Yi_&9SHbSt|OZtK-W*Qty|K{*rso^}_t
ze0V{=eN)nWb54AqeTb#pW~39A+{~D93wm!vS~LGS^2jv;!E|3(xH)sQ$XOUC)6?^n
z2cxCc<|+uN2L3?Sa={Iwl-C*U95`Q^@6yN2izp;I%3MM+bXST)M}Zp2M|^N#lzY0N
zdE2c5Rw`Mqtb9ytHgek5i{GJZ`~(jsEc{b{(b#^%EElG_w8@{kJf1nQ9vKz25bl3C
zt4G4=oIk5z7liks<gn%sEVf|+^RT>2U-|nD-Q71~wSQtO%tL4r3-g&TgG8LIUw7+(
zwC0nX`W2e7riqme(^%)>^8QZ~r2B2g7BZF%%C9?1JK!-ym{)X%fPUfh5Z0fd={x#_
zeg13U_^im0#HKNdw6|Za$ea)xOVJw-yjC^f|EKuZhD1P)bF-5yUcXkedwrgdzxwSk
z@grBcLz_2>RN<WXTMxNY+m*07f;B6o?QCKkXOfFt4~Huq%nPR<d`no=;~6BxY~BZq
zKDtod^8u79GXXTJV`%R}jb$5ml4_Z^#!!-uwLXx`Y^)?rC59@w{$UwVj>GFFVT^H&
zPJ9Rt9kofv0UaJge+pnxTMO(H!Vmbh&{Bvwj9EnhmbSf+YWQ&pk~9|fG28&PlIX~-
zW8w5!bFWdS?%9hMCFl4u?K?4{qe;varrer|a$fET=^nsf<2?5|02Oo(U$x$);SYOi
zx91GJRtLa=wKP4f6NgVPoq?Iv59PIVf;4+G)~!azof)A?66kZN1c)dpK^3Tj2r(}P
zV&b}fIwpnl%9RwmWTdX5q9Qgt)10LJ>49xuAplU-(wg>ZljI?udyN{JK2AS~z=V#z
z0AyJvTK^OQ-Cw3=9JBE{!@47GGhQOx{N*1%?rPtAY>-4!Tdmtm0D2XZ-te`0ML$aB
zEy&_$)!@xaVBCr}7wRMJG=B|+IL|Yv21U@K8O_21$zQ*R=fAyt7(}pqwGGv<=UDCK
z1N>}YonPrVk}@Gi<wZ(#_y(+w-Gc$(Cfw?Zq~F`D!`0bo7;3!V-jzOm_v+@}Bb7H^
zJKQAy11E-9Kt4?V#KsaW3ncRO;b4`qQM?wU+Ece|tymTsA0MBc5iHo++W8FN`fxc|
z*IwO~!tVFH#02ZurD$VoD-1NR0TB15KDSH{nlHX13kdl_f};AsblAIh?-Tm3gs)2O
zxF&rH)tp_jGP1UQ8-Q?3?)jtXE*?$)j+cV8pF~(5|HGMwi0l79CQTbgyYE@7@5jBb
z<7aRr<rJsiN<C9;GGj`XYb%`b8%XMS^us@<Q}ZZT{B?9j9@tJGnc*7htFN44ikaZj
z3uby=J+^XSQ#O>)%s3;cEV<$N7hvnL_vE=}eF0t!vS9TF;++UvC@}K}Y)&%qn|~7N
z-^==}?qRCwPX!`?t=+Z^cyHV5D^xyFOoSOedGhYu40to*c=^rd91Ta6FvitE-QNP9
z>XFprRdHha@oT4nVaQf%3274${0k%{KU&_{z`!0_q~%g{zW;3})7cL(2b{Bl){GM$
zstDuM9s4pC<R~<A!X<3zomLWwRK-X0bS&O=C>ydaF_BVgxrhv@faS>jAvx~2QdzjQ
za`4=(y``+~OR*ic9ARfS-=r~BwUux|DZlQ*9tNn4vi^Ch%fPL?XRdGsc+4>QpLaC`
z6_uARb1-(*#3q~OmA7&PacKmfeEu;p=}!ToChe)}q~}qh<b-o{j+<_<@9*qdHj%xP
zY2HY9$jLabQ%Xw!bW}W6#LCR&f7veDJv2PP&im1yf#d!(<(P*gYiBbn)bIA6KFo~c
zv5peQzS(r$Lam--{0Spj|2v!v%Kqp79AAFV=b$wut3dk|(b^^MDi;$Qn`xMT$)?1F
z>xDJ7`DMvsl^wLdAl8G+|2A-~hY{=F%XAzLzJ0yrMcK#<l}5I!1497%RQbHV^p+Z?
z+|<3ejMt(WV$Yaj&*<sZL0EP)qnfR2b}!^Qmo4rOei5UF<?kuROJt;dqH%04yu_MO
z$B(oORaLWEH8fe-*cROngLf2r^9(=w%@V|OG-I^kBtVj|uB2L6Uls$v=7J60avJKL
zr6Fcv@7}&mSi?GAA_<C$j%A98h!~9dd+K|78X(U0I81)$*HE|54d))IPBh0`S3Ocu
z0j9z*egsChtfs3G_29T`87SBmK=C)<CquKB^1iS7Hg=I3Q5S>a3wZAKLW0k3NOBj-
z-D*e?9LvaETGn{#)vq-#au#Mv-}jm@b0%rgVaTHuf5&CBL^IxWMZ`dXY4+#OPZK>l
zuSo;5ci!VLj{}4HE)r>)$})G9<ul<6B^~T(KsL$3I!h)x(PMDZd8GppFy}q^@+m06
zdR?#3veu~3{FXYpKqlUMb@(Qj*2U75V~63P-ZKGv*md=-ZHD-ssqYJn&8?se=jlvX
z#@%yyT>&4;Vm@?psU7D9XdAa_s(HexWSh~1;xNs=5a6_%c-Q6GiLi}+UkE7t%$F58
z(zRgayz*h}_VZXLnd(jlu4`pIDI-jr<*UVz5DmWSF`*WbYKTTlzUPu~es{`Dqc<3h
zYDpQ?Z6?K<zch5K(n3d?@<~%Md(Erd4X(X2>pWdbv_TaB&UcIFDAKdAaG%+kk{#=U
z<Jz9*>@hPpSLEi_0vS(_edHKC=I6_=C={yMJN}*v@iiU1IFuhU>|<}7?Z$&q>w^1j
z<f<jkzIk&T;z6XwNjt)8nSbMjesvks+$8$|^6Fc19RF6-Z^ZQXM+`Z*HeYLb{$<&F
zVP*APZvTaAV6)PDI;hWZ0gjBX&Y7zf+_hO5y;*8=l_7GxM;8<%venU-x$V0hBY;7x
zWQ-^=?sD5#nFa}|$y<d!tHbG(kt5ysib7(#ollI1oX<*c2yZ~z#_49x72%?Uv{aQY
zuO!?EWf*T0zfBnv2Wx0+_k3a{Xrf<QSrO|H=62@!#5|5ZJBNlhPh^Xgz|Wq2l_ifh
z(AuCFJy+M_xeoJ`p|Uxl8)>m3QEbkG#bEYup3JSSGtMJ;$g~(o{!-CVD4^qp78Yqx
zWKwFBu<=6uA>X@@5W(BG)zMqy%r5>12}(y&5VTZP+?PNJK&Pec*B;K!&Bzi^z!|wv
zvZyW?{E_J_PtKCdZm5UpZhNdpx#zk>W@cu-TGvXP`;ayH%<6#X$kuGk#O-^xjOol<
zhF}MW!W}49=o#TaUf<Vu&u?XjojPxIJ~t!daWZn_oe{<?{r8vWVVqud0#I3HreNjs
zhtp6_i7ksl^J>eM7C}x)@A6BR%wWUis|E%p8SDRu4MesHXrg7DM+*RUIQC_U!eYB0
z;YQtq@m{NDE)(2<Amg%zAFah+Me>WEsb5#)IU0?#EYcvT$D-OrR>aEZ<8=CfQKvfP
z4(ko7kL9$B%wp$@NijO#?2vRIW`=A2@7g&~{ANN630n7BAn_D(&-XpwLg~#0vPo|4
z!f+k^yxjvi;r+@@2fvxgTM4t&B^ekUABN5d3IZW^8e`B`8`c2drZ=@Hjn2r)QRkM8
zOplecb!?=C`E62+v5sUoWvoocAGHwJaPY2k+EkL9=Rwxy^lI3nZO5-t8+Vk1<>j9;
z1jyPJXl!X&cl`Kqd1TYf%;iF`MfTv}9Os?lqf-HLMS!ShXJ>gI6!mvPs-r6X!iuU7
z#nBnOfxA!o>JGI@6Klp;cw!3R2@JaE`%e^hlC!Z6eQflJYTkL5o$=gl?%}0uUgSXa
zYE3rDG7$Xa$rHcb)Ml@hFAZ^bUL?$QL32**N5Hss$eoFvomIhD#K<{_7jYJy5o5WF
z0VWo_mYnZ_(U$wG=A|Yg_^DPw26reE$r&SX0ys9-l(rG-aQgiDz7E`IN_n{_;-H7j
zsrd36V1m?T0<_=I7@8%F!9OJ&(&Cc>SNIXzKSLxq<JWXN03qs%=dm={`Rzv4+yU*!
za=*S;`|J0&)6rYM?gYo3+*Nm9wvYOD13?&DscEu~e9u?8-FNp<9KqPGe0f>Ltmakh
z_r^x4ts0N9PSn*07C_?Fo1KizoozG1C!)ffi%$L1{2+$Cxk<)&hi8lroG9nxSz#Vg
zY4kClbo<)1hc0#Wys4>|Uh}%)hljYp+tSinn`H5RXWT>vG5=CjObjMF$@eMYKuU#6
z#;F&eLktRqBDNP|T7UflkowU|Q*=LI=?s7DMH<67v`pD(Xm1}BQ$H`1@q=TuV_#_;
zgEzj{qP0oitLz8Na3L-9hz}gMP4$Vpzi`QJFDt&NukpM>(P)AN(2`x4=u%8oMEDDf
zi$g{KF@vp7*_4_U4i_UM_!d$_c)tue8KHQ_JgJ5xqHL0F$9H0lZ~3`pr4&HG3%?tz
z3nA5(N676{)RpPMYmTip5nD?&CmG^GXWX?C?|+xB##jXa4Wt$}>0HU)R6A#EY6?u<
zY;a{}W#np&3;<Ix#8j0BFt(njxKY1!Rmh!3GVzcZC?KU(*MPsHJ)1(HEi5OBm(gd?
zn7#R<nUS}eip@_4E6(B`aB{!Eg5@MyA^4$q$Cw!(zh=L<j<^SEXeoz{zffJBoM)JR
z{%jVM>IViZZOcq?<K7W<``c>VgUJ~U<TL%ExbgV`_@-^M-$rk*UhVc`d?#(gy}5T$
zp?YT#tto~k5C|CoUdw~ZcRQ^3z}&Ls`lhkd)tLLGm;HZycrjdUmmDo_&XBthAl6#{
zo&Ld_4Vxx=dne-*9E$+Ml7bnGd6(sDPt?^?yKkOXcdyZNSc-P`n^eNs542a|UyYhX
zMMuMiNfQpht19d|P=<Jr+ey<Xg_~el&y8_k<QV=e=be<~cH3s9<}ckBurRMt9gD?l
zHx*RS2|H^Ub~?>vt#x(bN~?L~)DBy<Ay}CZVBbf(<OykNFiP5r=7hDsh&lC-_%l)w
zMEliKfUWmExVhf&C$3K#Z+r(?m^tXDV4hKKgfsm%W}g$Rcj`-QjBjbS{xSxS@RYh3
zW9sDR_R$d}6Bl5;Q6sp)k(!b5V^4APu9a9pjG`!8XtQ7Q&VmUWHyh7f!D=5ard^=y
z{TYts-orstGabnacBs56D=TZ<1FH%E0|LhT@_<AQ3o}ep+@Df;^7tykhgeg!38?L7
zg2~~rLpUPw?=qBWLqkL7hHvBh9C85<5RqD{4rtqQ@PQ}nsIPocQBh0vhbI`GnOB=`
zFjC=6I;uU2HY@)?ij!X2YS-`5L<7C!D73rhHa;!w5%YP0<h9*5sG9MGFr1}fyi6e<
zIK<=p(%PiFU3}he^V#{imuklHmoHzwooe_-@o3{FpqUOWXdBu@^=dwpF#ahNGh55h
z$NTvP?|$b^OD2*;?MIUq{&pz*9)?e=R#p^nFn;l6xH+Vy*<h^m2h-kPZz~UEw>c&y
zd%nNZGyrIJi}`G*KL3%xzGH$!hA02EJd9N{$~Sy>@|_uw<IS}v-2%f#D#G}h&#XD)
z#xm4+{nb&5+h5@LJwN_(Snh{kAO68lkdp&5gP9|!J-1euHpP{CgU^qx%H#YD(>57^
zCXieSGE%a3K}6HyV^t}A2Z!8t+XzNX-P>dbtPFDU<hwXpL$lvrCdpcg)6l>q=dIDH
zPk_H_1Qu-cp~AJQfXaqOT}=m)!H!r3ou5DXX?ximUUh^Xdp#gh0Dw<_kuw+IP#l`J
zOo6|QG&J&({8#up<R$u`#!sI7#P1|AmwUCzVC^|DfPqEwnHCI~6#?_4^+WbRc4zkl
zaJa5ayL4jIV&8W)+jM0sISnh>E7mcn&(bwfw|<dQPy$t?u2DgHW#bAm?PD1LV;qj~
z@`I<FQJaGT3Zf8{{K4CE+^uc{TJ+!lFkV1dS*$%j9-W+Qb?TM1K?YxQc&{<Utxy9s
z)Uf-8MGZE%mP%V0;f;!m%UZ%z8!Gryb-j%$He<)@>mL?E%EnER)LBv@qHeFL8ovl@
zX407m+=*aHmee)J!Aau^`<~AO(PDMh1wz8%b!kGA-!dE9VhVKucBqDPrsmA&=<oOP
zamYK7xyMB;LfOUjEiIE)YL<)?c9ui&(-njVo$o>xN^bFdZL#kC0iLFA>32Ewz7^&J
z2ktEqhs*piN&7pYev7fq43|~Ax$W;qrtI|R8NL}VcNPuKJJK|j_82L%^8vz}9Uj;%
zO-(;qm<*)ri_0ICdYmYMkKyN=;$eYFm9Q2<&vV^?fCK?;{9^{6JZ$$r31{EFo@$dw
zV9ctf2yWm(PIsB-la<Kx>m?nRFWRFUe(z!et9};o0>cAw$C~9=%`_{pLn5-?xt`qO
zj-K)NoO=N0%y~bDU?xzWQ!xhMuO@7vPX?@PPcWb5Okq(&^}g9-VVE_Lpm;6xf~RkV
zM_@2k-n&EO<lYc{rJfBNVXV!j5jdRuocSDQN{N-)QoKu@&o&SS1Oo%rD#gSxu8Lg3
zV53k&q#8~B)g9BLofYQJI@P0v<J9}5r(*azzD*7uz`p<0b^Yk^!F0pE{J=y&+gbcx
zbUK$6eFw`P_4R9R>n9CB>BJ*i)_2mavd__$L(fM=#}y4$n#6VpXw`YX5ek316Yo-G
z353TSH2M<Y6rt1pXz1Q5OXsw9qTJ#>F9AKavTIICSG$MU7-H7Y)QUl&hHP3k+J}_z
zTOLkBPBK-IE>%=ji1%J*Ye$RWl1!nEOfpAx9HZElzB`zINDklxjxsbd%B!q2IWif3
zdc?hSn7qGFma%XuA92pR-D&)x>e1NrLHWJvN2dG?Kap2+r@5+qNYAq1)6@ZMf1M@V
zRqS2Gh_jHw^5ENFN+M>e5&Kzs*%8^R<+9a2lpe<;gy#8!X-l$zIyJSlR1dJ}Pao`!
zoP&TFv;Nd&mD4V4mK4WOn8&Vb5&%d5z|=YNoZy{1_0tlI_bda|ysIIBgw>S@JfkHU
z)JHz7@~)LQD1P(i&CK+4-!;tWRx8NjCr|*vvA>>6_*#tn2|W1vFR~j}c=vcQN%Xa1
zGy@+QEtbRrmjG7#xY_FXGjKVOuG+uI(EnO^{0JC-MOxCOHgYGc8C(h)mW~C<U#lxo
zbDf*|pTAT!3XYvYFPp^+M45B?OW83gmEAm$t&?M1^PyJUQ&99(Ww-{eiRaJK=ig5K
zDVix~nQVpr01@ZTCSK$c0dbvS;s{gS`(`rrXDDF2VD!e`H@@_q!IbNj%EyZvp1U&r
zF8V4{sO9*f`p?70rC}WyIE*Cdp26SnVvgtOJ-5q-3VI6Lq!8H<;d2uI{ClB{(Hn*L
zZ);6Bkmd($B;q?HIJs6@EP}`2xO+ds0DlSKL4YUpyrvVEJcHqWplWEwHMPQc@}Q<U
zEBE$;a5yAOW)h9TV4e!-2fzEx#8MB)0N4Qc4;T{g4s49+J08YKuG_h0Q%+KhDOhWX
z*u&&nx$~Gb*#o7+Dsyx^;wB%T(+igCPB(tdoqzW17%NtzglHB6Bd(G%SDYbc%Ouu(
zFWi6z<V#-VjZbOI&mUg95dEcC!20I(7XJM)WZ;i8r%qkC#&>;(?#IKslK8-*GZy@N
zU6S0+VOnTpDiSS|czn$En2GG=H?@`+c^=gI9{{L(PuhYv@6f|s><uyNSfwQ*;w>W>
zg4RT-uW<^N5hG&%;xj=N1Kw@Ue}vK<{&zj&5K!`eR+{hr^)HxHf9pRh%@zM^vHGe1
z=#0*P7OMxm!76Z4{c6Jwfv^Dr?J`BQ^v`!y^k*F#T%vLw`O5Q5OEPw(Y)ZyH1r`zk
zB55L5ocZp|7PQn@G(w4Pn?(cfz}7r{cl!?xCYwzA;wTdjphEygW{ouizHm~Mh{IB#
z>M=NRU_dCpRCiOOH`1s?2g_q@?)4uM4%&^*p8Z5(y{JOGcSjY8L;__9a2Ks{nJa#U
z$r~2t=J}M_JwGY3FogS_#`H}ZkUPl{JN~_85DcZ?rYRw<#UA@V|1ZETal=6Hx3t5C
zl8wzx$*jl8FlU+L%j>UZ+^eK8d|JlMVZD3LTAYbef9N~$_nnc?BKLtEJ4}z;VAxhC
zcs%=MELiv~d!0u9VD|b&`f!>l<Iso9Qi^HGy+YgAy{TW$+dR*$ILn)VmfJD*t-UyA
z8xK<uy9vTY$*|O45?1*0eCHgNJ`ZNC9#f1S+Bbsvg0u1zI=5F^9j*iE-|hz_UJU8v
z@AJppWNXg-6J)n)p1b-9SMGC9TbRg`?bh*k1LNYZp3br-Y4*`E))hYN+U6F2EcSi{
za6;^Mz*MF8pJSZ3|LxL(T!k+F`;Q9#ciF3>2eRPZjpyY7XBMor&B}Ipq1kY0#=B}H
z)vmCa;=c5eP?v(K+byd7W44}Gbh-|dwBn`q-iAX;tYfpZ;tI0u4xz$3i~aL=Fv_xq
zoncSWKRs`gNv|x-4Dl-3E`4`MeLR_)>1bjbPo}$ZScT!tLMYu~<Lb8ioU3_C(Y)V#
zzrP;mHBI;WHCrMekz(La)bqsOzu(^6Zl+M@_fL$NEi9Xbj8F!YpuTE*zVGsi@{CMO
z)YIuMb+mA#1y)-}=_rTk%<{<0?yy<5xAlr%*Z3Ig6?>O_I4{md)5wwf348j~DcRI%
zz-dH_Sr)cC%XzLne>e5dOX-EQQ=dMCJIy8~-3OL(>?H^0OLksOd%H3=T+LwS{j;M-
zYrN9Vz1C0mPcD_Yu-lKmEi?DDK<skgn{*lj_UX8Zo2zA?uix3OD{hg&WGpY9@Do{*
zoF(1o1LJnS<p@IF|LRW}ef#SWpEY8yP)xU?6pV_4W$y`rced~kvzYk1!soLmnovZo
zg)(V=zYj&9x!w8|y~;r~GSXTAwX%-w9E+SInJq}%$W8FZ=8og`?h}@nMJ)To01;SN
z$U(9|YV7-^)mUN__gw4v95(pLygTbrtWkc8>+IMU5PTDz@C;b68n@Xg-{EVQl;rQ5
zMcbkf^XPQ%hL@Qx!&%j<M|3xCvU?R3LmJorp)#p4KTdhO1ejrv%ii+H$v7E@Qb5q7
zX%|NC93ZzTZ)6r{TQ*|_yMId0wtCJu1Y%VLzzWB2P)(8@&>6Xq_x6ijleqGVN6^)g
z6zM0X8ycrecbAT6kn3f+Vr%2X&45^IJyYjQwwVIbBHe5C_gU;P)qX-VYT;L3(Z(Z+
zkhlS`w+BhD5K%*NCGV9GnHx1R_Q>Hz71Vg{(ZLQYReQN-`LOj9ezV{<#>x9=vL+-f
zhc~~yr`2DcC;fBZg6zvGEeCU~zj1}$`!n*X#j>l7d&9+Ikgl4wZ!1TAM~g|!F2vEU
zaRUR-49h@=Z8wsSh>Z<%RE&A|i$#F&hh$^kfNVgySv8}%OGXzsk^H<@juq{^*ha<S
zTncM=P)Qtq*!NGi^%4TV@h#xtR{Y?oB2F#ndfHPYTgx=@-Pho)5M_N<*xBx_!LPIm
z`_KY`P`-tz_SN!ADV2>^)LUKrvXXhIH&2mfW~C6N8KPE5T~_mbdX~>vVuU%;Z;71r
z&HC&)`;iExPwf;rtk<SDb#V+LsDkFCjMO=YjQdR^hy(o^=%N~$UKqDh@8Bxc59`|}
zLum)_-`39Y?5H-9Is;*h9K>Zm8=!bEwdt@g?z_Y|>=ZdYd7=i}8oWp&dJ%M8UBA>p
zicMJREHXa)a;>rub2f=7+7!EQ?pyV47@d?V7?Xf;boo|P|FBv}Scp1QgTea!G^311
z6&A1Qo;=B{fwrWRBs-GGcDy9|&zfcS<|C(Iz+6K-6iKXo*?EC_yjK1|?`;LY%0{nT
zyj3*@uf4Z#1)M2l=TelHpGU24^ttT=tz(enJW-*te##C1l4cMl?^wwvD2{u`+qw7D
zQNQmpH+QaN7iSTaK6jd42}@KwnsJPZlHK|Ng?6i;Mt%GJ!e?GB`L3Opl=ePQr<V(8
z4f%U`O-6b|b}LvOA&&I9<xNsUvmq(MSvm?UOF+{jsIR$1^^FdBO?XciBr_tSx^|{`
zPZRwV?IaNTrqFBRUbJl+r{6rs0IyJ~=T6rwdKp4hrl2<bYJtFqSK522C90&-rXfN7
zUbJcuefY86sH~vD+cbD-@s7EuDug;B8`nif+yn#E{M6c}jKp9H<8fRQJM5RGhm)(t
zp@I0-?#7iR61<m&jpqY<`v)oRZY84^-)#I7h){Mk!o=_ag37C$51I=+EF8d$WRRhI
z@fCK<{ow^;VT;i6wQfi@;GDJT5j6X$y=m&igXE=%^JHNWc>^-UwZcfuJiSyeWO;ke
zMPz2VgE-uO_ET7B&xdC!<^j&1H^oGv`7+ON3|dcodC|ftA!3S-#EC<NV=z6j>F*sD
z%fWdCIsLrwKogbs{7d5@!0K6U|E=AdT?-#g1C88UK|l+K>-3rOB@}8LsEgaEz%GaS
zdd0=$ezo-G@b2g>O59<-LvsOHJsg(=Q0}<XSxXypCgoitsIMN`C4K*{;x#QwFj}b#
z=r|-X%kC%iEMEG@Ym{^WaJ|{6o9}-2DI91hUJlCk;mTyOViNw&mZ9qi(bW(gPyJD^
z(p4j-@TF(|3hs$ekz&q#&;>7+zhj;XAkej{##>kTLt6^2Uq8ip37s<H|J1;ndQ1Vk
z<T!0Q+1GIR{iP`VMJ8~2>FwobTHDDUD<=GBm-BrN>Ci%xxMAx+(x4cAx0EIFaC2*F
zu=2{yFVa^9A^X!zg{HNZfRvH~sV)E`pSkrM8$;|j0>ua^%_Vx#2WOeiYfR4oSkB{n
zV2My%b!3>*0wGR7NlB@8e>+6z7pA&`i{!%KJGl3=Bc{91XEY^KslY(n8(v1<o3&#B
zkQm5=C$^jGT{KKV4myKPbd8wr<D($I$ph}a2c@Uv<-zEyyvXd7-wzoV0c2`c@d}In
zAMCw#RF!YkHi(^osGyQ6B`w`xAV@bzBi&un7O0ezbVzr1Bi+pb4&B{{j&C1*-*>+6
zTQh6Te6wc$nQ{61Eri2!&U4@U-uv3uzV?1(uP)}%B&TSc3taKMOvPXPLb}I)#J^O9
zR1iyE3_(9qNu%O&w8y2#D|8nJ$8HoQ7VhlZSw4B5S~Qqiy5SNhN?-osUMErd@-n{5
z<~n8TScoJB6r49NczS9IC%YU3J3qtlL|()-yTwxV01>n@FgB4s=(u>;yZ*ALw>Cqt
z=?ZfBPhOvFvC-}dr)VLIxmVUQuOQXb81B5HqW-@7TVC!-YPH<6U|ARHOugE!>`UQ$
zUM+dU;b+vLViXOwD{0-`KPisMT8s+O3z_b>;QD*4Jdf3A_fgr_ezlp5SzlvjKmy!7
z?|J)5<K9u~fKnJY>s;@SZt=Ag$i1pg@8R|pt~WyIp;BH}tuN(d_+FEN(4ZM?X&SDm
zEWFI1IY&p012sxv8WK#@|B2y2iy3xz{Z3=y!3c|7_4A>5@kfwpyT!YFD7~Vb%L2U|
z>cvANKc_x>yOeU;b~$NS4`llI-ne~}C9BEBo-b)S?h>E}mgq#j(cERj)L;F~2Mf|>
z{QMDQR9g!RiKc^P6WGPayRNu+V9?50?}1Dm0W#I|;%3=&ln8f@(6y+6BR=y$>UOi?
zSE~W#>jMIKflAs>j~1g&1{xX1PU>(qQ*T{Vn!B<*{UA=*vc<}Y=V)cGYc|!EMvje_
zW7f*Ydp#Z_U%YayXGC7!Cc(_+VQ{c~<FN%p$zr5JYTulZD-Lyb@;b%mG2&S8*4oG2
z%rZKK?^yIkn+50S^khGGi3^!fO7bcevKEG)9~M*7*rueVDf4G3CzB{<_93m+<pgv}
zr0u2@`QHX4Nkk;LlZyHC{Q}!-XlyV5U{z+-Nba+THgza_bPbs?5iL8tHON`r!#G{2
z&TiI9<@SqQ<pBzt$R=pzFj=E7JG)#aMBVlG#nlUCJNq3BL~aF+zCxnQxu=BAD+4ip
zicRVz=*%xl(&c*AxpUc0n0%~ko1L*)50}f_P~6CK{^3`b$OB=9K|ygGea_x(@80g8
z>y3=|yF6V76(t4{e`qhDp_W?6a|LEczd$-#Df!<DbhINTLFsm!$n^w?Khqlu=$n+K
z=hS%eyOvTuBt~Ow#h;1Ut`&l0Y`kh4UiKhjr#gfTC6ZB|BriX3G?s~2{4KQJ4`C*C
z#m&C(uA_~tj@$vxidm;qKEJ}=xQpXX)B<Yn8p9I!N%lQ-c-kt3lf}T7>D2gPyJ3Mf
zb-`iO`Pe+D)FpY`b?4ID0&ZGDf|!Q$wold3G`E`TK#-o_BRjz#X=!PN7PZ(`rK2Jf
zCF0nls0XHFk*RsTWe9W3heL{N{1LwxlrrID%%KJ|jZAYx<rS8tOvTrvS2%wSra@4{
zs6qo(n;#I=y07O9YyBF|KJ0U`+2QFRw)FymMD(KDSL#vLZFUtO+?YPmyuz%fDonz2
zokmxX7omv5q1I<w(5lAT*uR{acpRi6OC31eZ^BLV6(YKjb@fj<cBYZYiqVUwOI7Ex
z-~hFeD&`g0#p4bd;BXvKnfkNmJ5C?t%LGKyRHTm()d!VuM?Tt}ylxdxf5`Nkcl|vY
z={)App(gT(N$Sn9S8$BtGvS*zZ}v+Xv*Ay~I4!fjd4m`@oSvBIXK-@~BU_p|cTJVn
z?(CiyM;4G87u#*L4+e>LDrV*n8e}{9nKdrpin_@urM_N>WS8hslUOeuz#;Wqc3ZC!
zK6hMGn<<nIuvsBO7}qzyzGckn%x^PsR%zR|hFC&{=&!_NS3r2y+!he$af<}LhC+?y
zr612h0-51t>{*$?a;f7v{|<|d!w(s#60WiHcb|`M|5SH#8pK)Q3^@9@7?`=Rxnsof
z2Q9;iG;^lFAThnD@1LmbHvU}E4d40e#Y|Vgz68gExEsA1MK08`FUB+vqxesS+z7bT
za`!BT#qi#o5W3z<Yu$B2R{w12WqE8<&=OC;Zh{UjQJhAhcgyU#wMspvil2nE4J;~k
z`|D#OK0Jubgd89hj2NO3q(13h4COCe`8{W=`L<%uPP_ICwG7jG-CQY3R9<BWMzg9u
z5aSa%kJ>4fj_F&Hd+}ndE4C;}K_R{HCDJUubG7n#_oyx3r>wKu;?q@3zFq3%!x$GD
zVRQ&ocD3}?>V0$1X8mwRUMfd}B2bu7EnYX5P<iS2qvwW!ReO+V7lL!aPxj@R>sO&K
zR8OC_5AE~YPb6rZ?@_m`uqK&ymCRdx_4wMXm20rBZ;rq5f=`(j6NXbQ<(rQ)R_zmX
zCpVy2c-A*J@X{g6frXs3(cT_BkJ+M{h1}eROI}*~x3OJiyuHV0e?og9!2}PvDPol&
zkZkzRXC1y)=0Npgq0Z0p%j*xa5;h%z2Nb9)b+Xe=#q+Kb->g^nQ_T8d^oHuiX<b>1
z5fe>3t>V}5o5P>hJUzzAJ{YN4{gQu65qJ{+I>NYUfW=<ikIed5qH?pHpzQeLM0!`3
z7h&Pm<UVqt;g@d&zmixcbT8SY8o1^DA^qcfFcPOtMMV|ZVFcW=0(9_RytMYi`-g$d
zdc(qa5Mrf=Xn)lC)f(Io28V6d*g?|xnoA}SeLDHW5{o``P3e7p7{~U8t_iCa6kbZM
zQ!iWh`>C_7JmHLrO<l+%{xu_}7ijXtj<Z5NGqocXiKp|cqu=I@dVWk{!&-5o>*+mI
zFMo^)%F&c9JuWWdYENBTz3qyl%o+<};q9Az+ak^9$DY3??xR0I_o3|(hI0j6P)tws
z*3EF8yrNh_^bcZRZ-RsU%eYke{Kx#l|DuEzpI_jpF)`ktk1YD{$OJ#XMZ~xohpFY?
zTbmr>YNzf-H24LR(J{2h6*dibR&w%Q4mHIm>FN6STkfPQ&o8`#g6|hj^jp@Xb|=Zk
zic`p{u%X=*#$wF~7ip0aG?t>tq-|!EuzwsPU&hExP|PrO{_tqhlM?ZZIW0O&7dN|O
z9pHUTy!8HlW|+<vAO<WE`$Y?tuaj&97l6rw;%V7at(5uM#O3m7I`7MWiBIg*Jr0!G
z7G6h-=m0QEx`l&27mINN5i6*oH?N8Pgv^Rn3JVKc(`frE0$38|S7kGs2JrrINh4t~
z!)d=?ZlN!FbhWX$t4k7;(H*ZWBCcp=BWU1nF_JE%jU4_DfBl-YSO4CY4IfH2vO_N)
zWNZJFYqWTx5fUHG@-b+MZq}-2D-!!P9sK1u7f<lBu;tH7=^oS?^<k)HR|)??i;XZ2
zejU{yiL+ZwL;h{d3l-z?IrLZ@=w<m&s`tNWyZ@XqdGCLn`TPI!B?k8l3M%4W4Re-K
z)7du9Y!wJS_`A@i?Ivs>*pM5$S4PG0ETsd<{-ILcT!rnOy7X`HC1iiPzI}tu_kad1
z!?yXq7P(fxW|wZ^mTR}sGB_EOz=mCGO6*>&r$fy{D`uI?XgW-bzHaR2<~9a7L#42*
zSc{0HwW34jn#4pbxRTMze;BraSje;BUtA*<V{F(p#D1QJUFhGNtOF}5&$!k=jUJ=;
zzr^qU*DhzQjeY#Z<**qG!B<X6DV1KW>=_%I0!3hIW%*y~kwe_(07F$>J&S$98LF9v
zK1H4$9?M57*@&F?b;_!U(Nb#^3ZVhhlU{Z4?yDNx|C2I)v^}8e&aOH#3WR}`Se~yL
zDmFjut&bt6%OWN8<N5#jn)uh(CV%|6X*!(uCZIoEk%9N@V8(H);eqY=hlNMFc=W16
z>SKSI(nvwB-TRB9qpCAI_22K|l8`V6hcjw>u$hh|<mE912L(OUH8M6vO?i?)iB%jF
zGx!`9u^!kYSv~PWZAPZfF#3Rg04lfio^`*~D;<|S2+X8ROfquahVyif<|E95LPC;L
zQl4QF^Soo$YyXMX*H>;e5{y*4RX2J+iU;{W2rLvXT)4n>ezL=A)c>p_npXvC-m;pS
zv94QQ8V3C-(t=~Dsj132njfLUe*fXal!OE_A7WnR*B-b1$$(FBIa*3q&ei%#h~+sw
zJ<Vd!{a8GbBUhRPy%Li;Vv!uu0lRhB`~}vMBOWa)C`V*oEePEWMnnDSs8=jFY!;&I
zMbH&>)(_h{J`WjRZEbCd<JABQ;ka3QP5#}xp@eAZc)_JX74w1ejjHrFUU;m?UohWA
zl%bLg5>J=i9-(l4H`hQW_(jKAf1%lhg=FrH3Rx`A_~EiopFhj1tB)HXwf%ULqIsQ+
zI>K2U=Ykc(dDm;Nk@UM?xU}2wK*M0X;)D3!@$vD>*9Yo9tE=7eo6x)SLKN;q8mg|p
z$UwcwX-fRbkCLG17Z&doE*2KKmX?-)gz#{D^!+;?OnKV&iL)Dm*m0!DG(y@A)?W~4
zRI|wSk{PUqh6dp@0?W*-EHgQKE33S-O;3J<8utqU%h9*St6a)OL`1wdBSJ${_|LZd
z!g)UAkr_@@xhUuBiN`wvY@;t<Wr}iIFKq;kgO!@|R)bGbVp5Vwz}781T--!Y64!Uw
zJe%&)dNYkaR;8*((_ReTI|mE==cyBCd&P~cDKU4k(5Hzqjql`avku!4Rt()Rq|H*o
zywWWjOTOgGz1|H*lr`5DLO_}Y@nUIdNkmc-5kw_xGa#>M*q0<8uq<e0UNUtRWWEjc
z^#&~g<mhZQO%OG1(<lDp+czmGsh@hCkyNSlntHmrk94nM6K8-0qu^u=6<N)R_z<vn
z9z;h*X28XS({2^Ro78z?BN)KQ1d-G<G~~j4$&!k;wuP;2ZJ<#~?ucL~u!UM@s|lZt
zq*lWZTrP`A_p6xr3DqZa3_pB*^>)!7tVY=Ip=%fC0^v;c_j{B^)Aiq@9Jy>fv1`uG
z&dQe4($Swj6?AN1(S4u{@%BfbToJe(*_SUrCY1RP9Nl?DLXxd<x~$kS_y`B*Nvc_y
z6>mseA~avk9P7up49*UHzJ|?qG`@KN1%3EnG%PIrLwdRI0KDN7?fkjLz;a_2h2Epe
zT^W~?t)_s4OqF7zmBGxT#dtp!I8bBGI~^Uwe`98omBT@%BL9`Le9uWNBKN-DUhl^a
zNYi2}@Jk>;Kpbq%_}Cwbpu1l{-9y&$&@g!U&vIuJH+f6wGHuJd<}^;sOKSy&ef^1|
zA%e$sfBr};M@BnL-x%ocZ#FAl*=}P{l#vO5Z5Uo05PP8Eoa=!_l!i;A@C<y%;o)Jx
za*{NHVfnB3YnpjGRUFOmWfJT3wgv26UVeUXR8%H5-@yw&3IPer%SLNMxpmJT5D{g5
z`Eps<_LlyD=lF-6`K7~!7zEl*DZKQEgil5KP`0qQ5_KM!vPMQm@eAIP0-(TxFUf=h
zDJ2IJgabjLGV<(1Pe*4F9MWKW7;|tyKpbVX1KO=d=2n;5KSdw5njS)$lfiWC+9*`m
zBo^<*NH`AQ(G2(3$3#R$`{;^CpGI^HK6~!_h*|LC$B$);abDis_nGxOgFr@w!`8*K
z(~if_jVw0T0Gm@Ow_EE4?O-fw1(9A*&_Cq1R)~o1E(I>;>({S<;{UueFh1T}^T8{$
z;))V^`}XJGie68KQoi>Fife}9349`V+2q8jVs(Au8|&SqH6ZZXAGP)auc>Wf{Lq!5
zWb)#eMIB~9LTKp2F*~Gb<4!ed%6@aQwha6$dFrtAqz7`Df5H}_CL%2CPeyt&V!}4&
zdc4+n-O`1-DQ(9BZOG6TASWvuzq@M#AG9mQdTpc-deq8}*UNoy)*>Sb!QnqzKvuh*
zlMbSDFbquIy&>&@{^?DX>?vda<(0+TT)R&01Zk<M(qPaq68SzcaaL$(sGg9m8hr@(
zYiL5uS|2NCcTC!M;3R}eg2j@*fB*jB<z-y(YNut>v2vu)I7CZJ%Xb9EknGd2vnxJ%
z@??3WFddM*a-s|RJq^s)wuoUzu9Q7-b8|y2_RNINL0P)Yeq)^4)WgGrO}VGE5Eho4
zf`T|-HH2O*oc7PZ0Lw_^c=K<y5hL^K{|vtWvmX0j@%sN&U<Y`}rXh`Wt>-UXsqrin
z#UN(a({W-!cj93zJ|5B545IqKk3s&Qyr*}_@=KWwfX0e|2oFjBSHQ%G`ZQn!lj~vt
zM>*Li%G><F(S*uhYpcjV%w6yld>j0$bZmWZT_k<+{)LjFqN2)j^j%{_Dd@MTMm@z~
z-u}A^$rAtm`4^{H&|cO=zs6ni|N6$&j*Js6ej7Ejce1}=zzWI5zxT7b?)|T=$N3^@
z4M$vB8ntjhOpHc^_tQaeXER%nQA0Aa5mb!!oi)XG-2EntkY=*-^1(7PGB)5l9wI?U
zU<NTsxcAGAdn^`{FDmy&jGHpd4>qTit6fi}+lEZo&}gS@f7}Vw<D)um4h|)q5G}-`
zxX`)?`|%ISfLcIiq3(8S8zx2(zZ%JDU0^ZwO1M|!Y#Y?xJu@k$ZV=m#meaFmH#V{n
z>Q3U2OBIjVMUWYSD=6Fib1Q;(9pt&aXgDJ52v}eMoO67UECUUVD8NH$Y3b$R{N$dl
zii!#fL`7l6PAB)#8H_zto(JF|XJKKHUW`84v8Oohel;^&EJr(Ubt}}(y_SuIOON#Z
z{QC7kX~%cED+|GJ89v6}c3)_i<&2V88_pN1bVM<=4tlOlPJYDy2np!FX9P@YdrWwk
z60bQ&^lersJJOLYjoD8O0RCaIS(F+BpVTxk|D9{xdWF{cFw8F64XE%JuP;vq_9sh{
zs9ATgHtz3FxM@I)24_*W+bim`rdDPnEh6%RtYyk#ai@zvgbefH^B1H-zCj5TeK3Ok
zHLJ^!jd1T^rb?k!!%b*_{d$X4yYV&}Cwk$*6bg{_*IuuI^*G+&2tmWgqc5FpCTuJF
z)#sIDso+W|<(jt2VEcTer{*0h#|7g@DdVTQGJd<eyDOwtvmP&dEt@A<pa-3GhhMLu
zOa<J_wNbI-y+Pu3k_$lO{-a0322QU*uP2DHK2d#+)ArTF!)Ua`G9bZnrm<zohMJXC
zKEP(O<^pP|53N&@mzP&AHj6@IE8*To9|9jP*iTYn5pnT>PgicCaWe#ba&mIR-Nhb!
zCY`tWrcRaWE;}9UPy?1trlz0}3@CtGbvZ>L&}jPZy?Z`V6F-|~dH^*fu^JDi0PIjJ
zw;KS6X|rCskOq1`M|f>;L<EiS2w=Wwx3dppmQ6(HH-wFWfq!vTF2^DPs`MfA?P2k@
zD}$*81#<8~PmfT2kcVV%ZdwTUPB(a=7r3FRDP1y#4{b;=nmK{FljAkOX!U&3Nujd&
z068_aOfX6102@HMMsuyf=o>vd+pjj>TODrg>Ozz*M1zCBnE5XE6++EE3XKv#v{re#
zhiq+cmxB`q0(4fb`s*E`jIR}p$21Dr#~o(AHL>d-ZqGR`rzWE@GhuEurM9(WnPq;$
z6R(E2{PT%(ZgSJ2`Vm&+`@}fET~Ch+Qz{TE0|5<QwvFF#MnVGPAtQ=9-0?{)l2Km=
z21)+yb*PiTlP=^gPijA-rtbCQKQnMP?=mdFOtwb*03D{KjQmdYJ)@xsKy9GajK|7s
z0mtxDQc(QG@~8nt0-|!G0qRWULJ>eOu~%<D>`tJ|Mx?{y3#XM|4cG<KU#i?6XKpna
zE0c$9Ftu7;9nLSbS(2G?l92GVva%|GuTN)4&ZUfu(kzM6)6#-|{i5(|0;TG0h``Wh
z(!5wl>c<mTQNa_R1&#_t^3rfXs-qp3son?(Jfox(Qc_Za@Y@?eF6y0!&dC66?t*cT
zrR1v%3JM0g3c<_3X6QrOIQEtD^&Yu^2nn4j0QBG8a63m1ty`7Ksj6mp5<9+?NbXC?
zhRuhQBO@s2aRxjybny{w9gr$jIhX!o(8v;{FP#ngstM^2CMT_XL`U+%#Vz1m)QKi+
zPP9Ml4YN`|OX)Uui->#qInM7LJXC=-@15AuPE1pQNI56xHPC<EC+T7a=@2?HJKqLO
zM5jEvEN8(%c(m0-GKX>m74*QfZ%vJjA_0xQMClD)4@3ic`}%AfAL&2i<y8x?8C232
z4#?%FrWQdvLv)VXFDnU24xJf221)0V&2shmX?8-H1&i&n9H<rn&Sy(=!jj6TD+mXm
z4Q{C~8NHWB2Qz+iHe7|q2zuVr-9E>?VSV)E)w9#%m81wWCc(D^%0(t&(06$IQQR$t
z3aJ%DHo|_wg)+G>wbXh6zpr4$2cK2s9)(ypSbSQ0yI6cjolshg^L7ixnhy!TI#{lD
z;Lg%OdWa)xc_76Pd>Rf84zwu2Ou-DkgUL&zC+ZGUU*Uv*o9}|&CzT@fZqg`bu?X%&
zaG$*;cHVp`+$$@|Yuow?##@`&O))^K?PF-TjLeP!`2jjtiQ=|f^u{3#sxl0G_39Pu
zA}vH&fQ6W162Iiwxu2{oNLv7OBHvqzhwtj@>ZX>JDG$iYr=_GovRUncNs<NfR*;Gr
zX)A|AE`<B=;n1SstJkcotRod4^0BxGf%JoltZWRQi}GnW%YD50>`WCec#MKeztyFy
z0<C(+l?2xqsw>nlTu|UWS{zbHhe3li2po5n$1E%bJ@%e;JrrwPguZ%p`&S;QYI=90
z){u&jA^~pfIYO;~fL`~DXRh|jS<{E3-KDgwESQ*33h1%m!;W5j7T7f&ikzJtk+PrH
zM&CysqWV;rnt_2`AtK9uqjJA>&I)}$j~+dO;1`2m2!sE~;ckTk#?1JqTYHQVS*(2L
zUFRo$5N87d0}Cx@1fi$V2oeTy-@~yDS4!v(`}y+@?{+gOOry`s!;6aV&@;|61t@(~
zM{?G!12Q^9pd_CmPjM6+OW|dhP^i})`XqIIc<Cs(0Fj~8_Y8x?^`s|q`OYd>lK%d>
zAo36CQy5vA1TNgPt654w;0sf+xuT9v0^?d0$XZ>FQGtC+{p)Jw{j6*X{{H?Wk<nSP
zlbVUUYw0eWoUKDe;*5-pX{lKXJ!hxzhyiqSLm~7zt&QfsZuxxG5ZoSw9O#mfBzi`#
zU}|cb?=n`V>y<`L6AT$HxVg3QN)<~>OThA!wwSGLQH~pxbRwcOK}|FA8{_YfI?QG6
zKX{OE<6fCDYFX7~e~j4W$ne*zS0~`GPgxD53XF_K;k2SlAZGU`v=|Nld|ChDo3$b-
zEgh`aC84ON_Z_tNg5KW-SP^7x6BBW9anzNlK?+^HU(H&KR9qwU<zq?wXO;z3Csv-I
zqSs}MV6k5Z2AV=VDm*1NHmN!uj=lls#Z5*sO3Ib0<8|gLc4tf(l@#m=wg~jSLl4y_
zK_7hGRrWA3d{(2NUvw%-1qCeH7pP#4UVXhl{3sko%?iZ604y_p3`BKvXFeGB33MU@
zgXH;Pmz#uRnFA!UWK{I@S<)OtKwI6sbxU4Ww$C7;+pL%%z5tRqq0Hln^D}#|qn{@`
zDf3f~`|GA(5FV!wIV?2e&jjAQNd=+vl`B_-c&f-Hbg$c$kF|DoniX`cpr~nS#Xif(
z6gUo0pO!clLQR3Ol|~pmzPz(@1zGBB&4syzIVvV58D7UdxneWulDhW#wJijHZE_=U
zn&jB{WWv;RG_ue{olq9R3(^7kSFb)f?yaUKVkYIW!{#K{#6G@q^=j+(PS;Uvon`NZ
zgF0;Hpz!cyV%}G{cc+1$@Y*e|&g{)ly63|*JbVoo_OsH7$Z@^2(D86?XKq2i$NhqT
zT853$M3ogTu6%0Je0Lf$yE-~))x<MNOt}B-R9?B%DrVHo&#dZ0%D4lmIJaF83`&vt
z{rgNryhGL?CC12j?C4~N_5+V?U&#adjB-v!E1e9-eJt+O9Z;`s+FqW-qJ8q@CFH<7
zdZoGAO-4XEp${frRvO7^Z~{8T1{Z=(C{MQAfJ;mWW7a3O3^%l17BWdJ)Bm)REWUv(
z&Xz6({t+Gg1<#Yk!r~?;HF+V^r87%cfA=nQZ(|}G%u6tx8c}S>7C~@jMs}+;;^)tw
zdd2LKxZTg22N~AM2gI%Esi+KPs!BK3sGwIVzKP|0G!0xEWR`MLQn8T7vz9g1VrKb_
znXz{cD5<0e(<n5rpx8eADw*2w?=X^2Y$Elndy<VX9<5*u6Z2_h)nYQNJ3?8Nk7e#f
zTInXrwuLM_qivrEH9P4QT`6>R`Iwg{qLV)mwR5m_qwMVH{^@3&dgbvtUZzrDc7B&c
zw>bL%9a*u(lvzhqc}EI6<wC68I<35bfcwpxSRDoLinCsP_%Jt;8!zW_EVx*8yliGb
zPX5Mdp%b3Iqq5uOrk>)op+;LimKMg`RNVRjG~MnPqg1y6^TPR%NS1|l4ZylG2@IDu
za<(Oq)v%Wgrf@8k{K=MMFDxF12$dWZbRRILA?%4yD<Jiz180DLG>nYW*7NP0T9ra8
zLcsAsoF#`)MlSlx;Ln#EBe~k}NT<=^1j(lKGtQ+tbOKWHIk-hf2CNf}Q*_(#)<#QZ
zp%-j0?v0nX^yaTDJ!djWzQY7G6oGhm7DVSU5IHiU3@#Qh0~I&73LF8JEXlftax7w=
zXW(mr&!UD92c0T1e#E@9792r?nrV*K*{o?Km6>U2OnmI@S4QB7X(QPHLQ{X}ehk!+
zVM|w6am?-H{B`~N4;>a`>SANdppjV-wg2uZ>595PF0uN)zM0vf^h#z*%JEpyaC>9_
z+)n38YG~*SPQpU*k;v!2%Nu>X*sCJM0@~&xHnJe);E=yw6ZPVhW$|eLGJE71Avo-B
z->!q98l0URqA_xj$*>k7viC6|4$kkXI!|MO!XuSV#p`7&S$b`(kxVDR*3)os3|-IY
z{oO5BO}ztdYPb6}_7Z>?a~VW`s%#-7b0F$Qv)UWg=dST*gZ#!$PxU&&2Uhn8%qyfJ
z3URL=WdWVfyVK6R?Z6YxX`N*G`c)c1YBbM>?Hl_jIZusZq^bA#APB;t9~3daYXcl;
z6r<Lc!7L>-LevhoU$1gOM<w(lsi4vTblJd}bAF=h`)oD-^Hskh>U`kcA&7Mnao;B-
z%=q)^lU{NcNI9X_@<#9tJh{sd(HUi%&KEQLqwD?qvmf8CLj%y)vz?fZo0zD+*5J~c
zSVe}LlLjt(O25dKBFybzGcq=+CuoGZj#t0L4<geQLrvK7!O`R1yZ6kiA)(NCr_km2
z0`G3O!LW%Qpj8d)1v6PNeub=2%8<7BCK7&?fctke<;~1W`OX~58N*Lz1Mle+?{u*N
zZuri{J7L@Vl7&6oHt#s$b#^SLLa7J7#0Rqjr2yB%HjP%j{M4i*LEwm&5!o?YtMkAi
z&22d-_fNoz_BimHS3-hVEnS+E^IXlM_6m^P1mmUF$rR$@IzdXMR*9CXryu4Q7TCGf
z*f==e`SBg4Y*kHoeB1_xA0UlP{241^LEDtupQ$5QR6=49m_Mz^*De}$b#<sAZ9moz
zn6jcsLoa^~I5!2D1o)@L?@t}q7-(VX!;Y{Y#>U1zhI8}!%Hd(-QwvDe+kVjxG#0Rc
zGf%VE0#_D~d*@CpiDLF(UZN;kv=367vjs(KqO3D6G75?`Xz8O-%;@$d;tp5)*{+p~
zM(y18tKGfiqCo&mAs-dYE<kq%EFGM!zwPDS_wEnVZv@v%=(5#-h1wwbjWj2r4{S*w
z7hR6_!@8cc9Pd|@p4OUZ*mnd;U?Yvbq5@l0*zAURPvyR^%=wvrIJ18GxQo4)l@%5+
z*u;%h0NQ;(-83g59${yYR5ROBNiMA6QYfoZjAz^(YjEZA9rXAi36B<JI77S1$N#9N
zWGXMze!iwsSao#8i7W7E|ERIPp5?eTVn!O$3P|rzkn{}4J{_RD4cU}SKNEcjnxD|i
zAHH5HWSk!x`(kQp>W7cdTFyo)%7F)Hcv)D`GP^Y+9)x2YI_XG`c1#mb<}I#=rRXo#
z;D=lr>N(Jx8ruUY3L!Lkfc6!bC2jhnIY?$e*8pK6{><6f$OyksNlk4m;ncC|Shb{W
z&cAPobNZRFl9JD>*Qeg@YbZx~DJiP-feb};rR>$!&yJ`8;XGx6{pzGfs5m1{Dp^_A
zW4e-;`23pEf80!d^-8%)6Q+RFq*^7QEG7C=n?0IdVVDW(->!LKoQ7S4O6RqgOV)Z{
z-~mAbRevwtXXAnTkV;=N$#LZf0H5Ue&O7d5lGi3nY`y%<QEnKLLN3Q1E0S*bnR$82
zm=Ev#u6Z%u2P9axKlBt37T3jG+1LI4T_~ms+M3*bKV#gsu}XHtN6#9uD0_^-{<#Le
zLTkF3R7L*QRoxW?F~Gk;jr;$6W6FOKp<Hh;VCdW0*k2BHv4Bf-e);}|p{}m%|B0qk
zp~VB6whJ%6i+-nWoOhWDXuzVCTVSuK{3co08~T6j$}21Xj*P}wjOA*$j{d|L7_e6V
z%OCFlXEb2}`Tl!G(=+!S?SE`mGN<7G+=3$Z(M%Bd6tnU*HsRhk57ZKXR}6u?PYUvS
zGQ;lJm)raM<{?#MZs(_eS){vnSpXi`Eqx|~G!eKqphZM@o%T$M(aIqxNWv7BDU@S`
zb7yDgpcg~cGhxT+@09lm2$1wHI}SWPM+55PF8gX|V(_&m)_|J*m~AU^rgXK@fdV}>
zhr?CuqhK;zV9tUA+~x2(``=;HHay-K#Wlczp;{<o9!^X+uF#<ipW2Py(!f2UFQ}`d
zlL9XP`}gl<2h(0qzj-Q*CNKET4zwYuP;*>LMAwI*44!`B($z&o^;sc=?l|+RLqTv7
zkZcd42`uo;c>AU>j{zK>FWC}Qs}N9nkB6KcwK1WAPT@DF>d1w67P=5H2`~Y!lmf}4
za-PojA3uHs0em&iu2cX*5<SAfQTQ4bVRx8*bSjl>5_I`wD8*m7g@<O0y4=q4fvv)v
zo1Yg6C^DbOg2JY{{ivm9`+U;AEE5yctX=s4l;q*8MAr=PvjJ0-sZx}ZlhZw<#}>i*
zoKp#?PR`|Am0}ZVNDl-fKP3I4RnK4+^nRZ8Mku#BM@ps0r00uuC*zUR;9`&Ii07qi
zX}E+YfiWbcXb}U43p(wFLQ1*)23wWBo?e=MS2UD>dQSHz7?S%8SKFGK(YtR}iBdpQ
z7eFxrZU`WQ!gSlS{XR*4DpJzdz&b%E5fHvW@R?gq07)%<&fLYLZ6YZuDyys<PV6vw
z0nJTrjQ=g**sYBWEFJ)dVze{gaRfOPJblS6UJ~*l*4EXD>gpa#sNgrstpargBTrg@
zWxi1ZHEHD%i{E^Qv-f})5rrj9g$PXs{cvgT9optQY}xNz#gq{f^M*_}DAzQi$YeYt
zU(iqC#fusoKUCTw)dtb`{hY4MfhM?r)Tp)btc~MtGpRQ2eI4VX$flVAmwmcH@{rvg
z-4K*<aFMkY78;N8@s-Fgqbmx^pD;!*E<{@U0%NiZbwQB;AW4bQr910|PS!sgz)>eJ
zE*hM!Xq?NSjnHX>7gj4xnimLfG~K@orrJDZky25inwy)8t_HH0kMlr@%M?gHpu#8u
zmr9Nw5fG$LoXoSMiHQQ>%!PYBFbTkt`cqV)3g5}KLfa9;uL0~A++#07!z~kv(}gKf
zXzsL&?>Gbc=mx6Y+{U27ou?deMvV@5Fe)5~*O8p}pNq`K(iAmZ<l_Z>dckmQ8*mi~
z_c@6>=d29R&rX+n@{=L^fwqToHLB0ojQ>#v_W^o9S#NEmR2GORkX_*O=rl{eb^sc3
zZ+(~)5DlOg$W9Z0xX?90QUH$xC4YHEMH(1&^V$<LutQH)!mbDonlYhlHE2&omLk|v
zfzg2eLHwUV3C+#T6sE)+7B7^-!r-3J6DIB+?=p5S$z8vm(>&w<<42mD><ph4#;=64
zQ_}u;p%owR>XU89E0^D)7UQ*5G9_SZCf{AJp}Pa06oex)PBu0LPzyw79>Oxfqo4&9
zKraJTZ3M+iD-J?*N-ozW&OVlKaNq!+)OdZgG#~+#8Y(~|z|Ub6Q#2WxAc}E4N@dJb
znec?_=0?it$w0Pi;>SzZj3#S79)Z3E3hMCKu)!4XVH0?+#snQ?Dva8V=#ufT1VK|G
zQ8~Gw+?z$fDJ`?i5SW#`luZ(oHZ#jo$X3q;!(Sdy)EIzW@TrRSKEm0pJJu{zX0;i5
z4)ej4!t$7yaUp{^_;OiSR}bdh*y6LhI_KLu@(`~zx5^YBIJ^-QG;$L30FDUJ{k{&3
z;UTeWpd@=nMkat{W-2gVkU%XC10GTmS?v>owQe1)QbU76_XM)j0=rC5z+ELHH*|ad
zn=L8PaJ9q|EXTNi9a05o1ENVZ*H~+7k!~z9&AjX0_J2eM`IBm+=0do4v)xRgX#4f<
z-B&gptSvvj-;e{gNBx6tWn^br&)J8aq7`putd845WrgoHs;lJ>4{@PMWjW5v(Rh1S
zK-l*8QD!k46?47-o|kY>j~zUl_H@fH9(`pw85z3#;e=A_Vo(|yF89~RU$ubUj%B^$
zF8K<^BW*3TF;tK0oCAm?aLINnDxPZAwy+qx-(6QHrKhJCZ`jnqtKn4QK_d$fabOEq
zS7V^3?|hh9IBbGu$lkw4SC##g&c8p8=vW@ij3~2RNdlK8tKoVGHoT3dRG<(YV{_U$
zqAYB?U`6J%zaHG7$9yptv^+<)D}Wb!oTDU?!Cs}I<_|_jS3WkrsC;yM3{x`7Qfts`
zC=?M6zI-X$7#M&zlWqQn0|Wt=)L*{!eVr$yg73f?DCark-rU|9s1))OT-$?v1DZLI
zjOaGz0GOMyE@}mvza5zVXvf{_@^8Pzu$j~MPMj5qfZB$o)dXqxLaqF&;m-Wi%7bZm
zS{tYO@87P=NcLA|#X`s;A}L_tr1|)(Uv=@73&Q%Uxqjf!)X+%r;~UA!dG6*zM3Bus
z{<hDTC=rTfat0~YGO|1O@t2d&yT+qDg_I_a&)qr$+Q|ZWpWM3fg!b-rvbbifAJYnc
zrhbLIBSw;@#+lK3&Y6SCDo)+hbWIva>jI(7LbJ?4wfm!Y9_*>%J^4a@>&vPWx__HF
zENp^=^b%v>&*m3F6~u@+U8a2(xAlEqW{a&d{<bwcC#9;2%P|bky`AP-Yx+Me_4Pes
zrZ`K;1{Op>Ac6m84P~uX?xYQuu!O{XT6)%UAukP0x+3=K3%Kh*Z*Onn1up-OUuLti
zvL?G+t794)1u^d4z3aGYe^N0Y|MFZ1($`1{N>EYE&}baqghD6fSkhV_!F6$QaUDIq
zy&(l<nO8DaOllJPn}U}J%a<m()+;%phfR_)3xo4|WlmiA1><v@v_0eeR1!czGi6u)
z-Pf0bl=L%%DR5pn%9*p`(cUwCKTo%cOnEz}j#x@ax@PS1E$cicIqQDs_W?l^T;HVf
zsm_PQ)q#@Reo$J*YSp^(a6VNmCc5+dbOOt6EiE~>M_4)BC+37K=iA8nNmmmg&k*6L
z8?s0lV|toaPM-6dAGR}pv00{Wd#HnmsLCULK7Wmqr_V7pr|ZdDTSs!<iJh#Ohd`w+
z{re9l>+{p!PE%0x5fG5La%Hk>%7CN2y*(iz;Y(5y1)TctUS8S|PEE!u9>w=GgH(r4
z@%ZZJk8Skjw2|c3z=U(5&;g3XgUQd>pS+ZGT}D2Kg@^yBn~E(d3582QemYcUYaFvi
zL=q%fufvoJ3_KGva~Q9a-MeUA0$kj$wVJWHzkds1n3<a=$Hjfx^}cPwrs79D8qd44
zb>l|=-~h@fKdCGnb_?F-t(Zt$LBf}^nY|r5`)h7y#>RD;&nNB5ABBar9OQS#<>vbL
z2HeG3osb+%t{lzR>%!WrC@w5SDKA0d5CuX3!G+nMQBgqKEd;8SOB|hYayfHy9SxD#
zM$m2MBb-baGwbVLxQmP2q<yF$KlhkCaf9H#nSHGOh!*4f{5P8UZ*nZA3~t^O)GRJ{
zirV>fOOVliJ-4e#(|z4+LRc;08~kb3q{6`N-m3c*LaX!#+;|82zf0IW7?<a_A%z9~
z!i8tgo-Nv=rp}zBujE{v`Rz&k$AIN(9Yf7rhz3?oD5Ew!`lZgS*t&_xes{RB2Lom!
z)@Qq-Xz&=+o&UTjciJ}tZxO~}`4pJa+jYU4OCo>5KE6r!C44{I?9UM;Vdu7e1I!oH
z0=>*kL-|hZm?)I@Tk*u{W*pd$qm1JC_)CE;0<W~5(ua7BjEoS+2s=4(6A=+T^bs^N
zHiEK{jg3u?{=QjKlsz#hNm<xfy2r;Qw6vaL%z0v44}O7d>9^RNe3=w&E#bG}iJZIW
zi>b{or*Jj$<VV-m7T(=^nf?7Xn|^Mq<n;6bJ_P9iv^9GZ$P_ZJ-_CcN4|_G=-l8*B
zCi3*D_v}LQE^>WX-)}O?zSY3Uib=ooZFofaP)RO+{%{SV+7%B6N6;?M$l=p}Y5_LP
zCKE&U0z(aSXBw%?%3WyHc}OtQ2gGa(KO@w+-|Fge>*{8n?7L~akPA8!f%Z8Ze_5gP
zk=s)TIo7)itE(oBek78@!Z#$61A$ir?P{|R`*<^&x91_2e0~B<&b0?2_y)(HF)M%j
z-Wq7s*ARXC_Awh9TgeMW0fEc>hb@wy((k&>5KL$SE`sXvg^#}x3(-#W5p1T*J)KZW
zZii~$)}eF%;9&Ig6kB`yd^jUORyG60dDS+PlF97Efh$S^W?@p%&|wZnX-Hwbkde9D
z)6=s$R{o$a`Bn&#i$wm%@s0O;i#`1V1G#2vBa>U;g@Rnmq(XZPbdbrF(|Y+~EwV{>
zaB<(r$=xS0M|#w1))=rbS@x1;D9~s(`6gy$cteF5qqn!$5tCC=Lb%qbFi&?!?{Q8}
zc&(=9f-lkR>?~orU#**>>)Fmy#g-uB%Aox8&S4k_<M(Vg7alq~dMrYNMgx}a(a{Fu
zY$7sN)^Kwdng{W@3!GfsPJ6q4Br(m{ZlPVR!JZ$sTX-=Nk_4Gu9IxVeedk^et=*m@
zujQ=z{#_xfbbiQaR^zbsVYIUqHt1Ld1-|%OcZt^-4QL2Gg+EqCk4};gYm*7sOtsfn
zm)@K1<a>!nWt`y=1KKK4r3cjcX~(Kkonc^Lz{bulAS`THyK3n{16t7nm{mkj@G8`1
zHw;Zp6XA@5_xiabPK0$0%ky)8e?Q+syq&$hb}^C>->34T+A~OE(6Umo7`{_$Z0wD$
zo~C<mgoO5$<!)c>qTO@gsjsiUZQyGP$AK*ZGrs2=a;*`Z)^VUDpaAgRgwD5nx45{t
zKxkIqfO6L9{%*v5=HS)vY1pK31vQOwe7%1D!Nbqq{&>^D`H7R#sVl!-IX6ehgPOVR
z-jNaL%9^pSM%ITiZk=q0R64CAkz)dH!Wbi*s*~wM9#l_|FpVBLyK-^y)Hm*(y8iVh
z4}?riOx_{6afder`sbM50t&6XnAM_lv+YM?vMgj9)xTN$ZC!s2n_wOCAggBQ=A<_b
zvsY6!*&>cBlj182F4>-tY<77_K_*0Va`A}<!CTYczEB2xA4chtaaFtd=gp7mb2H$5
zoHmHGhV$Yp$FI^?+K4r4AK%Ks6P-X2_+0&}0jCIuGxNUtTmfg<_5KhgWk<(%ua_PS
z&xQC+W#r%8I)1{=ej{+Hzf=6d-<J+loqQL#Itx?benXm!=vI9c8Q--;g!PnETr50@
zr(YL+Z{NQ7T-<!l=z8J+N0R?PzW43+qbrklJlgIkqA!HwKQ&t~It7AU^q<HJ_uc=-
zDgm8$QW)SF&@XuZ^1?fG{1OoGxN=4F@Aq&X;r;h7#QL3-q?aOk=ilp}%l_~F=Hwm7
zr9H|n|GU5qX7~_1#9dM$kI^>z^y&K~48m91+A~ri&rNLX91YCY@t2wYzN^kdDGXw)
zvU0|PqUgN&{War1X7+Ab+UG|INr%agbnmm?{(V^jJ6!Q8DXC}Km(8W+KLsw_MHLm3
z8&k7Z9}Z_oinq>=J^2w^oSa*;3x3y)#s9tQ?@-S&cZN7PsyW4nQ)!qLo7+~6J{|KG
zA8^&PLsqI?aBp?ST&Zd7Kz`6&LI#nfUYs;Ow_;>>-dCYjEBa)wknxn0>f>~8-F>mJ
z`t?69VlfIeYW64BphMw-#)m+8WA>iG!OjBfq|NvZw}}4!`?n=184V2`k|moaEi@yT
zuW9H}bSkPpl3OEjvH7w;&MlxF9~c^XorjpjkI(T&W+pvI&ThM_l`k)?@8J*-wBRaw
zU(p=Sy9*?EB%}7-P#(^(;&JMRnJvqODCXvt?+fEj?A=3)WK6yFD8#~*uKkeeRjrM2
z!A2iZ$eZ*)G*mL>K_wRY^Lh=^JY;LVT(?A3-O6e@HGAVRC1o_yjC&)2pYrb>aayNd
z<M`t1>zh-|sU^VFL6@1KRvm1qoo87(%5&H*TDvAho%S%yzj5t+Lr_ng-!nwr<yLuR
z)NTQeoIIj;eep3B<3~EA9g~al1!IJHVp35wE)8PyPg|Q(i6%WlZ717gLaDj3+UZX9
zgdack58t?_&%-bltEO+3fhUu)Er(tUhxa5Df&MDyQH@`22p>4RVx*-LIUl_Lu(=RS
zgPrgELD<5{u?*9%sVSNlv*Kj?f}pQ=?ZQr956(NCRX8?`VYdqkOC2MbdB;5ZhQ;5%
zCk>=bmQqC2{=oeht0p_6xzzg^LoDK#ppp^|mZxU{3sRFG9nf%a9_ih8e+>`rd2gPt
z*(wll_g*t`a7z?_br=nO_0Ps6J!NGiMkwoyDw9xBuGSnrb(#^zGb%d$#t-_JEDjTI
zh1zxAzdJp1ux?*<;f1*AC5DQM$dqR^QBe}%;VN%M#3s9^ZW^uNV?4*h(;BIGgfMp#
zt&jKn^H{NjEy5>M?CSC|mji@x46}+{4EKr(owJjLuNbP1hFFq(A2|JZ?WhFfFSv&>
zGe6{JyWsxDYksp$qjNU5iC%Ym_C7{dIlUj1tRuFYdXA>t<^f<>>z3vmX=VJ-x(Y|z
zD;UM2Ou-T6(XA(kO1!>*?-pmt%i~3i-jd<R%?AYc7ISwUD*>Tc9W!h+;SqJ%B3z@6
zJSap&oH|okBgA1)d4@FJZI2q4Th(1c#t~6p4mh;5;x3dJ)SA%x12&nywAK~&d8ZJu
zs9thMLjvn8A>rkKG1H@iEx+XLt){~Jcx*Y^LPXql{kb|VhY;4Zuj{Ds5NpJk3J5%W
z#7b=^wQ%LF@b`;=2?7Qc6m#e>ijlW2JEr{eOjlp=);t+9nIe%;kyd(bElMLlVB0^)
zCRLFA(7p1_wWVdNDH}URCeq-HjN7Yr*D$`mx%Q0i)@{adx7hpq-GhS?^0sss<hpb1
zVXQubY}`2W*BfVbW-M&Bmsd744_LyEW~LXbX74`7U#eQB{`B3}ebtT~o4?|7Ny%G0
zhUl(H&M=IEg3EY)dCHgerHV|`r%(tlr3#08qQ5RH*pBDM`z{+@Q_qgkZ4>!aSq#sU
zT%*-cf2E`pt8Wj-b}$RmWTL$IhWqq1o{=$kO8QFu+_sFm*}}=rCEiLuzA~@lb!78k
zChO-i;(vBn)qjcbm8z=h5OTCin_WWxfqbVjn>n&2tuO-PKy%<KeJH;dP4>HHl?~@+
z23M3*Cw((1b!#huc~<?*(pAmVMpIR*9-hcf`aQfW^EFv&)n6x0_a1n+ztvvK!>t{k
z6s3>$Yq%R7oN;<q<2;T&RaUyOid_6|mrF}OM(f1))PR{}s3^9mm<NMqu{K!I_Y(Tp
z)E-v0g@oL}c|Qvv{r&TrUv#V$$7V{KJm~M@>dv3+2<7UDKfX@FGxP_3R?CK7s)&j9
zx%G1Wt=emIfM1_G+JInviX@NzuQS#s{(Nrmhf|!*WTbI)xUX(R&&kQ@9n#p;lpHkX
z8KziY`W`LH`~1kmI(iq=1rnu~s-u&h_%UxqMIZF^;J`tDE0U+hwolA4Y3H=%cq;HF
z>d1*2%afpd%%^E)W>|k;MrpW{)KB$O3roqk>A&SI85-Ku^O5z(loSB7;)v>ea-$}O
z@_<;E1z%G5;L2OE+x@}e_+txv{{Bg_R_jvH4qDhwdn}jTs%HZT|AlQF&L>wi4|@-L
z{BAy@F-}Zx6BYFE$;gnsck<U@XWQc-vT12eL#R8=8GhQ_wQ+ht_V?ZW&kS%E?_>;i
z@!wba8^Z*uLc#5%WM`8s-~IOuvUd0eprO}lpZ<mDFJTvR{(W`(*3FtH2}wy<wm1F-
zv%7jXYyN%3L<`d?V&CNayGAFEBi5#2+}FaY5;2Ot|BSfFA06FaOFjPQ?l^b;$6tUe
z+t}J-{%=<f2P+g6y#=DJ*J>V-6m_<)MIJ|9@Ijg_;)yl=8J@&+vG<cl<~sB7Z&bU5
z7O^3uLjHc1_esQ)cOWbBDErcv_B;3cY=VGy<K`H)C0DtH9qgDlwo1h7_mG)8@I<R;
zQ<9NAM@3qD#KyVX8Y5&Z_J*Ovie+%_apVY`eu-x7MHq(tR#_QeUp&;}NBV8Qqaz6!
znYicpn8|a_aOxgtj7r+s5pHe$>a&tSuQ4Yttl!(WZ#fdz&QaeNhTU@R2lg~)yB+pD
z!Tiq3iaJ@Ow6{Eui?QzPZ@I*mm6wJG7T@e$@DoYmG#w)+Kd{|&Ud64N=uzMbQ|f?4
zABXlFSv%j^p!*>I?VBltC6KkNlC5?7G;uAy94TaKdQC|w_tHppX2%;fwQKh%$S{vo
z2L`atR;mYg0%IcUN*6rNvRsCFPi>yOdE@iY=c?=JiW2Xu{gFc4ibFjrjEO@DV&J(=
zKJq2!M+_=Fc=V{KPdy*K(jmbYEkM*1RZ>zSJ9w6oaobl;ZmT8QrKHTmE;O;h=>4F#
z^;_XbsvL(qq>}fDOy|ZYM)9nULwl4GeBWXTeLn?}J1^)V7t*1BiRxCZKMoGSaq#sJ
zoLYa}L?@#P>A@~<-f$3NCCx76TQ^}rc|9dP{gNh7lt9s3lu}Y^@!z)MA;yL<RnZa%
z{EJ@G-dcTQLywe(U(?JJKECMuWQhjN=iMVCtyOVP%gW1zMMVB=U=zKMh=`z~qHkQX
z(aL@IklRf4og(YT>aNB4X+$U&Yp`)v7)Px3xO0Axe7f&u{k@R)&u?cvKp3$y+nHRX
zqS9Ya@osN_xVK>*m)rBbZNQq((aP$+u&{JcPyxJ^wIyFMvMuh-%Hb6DP8h54>=G^d
zK+TGZUigb(WbeA$uhDBQ5zrXe+x)yUk-wjjTKZK#+9f!ud{2ulB9!0$D#GoUn)cV*
zaFr2<<*<;U!t(1ONFQ>h0Fu#7b5)yK!cjB!uIhrw0f2NpOFGkEED5<(Yi0e;KL!NU
z@$5GDVT>O2ZS3?j!^l<X20C`Nt~U?br)G$p4v?}8lPE_jdfxh!jG8|h@a*TgT*@=y
zy%hicel{t^iJAiI?b5@>m2ZB2b8EQiDOss?CTv^1>E`cQ@Jpw+Z{@zZ_Nq1R_{?)T
zoC|VKgxYa-t?}-ma|No?GsD3R6Vs=|n<%gYg*c-*l%?42S@x;eT~_fXV*asBD(_Iq
zS7qISDAhb`cb(`fUoX4mehthRw7}(K5{FZDyy~J|&5vnlyh!Kf?ynEmm2AzVrl*tI
zPYVFuW>y?=bmT}eJKrm%At`KWY4N@g*dIYXy?~&g`r1p^p7A;SL~l3jX)&_p5%bmJ
zwl}u6tSA&JAu$o1)PdD%+DKsG3i<9Tt&IP9Wx~iP_J}_^tyKglB$7dllj`$w&}h<E
z9d?XP8h3Q4@u2#NMMRW09ZvxSRiQFf@#qOVAbhNjA+OhXF|0Qkusqk7pokZ2$g?*m
z1^xF84E8Y_w)2A~bs#lL_C~(bs&a&zB8@(*msUDdy8iG|Y3{^238SSmotyHs*DMUr
zRqp8T=LqGrCId#|{^RF5AYkVIT`?+QVnWu_qc?&a8+G21qY%G&E*^HaY-nt42^PBP
zP%&yh!SjorPVab6IjcmAR#BA^&s~(Eqjqg?`)H-1awM9E^XuZ`bv%ageq$Bqim&F*
z+85o9k!B#e)Eh04<+efxgIO_f$`bHs;ac<cQ&Mg_+`Eq+)fTOlJDHrf&2;6$Q>C*G
z2ZP&VxIZI8s+;)F4)HPCCLCi1R@ipx2(qS<NSp~G=<s9MbFTNcVh?TsV)@DS^lP@d
zC8H;nV)uw%)6(iwdiq}nCGXPGj7xVAqHl$T|KJgQjjz1qKAUivB9hf(r0gm%QlAUS
z$jQ5VdRmg`xO0Z%LhU5@R@lvE;Q8APYkQmf3+jo59TM8Ix4QVMgR1%Wslmu<XDH`=
z>vWhbODf`;SgZ22aQ*mE7cp)zM2ZgoCOt9gIdAg+VI-J9)-&4MT84>y7!l~xHaETG
zR>2dyzn4|MJ{?khqMJj>G0Mfw4Lz2NTQGbB7)wUWX#qm4Yfg3>6l`ooP0LgFD8--B
z(fLpv9s<(DCm`5z;PED6_s#F*x)sqO2y6_NC#i#&kr6c~C#P6*M}rC5j0Fck^#f<V
zPR@N*XiN+X3PI>+4#x`x#>7afsuF^-7FtAdGOg5P`(6Un-&xRq&qTD+qE?jg#pO8s
zpx7;<xwtCWt3m6}3g)g<_4(QR<rVG=z`0r}WbueeOW(V5-2xy62O;s<f*T(NRf~wg
z7aUL0=L=k%!y*uGB=qh5uB2*dlYV^BZChGFMxm@!T@^4gQnP<_xUg@zC`AByhh}bQ
zO6pS03M%lYh0*-Zo}%A?5e0RtcimL&%$9#J?mfaXLad#IYl65H`{TcJ3Me6dS|!P1
zTU<|$+qbWq_q$NCupYw**%UVa9%P=XmoCrunT?kPT51c)D%#V&%~C4<N^&}h)bYLD
z?&7?=r5_f+{_*RB&iC`XsjxWeE~i9saTzCPXWWbtVv+pjSI-?>sn}Flwk&gLD=e^J
z_{`y9Cja!GTYCE`hGL!1Tz5~+^Nqy2#uIyn!^A?L|H?$#Sx&f(`8M2bku*=AtK3Iy
zR<2~t2fOjLX4;?pdZ@xueZ0otsJ3FCb;t#|4j7?R#o5%d55~z^6}Rv=KW&+HhqKLU
zH{G2<q7&qRVn9%+J5@t7QSn&4S9V2<HA97jaeCC3FZbMtlk+G!czL5nzyJ0;_I)ef
zAS3gsZEm?x(quJP{j9n9Z8$yw)FJ-I(!k6&Uk&#T9j2+BLjx0o8Xczhg~}I>)DBwz
z6#+DnQ#P~Th}?6v0m13%UG?y+-u%NS=<`FjGqQd1=jg<V9-Ab;S~FA$&<sB6T{CFw
zf9-UUG^A$}PnNB0mn_Du60i9ZMb!AP<5?W9r8`zchvRqDe{V4vQ?6rhWdsJ?j@a1(
zO_0_%3g+ocULqB0+{}*=kFOl-=yKh|nQ0{d>EGk@(1~ML5uHl3NAm^%sd~NUaKUf7
z;laM=+9)HVKj@{U)Xe}Gp%Iim6Yv@)MVk!N)+|HBnAR=AO|Qg+gknA0?>_q8frnXR
z3yz;u=3*VIz68G~K^3x-vV1?+^w_M(bVB^KHZ%K#1Fw%bT>=@U))C9<tas-$!v5^?
zj(+qO7o+{Cu*PR{CZ>mJ-h!mWlKZi~_N5mq)fGfzDd~^;p7fdR=gR-;laa;v=7Z^c
zbxdPZf0vDwb;_#r`NP{m_hEYcqmh{{&BI+~HTnlQ{{H=PihV;vZ(qK=@LgCq=vUC?
zg&UWiEHpzSYlS+4Yc<K|+86rz`pwECNMve8h7LrA;o;$-H9NlHLK+jq$mr_j$Mp1h
zO)Jd$dfkKbaXC4FHMr;I?C=SqPG%_=oE^nKo&qz1C%UMQEg8;oa3v1|nDE+hIlm^)
zVUv0TmPxy7RqSJ9$@`YlF`3tVU6Rz)J|FKeNukq&0-GoYbSno=&z(i7@bK_I<MSt_
zeHR>-HyC!-ozg!XkNIH?m1l=W_9&6nH%Y6>Hhl}yVd|AlP04t_c0`9!QL$?}es00b
zesWywFu%orQA$SHw?#*1uie_v#AwRD`s{PzO7UhlspL-f#1Rg}PEy=~)suwl?%0Z^
zlVic@K%3Nt^C?&Q+mGMc%~~7J_bVPh{npqxPi#A}f9!cMbI#W}wS5y$o#jCw)n@Q_
z-#nRu>d?eCg}>LFi8%|;qJI!9&suTVd5w@3>-K*u?meKQ+PbXK0u)6NOk@F-q(qS%
zOGQDDAd)jml$=X4h=PiMg5)Ggkc{LEq9T%WP7;b7BvXX94t}>^|K0t@KmO6L-*b#R
zu25ywIcM*^_S$pJHD`nNK@To-Fqh1W3M+Sf%=2)WNPOE=OhI)2DoUv}PS!}}3}80O
zy<JLLy){+tOsI>CB7z^cpveeV?L6jvB0|7gw-1Yladd145PJgcSLfY|O)_29{r!8Q
zAy)8xPme0~+`Lact+2z%>e1G5g~RyZ;5$-MCzwNCzxZ}no09?>zxQK=^zWLP-O$Hi
zFiNVL)OP5tQ~^rp{2{<{u@TJJ*JjpI3*Br>+V96sRQ>sd*OQYoSw0%u6wHJru-UfJ
zvT;>b9uptTZ(W*dVA-;n&!Ycgt#?5xu&=*TWW}TM&_f6i?H+@3X{2a&>@bF4H0kSC
zNhD2##QzcrCb!=H@L+oE(gggLo&17Q>ZgvrnaSR2-TGln&gsU&t<-84l${;EKxG&Q
z+xX|yP1M6j9S}%TN=y9(M%j(FmIzT0;+p_tU&RrO?+;^0SKFn$g+>R9dsln3QYuFd
zi})#KXElj5Vf!|`42SXOgNx#;@;<y)3#JGAW!AZSS)|V<a}M<(BP=NDcRoyV)OKsv
z_9&lm3gggg@F7JL-J1UCkX^nx@9neif$Ym0*e$|h_vPITyzPdd!`Sy!pWRB#7}!*^
zuZUS58!bPGzAGvD#b}VT$9jmc#y{uSo$(J9+LA^_P>0)T9F41+C0@ToyQmT9Uub(!
zQS((vQBn00ZR{m>p>HsuOXtkPk3)*D#y%M$hC^m|$XWXO<7*~Q^6tWivWQJDi63;G
zPEHNbKNzCY#%1Ne3x5FmwCF2{-MfBaXS3Qp;JWh#_01lfV62X^ka>TZB}GQBB_aNm
zeN!=aq0n)PlfEMpfa+hMq496U8vL1TP-iCxE!4hhPc$~hl@n!|m6fScNe#>0#YLEi
zhzMSuo10TFcH%%uOH1?e@hNIP>cH*<NHS0{NIg<fxu>E6e2a5eT;GH!J%Tc>MgOH|
z%K$cTQxY!><@v<K#L(e9;#lSasV+RzRs$5ze%g>wZwpsDzLIMwJyyZZea;OlQa^pY
zH8#2-ijT}<Kslh@6u~p!zNJKlx7Npd%dt7C#%=Yw(xaa(fpt@V{`~fb8WR5azG<tS
zwl?F_r~H7qJ+G$~JX`WK-&{=$=%;%temk-;5#M~zr~szkl&w>5B@=ThG&Im-UT8k^
z?w2o5`ty=F`&@N(tx`YzxD6*i>k3<o)eJbn=<`xX2ylgDgPTB=%jFWw(JJQ6Mf0m7
zB7x7JpR37puAitUU2twg;(J|eEq(S<0^UIGQyO~{1yb|q#l=OIk*8-t62XPt_#%lE
z#nnG9?of7o^5o7|Ux~IAWag^#dB<G=)Pb<wlFhkt!A?FC)^1W#NMBz_JhpFf<ImuC
z(kIrKm2%hRnS9mwRw)yc(cTVvzoZF!+AWP#;XMz!*w|Q$;V&<R?6JRBpTScXo8GxI
zCSso7e}g)pWY`My;d9)@Gcqzx2i12PSlM2K`Xvlxld-+cxlG^<>EdE%+!FTI;_qeZ
z>eNb*>fCj37}NL}8%rn4%ph+f01SX{cg=qqEIJ9~<t5a)mZ+$S+=vc<1KY}Eh%0QR
z7TM+5%irq)v8&r9JJX><&RAkQd-Q1A!b3>HYmeuDotnX}rlNKF%uUPSAaTDWc4joe
z$C35R`0F$Prh%5F)Kk=8xFE2t!CrZIj)u%=(SA@-GKrggoI-y!7@fZsQi;;WEgv@c
zc&dNfwiT+}<e|n@haJ3N*u!s%76>{+!|(R^>+&iwp+x*z1G@ZH&n@+=p0PXX`$7jX
z1VlYPtIgKaU+hi90MfEsEcCut9Y{D{HN8dWScb2u66$l$zvqOf0QDKSDK-Oz#!}pc
zr4{qya*fKe=k$A*^~Rx?dDqYj;0L&P%DMBtU8Gf8)_aX=<oJM^F`GE_oK@>827wH2
z>ye5C&Llr*Wq`O@M=e@?4MLeeMQc*}FWcX-e)o-yi7~@`A=A@Ps=Eq^?-fB(=Z|kC
zC4!{H+|NbI5-wG_l0#iXLI<hh{0#T?z2#@a>UYcEO)=&*o(^2aUHMp^$0rL^z5lJE
zBk|FwPe~yS-v8?7%16MbO8n41cfydLU;TX8dDax!C;<ikU&=iH_OJhU^`QT`H;%tO
z3BnrA|J0g<3}UZG&cpAZCGQ`E>?hT{Y=gGRT|_|bu9Q?fH--s$1b6RNooq7Zfg*5(
z?56}yCia$yZ>BdRU%h$rPo3%R<mtJ$GkAY5{+!Uc|GL)oKX-5cWtpu>Lg!Y=vr1h+
zABKmA{|+$>5ml`P{{<?l*A0f$bC16MhRfar$ll3`b?<K_?}Z`;BLE8=jy*^B`U<t+
zRPOh$;@f+kp2*<RmRG3ExTCrw)bFu>AKB5(eTncg`-ckv0NVds&!JYd>$uxFXXJuz
ze}!}3Kj7k@;|X;CR#ogG*khV@DhCK638*HJ2Sd#;SDjr#=U-EkA{ZbrAQl{M2OXlu
zfDw$1GS5y(O7bB%L4vyB{AcpYnJB2efuh0}&;ZgMoNkG2#8j=(CMG4F=$@VhQ}6-J
z^o)$xZ{HgJ`f&ZRwcgRpK)6j;w)YQo(ZB>*@jTq}M6qjpd9l8}e&zF-G3X7#P6VMz
zN-d%J2j~d4ASFSZ-rQ;Hj$mnv#iKu-<gGxX$;-<9hrIFSEX}Wx$M}9+*50ey5KznK
z<GrT5e>&q2K7jI41Sm~~08bJ{LNDI*NiN#=OA{Aac;h`SEgHHYle7m%%kI6>eX$yX
zT;QRA&cw#pGPp)xq|kkKCEuj=Q(<8!a3KQWe#h)eDMg&v)qv|~^J*C=5ze4l1BtoY
zqPgA#Fe0bG=Y4W|+79F!6oKI4x?Cw`V8Gz)?Cf@k8?86a-_U6M70Tv=9(BgX!u#-V
zKu;PuhvpFz1_k{aEztjQot@oqwj%|#w}(ZO7VZ0?_wZ6X8$j;>Ak~x3?m(Vn*D1T0
z(fv!UdRIj?Q~kEBEjO?pwOtnr-_nYZdlip*M1zJ54`>5el}?eP=H};pDk}trYzTlv
zYcW)E?&PtS6ZCHHGIFY-K(y;+MN42H3DRZFZ#DE2`uJZ%=$xtN(}$MXh5pLurKP1Y
zbE4O;!5mAUchlWEEukt7l$SWwbG-nzgp!rb$olN#9Pn%2_vp#gZ7%KnG(I<Xs>fAW
z=n@@ln=q$RH!6@__o}-hip~o}i(nis?NtJq3Ix)4jDB5Q0>KSBF+X67L%oz>$gYv2
zDT3Q4EQ}l)?@`+@iWi5hfx>o4&;|u1h>60M7J1~Kh?@&J%$!9*k5lc6t1_fL@SHD_
zktyowk>0Ymw_k~vm>+`lNIX6WdM5z@k<cAYQ%rhZzXbi1^_#fm>UhxW@&l@G;3c82
z2@-y$W@e|BCLDx)>V+?n0DboX{IS8Y#Jhb3#j!pUlvAm;MgNzVz*UcfYeV$G&eGG5
zVsSUsb#!zV21-Lpwx2O8!~r?>)925x6DwV>v$D=%0>2#cpy|<u2mU{nw=OKrjXX<=
zI75>jfkyl1xLdl#<MwA225&?X0|h$2&Ta%!Uq?q;C>CD~+e8+M;WqNnfH!}ZhNkg?
zf+*fGmq+z)sp>$=<RWqCC~jm6@TPGfS|`IS^@M&jcyvipB7oCqLtj_L!R|a9_5kaF
zr=;z%Glfi@^5GVs2Cv}uDT#e`9UYFSBzQktT1Yg^ot*fAKn=hJ;8pT-yFksS8)AXe
zF)~-6?LOC}l@4_Pjl*_ZkhRZTLL{a%${enn_heqVdi6Od5I`Zl4|@Rl=iY(|nqUmb
z{|Rti$aH(pAVo6c#_~v2^G&V(*g`(g*fs+xxu4rk)OQ}tx(@a9`~b8PU~V|-z<5a}
zf7<LfwzubD`u-jAFn03O2K509K+enER#PF940&DDqY6_hBKQbxf|DQ2$pK9*pv1r;
z2y4n@N0EevDr#uF9$jV;5{d-iT*8BElZ>prukYk7z^9Iz#M6dtrEx)bJ+A;pQD<=m
zQ#~}q2&z*8jlY`(9%vNKom3FD)%dw}8ySYlyBEDq)R+|p!*tmbV`4fEu$ZFaxw9wz
zfV%=^8*U(cAe|NqP9kJvWMTuQAZgP8q{EC1e_-tsc@0{X2Xu8QFF3i{q}i#dQCI^x
zDHpqKdInaj>&jM@?=kwrvd&r2&+{T93ZA=4An4Et;)WUprsv@EK<R`u&Hd!De2^x%
zd;=p?7=PJ$PaGP6NdaaPg{J(yu@mSq=&Im>4h_l`XIw{nyLYqkJYSd4eCNvShRcp&
zFDLLc8X6muva<u>Q5paEzR^GZAK_sIK=?SrPXkO1PY71ihtSZxoU~Vw`Np<T`Y<tJ
zfi6>EFG91LtcxU}qoX5S7|%_fkdi)igbN16hd;~;OSUa=jD@H}CEy_nNx}jfYhwDB
zo0N%YuK3ngpo)KS**JHJgp@(@uKi-+h3nTSYXOxJ-I+vC=p8Ts8Q;Qb<X(<$<ZP^k
zGeh)fCY-*A*#shqVMbqj^ay{glLo+v{pFVzDT<M#pPwUkKBu+r3HP|2v-81@yTzcY
zPyK|!<WEXCUTm+$Qy}@I>lWdigZ~B1j_YzfO5RoyQEul0NoFmdJ{^BAMK@bm34iLB
zr6i_SgRTivpJHHeZ3$uL<Rl@v;(O~dZ=~$E@82I64??#Fk%khi{1q$=EZn|e#Dlrc
znf4?fv_ixUZx9#&>Rr%Ie(Lk@PsRa?{c6F#RzpB)16p!<4znF09<oZ1FDUMdvZhyM
zlf<{y7p%1~z#=;L`7<2kqRIva#Df~?#Dx1KhUqAzAf5%Oq_xHglL5)Gp!r8pme%aj
z(kDQ3=Qp14M*eJUG`K5s3iAIq3{tQB{ZISu!;YQ)>z6K;my#GrUa~SWryw^02{2@3
z3!|zxRIejdV+x9ff~QX{Ms@2YNG)NLn|>EdTSC;<(Q)rdBAH)Zb0gO>3mcoSbVzVR
zvs_|+rv&8SKO|W=d-Jx&ay<86yg4NTuzZ*=Aq$Ow>iEWP$?T_m=jBR?Og%kmGc(>0
zW~O{w12VcGQYfr#jiP1U-C0odZf8qYgWu_^9C4Q3-&RD46OsELPwkYpv%9IL<EWCe
z2>TfUo$sCokU<$47?SEsQAkoUxCj%ny{)b0)j5XeI7qz+)n3tYKe>B@m)_B#q^NP~
zD|YQndK{3U^}W#4RdCid&KDBAw6QJpBP%P*$E+Hyn?sS)`v4|4#K)51r4W)D)eJtt
zuAOJF+3|Mu`qX+g7|yjPS@B2PmTJ2b>IV%r|2RVfp|a8?4CI1W@&#Q8kU$Fo%4w;u
zHak`X0*;}f;f<?&WW|F4owJ4;=_<ASch2DWqMI+$i~bz>`Zbs2v~Dry*`noA6HX!`
za@CydF{q1wd8*`i1I5Cu2}CIhgdUUQSsCa!&l(9e4H|29l>XGOx{CFV1O4dGP`K^F
z;0V){>};Ox-9TDLAmylL3chGJ9Xr5bAM?`)9qzHmxn`e?=6L=e@YKh=W+w}f0|s#%
z{tDKHcgD!r80w36l$0*)#J9|9L(e~WSpy;RCUnNPc2_}U2KkWFrHgt8Q+k3nW2m#w
zbeFS=M*wi=KXc}c=-x_Qt-dRWq!O%CnpFVrIlJPI3<ydIe1y35XR5Ij)S-mnpW(Jn
z+>wKl@vW7}T9}Anbqj2`*7S+zgSQ5jTOqS+0kxLzknA7<E-#N|be`e@%>zitU_Bw{
z!Fh=Kly4<LX(Vme;b5^{zkhgG?#ZJ^Kkw!IS3qXT{<cA2%LKG!!XetYCF*746lj&b
z0gn2k&JH+QGeU{`Iu|K$TIAGTU0H+=2M*?^)(D7^2J>MYEc+wJviVlTzNiQKI<2KT
zUYc)~lO?XOwzc(+KBuCx-%7MJbJA@INV^tAH32VQo|X!UqAs~IX6KxzE*l~1y(I#$
zNBL6J>;6k6kv6=euA)`?I!76gPXbExRz0bf?iWKM=tJT|{sSFQ)Y*tenhO^$5DS2E
zhS>9N{q^3E@c8)Fw^Tg9ENA23;246`v2v42%!M~x+m6V_LY}RrBjthfM1a7Z%>&=E
zstH%LTDEorY^-e)eXtPcYu9Kups9=w{O*>8+{EdTeZ@xC))SGiqH~@+$1EFB10p6A
z#KSD+kRkwVoDUr{P;xdX)D(K8D-Y~Y*b?RL+`&gd``KF>0nWbpSlH~eZRVa?g`XC5
z;u(9WL1n|fz3V0p*}Sxz+!Xu_w0UR%E3zDZ!@=we%1e?#baIX=2#*gMjWjhiZG>ZC
z^F(OZfSO3xH+TEi$eoC8_H8y!DlMgg74Lu!YNt+n{#+RWDQiy@^H^$9TUYCxs_FXt
z8JYlyZ$atkK{(yy%6JXt;Q8r0IWz9c^75iE6q=f4_vHeB$+`mcCU|SpcZwjW`W=Jz
z0O!f~I>5os1xTqJBd{`)6b^NuS8q=3Ic_ZEyCMkJh)!#>fPzs+@}x&AhzCQ_M|nHU
zRLtiR{jH#bnAq6n?Nx87D#$xPGzlT4gF+Dl922(Ps`R&;TU)Updqk~_^P#G80YO<?
zQ1J2{ayr<-u0fTbwNDr7Wl-qc@{zD}7pF%wzigIlJ$o?~R6NG(r>Y^Q9n+ud`rH&N
zB2dzdU9+79>UX*&P#eB|r;SAqbeIROn{en=#emGzD-ftSV#w!;QvPK}kF7r2em2P8
zlcQA+85Lz{tQ^p+C6nI2kBn4SRnB#4rY4~itVvt2fCpah`G^pI`LUhMDc~4zL<{6w
zEo#a#Uw}aaHKb#kJd{W=d1Jl@b~EHA;ZuO$2vr>Y;ekSnk%HGHC4#}h!4dDG{XwAs
zS5Kes+{p}^TF&uY6!aVbuj@xtcgFRhd_Nd$Y8vY2Yn^8Z3F1w1SBk5}-oq+UQt57a
zz_rK%oHE#;8Gzqp-gC@Xs=i+98E)|=fOAiJGT%4FM)xNLw6w&D?f;8r4Yb1wC=x+L
zdj+)}&Wanki8~y{vQROSJ$0I9yB@vyNPFn3QFs8+=4MN5^y}|Wo^*aP<G0Rc=IaI>
zuO@7XFmj}$$|gSO+&kNOCc20lv$>vI<eYe!PraT?dtHOXj{wepva+%^bm_hGDP?6*
zaHN114xjNq%JZ<T78Qj-Zw8>D(h3U8_Ewpr%c=0IzP>(>d69!%Xq){CJ)mc5ARWIA
zdpIbF7#bOEXcnBtuXCWGL26`6#eqdd{70vsyohFZ(mU7K*(agF5$WN1GE(8ZUrEN2
zlAj;4v}6VPRIbCXY|4jWKZ9@Vw9b-pba2qmQwMf-ZD}K9yvlGq8FF3&;V*<bA_$z1
z+Hso~ZfMBr#pAi2O<ca1)9c?kOYD)2L{IjxcLFMb@fXA&E-u1{yLyhCJy{CcJCu)r
zxb5f|8__ID=kCA)BstJF4L|0`O+RJlyt=bjt2;cg<K_X0nXPR?>(k=$*8u@-N$-&4
zS3ciH_MYenwD7YeUTO2W2v^B=D@vAGGGNYg8;h{A8-D$o<8CVDBJ@e9Pt<fLa&(sh
zGf5BE#|#V%3fnQdKDB2r>AGFLz#?x5s>E07oCNP}<x@Kt8cu#}@!Xq83e?*^h2Kjz
z#}xp3m3aJX(Rb0;K?S_tBOWv3uD5%t8r9w|MqjU@Iq)NxDcYx6&#6B`cbsAdLz2^O
zI>WPvzi)K`8S~j7{9L!kXOinT8ZTeDf~SX0I@Q8BQO{ztHJop1ZXXgI-N$wrp-{ad
zPT^sA{PX(z@bG$Ql{ncppC^9P2Gps))z_0cQl&Qc<q^z}Qy`xyG<?x3MFDIUpo56m
zk?JU}Uwxc_y7U#RaqTY;`fgPpZ}w5k*8ekM`+oysNu+)LO!e;>Xh%f0|G)_sd;u+A
zfaM^Aa`*06Sv<jGLG?UcOvnuZS{rd4<=58NC)mYAOaquOurqwih>=@3M@4wi%g<-Y
zia0APHFF2*@417+@$-Gv2OAgYp6Ne`VEao+o0S9Z4&clQoLAh+%5GSW26Aw5ZMzDV
zYU>_s*IQN`9*nm-x<UNi*<tvq8S?jAuT3X#j`?4MjB3Hsqr~ipcWY~qFQl#evUh%J
z*IMuU^EDH^T-!A#U5#D-DXDbS_CU3E)0xqI@(1BrW3glz_vK|imaN}6uEd;IZbRRh
zN@mkbd+1$1G5%d`#ISonuAs1xXEEmb-VAP(nUC+dPp7o3CiTc{C%53GzUijg@W|I|
zp=yLGI4OGC@yacdcHm+&Gvfn8IVni@j(LVZX5>17es8u5G}b_g*zP--0iHV05Q4;6
zO`0N(F)PSVXBEq=K65*Q!|i^TZjGGb<rjYame+QF!?|{Ce~PQTue|uZ?ZkOd$cju(
zzGhYO_!O|r@K-hmjevnk#TgzR6Y~uC3kVy$Xs|_OwpIFQh+4Gg@JIkFV_2{Zq<k+6
z%voS%8x2KRXmbiEh_5}e!M%UODruZ-i#sfTuhH2$o}xDT)ykR$ic%`wg#{wQz+2XD
zEQ&=q?gJZIpFd}reE-FVFy_fQBN`oh_t*w8<aW!;bl;Y@CW781CZ(N}Wk!|dlswO7
ziNB;g3>OB_g<pf=WRF%V_v1U~#pCI{fGi7g<aB$^kYWN+_WV#>oK@Y#Y95r%xvJf~
zpviS*XV1am7&(;)lw4$)2`nwM>9Dd2#X#~^Qt$gY*>Jt9+cEdaz00P(U4rUm>z7fT
zpHdW6d!R+`3P&@4U(nIL-}ObB9^k~=H^?4w^L_HSV_&3<?69rY({CENlJh=ChV}5H
zjGG0+o8CXoR4?^?lTMA2k!g&y9qC7Dd(7g0isg9;H0LT@tTpPP(qPSLE-n_<Uos}C
zA)ltnfgLXBQ1Tp@HK?~QUq<j-|JWEDJ-<4WbmJ#kcC#@9bBK3Y8A+V;r?Xy2Hhr0k
zD-wO^d<7M*8&wygpxa^)r1PfT6s14iMEoOA4yE6oC<NUrJkASw4<G|S?lqs?Xz=U9
zNL@SyJ0+Ru0s3%F`{qrH4`GDUH*$1!@M>T`nwpMIz3J(p8f5VIc6T8*rfRroUf%ou
z<CqIOH22Wb#tt1c;_~iE*$)@$rB)@p4(^DvH)}SAEf~-I!*QQ0Hltsc*V+e+S+0l&
zMnssRI5lt3JV<`|?Zx&joc;8e+ag~X1?RW$5FhmQrw=!xWC=a?CO*6E*>b#md1j$c
zu^tWs>>76B0Af($YfuE$_nOc^Y6SEO+Ae22AZY@LARxK0o6O>L&Eh7$H=Ws0G<fg*
z5Ew4}THAh|s>(fWLme_Ij<kh^XD%+X5$apF-!3cDhB74Zm6_Ps2+D`?Zar?tlWD}4
zc)LY^?K>%~MkN)U)3>BGgzQ259!N_sgr0K?^$T8#t=Qcap%j<<bWkE###MUktz=nF
z*&F>Qw3o|=o9jrIfoT9rqgWnblc6{`yuTM@_SA@d0Or`U{f#HU;`$cM<gF5mSx8GN
z8}RO(H|hTptiQ~0>)t&PII2EWC7<a>*h7Wp1cM+#hY#JDF9!xl;EZouTJa%#5Kck2
z6qb{MmVQ^^_`f)sH-F3qK~MPO%e8^>gOe`BCV%mAUqEO7z0mxy=0Rw{TVzIws~38o
zo^Jj9i;etGj|lxAf4%*<{L_D4z4`LzM>N~&vobvOYFnCcZC*IR`d8lb7RrScJdUZ}
zKhD6@p<ZTjFIQkY*dJ?<_riq9yc&HY9s{c?Q=4igw565)ww2XKmVV&Rd3umTCmN_H
zr2xKeGZi|4f@Py`<FO1aWkA3$9eb`wNt|o+;0(0nlZ&<@zr7a;H>3#Cbtk``AT5H|
z<Z=VxQEg8P*q7p#G(hrFh>wr<Egh|tv-7rJ=Fz71GqQdR9c3dQ@^3j$|Huek&!(o9
zmNbCJ=FtS>4umc$Nr{<0;yu{4aT|xT6aw1`KUjc_08s8ROH0n+;LM2T$`d3d!@3o^
zXhp@;gE&~$KddkltJ}{u`zw`Ii`ITJgzMitla0|jdc1_3{QMOf6Uv5l7ZhPy$*0=i
zhqES8l@wLL52f=Sc;_z=IHr7(+$vQtOrHG^Bl3YIuCESyM`}m8N*Se&N_LQ9+{aU|
za`0GB!vFP4b9U}e@cYLMZ1Y{mJdY-<P(Dzl-$g{g&UPPdQFQXpnk!oTZ-h-oYaSOq
zma(x$dhcI5EEh9`9e|(yDZQLK>U*ltUH*rKjr2XS|J}yxo<nT|ket7Tte=OYBeC^T
zDx)}hPm?g&%~*EETPM$6UbuWM`c*-<nWed9mP&eI^`NSCrP`n-h{Gm!&xe}RcbhFb
zX1J1N6slY#yIqv~;QUo-^)JED0nQxKU})^&`IhQ+<Snlk`qLY3qJM1cdX|NVoVUf}
zm$zI|D4)0g5?w!iOrJjD*paBWB;5#sTiA`f9<`8m(@RUtAOL`(WK{NYzr2q8wdSV;
zYSUXf7x}yX<P{XIt-oJrNDlcCMSSxI{M^+AsY>#=6=4hBfv{8bW8@Xe*J&sMhPNQ0
zKe$M@Wc>C%XSf!<r*?W6InG7^kugg3K9x&aTU%Q<{31U+yXtlxcl%9B!e!@I%{|w(
zQgyi7-}^W<*~^W16TtCrK7YuR*KGDB1&M^esQ7TXnqqr<6z|gxuOdwO@W2=6{OOkH
zRNyy*-c+n-?Qw~rU$yOBUDy4;r@cG7rXd6@#GWX=6MRk<FRn6hm`ueW7bpr(03off
zZ!4g;qDbgCgWL7nhA|^IGp~Snv?>}mrQ<R-GHTkg@RVRAC-I9Wp@f$t3)8mtVVAw9
zijh&F$Ki@6iK-HlG~VK(U37Es)Z{n=506p?$cTaZ*@?n4^{0u6yP7oeT{vi(P7s-d
zz{9|;9mc)x=paw|M6!S>OZlE1MV-;nX&^tZeYi@mRcNaCCA->Vth!u}Nvk-_d~pEe
zNeX+7O<Q8N@v=gagM-OI&(Dtj7D#=?kl^Q%0?Y)MBITEfAZh82_CGR<hncrFTgDe<
zo)UeTd4AmfA_c|_Z*rAI?;+S3ER|!`#CwD2!xOg^^L*OxlKM&9q$b-9iBFq<!!}tm
zO<k&R{y7g1PiSQ1XEq?f{=5Sw_7Bz7)#In&dwva9>j7=^5wrn8Bfhe>a&jpcKh&7S
zUl$eC2CQaoX-O4?Ha{5~-Va9X=?gMtK}rmyd45Ik%RzGo$a5;2n4}6@@*g?BlQ+ll
zNZr1D8%QIMmOvV1W(F?t6^Poj77Z*qf!59EtU?vAUIUgH=#GB<IDEQT3xqVaX~hQ8
zPtd8~{OI13&C&5mP6}jZ!mnMvJoceAGL9~(pdi6rpD*T#fe*;uWq$q2%qM^$c^1pK
zzth_P>*uS^00DWlRx`{$LF_p%cVI+FocFS~Tie(~qm{MFRTSTkSN8Dn^3Osh_{d2<
z4&>j#KKo-Ry6h48gOAkFn(KT1*4J1B^ft3OHSh^GI^(so{KGjOsi}qQx=!d=j+80&
zkVJn<R(L4=v^36h`WzW~*j$i8)n)0jjWC*xJ%3Ln4d)cAgB=;23XAvR&AYO#;)h@o
zlp1(3)KvD3$?u$n7*Vl}Aw52)CQ}ua-p`+k<kzN~+T;%HVy`mPZ5;STJ7lIyGKVNy
zS8T))6Z&wLJCxp$5Y?$)-XEq%UV=wjwiLDOlG8qAH(TjQvoT(;rK~oZR<LSN_$O-F
z?8o}`UBfk!%GDlM85*>tkrdmMLz%-OX?2p(gVu1y<6^sM_<AnVcqD%8-QA~37x@b<
zhpu6VO7};Wfm!|_xBw)Rubi%hp*2cLsSE?NUN(?ah4B@3n|TK%SjWkg$6y9?4P-Y!
z6%+U*QG!o{VOV7z$b5Jg0RrgP$jHde9PGY8OR~du+Z9?NH+9e$2&>Fj+HiDy6BMKd
zvX;=AuL2Y7?bFT=m@zNV2>uaBllsFKsQ~O)nBVrOvY@5?_4DVuZZj3o0Rqf`Fst#f
ze3{&=H`}0Wx$1jm7_dI^rY5`6l9IH@{S{|t+jqA-<5P#rGd_f?aY<|DPk$u#MR90;
z$mBNo+C4Io0xelr{OUeK8rJ4}#)$R$)AkByqO#df{pneY;1$2Dsur$PTg%L$5zH<<
zH)l6jeZZy^8#_#m7MF2$-iQ(vl0@VBW$#I98WxLe{PsWbAyx-;<E4qzbaecxRs&W+
zZMEQbDQUfkhU>wW=hn<jyXyXWDo<B`f0n?AVA|?LlEa|o8l!aQr|;Jpzh$1FAL_^U
zv1qbLA8uOPJ09+fe0X;@v5}Kz&m4r3wpn-0HoNyunOR!)if!%dY6zXUNNL(L;$B+W
zb2!SA!z#j}fZnSuE^t`I-=7!`TK}VW$SLizRT)(1Jjl6U9l!SweK;F*k(&Bycqh~6
z5A8Sq;Q~l&RzHp&*{v7;9`vS@EZkj=DP_vc>S<_m&*xXKZ0<?E$oQjPxKx7k1nHKf
zws-o4#Trb~dEAOJ@w~d-e2!*MpRN^w=ZB1{IcS!)JTf)Soo<dyXrgu9=s}|&s)b8%
zRqlpGX=$pAwk50Sx@sXmLIkM9DMX6imP}GiF`BB(wjK71UT<2<c@V71u9x{cIB7S?
z^-xW!G3cqX_FL-cs6tDeZc0jED5z(i<~nRH&)M(M>fWg#IF*(Wl2D{-Iau5%<hm)n
zj035&6sW~_Y7x;{fIce(mC7pM6oakMCxvh@_XMqH5MLV0`XhsAse%r5XjD`>@Qzi~
zR1ldp%df}eqIjhtgq<QGQFV1K$HXHNOtR6RxDD!Anfbv@5{vB{7)W1z`V>*@k14gs
zWhFC%1lM$?#+%mxDtD7p%`LRd=RXenlZs!1==kc#+nwLzEww%YznU`J)@PH}xejkC
z+1l35Ep0mFfgjkT?jEQ6!Tc82I(IixezjU}?`Z~5iwVmvE|P!}x`(5K;6<vZiUvuk
z9aQI^fQE$Pm%-TdjQN$gR>Pauu6|A2bn+vix9UokZfCt_+E(QrR}&qnks#)p&TFRp
zidp_GcsBYE4AMezhPD7_QxQ_ga^;FLzgF?UU^$FvW?-PzvY3#PLA@j>T;8AWAtU{@
z3R|TlK5LCQ@x2WUE?a>~I^$rCzd2q&$<t+y$-TtGpRx7XfR5`IzAKh7W@c3<gSCnl
zds;nq8JL1L-{$YH@#L7gNS47!CWDAuSmRWO)}eap*w|&U^%~lnQ~_l+4fvIN1B0i|
zoKZBqTY|iA&qr!KTFdj(R3rJOS?6{a_ildxy5kc^CENXpAIxlGVsfsV(=(XE4RZ~4
z@3JYi?%kOQj<WHxjP+@~!%QvfYQ4t^S9X_io`YD;oc(c3SNmh7sk}MeMggmlE7C4A
z7|b=+n|G906uKCK#IxYi9X3=(AIUm=cxy{Ie2@`u-W&}Q-1CPI?d`#3^6F%fx}o!)
zZNKM%eI$D4?)273$XdxQ=c^JLL?ow9bsRrUv8!#8r+yJUqd+VIOt>~(3LmO(Q(WPO
z7zm0JpbKjD)JoM>@%@lhG4RlG+}Z0Lcle`a=WI&51_oG*2ebOr6)<a{BC0#MaUR6L
z7A%BfTW-^*LXDcqudX{)#7;fJ#4cT@Jn(aJ^1Tq|d*(ZTxPy~jmo(BSbOk>)HJuW}
zEim1rtU9^m?Jenkh@1V@n9&;}M6^4_g`L^frYAS<;qnxcs^0BpscbR1am=*;3pXpL
zRnM<bswgyCT41<9S1OQq_P2k%S?8yu5qm9m$^FgZXi%R|DYbVGGD0h{m_x5qKzmPC
z+=+X$v)pg|X@-clVM6u9iK)yjET}#_>$wC;$u{~b{T+!D)zn=VERqsM$A$Ts2g+N_
zHk94iy}e<G-!tl9nlXH=Ef>sM;?Yv*9oy(lEV=1&mG<Irct+W-<nTHd8xkB!`b??N
zq`aRe9yx5$R)3g%uxuN9bEm1^MH8Q(vbI70#?SE?@s#~Vr`BiKkF5lnKe0NW%FC)K
z^P|qvvq+yJ-P$8A3vwmRS**fM#_&DRQPbnVEL;xcqPq&1WqMYY%B@>oAZN<wG$gpZ
zKfiSFdjyEipn>&yu8+IBx7Qr(Hr@ojR#beP02IxN!JYJlO$WWAev6UTs<K-kK2IzB
z>>(T#klY3|%OL|@`>12C6q0(AhKj1sd}pTpv1aK_3EXBkhzLqYMyi6geilodI#`#W
ztkWC?wZEvlRl7c$>!OVPv7-O|2O;>L{M0}B5L295|DvJG{!k1%ui?SJZKlxb=;-9)
z(K<L#cJUndv-}5JqF$zEbD-Nbnl}ea^T3z0O`MmPmw1;uoHLF~+T|dnde$e1e}11-
zG&G~)IfD#scw*YmlVD)co>rpH#PlPhB2h+*2lF8KU~?0<`^?~zhuuEu`fnaEe<mXj
zZ7}6E9pAA>hJYpBLj&G859!Ot<%2O3h|`c_8vGiG=aL>Md0H;6UajGTqZpqFX%;D1
zN|Fms9%?<cK5`;Ht*R<dt=w~~jeY|s6|eYIqf}M9LR~TmtH#VIcz@?a(99x6yo)~G
z?RIs^l$E2?fQq6<O5r^J%*y-o(s7{YQMCM?kwdVx(`cuiC9cy~;pWEBX>&&Dd=ojP
zdq$zK12|@;tHO4}dhOZ=#wm(Rn?)(OME}Xaz%cs}(b7jsC)~g-e*1BjZl&gfFm|eS
z+Zu@euo5BqM@KU`>xLNKpmZ47+W})dVTYM_m}-O2P_X<mv#?N>lJbMZ#IR5knuE#6
zXhCi)8}9o+ejeoV$v~(1cj8q@LOv%}XmhHKKE&FUf^sC;1sb;e{><Rtzi+$i+1z=K
z^}c6szbrir%JCf;In(A1!G>UDaPN)(>9FA?Wwr3sfZEzP6Puih;8gJY;u&_Cmn6H$
zn^su(K&$8(Ym$ZrpUc+po$fC6%KGM(>~4|ei@%KLRV94nfF?h)C_c=SEy$IFEZBxA
zI|xv6Sy?)oRc@J#vn?XUGw@$pVfWUv*;<Fh&9`)mL@Ch%;q!&PrwsEQGfGR9y1P{!
zG3D#ECzy68FDP`oj8;)sZt1?))LdZE##F>{P5?uTc*haM&E3cz;%z2WOTTFO_M*VH
z?4WFUc6f__rXf|Y=fgS?WCh*z@fMxEoVuB~<^94DXG|p>u2YXux*_R;<1pXo>cWB(
zk}X*6H@lBG3S?Hu1g|&hY3H;{ufpu{6W6Z3_nIilq3+i*+l?C!%eSVl+1KkzcSH$@
z)mpp!Fbt5EMzZRI<$g7zeCLA`rKw*oouf-X9sZ0t4z}Y*<%JS{ryoFu<EFE-_@JWK
z{<{%d!C^kW*kQ-$MKY=cB%A$yK5f`_Ym2%Z2iXK0_u~&pE^qE(^O8O6mgP`^&LC!~
z^X;tCdQwJp)-2Vm3$`-IDBm%?Lp4jx)xH2yCF!_#Bb{-b+#kl({>VNrM6;x}{sB42
z&nYSQlz47J{*(?1`{|jPvJDM!4N;KBLuHb+p>smtO*0C}m`LboG<fo)tF7&0;@3Oz
z*rm@WQ&Uo|qtSXIMb>H%f|{nQmcQ{)2OxPbY!EVU{K4k~%or|1L&kj|!HrBD|A|T2
zF=QuCN=))me%OW^f8RJo)YmFLPqk*nPqRL}EdNK<m4ZvYCyZlipmZ$)(pmsNz%xMB
z$cSU0qW^*yDV;?ZWE`i6xLtiVAxWN_QEc5d@~cb1jB<1hl@dh>a?8Yf%sJZt=2I$w
z>gjPpvQrM7sKk{OcueXbILQI;4kQ`PHzxJX=EM>Wf<{qH7^hr&ktG>q9}m?dG$28l
zn(mpcSUbPbqopUxd;OZ}!`rugegp<Ql#zK>J#XA{iK&5yZ7V?n?v->^wF)+iJsmIC
zT$x)01@2f~4qZXdhe7@D<$nU?Z-Y86lGJZRw6vE05su{qvzV7Jcb1GTi!lw0PHfj^
z{H@;cYo)^Z$09a180T-*Rc~La{Y6vcBAv(d@TKxt`QgJc0{~EZJx4LF)s~K>+Hk-;
z)Ra%I9Cp#f#lA@(sZKSAN<4Bnfr1$NP~*gg=4emPr?$3-RK&<R0|MbD_34EN7)&u3
z+ky9yf?!pzRq>WEbT^sAuRRc+-EnJx)d`f(l+gnx?@zL;6{?N14vl7xKTV0>b<ee>
zDP9pT=P537x-L58ra6vN?(Q9&v@7jy)9<{XV0fL6?-6DwPyZH9_!1|miMoLA6TV!W
zo69oiW=c|B!pF->Iks&kW`_rwVh7K{JT@}cc->uwKGK4i^fvfDt%O)RobtU&6Gu#@
zPyhS3?~*5ZfMgw!PyF}ueI^<<HV>=kU4U<Qo2WW?ee6&)dtu)>IN3b=P(W<+XJwRN
zf_1n-tB8#P*EbT!?NHDq4>JYEBUX7^OxH6+h4#>o=|=8h{LU)4Xk10d_wOjT%(Csp
zWeeH==JWJO)OF`mAQdlB4mRW^gtXKCOhSS?Tc?;ykr2&NsY&#uK(4aadUg#p<(;IV
z@7^6OH_sv`E^-bT<~;~3m;6u*J~^Dp2a~A++F6a&rFVi2`J+Dwa~efxIk<$eYb3(u
z5My|DDPv<qXB1jn$f~!$FNhC+Y~@3~R0_oN!B1l1hqEr311rpTssIVS&*DmKYR1<X
zd{zL`vJox2g}d=V=c9Md^Uhg(uu}7SZ^`K3ZESoIwoH_l-pA9tHu%bSU=Dh{_dzYx
z>0>;@PCi0jyD>C_ydRu203bvD@1^%IbGyBN#JDN`rFUI@>tB-D$MKIev}?G|dch~6
zP#)g@H^%mV`Vntmp)77j`j!(R|M13>fDcW4SMhE1^~Y=kjy_v5^L=osBoN=JVL=m7
zaVsz(ZyeLs2luA)=dUKU3l7OqU1VSenvmr26DLS9Jjm-PY}z?Ryd#0{F~k4K%l}VL
z;M2HOjlQjLECTajFk642Ka}J#(87na6d<<aR=++{o+Hx-nOmR*|8*oJPJ}u&6s3R8
zI*?$L2*1BNSp!*H-7pxO0B)BjDKkxd4lm*t7xE)<?B56S-@du$PfKWQI3W#y?{T|F
ziCh`XRg@QABL0zO`O0Z!FF)^LtMJCD;C54G7?OAKIpyVAfP@hG+$Q%o`q_$@5~8qI
z0ha?d_Xnrt5e{j@uNeG)7Iea+qcf!F-IasaedzaYh3h!=69plrR#J4%cY_gs3MlwW
zBmQ9kuJM9z-u|>e^=fH6=%7}Etb|Ok6%aUez?6!>%oPlA!HM7#JU_X3ah+g9DcKBM
zFu+OPWjfM?&>=?YeQ0P3IKBLSF$j(B%^<^F`!Svdxj4c%Fx$bbb@@yU)K4q%ZRF+U
za~9=6Q%yX}QirqGYpb!TsSBveTwvb@+WvDN1~6rWb~>qci+W54!n!eeh@AB{>s1u)
z23Yw)s06cTP$fr%ySK6%TUx>x;rP$W&%ap^cnIcc>Hr+3RvvyvJP|{|s42f6v^WPB
z5y9w>G3Mal3ykZzd^fN;@v+;hwa7rvIiIZ+gK_pk!&kth<^`Q|#2l-nL>(S9_^k#6
z1ejS_g)wqy7Tga;oJ<j0J@99MSAlYj_+)cdZU6R=_yPWTpdI`Pu@nOf;Nawrjz@?U
zq_E3++V6=8*OyClV0Hj*fgrLxoB<LDOpJ`C(B_6{ne(}<n`UVh%ZoTIyqlyl*#qML
zED$LkDJs541fF4!XpR->b*%u8TjasRaU!(eLKW1bvnw|>5y&7Iacu+bXz)Y>t`3+z
zh<5;a=0jXuwozl))0P+^_W?oA12?%i(b7>@ToX@g8fYOS-n@`86u9G@5EEI%hbvpB
zocHn9V?dCa^&u5U6v9CXkQ&qw=RrGNO;t4v@>wJ+l@4K^{Xt``40_0nPvMI8mqz13
zLLEtfK`ng|6WxjEGy5DrF5b%_c<A=>#S7wHp%aPVMhL2w!iUdK6IQf>5y^*l?>>T~
z;1m{X-hYqc%;VFzxh1F1d3j2!t9ACsz~8Vt>xIh$(QFtJ>0r<jMTF^fhvO+YwbQ1j
zjfam&WMEBOjW`4WDObmNDpWkkeWvXSa8|B^KXx!OBrv^3%d09XhD^4mfUGPH_In#1
zdSDF!99BfB8zdh}KphyA2fH#j8pFBNART~t;-caOdT`Z<N!Z9TErKXM*g$+;zyP!p
zJbK|Mo&NRf9qB)T2I2?QFtGA+kvCJ+Xn<6YD;NaNjw7!}5ZnZY3ltJ`SDY51)c`Ry
zgU^P`nzrl(32{j09l^g07U3^f(dgz+K)gf@88s_i3IW{24IkbG+Ri@!`TaY&jIjcq
z9`Qy{$B?kgPMAE{GrzIF7B5xc?wW!mNI*==8(jo_w}$|x%$H(0yY(+-YiTZ|f6ikS
z6Ps=#g|Ow7a}nPL4fZori-bU#%>qLvmvVG{eLWi|r#zfv5->PmbIT!;;&a^@-Ef-=
z3kx0uE8&QZ=}7Boa`rYbwb_84UmfTw9GQY?ErMBEFIog+P*s>Ch{<CksG=t)--UgY
zYkhOj+PpE00|^%poXEh-d2eq|7n_llwc+~>m{mIN8{KB6rfpi*m4H4ZAX523Vw>tY
z?!Xpu1iK=0uqYZRu}uQpXNK#<7_7hb(keujeVo*Drm$(s?z*rr;`}BfE4xrQWWjF^
z^F0b2bc!qor_Ug4v@URqO9Ty3@c+CG%ND5VzE%LWdTgQJ|9gn}@#DwtVM2(bX{8pl
zbVc2COa~<R%jRMyj8j)f2eL^N78hsa=PLn37scmV1cJekbt6-!XMh!Um~Y99auGLf
z!yISj<Ww~^O@k_((G5yoqdDd8-@hZ7B$`VB0tz5BEHRE1m(hA4YZ9CcO?u5SeCGGd
zW$Nqw(qQ`62NuTLlqV-Yl#8Vnxi+pA{O?K+ZDg0AMAi!H;xR-kh>44%)p`(HcUM8V
z^-M6FKi@M#v`_;HSTk$u@VfCf@a~2|WR(Wk<kCth39T@rG~%n?486+Ih}X&mASCWP
z!6HZQ%#Vb&1DYo)=0Py?;<<C<XS89n0osswE5?lp=SyRCWE!DxV*~~Ss;-Eant43p
ziJ+7!-;H=3J?&(M5M5YMKs>YS79d7KLef)5ieBJ(2i};!L{|G&x5mP>tlmTXg6Lvr
zZ?B@IH8`*7w&;0Ng7$f1mGU{#QzWVgIvN}dp55um?MaS6areA)R0Tpt0aTJ+`uWYT
zBuKDc=TzODY+(J_8lIIT0W$y`3gh-ef+uH|!oY#Jaq1EBDl2=}xP%`f{hcHglwMV(
z3l$!_a&0ge+|=;4va$l}yewwfm^9el$R@EFUlQ+JH~10LzEQ4im8GMV+#DU0UOAkg
zn1o27D?$9ZhM@S!Ihu@|e}1XF7>0E|(f`L>@B`7x<8+>G@g(#IiBfgY+3QeyJc&tq
zV}rkPy#tR{sDshx%B{6&CNM)K)?k<HUzCUF4Sp3_!FA&u0N}tHom;I}yCzZ&K_c#5
zwQ=)pDq=j%f@>NEKVHPQBS+-13~!VhK3H;gKx<a_&`>7Way%<v;M6X87@S(Rm5Sb%
z2GBXxJuq(Usx!V#P(eX~?jUTM5DjNRr&v5iBf<SM+_;DMK@4cuuc~6IFL?#!bojn_
zv7RnZzYH{f;c?0_IxvFYqVhNc*x|}RXAjg`b#J=>qZ8S9AR(z62Qbu|^4HnDsnLMk
z6&u*et~u^KgD-jNDIbV<$F@Xcvm`ay$(IE!0MLLsX^KKzW^yv)%NM?^AZITbf{nKt
z#F9db^iqX01O^xnVYlsE#?RSBs!(YiiI?^y<pBHn58RefzkmPkYHz=i)Sea=7REzT
zvs|f`3@1tDyLUfMH$MQ(nQwQ3e(Py>`aNn9{yV`C#6Qo>TrMoe%vyVjq<#2sLoS*;
zb#+2)qI__WmX*~^)!aOMt3&}^sW&y1RkrYjx4XN)z(6V`Mm`)wbv1TplFl0$t6mcq
zzpIq`!>m3~M(7fp2ZzBU^xwep5XO7=j)N-?94U|CZ67mkjaytK-2d&*C9|7|%b$#F
z`^+-tHm^0>0Y38^h!==L_{0UUXc+-;&2gj^SS|B~!*G(Xu!P>GcB62ePr13d;wrzr
zU%h?1?g8|ERoEip?Sbp*!m<}ET5ER$$a34-2UDDN&~F0eX(e}e_Z+H^Y;0_mi^AfR
zxH&t~m@syof#tH-7g)f3PXVC9$|b3vSc5tyWE+HRHm*OK0RKZsEJtc*KNfoq$`F;L
zkRFK)=0j0S^UiZjIn>H@(Y<s~1C=77SA{yb&j81>!6GnHPFL{<ch2_d<|&t{P|?L9
z=O!92=#N~-jp`*sJsEn1qd|$Ut>CF`+3!=WluK{k@WW~!c5Q;ckWmP*2@Br`D#yqa
zAWe3qL%S<==V4;IjCnKNj3kCk?PBGwS=Akh<}z&DOBcvEky=H5tL{}FZ_YMI0uBsq
zl$uXo0GtAHs|SCSe<yR5p&vW~w*W>3vJE6pf=ozYkEB4x{AOguI13Al6r>9f3tSHO
zw_GhDZJFM817f+^_}7=hV9;G%FIL66Yb4fvPa5$gh6qkgP5mJ<@_NGsR`<$ZrkA0=
z5<Hr{#r5<^)(N_K9uz?k1yeWJs#Vn0(}3$Q-4Vf)`B0_<0$V27xB%eBB*9M=#sxwC
z)X9?%&CSho-jwB+58_HwQohsNC#4llgEWUjvqGJMQ>%w9ZIeP%jyVK2mo3+f?m7GN
zuMAR##e;mFwfG$6Gl{pO(=y5j*OqIZtX2pJGJacY%F3Ac-(mrk4C&yjS4ByESlJXr
znfuH(_N=0t319j~kx`rVydj%d-(Pl3A95;JGR}wE7B&u4Fz2$%Tf!SAckFxZGcE=4
z%u6Fj&>T9}8Wtq00(%;l>gutQ-uk8}z6XOvmYra52Ob<jbI|5F;s_un!A9(|n^aE4
zpEvNBz%oNTesKM5XJ|6wP6GSo$k}Vo#*e}#-75p3&;m4l^I>Ri6c6GvZlVNJT66H(
z0k1qvPR&8HwMV|1(XMjE&UCbRIG1{EjY!pwGSaaJ0&<lQGjv^MnUH+B^6UO<U3=cM
z60{yc@uB6waC!kU5Qh2vyqFPD+U*4%_ps=Um+{q_kUz+Qe>!YW-SMsD;9UIgk<lmM
z0%mPgg0@YP{0!do(n(SPl|cBCgL1WdQGUM#)CN>wg9a%mqx^msl|+T!rpQ%f;u!=j
zc0wr@<_=IH7W!9(-AWW8y&lRe9u?2*c%*<?GHR6HdkCF+kKi%O$;GKLPzB)au6LTz
ziVvkh$72k$>?_FJ^W)rZO7R$fyUvoTT3YG|PO8<MKo1$yZ;h{1(``@!FwV~2+_6(G
zpU-iw-<eAQX1Xsa*;q(~m}}9NJun-<`gCgl06g7Q!2X2sI=K0OnHI3^;}~0$??BUB
zWni~b3eIk;d#W*fo@R7gGRKHbHFIXe9V})s(a@9(cA)cMT~mf}Z^e01u&a+{T@&Er
z`<#{4jCDkk%n{p!dcRR<v{XjgEL{q>8sn=gEH3L9S64JQR4tzaD@1Tgb{^dtya0QF
zk5$!<@iKc?YNzFvg|f#Mc5;0O(zb`N4&i(QS{n&ZJ5w92ie2@tK+aQuX{B2nDSQCl
zcS!LQ4zO@XZ~WgBI5v|1wUYTM;;rckZGdc0k8+RqNQWwv20MBDmYKF$I&@YPfbKam
z++d3W{bMaOV+7)d!Yb(9_KR8S-14EJmM#+kKH!Deh18U|4L%fEtnT4ny)Bs8-||;^
z*!J->CuP=mf7hV#qW&^hck4V#N8IA+55U;y)#GXdlpF!F8^eP_8He50ERZdo;Kbbe
zpGIe4yJYEb?VBT7FLf&fHK3L+f}!h#%^b>Y>B-6V8S|pZKuLO)o8*pZd^tiA`?iMD
zOcJZ#VanuFT-cm{v_#2%@-We%LyRuLzJQ5^#dY-Do)MVvz~)RXU=`EaAIb!2Lk7UQ
z@O;4X?q=jJ*LpGJmf)fTXU>L(hE$y$F&c<V%1TN}z+r$xZrp0g<li&aZl;r~c;rGR
zJJ?=9b$HtSOvfrLPpI}4zZvZBpUqEn6@`Zi1bskcws0a0&K}E_{Lz?8jsPWAdjnrD
zZY~9;!GrPfD!sa{_VIV^rYpY64LqIs?UWxK=ih(@mlQm%HJtL(MW<A4&f?;9SJCjs
zEU5Ngz3LX950!)Qabw+=aBjW<j(t8Nphjj`7Xnl*n{+%%N_H{4XFsGz9*Yjiv!LQn
zrFLdTTWNBIH?CoyF7%y*ox${eE8tCD7ifqk)YF|&D1r;pcW*1>MR3>D2r*vaw*6T*
zrREKnqLM-WxojZ4py1l~Z!smm5S)zo7#^jd-&;B{my&3kmis_>kU6!C1%6G<*cB9k
ziI*7%ylJKTHZaH@A{I|52GX3{2(E(K{%^o$HvnS+S%kk-wVGFak8bt?Mg)bp|9}zo
znesw@WB5%p6!}Ikdv9<}1(wlU$q5?)qla%n9RjL6moAA8H6yR1Vv;299;Zb9<^>P$
z=yLzRLH+&{Y-S>cq9G=PDsaBLCUQMBLSJVce(4M1Hu~~Cex#+H?C#-<S?oM|kS*s5
z9nZiXDL9W6o5y=5`^z*mEHop%EKKGImfSuE&|3POCj8P|_Sa0l#{smZEs77aSQcxl
z=-SFQH)lZ|%mjDD_49hHe}fWw+7r01Cy|j;yMSyhJKo<Xk{_V)@xKjk{-+!L{{>|I
eKfj8VLp)+X&j&4-^K!^=NZ*scn|(+B`TqrkIm*%i

literal 0
HcmV?d00001

diff --git a/docs/en/docs/img/tutorial/separate-openapi-schemas/image05.png b/docs/en/docs/img/tutorial/separate-openapi-schemas/image05.png
new file mode 100644
index 0000000000000000000000000000000000000000..674dd0b2e273078ffea526c0dd8572547a4c04f2
GIT binary patch
literal 45618
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

literal 0
HcmV?d00001

diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index f75b84ff5..c56e4c942 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -176,6 +176,7 @@ nav:
   - how-to/custom-request-and-route.md
   - how-to/conditional-openapi.md
   - how-to/extending-openapi.md
+  - how-to/separate-openapi-schemas.md
   - how-to/custom-docs-ui-assets.md
   - how-to/configure-swagger-ui.md
 - project-generation.md
diff --git a/docs_src/separate_openapi_schemas/tutorial001.py b/docs_src/separate_openapi_schemas/tutorial001.py
new file mode 100644
index 000000000..415eef8e2
--- /dev/null
+++ b/docs_src/separate_openapi_schemas/tutorial001.py
@@ -0,0 +1,28 @@
+from typing import List, Union
+
+from fastapi import FastAPI
+from pydantic import BaseModel
+
+
+class Item(BaseModel):
+    name: str
+    description: Union[str, None] = None
+
+
+app = FastAPI()
+
+
+@app.post("/items/")
+def create_item(item: Item):
+    return item
+
+
+@app.get("/items/")
+def read_items() -> List[Item]:
+    return [
+        Item(
+            name="Portal Gun",
+            description="Device to travel through the multi-rick-verse",
+        ),
+        Item(name="Plumbus"),
+    ]
diff --git a/docs_src/separate_openapi_schemas/tutorial001_py310.py b/docs_src/separate_openapi_schemas/tutorial001_py310.py
new file mode 100644
index 000000000..289cb54ed
--- /dev/null
+++ b/docs_src/separate_openapi_schemas/tutorial001_py310.py
@@ -0,0 +1,26 @@
+from fastapi import FastAPI
+from pydantic import BaseModel
+
+
+class Item(BaseModel):
+    name: str
+    description: str | None = None
+
+
+app = FastAPI()
+
+
+@app.post("/items/")
+def create_item(item: Item):
+    return item
+
+
+@app.get("/items/")
+def read_items() -> list[Item]:
+    return [
+        Item(
+            name="Portal Gun",
+            description="Device to travel through the multi-rick-verse",
+        ),
+        Item(name="Plumbus"),
+    ]
diff --git a/docs_src/separate_openapi_schemas/tutorial001_py39.py b/docs_src/separate_openapi_schemas/tutorial001_py39.py
new file mode 100644
index 000000000..63cffd1e3
--- /dev/null
+++ b/docs_src/separate_openapi_schemas/tutorial001_py39.py
@@ -0,0 +1,28 @@
+from typing import Optional
+
+from fastapi import FastAPI
+from pydantic import BaseModel
+
+
+class Item(BaseModel):
+    name: str
+    description: Optional[str] = None
+
+
+app = FastAPI()
+
+
+@app.post("/items/")
+def create_item(item: Item):
+    return item
+
+
+@app.get("/items/")
+def read_items() -> list[Item]:
+    return [
+        Item(
+            name="Portal Gun",
+            description="Device to travel through the multi-rick-verse",
+        ),
+        Item(name="Plumbus"),
+    ]
diff --git a/docs_src/separate_openapi_schemas/tutorial002.py b/docs_src/separate_openapi_schemas/tutorial002.py
new file mode 100644
index 000000000..7df93783b
--- /dev/null
+++ b/docs_src/separate_openapi_schemas/tutorial002.py
@@ -0,0 +1,28 @@
+from typing import List, Union
+
+from fastapi import FastAPI
+from pydantic import BaseModel
+
+
+class Item(BaseModel):
+    name: str
+    description: Union[str, None] = None
+
+
+app = FastAPI(separate_input_output_schemas=False)
+
+
+@app.post("/items/")
+def create_item(item: Item):
+    return item
+
+
+@app.get("/items/")
+def read_items() -> List[Item]:
+    return [
+        Item(
+            name="Portal Gun",
+            description="Device to travel through the multi-rick-verse",
+        ),
+        Item(name="Plumbus"),
+    ]
diff --git a/docs_src/separate_openapi_schemas/tutorial002_py310.py b/docs_src/separate_openapi_schemas/tutorial002_py310.py
new file mode 100644
index 000000000..5db210872
--- /dev/null
+++ b/docs_src/separate_openapi_schemas/tutorial002_py310.py
@@ -0,0 +1,26 @@
+from fastapi import FastAPI
+from pydantic import BaseModel
+
+
+class Item(BaseModel):
+    name: str
+    description: str | None = None
+
+
+app = FastAPI(separate_input_output_schemas=False)
+
+
+@app.post("/items/")
+def create_item(item: Item):
+    return item
+
+
+@app.get("/items/")
+def read_items() -> list[Item]:
+    return [
+        Item(
+            name="Portal Gun",
+            description="Device to travel through the multi-rick-verse",
+        ),
+        Item(name="Plumbus"),
+    ]
diff --git a/docs_src/separate_openapi_schemas/tutorial002_py39.py b/docs_src/separate_openapi_schemas/tutorial002_py39.py
new file mode 100644
index 000000000..50d997d92
--- /dev/null
+++ b/docs_src/separate_openapi_schemas/tutorial002_py39.py
@@ -0,0 +1,28 @@
+from typing import Optional
+
+from fastapi import FastAPI
+from pydantic import BaseModel
+
+
+class Item(BaseModel):
+    name: str
+    description: Optional[str] = None
+
+
+app = FastAPI(separate_input_output_schemas=False)
+
+
+@app.post("/items/")
+def create_item(item: Item):
+    return item
+
+
+@app.get("/items/")
+def read_items() -> list[Item]:
+    return [
+        Item(
+            name="Portal Gun",
+            description="Device to travel through the multi-rick-verse",
+        ),
+        Item(name="Plumbus"),
+    ]
diff --git a/fastapi/_compat.py b/fastapi/_compat.py
index 9ffcaf409..eb55b08f2 100644
--- a/fastapi/_compat.py
+++ b/fastapi/_compat.py
@@ -181,9 +181,13 @@ if PYDANTIC_V2:
         field_mapping: Dict[
             Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue
         ],
+        separate_input_output_schemas: bool = True,
     ) -> Dict[str, Any]:
+        override_mode: Union[Literal["validation"], None] = (
+            None if separate_input_output_schemas else "validation"
+        )
         # This expects that GenerateJsonSchema was already used to generate the definitions
-        json_schema = field_mapping[(field, field.mode)]
+        json_schema = field_mapping[(field, override_mode or field.mode)]
         if "$ref" not in json_schema:
             # TODO remove when deprecating Pydantic v1
             # Ref: https://github.com/pydantic/pydantic/blob/d61792cc42c80b13b23e3ffa74bc37ec7c77f7d1/pydantic/schema.py#L207
@@ -200,14 +204,19 @@ if PYDANTIC_V2:
         fields: List[ModelField],
         schema_generator: GenerateJsonSchema,
         model_name_map: ModelNameMap,
+        separate_input_output_schemas: bool = True,
     ) -> Tuple[
         Dict[
             Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue
         ],
         Dict[str, Dict[str, Any]],
     ]:
+        override_mode: Union[Literal["validation"], None] = (
+            None if separate_input_output_schemas else "validation"
+        )
         inputs = [
-            (field, field.mode, field._type_adapter.core_schema) for field in fields
+            (field, override_mode or field.mode, field._type_adapter.core_schema)
+            for field in fields
         ]
         field_mapping, definitions = schema_generator.generate_definitions(
             inputs=inputs
@@ -429,6 +438,7 @@ else:
         field_mapping: Dict[
             Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue
         ],
+        separate_input_output_schemas: bool = True,
     ) -> Dict[str, Any]:
         # This expects that GenerateJsonSchema was already used to generate the definitions
         return field_schema(  # type: ignore[no-any-return]
@@ -444,6 +454,7 @@ else:
         fields: List[ModelField],
         schema_generator: GenerateJsonSchema,
         model_name_map: ModelNameMap,
+        separate_input_output_schemas: bool = True,
     ) -> Tuple[
         Dict[
             Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue
diff --git a/fastapi/applications.py b/fastapi/applications.py
index e32cfa03d..b681e50b3 100644
--- a/fastapi/applications.py
+++ b/fastapi/applications.py
@@ -92,6 +92,7 @@ class FastAPI(Starlette):
         generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
             generate_unique_id
         ),
+        separate_input_output_schemas: bool = True,
         **extra: Any,
     ) -> None:
         self.debug = debug
@@ -111,6 +112,7 @@ class FastAPI(Starlette):
         self.swagger_ui_init_oauth = swagger_ui_init_oauth
         self.swagger_ui_parameters = swagger_ui_parameters
         self.servers = servers or []
+        self.separate_input_output_schemas = separate_input_output_schemas
         self.extra = extra
         self.openapi_version = "3.1.0"
         self.openapi_schema: Optional[Dict[str, Any]] = None
@@ -227,6 +229,7 @@ class FastAPI(Starlette):
                 webhooks=self.webhooks.routes,
                 tags=self.openapi_tags,
                 servers=self.servers,
+                separate_input_output_schemas=self.separate_input_output_schemas,
             )
         return self.openapi_schema
 
diff --git a/fastapi/openapi/utils.py b/fastapi/openapi/utils.py
index e295361e6..9498375fe 100644
--- a/fastapi/openapi/utils.py
+++ b/fastapi/openapi/utils.py
@@ -95,6 +95,7 @@ def get_openapi_operation_parameters(
     field_mapping: Dict[
         Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue
     ],
+    separate_input_output_schemas: bool = True,
 ) -> List[Dict[str, Any]]:
     parameters = []
     for param in all_route_params:
@@ -107,6 +108,7 @@ def get_openapi_operation_parameters(
             schema_generator=schema_generator,
             model_name_map=model_name_map,
             field_mapping=field_mapping,
+            separate_input_output_schemas=separate_input_output_schemas,
         )
         parameter = {
             "name": param.alias,
@@ -132,6 +134,7 @@ def get_openapi_operation_request_body(
     field_mapping: Dict[
         Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue
     ],
+    separate_input_output_schemas: bool = True,
 ) -> Optional[Dict[str, Any]]:
     if not body_field:
         return None
@@ -141,6 +144,7 @@ def get_openapi_operation_request_body(
         schema_generator=schema_generator,
         model_name_map=model_name_map,
         field_mapping=field_mapping,
+        separate_input_output_schemas=separate_input_output_schemas,
     )
     field_info = cast(Body, body_field.field_info)
     request_media_type = field_info.media_type
@@ -211,6 +215,7 @@ def get_openapi_path(
     field_mapping: Dict[
         Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue
     ],
+    separate_input_output_schemas: bool = True,
 ) -> Tuple[Dict[str, Any], Dict[str, Any], Dict[str, Any]]:
     path = {}
     security_schemes: Dict[str, Any] = {}
@@ -242,6 +247,7 @@ def get_openapi_path(
                 schema_generator=schema_generator,
                 model_name_map=model_name_map,
                 field_mapping=field_mapping,
+                separate_input_output_schemas=separate_input_output_schemas,
             )
             parameters.extend(operation_parameters)
             if parameters:
@@ -263,6 +269,7 @@ def get_openapi_path(
                     schema_generator=schema_generator,
                     model_name_map=model_name_map,
                     field_mapping=field_mapping,
+                    separate_input_output_schemas=separate_input_output_schemas,
                 )
                 if request_body_oai:
                     operation["requestBody"] = request_body_oai
@@ -280,6 +287,7 @@ def get_openapi_path(
                             schema_generator=schema_generator,
                             model_name_map=model_name_map,
                             field_mapping=field_mapping,
+                            separate_input_output_schemas=separate_input_output_schemas,
                         )
                         callbacks[callback.name] = {callback.path: cb_path}
                 operation["callbacks"] = callbacks
@@ -310,6 +318,7 @@ def get_openapi_path(
                             schema_generator=schema_generator,
                             model_name_map=model_name_map,
                             field_mapping=field_mapping,
+                            separate_input_output_schemas=separate_input_output_schemas,
                         )
                     else:
                         response_schema = {}
@@ -343,6 +352,7 @@ def get_openapi_path(
                             schema_generator=schema_generator,
                             model_name_map=model_name_map,
                             field_mapping=field_mapping,
+                            separate_input_output_schemas=separate_input_output_schemas,
                         )
                         media_type = route_response_media_type or "application/json"
                         additional_schema = (
@@ -433,6 +443,7 @@ def get_openapi(
     terms_of_service: Optional[str] = None,
     contact: Optional[Dict[str, Union[str, Any]]] = None,
     license_info: Optional[Dict[str, Union[str, Any]]] = None,
+    separate_input_output_schemas: bool = True,
 ) -> Dict[str, Any]:
     info: Dict[str, Any] = {"title": title, "version": version}
     if summary:
@@ -459,6 +470,7 @@ def get_openapi(
         fields=all_fields,
         schema_generator=schema_generator,
         model_name_map=model_name_map,
+        separate_input_output_schemas=separate_input_output_schemas,
     )
     for route in routes or []:
         if isinstance(route, routing.APIRoute):
@@ -468,6 +480,7 @@ def get_openapi(
                 schema_generator=schema_generator,
                 model_name_map=model_name_map,
                 field_mapping=field_mapping,
+                separate_input_output_schemas=separate_input_output_schemas,
             )
             if result:
                 path, security_schemes, path_definitions = result
@@ -487,6 +500,7 @@ def get_openapi(
                 schema_generator=schema_generator,
                 model_name_map=model_name_map,
                 field_mapping=field_mapping,
+                separate_input_output_schemas=separate_input_output_schemas,
             )
             if result:
                 path, security_schemes, path_definitions = result
diff --git a/requirements.txt b/requirements.txt
index 7e746016a..ef25ec483 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -3,3 +3,5 @@
 -r requirements-docs.txt
 uvicorn[standard] >=0.12.0,<0.23.0
 pre-commit >=2.17.0,<4.0.0
+# For generating screenshots
+playwright
diff --git a/scripts/playwright/separate_openapi_schemas/image01.py b/scripts/playwright/separate_openapi_schemas/image01.py
new file mode 100644
index 000000000..0b40f3bbc
--- /dev/null
+++ b/scripts/playwright/separate_openapi_schemas/image01.py
@@ -0,0 +1,29 @@
+import subprocess
+
+from playwright.sync_api import Playwright, sync_playwright
+
+
+def run(playwright: Playwright) -> None:
+    browser = playwright.chromium.launch(headless=False)
+    context = browser.new_context(viewport={"width": 960, "height": 1080})
+    page = context.new_page()
+    page.goto("http://localhost:8000/docs")
+    page.get_by_text("POST/items/Create Item").click()
+    page.get_by_role("tab", name="Schema").first.click()
+    page.screenshot(
+        path="docs/en/docs/img/tutorial/separate-openapi-schemas/image01.png"
+    )
+
+    # ---------------------
+    context.close()
+    browser.close()
+
+
+process = subprocess.Popen(
+    ["uvicorn", "docs_src.separate_openapi_schemas.tutorial001:app"]
+)
+try:
+    with sync_playwright() as playwright:
+        run(playwright)
+finally:
+    process.terminate()
diff --git a/scripts/playwright/separate_openapi_schemas/image02.py b/scripts/playwright/separate_openapi_schemas/image02.py
new file mode 100644
index 000000000..f76af7ee2
--- /dev/null
+++ b/scripts/playwright/separate_openapi_schemas/image02.py
@@ -0,0 +1,30 @@
+import subprocess
+
+from playwright.sync_api import Playwright, sync_playwright
+
+
+def run(playwright: Playwright) -> None:
+    browser = playwright.chromium.launch(headless=False)
+    context = browser.new_context(viewport={"width": 960, "height": 1080})
+    page = context.new_page()
+    page.goto("http://localhost:8000/docs")
+    page.get_by_text("GET/items/Read Items").click()
+    page.get_by_role("button", name="Try it out").click()
+    page.get_by_role("button", name="Execute").click()
+    page.screenshot(
+        path="docs/en/docs/img/tutorial/separate-openapi-schemas/image02.png"
+    )
+
+    # ---------------------
+    context.close()
+    browser.close()
+
+
+process = subprocess.Popen(
+    ["uvicorn", "docs_src.separate_openapi_schemas.tutorial001:app"]
+)
+try:
+    with sync_playwright() as playwright:
+        run(playwright)
+finally:
+    process.terminate()
diff --git a/scripts/playwright/separate_openapi_schemas/image03.py b/scripts/playwright/separate_openapi_schemas/image03.py
new file mode 100644
index 000000000..127f5c428
--- /dev/null
+++ b/scripts/playwright/separate_openapi_schemas/image03.py
@@ -0,0 +1,30 @@
+import subprocess
+
+from playwright.sync_api import Playwright, sync_playwright
+
+
+def run(playwright: Playwright) -> None:
+    browser = playwright.chromium.launch(headless=False)
+    context = browser.new_context(viewport={"width": 960, "height": 1080})
+    page = context.new_page()
+    page.goto("http://localhost:8000/docs")
+    page.get_by_text("GET/items/Read Items").click()
+    page.get_by_role("tab", name="Schema").click()
+    page.get_by_label("Schema").get_by_role("button", name="Expand all").click()
+    page.screenshot(
+        path="docs/en/docs/img/tutorial/separate-openapi-schemas/image03.png"
+    )
+
+    # ---------------------
+    context.close()
+    browser.close()
+
+
+process = subprocess.Popen(
+    ["uvicorn", "docs_src.separate_openapi_schemas.tutorial001:app"]
+)
+try:
+    with sync_playwright() as playwright:
+        run(playwright)
+finally:
+    process.terminate()
diff --git a/scripts/playwright/separate_openapi_schemas/image04.py b/scripts/playwright/separate_openapi_schemas/image04.py
new file mode 100644
index 000000000..208eaf8a0
--- /dev/null
+++ b/scripts/playwright/separate_openapi_schemas/image04.py
@@ -0,0 +1,29 @@
+import subprocess
+
+from playwright.sync_api import Playwright, sync_playwright
+
+
+def run(playwright: Playwright) -> None:
+    browser = playwright.chromium.launch(headless=False)
+    context = browser.new_context(viewport={"width": 960, "height": 1080})
+    page = context.new_page()
+    page.goto("http://localhost:8000/docs")
+    page.get_by_role("button", name="Item-Input").click()
+    page.get_by_role("button", name="Item-Output").click()
+    page.set_viewport_size({"width": 960, "height": 820})
+    page.screenshot(
+        path="docs/en/docs/img/tutorial/separate-openapi-schemas/image04.png"
+    )
+    # ---------------------
+    context.close()
+    browser.close()
+
+
+process = subprocess.Popen(
+    ["uvicorn", "docs_src.separate_openapi_schemas.tutorial001:app"]
+)
+try:
+    with sync_playwright() as playwright:
+        run(playwright)
+finally:
+    process.terminate()
diff --git a/scripts/playwright/separate_openapi_schemas/image05.py b/scripts/playwright/separate_openapi_schemas/image05.py
new file mode 100644
index 000000000..83966b449
--- /dev/null
+++ b/scripts/playwright/separate_openapi_schemas/image05.py
@@ -0,0 +1,29 @@
+import subprocess
+
+from playwright.sync_api import Playwright, sync_playwright
+
+
+def run(playwright: Playwright) -> None:
+    browser = playwright.chromium.launch(headless=False)
+    context = browser.new_context(viewport={"width": 960, "height": 1080})
+    page = context.new_page()
+    page.goto("http://localhost:8000/docs")
+    page.get_by_role("button", name="Item", exact=True).click()
+    page.set_viewport_size({"width": 960, "height": 700})
+    page.screenshot(
+        path="docs/en/docs/img/tutorial/separate-openapi-schemas/image05.png"
+    )
+
+    # ---------------------
+    context.close()
+    browser.close()
+
+
+process = subprocess.Popen(
+    ["uvicorn", "docs_src.separate_openapi_schemas.tutorial002:app"]
+)
+try:
+    with sync_playwright() as playwright:
+        run(playwright)
+finally:
+    process.terminate()
diff --git a/tests/test_openapi_separate_input_output_schemas.py b/tests/test_openapi_separate_input_output_schemas.py
new file mode 100644
index 000000000..70f4b90d7
--- /dev/null
+++ b/tests/test_openapi_separate_input_output_schemas.py
@@ -0,0 +1,490 @@
+from typing import List, Optional
+
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+from pydantic import BaseModel
+
+from .utils import needs_pydanticv2
+
+
+class SubItem(BaseModel):
+    subname: str
+    sub_description: Optional[str] = None
+    tags: List[str] = []
+
+
+class Item(BaseModel):
+    name: str
+    description: Optional[str] = None
+    sub: Optional[SubItem] = None
+
+
+def get_app_client(separate_input_output_schemas: bool = True) -> TestClient:
+    app = FastAPI(separate_input_output_schemas=separate_input_output_schemas)
+
+    @app.post("/items/")
+    def create_item(item: Item):
+        return item
+
+    @app.post("/items-list/")
+    def create_item_list(item: List[Item]):
+        return item
+
+    @app.get("/items/")
+    def read_items() -> List[Item]:
+        return [
+            Item(
+                name="Portal Gun",
+                description="Device to travel through the multi-rick-verse",
+                sub=SubItem(subname="subname"),
+            ),
+            Item(name="Plumbus"),
+        ]
+
+    client = TestClient(app)
+    return client
+
+
+def test_create_item():
+    client = get_app_client()
+    client_no = get_app_client(separate_input_output_schemas=False)
+    response = client.post("/items/", json={"name": "Plumbus"})
+    response2 = client_no.post("/items/", json={"name": "Plumbus"})
+    assert response.status_code == response2.status_code == 200, response.text
+    assert (
+        response.json()
+        == response2.json()
+        == {"name": "Plumbus", "description": None, "sub": None}
+    )
+
+
+def test_create_item_with_sub():
+    client = get_app_client()
+    client_no = get_app_client(separate_input_output_schemas=False)
+    data = {
+        "name": "Plumbus",
+        "sub": {"subname": "SubPlumbus", "sub_description": "Sub WTF"},
+    }
+    response = client.post("/items/", json=data)
+    response2 = client_no.post("/items/", json=data)
+    assert response.status_code == response2.status_code == 200, response.text
+    assert (
+        response.json()
+        == response2.json()
+        == {
+            "name": "Plumbus",
+            "description": None,
+            "sub": {"subname": "SubPlumbus", "sub_description": "Sub WTF", "tags": []},
+        }
+    )
+
+
+def test_create_item_list():
+    client = get_app_client()
+    client_no = get_app_client(separate_input_output_schemas=False)
+    data = [
+        {"name": "Plumbus"},
+        {
+            "name": "Portal Gun",
+            "description": "Device to travel through the multi-rick-verse",
+        },
+    ]
+    response = client.post("/items-list/", json=data)
+    response2 = client_no.post("/items-list/", json=data)
+    assert response.status_code == response2.status_code == 200, response.text
+    assert (
+        response.json()
+        == response2.json()
+        == [
+            {"name": "Plumbus", "description": None, "sub": None},
+            {
+                "name": "Portal Gun",
+                "description": "Device to travel through the multi-rick-verse",
+                "sub": None,
+            },
+        ]
+    )
+
+
+def test_read_items():
+    client = get_app_client()
+    client_no = get_app_client(separate_input_output_schemas=False)
+    response = client.get("/items/")
+    response2 = client_no.get("/items/")
+    assert response.status_code == response2.status_code == 200, response.text
+    assert (
+        response.json()
+        == response2.json()
+        == [
+            {
+                "name": "Portal Gun",
+                "description": "Device to travel through the multi-rick-verse",
+                "sub": {"subname": "subname", "sub_description": None, "tags": []},
+            },
+            {"name": "Plumbus", "description": None, "sub": None},
+        ]
+    )
+
+
+@needs_pydanticv2
+def test_openapi_schema():
+    client = get_app_client()
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "get": {
+                    "summary": "Read Items",
+                    "operationId": "read_items_items__get",
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "items": {
+                                            "$ref": "#/components/schemas/Item-Output"
+                                        },
+                                        "type": "array",
+                                        "title": "Response Read Items Items  Get",
+                                    }
+                                }
+                            },
+                        }
+                    },
+                },
+                "post": {
+                    "summary": "Create Item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item-Input"}
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                },
+            },
+            "/items-list/": {
+                "post": {
+                    "summary": "Create Item List",
+                    "operationId": "create_item_list_items_list__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "items": {
+                                        "$ref": "#/components/schemas/Item-Input"
+                                    },
+                                    "type": "array",
+                                    "title": "Item",
+                                }
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            },
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "properties": {
+                        "detail": {
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                            "type": "array",
+                            "title": "Detail",
+                        }
+                    },
+                    "type": "object",
+                    "title": "HTTPValidationError",
+                },
+                "Item-Input": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                        "sub": {
+                            "anyOf": [
+                                {"$ref": "#/components/schemas/SubItem-Input"},
+                                {"type": "null"},
+                            ]
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name"],
+                    "title": "Item",
+                },
+                "Item-Output": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                        "sub": {
+                            "anyOf": [
+                                {"$ref": "#/components/schemas/SubItem-Output"},
+                                {"type": "null"},
+                            ]
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name", "description", "sub"],
+                    "title": "Item",
+                },
+                "SubItem-Input": {
+                    "properties": {
+                        "subname": {"type": "string", "title": "Subname"},
+                        "sub_description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Sub Description",
+                        },
+                        "tags": {
+                            "items": {"type": "string"},
+                            "type": "array",
+                            "title": "Tags",
+                            "default": [],
+                        },
+                    },
+                    "type": "object",
+                    "required": ["subname"],
+                    "title": "SubItem",
+                },
+                "SubItem-Output": {
+                    "properties": {
+                        "subname": {"type": "string", "title": "Subname"},
+                        "sub_description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Sub Description",
+                        },
+                        "tags": {
+                            "items": {"type": "string"},
+                            "type": "array",
+                            "title": "Tags",
+                            "default": [],
+                        },
+                    },
+                    "type": "object",
+                    "required": ["subname", "sub_description", "tags"],
+                    "title": "SubItem",
+                },
+                "ValidationError": {
+                    "properties": {
+                        "loc": {
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                            "type": "array",
+                            "title": "Location",
+                        },
+                        "msg": {"type": "string", "title": "Message"},
+                        "type": {"type": "string", "title": "Error Type"},
+                    },
+                    "type": "object",
+                    "required": ["loc", "msg", "type"],
+                    "title": "ValidationError",
+                },
+            }
+        },
+    }
+
+
+@needs_pydanticv2
+def test_openapi_schema_no_separate():
+    client = get_app_client(separate_input_output_schemas=False)
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "get": {
+                    "summary": "Read Items",
+                    "operationId": "read_items_items__get",
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "items": {"$ref": "#/components/schemas/Item"},
+                                        "type": "array",
+                                        "title": "Response Read Items Items  Get",
+                                    }
+                                }
+                            },
+                        }
+                    },
+                },
+                "post": {
+                    "summary": "Create Item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item"}
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                },
+            },
+            "/items-list/": {
+                "post": {
+                    "summary": "Create Item List",
+                    "operationId": "create_item_list_items_list__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "items": {"$ref": "#/components/schemas/Item"},
+                                    "type": "array",
+                                    "title": "Item",
+                                }
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            },
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "properties": {
+                        "detail": {
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                            "type": "array",
+                            "title": "Detail",
+                        }
+                    },
+                    "type": "object",
+                    "title": "HTTPValidationError",
+                },
+                "Item": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                        "sub": {
+                            "anyOf": [
+                                {"$ref": "#/components/schemas/SubItem"},
+                                {"type": "null"},
+                            ]
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name"],
+                    "title": "Item",
+                },
+                "SubItem": {
+                    "properties": {
+                        "subname": {"type": "string", "title": "Subname"},
+                        "sub_description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Sub Description",
+                        },
+                        "tags": {
+                            "items": {"type": "string"},
+                            "type": "array",
+                            "title": "Tags",
+                            "default": [],
+                        },
+                    },
+                    "type": "object",
+                    "required": ["subname"],
+                    "title": "SubItem",
+                },
+                "ValidationError": {
+                    "properties": {
+                        "loc": {
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                            "type": "array",
+                            "title": "Location",
+                        },
+                        "msg": {"type": "string", "title": "Message"},
+                        "type": {"type": "string", "title": "Error Type"},
+                    },
+                    "type": "object",
+                    "required": ["loc", "msg", "type"],
+                    "title": "ValidationError",
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_separate_openapi_schemas/__init__.py b/tests/test_tutorial/test_separate_openapi_schemas/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001.py b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001.py
new file mode 100644
index 000000000..8079c1134
--- /dev/null
+++ b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001.py
@@ -0,0 +1,147 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from ...utils import needs_pydanticv2
+
+
+@pytest.fixture(name="client")
+def get_client() -> TestClient:
+    from docs_src.separate_openapi_schemas.tutorial001 import app
+
+    client = TestClient(app)
+    return client
+
+
+def test_create_item(client: TestClient) -> None:
+    response = client.post("/items/", json={"name": "Foo"})
+    assert response.status_code == 200, response.text
+    assert response.json() == {"name": "Foo", "description": None}
+
+
+def test_read_items(client: TestClient) -> None:
+    response = client.get("/items/")
+    assert response.status_code == 200, response.text
+    assert response.json() == [
+        {
+            "name": "Portal Gun",
+            "description": "Device to travel through the multi-rick-verse",
+        },
+        {"name": "Plumbus", "description": None},
+    ]
+
+
+@needs_pydanticv2
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "get": {
+                    "summary": "Read Items",
+                    "operationId": "read_items_items__get",
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "items": {
+                                            "$ref": "#/components/schemas/Item-Output"
+                                        },
+                                        "type": "array",
+                                        "title": "Response Read Items Items  Get",
+                                    }
+                                }
+                            },
+                        }
+                    },
+                },
+                "post": {
+                    "summary": "Create Item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item-Input"}
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                },
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "properties": {
+                        "detail": {
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                            "type": "array",
+                            "title": "Detail",
+                        }
+                    },
+                    "type": "object",
+                    "title": "HTTPValidationError",
+                },
+                "Item-Input": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name"],
+                    "title": "Item",
+                },
+                "Item-Output": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name", "description"],
+                    "title": "Item",
+                },
+                "ValidationError": {
+                    "properties": {
+                        "loc": {
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                            "type": "array",
+                            "title": "Location",
+                        },
+                        "msg": {"type": "string", "title": "Message"},
+                        "type": {"type": "string", "title": "Error Type"},
+                    },
+                    "type": "object",
+                    "required": ["loc", "msg", "type"],
+                    "title": "ValidationError",
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py310.py b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py310.py
new file mode 100644
index 000000000..4fa98ccbe
--- /dev/null
+++ b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py310.py
@@ -0,0 +1,150 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from ...utils import needs_py310, needs_pydanticv2
+
+
+@pytest.fixture(name="client")
+def get_client() -> TestClient:
+    from docs_src.separate_openapi_schemas.tutorial001_py310 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_py310
+def test_create_item(client: TestClient) -> None:
+    response = client.post("/items/", json={"name": "Foo"})
+    assert response.status_code == 200, response.text
+    assert response.json() == {"name": "Foo", "description": None}
+
+
+@needs_py310
+def test_read_items(client: TestClient) -> None:
+    response = client.get("/items/")
+    assert response.status_code == 200, response.text
+    assert response.json() == [
+        {
+            "name": "Portal Gun",
+            "description": "Device to travel through the multi-rick-verse",
+        },
+        {"name": "Plumbus", "description": None},
+    ]
+
+
+@needs_py310
+@needs_pydanticv2
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "get": {
+                    "summary": "Read Items",
+                    "operationId": "read_items_items__get",
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "items": {
+                                            "$ref": "#/components/schemas/Item-Output"
+                                        },
+                                        "type": "array",
+                                        "title": "Response Read Items Items  Get",
+                                    }
+                                }
+                            },
+                        }
+                    },
+                },
+                "post": {
+                    "summary": "Create Item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item-Input"}
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                },
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "properties": {
+                        "detail": {
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                            "type": "array",
+                            "title": "Detail",
+                        }
+                    },
+                    "type": "object",
+                    "title": "HTTPValidationError",
+                },
+                "Item-Input": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name"],
+                    "title": "Item",
+                },
+                "Item-Output": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name", "description"],
+                    "title": "Item",
+                },
+                "ValidationError": {
+                    "properties": {
+                        "loc": {
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                            "type": "array",
+                            "title": "Location",
+                        },
+                        "msg": {"type": "string", "title": "Message"},
+                        "type": {"type": "string", "title": "Error Type"},
+                    },
+                    "type": "object",
+                    "required": ["loc", "msg", "type"],
+                    "title": "ValidationError",
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py39.py b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py39.py
new file mode 100644
index 000000000..ad36582ed
--- /dev/null
+++ b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py39.py
@@ -0,0 +1,150 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from ...utils import needs_py39, needs_pydanticv2
+
+
+@pytest.fixture(name="client")
+def get_client() -> TestClient:
+    from docs_src.separate_openapi_schemas.tutorial001_py39 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_py39
+def test_create_item(client: TestClient) -> None:
+    response = client.post("/items/", json={"name": "Foo"})
+    assert response.status_code == 200, response.text
+    assert response.json() == {"name": "Foo", "description": None}
+
+
+@needs_py39
+def test_read_items(client: TestClient) -> None:
+    response = client.get("/items/")
+    assert response.status_code == 200, response.text
+    assert response.json() == [
+        {
+            "name": "Portal Gun",
+            "description": "Device to travel through the multi-rick-verse",
+        },
+        {"name": "Plumbus", "description": None},
+    ]
+
+
+@needs_py39
+@needs_pydanticv2
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "get": {
+                    "summary": "Read Items",
+                    "operationId": "read_items_items__get",
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "items": {
+                                            "$ref": "#/components/schemas/Item-Output"
+                                        },
+                                        "type": "array",
+                                        "title": "Response Read Items Items  Get",
+                                    }
+                                }
+                            },
+                        }
+                    },
+                },
+                "post": {
+                    "summary": "Create Item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item-Input"}
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                },
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "properties": {
+                        "detail": {
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                            "type": "array",
+                            "title": "Detail",
+                        }
+                    },
+                    "type": "object",
+                    "title": "HTTPValidationError",
+                },
+                "Item-Input": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name"],
+                    "title": "Item",
+                },
+                "Item-Output": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name", "description"],
+                    "title": "Item",
+                },
+                "ValidationError": {
+                    "properties": {
+                        "loc": {
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                            "type": "array",
+                            "title": "Location",
+                        },
+                        "msg": {"type": "string", "title": "Message"},
+                        "type": {"type": "string", "title": "Error Type"},
+                    },
+                    "type": "object",
+                    "required": ["loc", "msg", "type"],
+                    "title": "ValidationError",
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002.py b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002.py
new file mode 100644
index 000000000..d2cf7945b
--- /dev/null
+++ b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002.py
@@ -0,0 +1,133 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from ...utils import needs_pydanticv2
+
+
+@pytest.fixture(name="client")
+def get_client() -> TestClient:
+    from docs_src.separate_openapi_schemas.tutorial002 import app
+
+    client = TestClient(app)
+    return client
+
+
+def test_create_item(client: TestClient) -> None:
+    response = client.post("/items/", json={"name": "Foo"})
+    assert response.status_code == 200, response.text
+    assert response.json() == {"name": "Foo", "description": None}
+
+
+def test_read_items(client: TestClient) -> None:
+    response = client.get("/items/")
+    assert response.status_code == 200, response.text
+    assert response.json() == [
+        {
+            "name": "Portal Gun",
+            "description": "Device to travel through the multi-rick-verse",
+        },
+        {"name": "Plumbus", "description": None},
+    ]
+
+
+@needs_pydanticv2
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "get": {
+                    "summary": "Read Items",
+                    "operationId": "read_items_items__get",
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "items": {"$ref": "#/components/schemas/Item"},
+                                        "type": "array",
+                                        "title": "Response Read Items Items  Get",
+                                    }
+                                }
+                            },
+                        }
+                    },
+                },
+                "post": {
+                    "summary": "Create Item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item"}
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                },
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "properties": {
+                        "detail": {
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                            "type": "array",
+                            "title": "Detail",
+                        }
+                    },
+                    "type": "object",
+                    "title": "HTTPValidationError",
+                },
+                "Item": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name"],
+                    "title": "Item",
+                },
+                "ValidationError": {
+                    "properties": {
+                        "loc": {
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                            "type": "array",
+                            "title": "Location",
+                        },
+                        "msg": {"type": "string", "title": "Message"},
+                        "type": {"type": "string", "title": "Error Type"},
+                    },
+                    "type": "object",
+                    "required": ["loc", "msg", "type"],
+                    "title": "ValidationError",
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002_py310.py b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002_py310.py
new file mode 100644
index 000000000..89c9ce977
--- /dev/null
+++ b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002_py310.py
@@ -0,0 +1,136 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from ...utils import needs_py310, needs_pydanticv2
+
+
+@pytest.fixture(name="client")
+def get_client() -> TestClient:
+    from docs_src.separate_openapi_schemas.tutorial002_py310 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_py310
+def test_create_item(client: TestClient) -> None:
+    response = client.post("/items/", json={"name": "Foo"})
+    assert response.status_code == 200, response.text
+    assert response.json() == {"name": "Foo", "description": None}
+
+
+@needs_py310
+def test_read_items(client: TestClient) -> None:
+    response = client.get("/items/")
+    assert response.status_code == 200, response.text
+    assert response.json() == [
+        {
+            "name": "Portal Gun",
+            "description": "Device to travel through the multi-rick-verse",
+        },
+        {"name": "Plumbus", "description": None},
+    ]
+
+
+@needs_py310
+@needs_pydanticv2
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "get": {
+                    "summary": "Read Items",
+                    "operationId": "read_items_items__get",
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "items": {"$ref": "#/components/schemas/Item"},
+                                        "type": "array",
+                                        "title": "Response Read Items Items  Get",
+                                    }
+                                }
+                            },
+                        }
+                    },
+                },
+                "post": {
+                    "summary": "Create Item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item"}
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                },
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "properties": {
+                        "detail": {
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                            "type": "array",
+                            "title": "Detail",
+                        }
+                    },
+                    "type": "object",
+                    "title": "HTTPValidationError",
+                },
+                "Item": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name"],
+                    "title": "Item",
+                },
+                "ValidationError": {
+                    "properties": {
+                        "loc": {
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                            "type": "array",
+                            "title": "Location",
+                        },
+                        "msg": {"type": "string", "title": "Message"},
+                        "type": {"type": "string", "title": "Error Type"},
+                    },
+                    "type": "object",
+                    "required": ["loc", "msg", "type"],
+                    "title": "ValidationError",
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002_py39.py b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002_py39.py
new file mode 100644
index 000000000..6ac3d8f79
--- /dev/null
+++ b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial002_py39.py
@@ -0,0 +1,136 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from ...utils import needs_py39, needs_pydanticv2
+
+
+@pytest.fixture(name="client")
+def get_client() -> TestClient:
+    from docs_src.separate_openapi_schemas.tutorial002_py39 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_py39
+def test_create_item(client: TestClient) -> None:
+    response = client.post("/items/", json={"name": "Foo"})
+    assert response.status_code == 200, response.text
+    assert response.json() == {"name": "Foo", "description": None}
+
+
+@needs_py39
+def test_read_items(client: TestClient) -> None:
+    response = client.get("/items/")
+    assert response.status_code == 200, response.text
+    assert response.json() == [
+        {
+            "name": "Portal Gun",
+            "description": "Device to travel through the multi-rick-verse",
+        },
+        {"name": "Plumbus", "description": None},
+    ]
+
+
+@needs_py39
+@needs_pydanticv2
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/": {
+                "get": {
+                    "summary": "Read Items",
+                    "operationId": "read_items_items__get",
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "items": {"$ref": "#/components/schemas/Item"},
+                                        "type": "array",
+                                        "title": "Response Read Items Items  Get",
+                                    }
+                                }
+                            },
+                        }
+                    },
+                },
+                "post": {
+                    "summary": "Create Item",
+                    "operationId": "create_item_items__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/Item"}
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                },
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "properties": {
+                        "detail": {
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                            "type": "array",
+                            "title": "Detail",
+                        }
+                    },
+                    "type": "object",
+                    "title": "HTTPValidationError",
+                },
+                "Item": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "description": {
+                            "anyOf": [{"type": "string"}, {"type": "null"}],
+                            "title": "Description",
+                        },
+                    },
+                    "type": "object",
+                    "required": ["name"],
+                    "title": "Item",
+                },
+                "ValidationError": {
+                    "properties": {
+                        "loc": {
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                            "type": "array",
+                            "title": "Location",
+                        },
+                        "msg": {"type": "string", "title": "Message"},
+                        "type": {"type": "string", "title": "Error Type"},
+                    },
+                    "type": "object",
+                    "required": ["loc", "msg", "type"],
+                    "title": "ValidationError",
+                },
+            }
+        },
+    }

From 098778e07f8d04d3fbf3a21f812ca97ab7daa46e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 25 Aug 2023 19:11:02 +0000
Subject: [PATCH 125/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 61ec91b4a..3858f47da 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ✨ Add support for disabling the separation of input and output JSON Schemas in OpenAPI with Pydantic v2. PR [#10145](https://github.com/tiangolo/fastapi/pull/10145) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Add new docs section, How To - Recipes, move docs that don't have to be read by everyone to How To. PR [#10114](https://github.com/tiangolo/fastapi/pull/10114) by [@tiangolo](https://github.com/tiangolo).
 * ♻️ Refactor tests for new Pydantic 2.2.1. PR [#10115](https://github.com/tiangolo/fastapi/pull/10115) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Update Advanced docs, add links to sponsor courses. PR [#10113](https://github.com/tiangolo/fastapi/pull/10113) by [@tiangolo](https://github.com/tiangolo).

From 859d40407caa3850862526ee689e2d22177cf19e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 25 Aug 2023 21:18:09 +0200
Subject: [PATCH 126/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 3858f47da..517553c9a 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,14 +2,28 @@
 
 ## Latest Changes
 
-* ✨ Add support for disabling the separation of input and output JSON Schemas in OpenAPI with Pydantic v2. PR [#10145](https://github.com/tiangolo/fastapi/pull/10145) by [@tiangolo](https://github.com/tiangolo).
-* 📝 Add new docs section, How To - Recipes, move docs that don't have to be read by everyone to How To. PR [#10114](https://github.com/tiangolo/fastapi/pull/10114) by [@tiangolo](https://github.com/tiangolo).
+
+### Features
+
+* ✨ Add support for disabling the separation of input and output JSON Schemas in OpenAPI with Pydantic v2 with `separate_input_output_schemas=False`. PR [#10145](https://github.com/tiangolo/fastapi/pull/10145) by [@tiangolo](https://github.com/tiangolo).
+    * New docs [Separate OpenAPI Schemas for Input and Output or Not](https://fastapi.tiangolo.com/how-to/separate-openapi-schemas/).
+
+### Refactors
+
 * ♻️ Refactor tests for new Pydantic 2.2.1. PR [#10115](https://github.com/tiangolo/fastapi/pull/10115) by [@tiangolo](https://github.com/tiangolo).
+
+### Docs
+
+* 📝 Add new docs section, How To - Recipes, move docs that don't have to be read by everyone to How To. PR [#10114](https://github.com/tiangolo/fastapi/pull/10114) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Update Advanced docs, add links to sponsor courses. PR [#10113](https://github.com/tiangolo/fastapi/pull/10113) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Update docs for generating clients. PR [#10112](https://github.com/tiangolo/fastapi/pull/10112) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Tweak MkDocs and add redirects. PR [#10111](https://github.com/tiangolo/fastapi/pull/10111) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Restructure docs for cloud providers, include links to sponsors. PR [#10110](https://github.com/tiangolo/fastapi/pull/10110) by [@tiangolo](https://github.com/tiangolo).
+
+### Internal
+
 * 🔧 Update sponsors, add Speakeasy. PR [#10098](https://github.com/tiangolo/fastapi/pull/10098) by [@tiangolo](https://github.com/tiangolo).
+
 ## 0.101.1
 
 ### Fixes

From 9cf9e1084dceb45e50946e4130801012ac0c0c59 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 25 Aug 2023 21:18:38 +0200
Subject: [PATCH 127/317] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.10?=
 =?UTF-8?q?2.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 fastapi/__init__.py           | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 517553c9a..2375bfee5 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+## 0.102.0
 
 ### Features
 
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index d8abf2103..6979ec5fb 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.101.1"
+__version__ = "0.102.0"
 
 from starlette import status as status
 

From f3ab547c0c6e5b42b81e3669aaea753f742b742c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 25 Aug 2023 21:23:44 +0200
Subject: [PATCH 128/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2375bfee5..1a9721e2c 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -8,6 +8,7 @@
 
 * ✨ Add support for disabling the separation of input and output JSON Schemas in OpenAPI with Pydantic v2 with `separate_input_output_schemas=False`. PR [#10145](https://github.com/tiangolo/fastapi/pull/10145) by [@tiangolo](https://github.com/tiangolo).
     * New docs [Separate OpenAPI Schemas for Input and Output or Not](https://fastapi.tiangolo.com/how-to/separate-openapi-schemas/).
+    * This PR also includes a new setup (internal tools) for generating screenshots for the docs.
 
 ### Refactors
 

From 594b1ae0c38550ddfdedab314276c1a659ce4719 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 26 Aug 2023 15:20:04 +0200
Subject: [PATCH 129/317] =?UTF-8?q?=F0=9F=93=9D=20Add=20note=20to=20docs?=
 =?UTF-8?q?=20about=20Separate=20Input=20and=20Output=20Schemas=20with=20F?=
 =?UTF-8?q?astAPI=20version=20(#10150)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/how-to/separate-openapi-schemas.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/en/docs/how-to/separate-openapi-schemas.md b/docs/en/docs/how-to/separate-openapi-schemas.md
index 39d96ea39..d289391ca 100644
--- a/docs/en/docs/how-to/separate-openapi-schemas.md
+++ b/docs/en/docs/how-to/separate-openapi-schemas.md
@@ -199,6 +199,9 @@ Probably the main use case for this is if you already have some autogenerated cl
 
 In that case, you can disable this feature in **FastAPI**, with the parameter `separate_input_output_schemas=False`.
 
+!!! info
+    Support for `separate_input_output_schemas` was added in FastAPI `0.102.0`. 🤓
+
 === "Python 3.10+"
 
     ```Python hl_lines="10"

From 5f855b1179d06c8b82f479013e5888c48e68c716 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 26 Aug 2023 13:20:54 +0000
Subject: [PATCH 130/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 1a9721e2c..5d15e1c25 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 📝 Add note to docs about Separate Input and Output Schemas with FastAPI version. PR [#10150](https://github.com/tiangolo/fastapi/pull/10150) by [@tiangolo](https://github.com/tiangolo).
 ## 0.102.0
 
 ### Features

From 1b714b317732df1e08983e4a8ffe2e4e02c995e0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 26 Aug 2023 20:03:13 +0200
Subject: [PATCH 131/317] =?UTF-8?q?=E2=9C=A8=20Add=20support=20for=20`open?=
 =?UTF-8?q?api=5Fexamples`=20in=20all=20FastAPI=20parameters=20(#10152)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* ♻️ Refactor model for OpenAPI Examples to use a reusable TypedDict

* ✨ Add support for openapi_examples in parameters

* 📝 Add new docs examples for new parameter openapi_examples

* 📝 Update docs for Schema Extra to include OpenAPI examples

* ✅ Add tests for new source examples, for openapi_examples

* ✅ Add tests for openapi_examples corner cases and all parameters

* 💡 Tweak and ignore type annotation checks for custom TypedDict
---
 docs/en/docs/tutorial/schema-extra-example.md | 105 +++-
 docs_src/schema_extra_example/tutorial005.py  |  51 ++
 .../schema_extra_example/tutorial005_an.py    |  55 +++
 .../tutorial005_an_py310.py                   |  54 +++
 .../tutorial005_an_py39.py                    |  54 +++
 .../schema_extra_example/tutorial005_py310.py |  49 ++
 fastapi/openapi/models.py                     |  16 +-
 fastapi/openapi/utils.py                      |  10 +-
 fastapi/param_functions.py                    |  15 +
 fastapi/params.py                             |  17 +
 tests/test_openapi_examples.py                | 455 ++++++++++++++++++
 .../test_tutorial005.py                       | 166 +++++++
 .../test_tutorial005_an.py                    | 166 +++++++
 .../test_tutorial005_an_py310.py              | 170 +++++++
 .../test_tutorial005_an_py39.py               | 170 +++++++
 .../test_tutorial005_py310.py                 | 170 +++++++
 16 files changed, 1695 insertions(+), 28 deletions(-)
 create mode 100644 docs_src/schema_extra_example/tutorial005.py
 create mode 100644 docs_src/schema_extra_example/tutorial005_an.py
 create mode 100644 docs_src/schema_extra_example/tutorial005_an_py310.py
 create mode 100644 docs_src/schema_extra_example/tutorial005_an_py39.py
 create mode 100644 docs_src/schema_extra_example/tutorial005_py310.py
 create mode 100644 tests/test_openapi_examples.py
 create mode 100644 tests/test_tutorial/test_schema_extra_example/test_tutorial005.py
 create mode 100644 tests/test_tutorial/test_schema_extra_example/test_tutorial005_an.py
 create mode 100644 tests/test_tutorial/test_schema_extra_example/test_tutorial005_an_py310.py
 create mode 100644 tests/test_tutorial/test_schema_extra_example/test_tutorial005_an_py39.py
 create mode 100644 tests/test_tutorial/test_schema_extra_example/test_tutorial005_py310.py

diff --git a/docs/en/docs/tutorial/schema-extra-example.md b/docs/en/docs/tutorial/schema-extra-example.md
index 39d184763..8cf1b9c09 100644
--- a/docs/en/docs/tutorial/schema-extra-example.md
+++ b/docs/en/docs/tutorial/schema-extra-example.md
@@ -74,7 +74,7 @@ When using `Field()` with Pydantic models, you can also declare additional `exam
     {!> ../../../docs_src/schema_extra_example/tutorial002.py!}
     ```
 
-## `examples` in OpenAPI
+## `examples` in JSON Schema - OpenAPI
 
 When using any of:
 
@@ -86,7 +86,7 @@ When using any of:
 * `Form()`
 * `File()`
 
-you can also declare a group of `examples` with additional information that will be added to **OpenAPI**.
+you can also declare a group of `examples` with additional information that will be added to their **JSON Schemas** inside of **OpenAPI**.
 
 ### `Body` with `examples`
 
@@ -174,9 +174,84 @@ You can of course also pass multiple `examples`:
     {!> ../../../docs_src/schema_extra_example/tutorial004.py!}
     ```
 
-### Examples in the docs UI
+When you do this, the examples will be part of the internal **JSON Schema** for that body data.
 
-With `examples` added to `Body()` the `/docs` would look like:
+Nevertheless, at the <abbr title="2023-08-26">time of writing this</abbr>, Swagger UI, the tool in charge of showing the docs UI, doesn't support showing multiple examples for the data in **JSON Schema**. But read below for a workaround.
+
+### OpenAPI-specific `examples`
+
+Since before **JSON Schema** supported `examples` OpenAPI had support for a different field also called `examples`.
+
+This **OpenAPI-specific** `examples` goes in another section in the OpenAPI specification. It goes in the **details for each *path operation***, not inside each JSON Schema.
+
+And Swagger UI has supported this particular `examples` field for a while. So, you can use it to **show** different **examples in the docs UI**.
+
+The shape of this OpenAPI-specific field `examples` is a `dict` with **multiple examples** (instead of a `list`), each with extra information that will be added to **OpenAPI** too.
+
+This doesn't go inside of each JSON Schema contained in OpenAPI, this goes outside, in the *path operation* directly.
+
+### Using the `openapi_examples` Parameter
+
+You can declare the OpenAPI-specific `examples` in FastAPI with the parameter `openapi_examples` for:
+
+* `Path()`
+* `Query()`
+* `Header()`
+* `Cookie()`
+* `Body()`
+* `Form()`
+* `File()`
+
+The keys of the `dict` identify each example, and each value is another `dict`.
+
+Each specific example `dict` in the `examples` can contain:
+
+* `summary`: Short description for the example.
+* `description`: A long description that can contain Markdown text.
+* `value`: This is the actual example shown, e.g. a `dict`.
+* `externalValue`: alternative to `value`, a URL pointing to the example. Although this might not be supported by as many tools as `value`.
+
+You can use it like this:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="23-49"
+    {!> ../../../docs_src/schema_extra_example/tutorial005_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="23-49"
+    {!> ../../../docs_src/schema_extra_example/tutorial005_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="24-50"
+    {!> ../../../docs_src/schema_extra_example/tutorial005_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        Prefer to use the `Annotated` version if possible.
+
+    ```Python hl_lines="19-45"
+    {!> ../../../docs_src/schema_extra_example/tutorial005_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        Prefer to use the `Annotated` version if possible.
+
+    ```Python hl_lines="21-47"
+    {!> ../../../docs_src/schema_extra_example/tutorial005.py!}
+    ```
+
+### OpenAPI Examples in the Docs UI
+
+With `openapi_examples` added to `Body()` the `/docs` would look like:
 
 <img src="/img/tutorial/body-fields/image02.png">
 
@@ -210,20 +285,8 @@ OpenAPI also added `example` and `examples` fields to other parts of the specifi
     * `File()`
     * `Form()`
 
-### OpenAPI's `examples` field
-
-The shape of this field `examples` from OpenAPI is a `dict` with **multiple examples**, each with extra information that will be added to **OpenAPI** too.
-
-The keys of the `dict` identify each example, and each value is another `dict`.
-
-Each specific example `dict` in the `examples` can contain:
-
-* `summary`: Short description for the example.
-* `description`: A long description that can contain Markdown text.
-* `value`: This is the actual example shown, e.g. a `dict`.
-* `externalValue`: alternative to `value`, a URL pointing to the example. Although this might not be supported by as many tools as `value`.
-
-This applies to those other parts of the OpenAPI specification apart from JSON Schema.
+!!! info
+    This old OpenAPI-specific `examples` parameter is now `openapi_examples` since FastAPI `0.103.0`.
 
 ### JSON Schema's `examples` field
 
@@ -250,6 +313,12 @@ In versions of FastAPI before 0.99.0 (0.99.0 and above use the newer OpenAPI 3.1
 
 But now that FastAPI 0.99.0 and above uses OpenAPI 3.1.0, that uses JSON Schema 2020-12, and Swagger UI 5.0.0 and above, everything is more consistent and the examples are included in JSON Schema.
 
+### Swagger UI and OpenAPI-specific `examples`
+
+Now, as Swagger UI didn't support multiple JSON Schema examples (as of 2023-08-26), users didn't have a way to show multiple examples in the docs.
+
+To solve that, FastAPI `0.103.0` **added support** for declaring the same old **OpenAPI-specific** `examples` field with the new parameter `openapi_examples`. 🤓
+
 ### Summary
 
 I used to say I didn't like history that much... and look at me now giving "tech history" lessons. 😅
diff --git a/docs_src/schema_extra_example/tutorial005.py b/docs_src/schema_extra_example/tutorial005.py
new file mode 100644
index 000000000..b8217c27e
--- /dev/null
+++ b/docs_src/schema_extra_example/tutorial005.py
@@ -0,0 +1,51 @@
+from typing import Union
+
+from fastapi import Body, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Item(BaseModel):
+    name: str
+    description: Union[str, None] = None
+    price: float
+    tax: Union[float, None] = None
+
+
+@app.put("/items/{item_id}")
+async def update_item(
+    *,
+    item_id: int,
+    item: Item = Body(
+        openapi_examples={
+            "normal": {
+                "summary": "A normal example",
+                "description": "A **normal** item works correctly.",
+                "value": {
+                    "name": "Foo",
+                    "description": "A very nice Item",
+                    "price": 35.4,
+                    "tax": 3.2,
+                },
+            },
+            "converted": {
+                "summary": "An example with converted data",
+                "description": "FastAPI can convert price `strings` to actual `numbers` automatically",
+                "value": {
+                    "name": "Bar",
+                    "price": "35.4",
+                },
+            },
+            "invalid": {
+                "summary": "Invalid data is rejected with an error",
+                "value": {
+                    "name": "Baz",
+                    "price": "thirty five point four",
+                },
+            },
+        },
+    ),
+):
+    results = {"item_id": item_id, "item": item}
+    return results
diff --git a/docs_src/schema_extra_example/tutorial005_an.py b/docs_src/schema_extra_example/tutorial005_an.py
new file mode 100644
index 000000000..4b2d9c662
--- /dev/null
+++ b/docs_src/schema_extra_example/tutorial005_an.py
@@ -0,0 +1,55 @@
+from typing import Union
+
+from fastapi import Body, FastAPI
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class Item(BaseModel):
+    name: str
+    description: Union[str, None] = None
+    price: float
+    tax: Union[float, None] = None
+
+
+@app.put("/items/{item_id}")
+async def update_item(
+    *,
+    item_id: int,
+    item: Annotated[
+        Item,
+        Body(
+            openapi_examples={
+                "normal": {
+                    "summary": "A normal example",
+                    "description": "A **normal** item works correctly.",
+                    "value": {
+                        "name": "Foo",
+                        "description": "A very nice Item",
+                        "price": 35.4,
+                        "tax": 3.2,
+                    },
+                },
+                "converted": {
+                    "summary": "An example with converted data",
+                    "description": "FastAPI can convert price `strings` to actual `numbers` automatically",
+                    "value": {
+                        "name": "Bar",
+                        "price": "35.4",
+                    },
+                },
+                "invalid": {
+                    "summary": "Invalid data is rejected with an error",
+                    "value": {
+                        "name": "Baz",
+                        "price": "thirty five point four",
+                    },
+                },
+            },
+        ),
+    ],
+):
+    results = {"item_id": item_id, "item": item}
+    return results
diff --git a/docs_src/schema_extra_example/tutorial005_an_py310.py b/docs_src/schema_extra_example/tutorial005_an_py310.py
new file mode 100644
index 000000000..64dc2cf90
--- /dev/null
+++ b/docs_src/schema_extra_example/tutorial005_an_py310.py
@@ -0,0 +1,54 @@
+from typing import Annotated
+
+from fastapi import Body, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Item(BaseModel):
+    name: str
+    description: str | None = None
+    price: float
+    tax: float | None = None
+
+
+@app.put("/items/{item_id}")
+async def update_item(
+    *,
+    item_id: int,
+    item: Annotated[
+        Item,
+        Body(
+            openapi_examples={
+                "normal": {
+                    "summary": "A normal example",
+                    "description": "A **normal** item works correctly.",
+                    "value": {
+                        "name": "Foo",
+                        "description": "A very nice Item",
+                        "price": 35.4,
+                        "tax": 3.2,
+                    },
+                },
+                "converted": {
+                    "summary": "An example with converted data",
+                    "description": "FastAPI can convert price `strings` to actual `numbers` automatically",
+                    "value": {
+                        "name": "Bar",
+                        "price": "35.4",
+                    },
+                },
+                "invalid": {
+                    "summary": "Invalid data is rejected with an error",
+                    "value": {
+                        "name": "Baz",
+                        "price": "thirty five point four",
+                    },
+                },
+            },
+        ),
+    ],
+):
+    results = {"item_id": item_id, "item": item}
+    return results
diff --git a/docs_src/schema_extra_example/tutorial005_an_py39.py b/docs_src/schema_extra_example/tutorial005_an_py39.py
new file mode 100644
index 000000000..edeb1affc
--- /dev/null
+++ b/docs_src/schema_extra_example/tutorial005_an_py39.py
@@ -0,0 +1,54 @@
+from typing import Annotated, Union
+
+from fastapi import Body, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Item(BaseModel):
+    name: str
+    description: Union[str, None] = None
+    price: float
+    tax: Union[float, None] = None
+
+
+@app.put("/items/{item_id}")
+async def update_item(
+    *,
+    item_id: int,
+    item: Annotated[
+        Item,
+        Body(
+            openapi_examples={
+                "normal": {
+                    "summary": "A normal example",
+                    "description": "A **normal** item works correctly.",
+                    "value": {
+                        "name": "Foo",
+                        "description": "A very nice Item",
+                        "price": 35.4,
+                        "tax": 3.2,
+                    },
+                },
+                "converted": {
+                    "summary": "An example with converted data",
+                    "description": "FastAPI can convert price `strings` to actual `numbers` automatically",
+                    "value": {
+                        "name": "Bar",
+                        "price": "35.4",
+                    },
+                },
+                "invalid": {
+                    "summary": "Invalid data is rejected with an error",
+                    "value": {
+                        "name": "Baz",
+                        "price": "thirty five point four",
+                    },
+                },
+            },
+        ),
+    ],
+):
+    results = {"item_id": item_id, "item": item}
+    return results
diff --git a/docs_src/schema_extra_example/tutorial005_py310.py b/docs_src/schema_extra_example/tutorial005_py310.py
new file mode 100644
index 000000000..eef973343
--- /dev/null
+++ b/docs_src/schema_extra_example/tutorial005_py310.py
@@ -0,0 +1,49 @@
+from fastapi import Body, FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Item(BaseModel):
+    name: str
+    description: str | None = None
+    price: float
+    tax: float | None = None
+
+
+@app.put("/items/{item_id}")
+async def update_item(
+    *,
+    item_id: int,
+    item: Item = Body(
+        openapi_examples={
+            "normal": {
+                "summary": "A normal example",
+                "description": "A **normal** item works correctly.",
+                "value": {
+                    "name": "Foo",
+                    "description": "A very nice Item",
+                    "price": 35.4,
+                    "tax": 3.2,
+                },
+            },
+            "converted": {
+                "summary": "An example with converted data",
+                "description": "FastAPI can convert price `strings` to actual `numbers` automatically",
+                "value": {
+                    "name": "Bar",
+                    "price": "35.4",
+                },
+            },
+            "invalid": {
+                "summary": "Invalid data is rejected with an error",
+                "value": {
+                    "name": "Baz",
+                    "price": "thirty five point four",
+                },
+            },
+        },
+    ),
+):
+    results = {"item_id": item_id, "item": item}
+    return results
diff --git a/fastapi/openapi/models.py b/fastapi/openapi/models.py
index 2268dd229..3d982eb9a 100644
--- a/fastapi/openapi/models.py
+++ b/fastapi/openapi/models.py
@@ -11,7 +11,7 @@ from fastapi._compat import (
 )
 from fastapi.logger import logger
 from pydantic import AnyUrl, BaseModel, Field
-from typing_extensions import Annotated, Literal
+from typing_extensions import Annotated, Literal, TypedDict
 from typing_extensions import deprecated as typing_deprecated
 
 try:
@@ -267,14 +267,14 @@ class Schema(BaseModel):
 SchemaOrBool = Union[Schema, bool]
 
 
-class Example(BaseModel):
-    summary: Optional[str] = None
-    description: Optional[str] = None
-    value: Optional[Any] = None
-    externalValue: Optional[AnyUrl] = None
+class Example(TypedDict, total=False):
+    summary: Optional[str]
+    description: Optional[str]
+    value: Optional[Any]
+    externalValue: Optional[AnyUrl]
 
-    if PYDANTIC_V2:
-        model_config = {"extra": "allow"}
+    if PYDANTIC_V2:  # type: ignore [misc]
+        __pydantic_config__ = {"extra": "allow"}
 
     else:
 
diff --git a/fastapi/openapi/utils.py b/fastapi/openapi/utils.py
index 9498375fe..5bfb5acef 100644
--- a/fastapi/openapi/utils.py
+++ b/fastapi/openapi/utils.py
@@ -118,7 +118,9 @@ def get_openapi_operation_parameters(
         }
         if field_info.description:
             parameter["description"] = field_info.description
-        if field_info.example != Undefined:
+        if field_info.openapi_examples:
+            parameter["examples"] = jsonable_encoder(field_info.openapi_examples)
+        elif field_info.example != Undefined:
             parameter["example"] = jsonable_encoder(field_info.example)
         if field_info.deprecated:
             parameter["deprecated"] = field_info.deprecated
@@ -153,7 +155,11 @@ def get_openapi_operation_request_body(
     if required:
         request_body_oai["required"] = required
     request_media_content: Dict[str, Any] = {"schema": body_schema}
-    if field_info.example != Undefined:
+    if field_info.openapi_examples:
+        request_media_content["examples"] = jsonable_encoder(
+            field_info.openapi_examples
+        )
+    elif field_info.example != Undefined:
         request_media_content["example"] = jsonable_encoder(field_info.example)
     request_body_oai["content"] = {request_media_type: request_media_content}
     return request_body_oai
diff --git a/fastapi/param_functions.py b/fastapi/param_functions.py
index a43afaf31..63914d1d6 100644
--- a/fastapi/param_functions.py
+++ b/fastapi/param_functions.py
@@ -2,6 +2,7 @@ from typing import Any, Callable, Dict, List, Optional, Sequence, Union
 
 from fastapi import params
 from fastapi._compat import Undefined
+from fastapi.openapi.models import Example
 from typing_extensions import Annotated, deprecated
 
 _Unset: Any = Undefined
@@ -46,6 +47,7 @@ def Path(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
+    openapi_examples: Optional[Dict[str, Example]] = None,
     deprecated: Optional[bool] = None,
     include_in_schema: bool = True,
     json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -76,6 +78,7 @@ def Path(  # noqa: N802
         decimal_places=decimal_places,
         example=example,
         examples=examples,
+        openapi_examples=openapi_examples,
         deprecated=deprecated,
         include_in_schema=include_in_schema,
         json_schema_extra=json_schema_extra,
@@ -122,6 +125,7 @@ def Query(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
+    openapi_examples: Optional[Dict[str, Example]] = None,
     deprecated: Optional[bool] = None,
     include_in_schema: bool = True,
     json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -152,6 +156,7 @@ def Query(  # noqa: N802
         decimal_places=decimal_places,
         example=example,
         examples=examples,
+        openapi_examples=openapi_examples,
         deprecated=deprecated,
         include_in_schema=include_in_schema,
         json_schema_extra=json_schema_extra,
@@ -199,6 +204,7 @@ def Header(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
+    openapi_examples: Optional[Dict[str, Example]] = None,
     deprecated: Optional[bool] = None,
     include_in_schema: bool = True,
     json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -230,6 +236,7 @@ def Header(  # noqa: N802
         decimal_places=decimal_places,
         example=example,
         examples=examples,
+        openapi_examples=openapi_examples,
         deprecated=deprecated,
         include_in_schema=include_in_schema,
         json_schema_extra=json_schema_extra,
@@ -276,6 +283,7 @@ def Cookie(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
+    openapi_examples: Optional[Dict[str, Example]] = None,
     deprecated: Optional[bool] = None,
     include_in_schema: bool = True,
     json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -306,6 +314,7 @@ def Cookie(  # noqa: N802
         decimal_places=decimal_places,
         example=example,
         examples=examples,
+        openapi_examples=openapi_examples,
         deprecated=deprecated,
         include_in_schema=include_in_schema,
         json_schema_extra=json_schema_extra,
@@ -354,6 +363,7 @@ def Body(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
+    openapi_examples: Optional[Dict[str, Example]] = None,
     deprecated: Optional[bool] = None,
     include_in_schema: bool = True,
     json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -386,6 +396,7 @@ def Body(  # noqa: N802
         decimal_places=decimal_places,
         example=example,
         examples=examples,
+        openapi_examples=openapi_examples,
         deprecated=deprecated,
         include_in_schema=include_in_schema,
         json_schema_extra=json_schema_extra,
@@ -433,6 +444,7 @@ def Form(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
+    openapi_examples: Optional[Dict[str, Example]] = None,
     deprecated: Optional[bool] = None,
     include_in_schema: bool = True,
     json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -464,6 +476,7 @@ def Form(  # noqa: N802
         decimal_places=decimal_places,
         example=example,
         examples=examples,
+        openapi_examples=openapi_examples,
         deprecated=deprecated,
         include_in_schema=include_in_schema,
         json_schema_extra=json_schema_extra,
@@ -511,6 +524,7 @@ def File(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
+    openapi_examples: Optional[Dict[str, Example]] = None,
     deprecated: Optional[bool] = None,
     include_in_schema: bool = True,
     json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -542,6 +556,7 @@ def File(  # noqa: N802
         decimal_places=decimal_places,
         example=example,
         examples=examples,
+        openapi_examples=openapi_examples,
         deprecated=deprecated,
         include_in_schema=include_in_schema,
         json_schema_extra=json_schema_extra,
diff --git a/fastapi/params.py b/fastapi/params.py
index 2d8100650..b40944dba 100644
--- a/fastapi/params.py
+++ b/fastapi/params.py
@@ -2,6 +2,7 @@ import warnings
 from enum import Enum
 from typing import Any, Callable, Dict, List, Optional, Sequence, Union
 
+from fastapi.openapi.models import Example
 from pydantic.fields import FieldInfo
 from typing_extensions import Annotated, deprecated
 
@@ -61,6 +62,7 @@ class Param(FieldInfo):
                 "although still supported. Use examples instead."
             ),
         ] = _Unset,
+        openapi_examples: Optional[Dict[str, Example]] = None,
         deprecated: Optional[bool] = None,
         include_in_schema: bool = True,
         json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -75,6 +77,7 @@ class Param(FieldInfo):
             )
         self.example = example
         self.include_in_schema = include_in_schema
+        self.openapi_examples = openapi_examples
         kwargs = dict(
             default=default,
             default_factory=default_factory,
@@ -170,6 +173,7 @@ class Path(Param):
                 "although still supported. Use examples instead."
             ),
         ] = _Unset,
+        openapi_examples: Optional[Dict[str, Example]] = None,
         deprecated: Optional[bool] = None,
         include_in_schema: bool = True,
         json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -204,6 +208,7 @@ class Path(Param):
             deprecated=deprecated,
             example=example,
             examples=examples,
+            openapi_examples=openapi_examples,
             include_in_schema=include_in_schema,
             json_schema_extra=json_schema_extra,
             **extra,
@@ -254,6 +259,7 @@ class Query(Param):
                 "although still supported. Use examples instead."
             ),
         ] = _Unset,
+        openapi_examples: Optional[Dict[str, Example]] = None,
         deprecated: Optional[bool] = None,
         include_in_schema: bool = True,
         json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -286,6 +292,7 @@ class Query(Param):
             deprecated=deprecated,
             example=example,
             examples=examples,
+            openapi_examples=openapi_examples,
             include_in_schema=include_in_schema,
             json_schema_extra=json_schema_extra,
             **extra,
@@ -337,6 +344,7 @@ class Header(Param):
                 "although still supported. Use examples instead."
             ),
         ] = _Unset,
+        openapi_examples: Optional[Dict[str, Example]] = None,
         deprecated: Optional[bool] = None,
         include_in_schema: bool = True,
         json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -370,6 +378,7 @@ class Header(Param):
             deprecated=deprecated,
             example=example,
             examples=examples,
+            openapi_examples=openapi_examples,
             include_in_schema=include_in_schema,
             json_schema_extra=json_schema_extra,
             **extra,
@@ -420,6 +429,7 @@ class Cookie(Param):
                 "although still supported. Use examples instead."
             ),
         ] = _Unset,
+        openapi_examples: Optional[Dict[str, Example]] = None,
         deprecated: Optional[bool] = None,
         include_in_schema: bool = True,
         json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -452,6 +462,7 @@ class Cookie(Param):
             deprecated=deprecated,
             example=example,
             examples=examples,
+            openapi_examples=openapi_examples,
             include_in_schema=include_in_schema,
             json_schema_extra=json_schema_extra,
             **extra,
@@ -502,6 +513,7 @@ class Body(FieldInfo):
                 "although still supported. Use examples instead."
             ),
         ] = _Unset,
+        openapi_examples: Optional[Dict[str, Example]] = None,
         deprecated: Optional[bool] = None,
         include_in_schema: bool = True,
         json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -518,6 +530,7 @@ class Body(FieldInfo):
             )
         self.example = example
         self.include_in_schema = include_in_schema
+        self.openapi_examples = openapi_examples
         kwargs = dict(
             default=default,
             default_factory=default_factory,
@@ -613,6 +626,7 @@ class Form(Body):
                 "although still supported. Use examples instead."
             ),
         ] = _Unset,
+        openapi_examples: Optional[Dict[str, Example]] = None,
         deprecated: Optional[bool] = None,
         include_in_schema: bool = True,
         json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -647,6 +661,7 @@ class Form(Body):
             deprecated=deprecated,
             example=example,
             examples=examples,
+            openapi_examples=openapi_examples,
             include_in_schema=include_in_schema,
             json_schema_extra=json_schema_extra,
             **extra,
@@ -696,6 +711,7 @@ class File(Form):
                 "although still supported. Use examples instead."
             ),
         ] = _Unset,
+        openapi_examples: Optional[Dict[str, Example]] = None,
         deprecated: Optional[bool] = None,
         include_in_schema: bool = True,
         json_schema_extra: Union[Dict[str, Any], None] = None,
@@ -729,6 +745,7 @@ class File(Form):
             deprecated=deprecated,
             example=example,
             examples=examples,
+            openapi_examples=openapi_examples,
             include_in_schema=include_in_schema,
             json_schema_extra=json_schema_extra,
             **extra,
diff --git a/tests/test_openapi_examples.py b/tests/test_openapi_examples.py
new file mode 100644
index 000000000..d0e35953e
--- /dev/null
+++ b/tests/test_openapi_examples.py
@@ -0,0 +1,455 @@
+from typing import Union
+
+from dirty_equals import IsDict
+from fastapi import Body, Cookie, FastAPI, Header, Path, Query
+from fastapi.testclient import TestClient
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Item(BaseModel):
+    data: str
+
+
+@app.post("/examples/")
+def examples(
+    item: Item = Body(
+        examples=[
+            {"data": "Data in Body examples, example1"},
+        ],
+        openapi_examples={
+            "Example One": {
+                "summary": "Example One Summary",
+                "description": "Example One Description",
+                "value": {"data": "Data in Body examples, example1"},
+            },
+            "Example Two": {
+                "value": {"data": "Data in Body examples, example2"},
+            },
+        },
+    )
+):
+    return item
+
+
+@app.get("/path_examples/{item_id}")
+def path_examples(
+    item_id: str = Path(
+        examples=[
+            "json_schema_item_1",
+            "json_schema_item_2",
+        ],
+        openapi_examples={
+            "Path One": {
+                "summary": "Path One Summary",
+                "description": "Path One Description",
+                "value": "item_1",
+            },
+            "Path Two": {
+                "value": "item_2",
+            },
+        },
+    ),
+):
+    return item_id
+
+
+@app.get("/query_examples/")
+def query_examples(
+    data: Union[str, None] = Query(
+        default=None,
+        examples=[
+            "json_schema_query1",
+            "json_schema_query2",
+        ],
+        openapi_examples={
+            "Query One": {
+                "summary": "Query One Summary",
+                "description": "Query One Description",
+                "value": "query1",
+            },
+            "Query Two": {
+                "value": "query2",
+            },
+        },
+    ),
+):
+    return data
+
+
+@app.get("/header_examples/")
+def header_examples(
+    data: Union[str, None] = Header(
+        default=None,
+        examples=[
+            "json_schema_header1",
+            "json_schema_header2",
+        ],
+        openapi_examples={
+            "Header One": {
+                "summary": "Header One Summary",
+                "description": "Header One Description",
+                "value": "header1",
+            },
+            "Header Two": {
+                "value": "header2",
+            },
+        },
+    ),
+):
+    return data
+
+
+@app.get("/cookie_examples/")
+def cookie_examples(
+    data: Union[str, None] = Cookie(
+        default=None,
+        examples=["json_schema_cookie1", "json_schema_cookie2"],
+        openapi_examples={
+            "Cookie One": {
+                "summary": "Cookie One Summary",
+                "description": "Cookie One Description",
+                "value": "cookie1",
+            },
+            "Cookie Two": {
+                "value": "cookie2",
+            },
+        },
+    ),
+):
+    return data
+
+
+client = TestClient(app)
+
+
+def test_call_api():
+    response = client.get("/path_examples/foo")
+    assert response.status_code == 200, response.text
+
+    response = client.get("/query_examples/")
+    assert response.status_code == 200, response.text
+
+    response = client.get("/header_examples/")
+    assert response.status_code == 200, response.text
+
+    response = client.get("/cookie_examples/")
+    assert response.status_code == 200, response.text
+
+
+def test_openapi_schema():
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/examples/": {
+                "post": {
+                    "summary": "Examples",
+                    "operationId": "examples_examples__post",
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "allOf": [{"$ref": "#/components/schemas/Item"}],
+                                    "title": "Item",
+                                    "examples": [
+                                        {"data": "Data in Body examples, example1"}
+                                    ],
+                                },
+                                "examples": {
+                                    "Example One": {
+                                        "summary": "Example One Summary",
+                                        "description": "Example One Description",
+                                        "value": {
+                                            "data": "Data in Body examples, example1"
+                                        },
+                                    },
+                                    "Example Two": {
+                                        "value": {
+                                            "data": "Data in Body examples, example2"
+                                        }
+                                    },
+                                },
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            },
+            "/path_examples/{item_id}": {
+                "get": {
+                    "summary": "Path Examples",
+                    "operationId": "path_examples_path_examples__item_id__get",
+                    "parameters": [
+                        {
+                            "name": "item_id",
+                            "in": "path",
+                            "required": True,
+                            "schema": {
+                                "type": "string",
+                                "examples": [
+                                    "json_schema_item_1",
+                                    "json_schema_item_2",
+                                ],
+                                "title": "Item Id",
+                            },
+                            "examples": {
+                                "Path One": {
+                                    "summary": "Path One Summary",
+                                    "description": "Path One Description",
+                                    "value": "item_1",
+                                },
+                                "Path Two": {"value": "item_2"},
+                            },
+                        }
+                    ],
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            },
+            "/query_examples/": {
+                "get": {
+                    "summary": "Query Examples",
+                    "operationId": "query_examples_query_examples__get",
+                    "parameters": [
+                        {
+                            "name": "data",
+                            "in": "query",
+                            "required": False,
+                            "schema": IsDict(
+                                {
+                                    "anyOf": [{"type": "string"}, {"type": "null"}],
+                                    "examples": [
+                                        "json_schema_query1",
+                                        "json_schema_query2",
+                                    ],
+                                    "title": "Data",
+                                }
+                            )
+                            | IsDict(
+                                # TODO: remove when deprecating Pydantic v1
+                                {
+                                    "examples": [
+                                        "json_schema_query1",
+                                        "json_schema_query2",
+                                    ],
+                                    "type": "string",
+                                    "title": "Data",
+                                }
+                            ),
+                            "examples": {
+                                "Query One": {
+                                    "summary": "Query One Summary",
+                                    "description": "Query One Description",
+                                    "value": "query1",
+                                },
+                                "Query Two": {"value": "query2"},
+                            },
+                        }
+                    ],
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            },
+            "/header_examples/": {
+                "get": {
+                    "summary": "Header Examples",
+                    "operationId": "header_examples_header_examples__get",
+                    "parameters": [
+                        {
+                            "name": "data",
+                            "in": "header",
+                            "required": False,
+                            "schema": IsDict(
+                                {
+                                    "anyOf": [{"type": "string"}, {"type": "null"}],
+                                    "examples": [
+                                        "json_schema_header1",
+                                        "json_schema_header2",
+                                    ],
+                                    "title": "Data",
+                                }
+                            )
+                            | IsDict(
+                                # TODO: remove when deprecating Pydantic v1
+                                {
+                                    "type": "string",
+                                    "examples": [
+                                        "json_schema_header1",
+                                        "json_schema_header2",
+                                    ],
+                                    "title": "Data",
+                                }
+                            ),
+                            "examples": {
+                                "Header One": {
+                                    "summary": "Header One Summary",
+                                    "description": "Header One Description",
+                                    "value": "header1",
+                                },
+                                "Header Two": {"value": "header2"},
+                            },
+                        }
+                    ],
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            },
+            "/cookie_examples/": {
+                "get": {
+                    "summary": "Cookie Examples",
+                    "operationId": "cookie_examples_cookie_examples__get",
+                    "parameters": [
+                        {
+                            "name": "data",
+                            "in": "cookie",
+                            "required": False,
+                            "schema": IsDict(
+                                {
+                                    "anyOf": [{"type": "string"}, {"type": "null"}],
+                                    "examples": [
+                                        "json_schema_cookie1",
+                                        "json_schema_cookie2",
+                                    ],
+                                    "title": "Data",
+                                }
+                            )
+                            | IsDict(
+                                # TODO: remove when deprecating Pydantic v1
+                                {
+                                    "type": "string",
+                                    "examples": [
+                                        "json_schema_cookie1",
+                                        "json_schema_cookie2",
+                                    ],
+                                    "title": "Data",
+                                }
+                            ),
+                            "examples": {
+                                "Cookie One": {
+                                    "summary": "Cookie One Summary",
+                                    "description": "Cookie One Description",
+                                    "value": "cookie1",
+                                },
+                                "Cookie Two": {"value": "cookie2"},
+                            },
+                        }
+                    ],
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            },
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "properties": {
+                        "detail": {
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                            "type": "array",
+                            "title": "Detail",
+                        }
+                    },
+                    "type": "object",
+                    "title": "HTTPValidationError",
+                },
+                "Item": {
+                    "properties": {"data": {"type": "string", "title": "Data"}},
+                    "type": "object",
+                    "required": ["data"],
+                    "title": "Item",
+                },
+                "ValidationError": {
+                    "properties": {
+                        "loc": {
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                            "type": "array",
+                            "title": "Location",
+                        },
+                        "msg": {"type": "string", "title": "Message"},
+                        "type": {"type": "string", "title": "Error Type"},
+                    },
+                    "type": "object",
+                    "required": ["loc", "msg", "type"],
+                    "title": "ValidationError",
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_schema_extra_example/test_tutorial005.py b/tests/test_tutorial/test_schema_extra_example/test_tutorial005.py
new file mode 100644
index 000000000..94a40ed5a
--- /dev/null
+++ b/tests/test_tutorial/test_schema_extra_example/test_tutorial005.py
@@ -0,0 +1,166 @@
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.schema_extra_example.tutorial005 import app
+
+    client = TestClient(app)
+    return client
+
+
+def test_post_body_example(client: TestClient):
+    response = client.put(
+        "/items/5",
+        json={
+            "name": "Foo",
+            "description": "A very nice Item",
+            "price": 35.4,
+            "tax": 3.2,
+        },
+    )
+    assert response.status_code == 200
+
+
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/{item_id}": {
+                "put": {
+                    "summary": "Update Item",
+                    "operationId": "update_item_items__item_id__put",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "integer"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": IsDict({"$ref": "#/components/schemas/Item"})
+                                | IsDict(
+                                    # TODO: remove when deprecating Pydantic v1
+                                    {
+                                        "allOf": [
+                                            {"$ref": "#/components/schemas/Item"}
+                                        ],
+                                        "title": "Item",
+                                    }
+                                ),
+                                "examples": {
+                                    "normal": {
+                                        "summary": "A normal example",
+                                        "description": "A **normal** item works correctly.",
+                                        "value": {
+                                            "name": "Foo",
+                                            "description": "A very nice Item",
+                                            "price": 35.4,
+                                            "tax": 3.2,
+                                        },
+                                    },
+                                    "converted": {
+                                        "summary": "An example with converted data",
+                                        "description": "FastAPI can convert price `strings` to actual `numbers` automatically",
+                                        "value": {"name": "Bar", "price": "35.4"},
+                                    },
+                                    "invalid": {
+                                        "summary": "Invalid data is rejected with an error",
+                                        "value": {
+                                            "name": "Baz",
+                                            "price": "thirty five point four",
+                                        },
+                                    },
+                                },
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+                "Item": {
+                    "title": "Item",
+                    "required": ["name", "price"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": IsDict(
+                            {
+                                "title": "Description",
+                                "anyOf": [{"type": "string"}, {"type": "null"}],
+                            }
+                        )
+                        | IsDict(
+                            # TODO: remove when deprecating Pydantic v1
+                            {"title": "Description", "type": "string"}
+                        ),
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": IsDict(
+                            {
+                                "title": "Tax",
+                                "anyOf": [{"type": "number"}, {"type": "null"}],
+                            }
+                        )
+                        | IsDict(
+                            # TODO: remove when deprecating Pydantic v1
+                            {"title": "Tax", "type": "number"}
+                        ),
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_schema_extra_example/test_tutorial005_an.py b/tests/test_tutorial/test_schema_extra_example/test_tutorial005_an.py
new file mode 100644
index 000000000..da92f98f6
--- /dev/null
+++ b/tests/test_tutorial/test_schema_extra_example/test_tutorial005_an.py
@@ -0,0 +1,166 @@
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.schema_extra_example.tutorial005_an import app
+
+    client = TestClient(app)
+    return client
+
+
+def test_post_body_example(client: TestClient):
+    response = client.put(
+        "/items/5",
+        json={
+            "name": "Foo",
+            "description": "A very nice Item",
+            "price": 35.4,
+            "tax": 3.2,
+        },
+    )
+    assert response.status_code == 200
+
+
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/{item_id}": {
+                "put": {
+                    "summary": "Update Item",
+                    "operationId": "update_item_items__item_id__put",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "integer"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": IsDict({"$ref": "#/components/schemas/Item"})
+                                | IsDict(
+                                    # TODO: remove when deprecating Pydantic v1
+                                    {
+                                        "allOf": [
+                                            {"$ref": "#/components/schemas/Item"}
+                                        ],
+                                        "title": "Item",
+                                    }
+                                ),
+                                "examples": {
+                                    "normal": {
+                                        "summary": "A normal example",
+                                        "description": "A **normal** item works correctly.",
+                                        "value": {
+                                            "name": "Foo",
+                                            "description": "A very nice Item",
+                                            "price": 35.4,
+                                            "tax": 3.2,
+                                        },
+                                    },
+                                    "converted": {
+                                        "summary": "An example with converted data",
+                                        "description": "FastAPI can convert price `strings` to actual `numbers` automatically",
+                                        "value": {"name": "Bar", "price": "35.4"},
+                                    },
+                                    "invalid": {
+                                        "summary": "Invalid data is rejected with an error",
+                                        "value": {
+                                            "name": "Baz",
+                                            "price": "thirty five point four",
+                                        },
+                                    },
+                                },
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+                "Item": {
+                    "title": "Item",
+                    "required": ["name", "price"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": IsDict(
+                            {
+                                "title": "Description",
+                                "anyOf": [{"type": "string"}, {"type": "null"}],
+                            }
+                        )
+                        | IsDict(
+                            # TODO: remove when deprecating Pydantic v1
+                            {"title": "Description", "type": "string"}
+                        ),
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": IsDict(
+                            {
+                                "title": "Tax",
+                                "anyOf": [{"type": "number"}, {"type": "null"}],
+                            }
+                        )
+                        | IsDict(
+                            # TODO: remove when deprecating Pydantic v1
+                            {"title": "Tax", "type": "number"}
+                        ),
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_schema_extra_example/test_tutorial005_an_py310.py b/tests/test_tutorial/test_schema_extra_example/test_tutorial005_an_py310.py
new file mode 100644
index 000000000..9109cb14e
--- /dev/null
+++ b/tests/test_tutorial/test_schema_extra_example/test_tutorial005_an_py310.py
@@ -0,0 +1,170 @@
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+
+from ...utils import needs_py310
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.schema_extra_example.tutorial005_an_py310 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_py310
+def test_post_body_example(client: TestClient):
+    response = client.put(
+        "/items/5",
+        json={
+            "name": "Foo",
+            "description": "A very nice Item",
+            "price": 35.4,
+            "tax": 3.2,
+        },
+    )
+    assert response.status_code == 200
+
+
+@needs_py310
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/{item_id}": {
+                "put": {
+                    "summary": "Update Item",
+                    "operationId": "update_item_items__item_id__put",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "integer"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": IsDict({"$ref": "#/components/schemas/Item"})
+                                | IsDict(
+                                    # TODO: remove when deprecating Pydantic v1
+                                    {
+                                        "allOf": [
+                                            {"$ref": "#/components/schemas/Item"}
+                                        ],
+                                        "title": "Item",
+                                    }
+                                ),
+                                "examples": {
+                                    "normal": {
+                                        "summary": "A normal example",
+                                        "description": "A **normal** item works correctly.",
+                                        "value": {
+                                            "name": "Foo",
+                                            "description": "A very nice Item",
+                                            "price": 35.4,
+                                            "tax": 3.2,
+                                        },
+                                    },
+                                    "converted": {
+                                        "summary": "An example with converted data",
+                                        "description": "FastAPI can convert price `strings` to actual `numbers` automatically",
+                                        "value": {"name": "Bar", "price": "35.4"},
+                                    },
+                                    "invalid": {
+                                        "summary": "Invalid data is rejected with an error",
+                                        "value": {
+                                            "name": "Baz",
+                                            "price": "thirty five point four",
+                                        },
+                                    },
+                                },
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+                "Item": {
+                    "title": "Item",
+                    "required": ["name", "price"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": IsDict(
+                            {
+                                "title": "Description",
+                                "anyOf": [{"type": "string"}, {"type": "null"}],
+                            }
+                        )
+                        | IsDict(
+                            # TODO: remove when deprecating Pydantic v1
+                            {"title": "Description", "type": "string"}
+                        ),
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": IsDict(
+                            {
+                                "title": "Tax",
+                                "anyOf": [{"type": "number"}, {"type": "null"}],
+                            }
+                        )
+                        | IsDict(
+                            # TODO: remove when deprecating Pydantic v1
+                            {"title": "Tax", "type": "number"}
+                        ),
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_schema_extra_example/test_tutorial005_an_py39.py b/tests/test_tutorial/test_schema_extra_example/test_tutorial005_an_py39.py
new file mode 100644
index 000000000..fd4ec0575
--- /dev/null
+++ b/tests/test_tutorial/test_schema_extra_example/test_tutorial005_an_py39.py
@@ -0,0 +1,170 @@
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+
+from ...utils import needs_py39
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.schema_extra_example.tutorial005_an_py39 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_py39
+def test_post_body_example(client: TestClient):
+    response = client.put(
+        "/items/5",
+        json={
+            "name": "Foo",
+            "description": "A very nice Item",
+            "price": 35.4,
+            "tax": 3.2,
+        },
+    )
+    assert response.status_code == 200
+
+
+@needs_py39
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/{item_id}": {
+                "put": {
+                    "summary": "Update Item",
+                    "operationId": "update_item_items__item_id__put",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "integer"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": IsDict({"$ref": "#/components/schemas/Item"})
+                                | IsDict(
+                                    # TODO: remove when deprecating Pydantic v1
+                                    {
+                                        "allOf": [
+                                            {"$ref": "#/components/schemas/Item"}
+                                        ],
+                                        "title": "Item",
+                                    }
+                                ),
+                                "examples": {
+                                    "normal": {
+                                        "summary": "A normal example",
+                                        "description": "A **normal** item works correctly.",
+                                        "value": {
+                                            "name": "Foo",
+                                            "description": "A very nice Item",
+                                            "price": 35.4,
+                                            "tax": 3.2,
+                                        },
+                                    },
+                                    "converted": {
+                                        "summary": "An example with converted data",
+                                        "description": "FastAPI can convert price `strings` to actual `numbers` automatically",
+                                        "value": {"name": "Bar", "price": "35.4"},
+                                    },
+                                    "invalid": {
+                                        "summary": "Invalid data is rejected with an error",
+                                        "value": {
+                                            "name": "Baz",
+                                            "price": "thirty five point four",
+                                        },
+                                    },
+                                },
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+                "Item": {
+                    "title": "Item",
+                    "required": ["name", "price"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": IsDict(
+                            {
+                                "title": "Description",
+                                "anyOf": [{"type": "string"}, {"type": "null"}],
+                            }
+                        )
+                        | IsDict(
+                            # TODO: remove when deprecating Pydantic v1
+                            {"title": "Description", "type": "string"}
+                        ),
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": IsDict(
+                            {
+                                "title": "Tax",
+                                "anyOf": [{"type": "number"}, {"type": "null"}],
+                            }
+                        )
+                        | IsDict(
+                            # TODO: remove when deprecating Pydantic v1
+                            {"title": "Tax", "type": "number"}
+                        ),
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+            }
+        },
+    }
diff --git a/tests/test_tutorial/test_schema_extra_example/test_tutorial005_py310.py b/tests/test_tutorial/test_schema_extra_example/test_tutorial005_py310.py
new file mode 100644
index 000000000..05df53422
--- /dev/null
+++ b/tests/test_tutorial/test_schema_extra_example/test_tutorial005_py310.py
@@ -0,0 +1,170 @@
+import pytest
+from dirty_equals import IsDict
+from fastapi.testclient import TestClient
+
+from ...utils import needs_py310
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.schema_extra_example.tutorial005_py310 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_py310
+def test_post_body_example(client: TestClient):
+    response = client.put(
+        "/items/5",
+        json={
+            "name": "Foo",
+            "description": "A very nice Item",
+            "price": 35.4,
+            "tax": 3.2,
+        },
+    )
+    assert response.status_code == 200
+
+
+@needs_py310
+def test_openapi_schema(client: TestClient) -> None:
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/items/{item_id}": {
+                "put": {
+                    "summary": "Update Item",
+                    "operationId": "update_item_items__item_id__put",
+                    "parameters": [
+                        {
+                            "required": True,
+                            "schema": {"title": "Item Id", "type": "integer"},
+                            "name": "item_id",
+                            "in": "path",
+                        }
+                    ],
+                    "requestBody": {
+                        "content": {
+                            "application/json": {
+                                "schema": IsDict({"$ref": "#/components/schemas/Item"})
+                                | IsDict(
+                                    # TODO: remove when deprecating Pydantic v1
+                                    {
+                                        "allOf": [
+                                            {"$ref": "#/components/schemas/Item"}
+                                        ],
+                                        "title": "Item",
+                                    }
+                                ),
+                                "examples": {
+                                    "normal": {
+                                        "summary": "A normal example",
+                                        "description": "A **normal** item works correctly.",
+                                        "value": {
+                                            "name": "Foo",
+                                            "description": "A very nice Item",
+                                            "price": 35.4,
+                                            "tax": 3.2,
+                                        },
+                                    },
+                                    "converted": {
+                                        "summary": "An example with converted data",
+                                        "description": "FastAPI can convert price `strings` to actual `numbers` automatically",
+                                        "value": {"name": "Bar", "price": "35.4"},
+                                    },
+                                    "invalid": {
+                                        "summary": "Invalid data is rejected with an error",
+                                        "value": {
+                                            "name": "Baz",
+                                            "price": "thirty five point four",
+                                        },
+                                    },
+                                },
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "HTTPValidationError": {
+                    "title": "HTTPValidationError",
+                    "type": "object",
+                    "properties": {
+                        "detail": {
+                            "title": "Detail",
+                            "type": "array",
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                        }
+                    },
+                },
+                "Item": {
+                    "title": "Item",
+                    "required": ["name", "price"],
+                    "type": "object",
+                    "properties": {
+                        "name": {"title": "Name", "type": "string"},
+                        "description": IsDict(
+                            {
+                                "title": "Description",
+                                "anyOf": [{"type": "string"}, {"type": "null"}],
+                            }
+                        )
+                        | IsDict(
+                            # TODO: remove when deprecating Pydantic v1
+                            {"title": "Description", "type": "string"}
+                        ),
+                        "price": {"title": "Price", "type": "number"},
+                        "tax": IsDict(
+                            {
+                                "title": "Tax",
+                                "anyOf": [{"type": "number"}, {"type": "null"}],
+                            }
+                        )
+                        | IsDict(
+                            # TODO: remove when deprecating Pydantic v1
+                            {"title": "Tax", "type": "number"}
+                        ),
+                    },
+                },
+                "ValidationError": {
+                    "title": "ValidationError",
+                    "required": ["loc", "msg", "type"],
+                    "type": "object",
+                    "properties": {
+                        "loc": {
+                            "title": "Location",
+                            "type": "array",
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                        },
+                        "msg": {"title": "Message", "type": "string"},
+                        "type": {"title": "Error Type", "type": "string"},
+                    },
+                },
+            }
+        },
+    }

From df16699dd8a5909b7de2d8c79f53f7153d922625 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 26 Aug 2023 18:03:56 +0000
Subject: [PATCH 132/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 5d15e1c25..4021532d2 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ✨ Add support for `openapi_examples` in all FastAPI parameters. PR [#10152](https://github.com/tiangolo/fastapi/pull/10152) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Add note to docs about Separate Input and Output Schemas with FastAPI version. PR [#10150](https://github.com/tiangolo/fastapi/pull/10150) by [@tiangolo](https://github.com/tiangolo).
 ## 0.102.0
 

From bd32bca55cdbf3ca3e9de66b0e790772e019b55f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 26 Aug 2023 20:09:59 +0200
Subject: [PATCH 133/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 4021532d2..f61d1360d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,8 +2,14 @@
 
 ## Latest Changes
 
+### Features
+
 * ✨ Add support for `openapi_examples` in all FastAPI parameters. PR [#10152](https://github.com/tiangolo/fastapi/pull/10152) by [@tiangolo](https://github.com/tiangolo).
+
+### Docs
+
 * 📝 Add note to docs about Separate Input and Output Schemas with FastAPI version. PR [#10150](https://github.com/tiangolo/fastapi/pull/10150) by [@tiangolo](https://github.com/tiangolo).
+
 ## 0.102.0
 
 ### Features

From 415eb1405a5bc93a32e14c15d690517c95d26743 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 26 Aug 2023 20:10:27 +0200
Subject: [PATCH 134/317] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.10?=
 =?UTF-8?q?3.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 3 +++
 fastapi/__init__.py           | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f61d1360d..91b29e772 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,9 @@
 
 ## Latest Changes
 
+
+## 0.103.0
+
 ### Features
 
 * ✨ Add support for `openapi_examples` in all FastAPI parameters. PR [#10152](https://github.com/tiangolo/fastapi/pull/10152) by [@tiangolo](https://github.com/tiangolo).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index 6979ec5fb..ff8b98d3b 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.102.0"
+__version__ = "0.103.0"
 
 from starlette import status as status
 

From a3f1689d78abef3d5d54ba655ec87cef81bf7384 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 26 Aug 2023 20:14:42 +0200
Subject: [PATCH 135/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 91b29e772..b60e024e5 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -8,6 +8,7 @@
 ### Features
 
 * ✨ Add support for `openapi_examples` in all FastAPI parameters. PR [#10152](https://github.com/tiangolo/fastapi/pull/10152) by [@tiangolo](https://github.com/tiangolo).
+    * New docs: [OpenAPI-specific examples](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#openapi-specific-examples).
 
 ### Docs
 

From 37d46e6b6c58c0e38747d91c4a0cdc0ea76c9d40 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 1 Sep 2023 23:36:08 +0200
Subject: [PATCH 136/317] =?UTF-8?q?=E2=9C=85=20Add=20missing=20test=20for?=
 =?UTF-8?q?=20OpenAPI=20examples,=20it=20was=20missing=20in=20coverage=20(?=
 =?UTF-8?q?#10188)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

✅ Add missing test for OpenAPI examples, it seems it was discovered in coverage by an upgrade in AnyIO
---
 tests/test_openapi_examples.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/tests/test_openapi_examples.py b/tests/test_openapi_examples.py
index d0e35953e..70664a8a4 100644
--- a/tests/test_openapi_examples.py
+++ b/tests/test_openapi_examples.py
@@ -125,6 +125,9 @@ client = TestClient(app)
 
 
 def test_call_api():
+    response = client.post("/examples/", json={"data": "example1"})
+    assert response.status_code == 200, response.text
+
     response = client.get("/path_examples/foo")
     assert response.status_code == 200, response.text
 

From 7a63d11093d17de34a62dd10f81b1cf149c2e37b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 1 Sep 2023 21:36:46 +0000
Subject: [PATCH 137/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b60e024e5..198bf3823 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ✅ Add missing test for OpenAPI examples, it was missing in coverage. PR [#10188](https://github.com/tiangolo/fastapi/pull/10188) by [@tiangolo](https://github.com/tiangolo).
 
 ## 0.103.0
 

From 4bfe83bd2706536fcb0fa911c0e1e0bb95ba39ce Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 2 Sep 2023 01:32:40 +0200
Subject: [PATCH 138/317] =?UTF-8?q?=F0=9F=91=A5=20Update=20FastAPI=20Peopl?=
 =?UTF-8?q?e=20(#10186)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: github-actions <github-actions@github.com>
---
 docs/en/data/github_sponsors.yml |  80 ++++++++++-------
 docs/en/data/people.yml          | 148 +++++++++++++++----------------
 2 files changed, 120 insertions(+), 108 deletions(-)

diff --git a/docs/en/data/github_sponsors.yml b/docs/en/data/github_sponsors.yml
index 3a68ba62b..1ec71dd49 100644
--- a/docs/en/data/github_sponsors.yml
+++ b/docs/en/data/github_sponsors.yml
@@ -2,6 +2,9 @@ sponsors:
 - - login: cryptapi
     avatarUrl: https://avatars.githubusercontent.com/u/44925437?u=61369138589bc7fee6c417f3fbd50fbd38286cc4&v=4
     url: https://github.com/cryptapi
+  - login: porter-dev
+    avatarUrl: https://avatars.githubusercontent.com/u/62078005?v=4
+    url: https://github.com/porter-dev
   - login: fern-api
     avatarUrl: https://avatars.githubusercontent.com/u/102944815?v=4
     url: https://github.com/fern-api
@@ -17,24 +20,21 @@ sponsors:
 - - login: mikeckennedy
     avatarUrl: https://avatars.githubusercontent.com/u/2035561?u=1bb18268bcd4d9249e1f783a063c27df9a84c05b&v=4
     url: https://github.com/mikeckennedy
+  - login: ndimares
+    avatarUrl: https://avatars.githubusercontent.com/u/6267663?u=cfb27efde7a7212be8142abb6c058a1aeadb41b1&v=4
+    url: https://github.com/ndimares
   - login: deta
     avatarUrl: https://avatars.githubusercontent.com/u/47275976?v=4
     url: https://github.com/deta
   - login: deepset-ai
     avatarUrl: https://avatars.githubusercontent.com/u/51827949?v=4
     url: https://github.com/deepset-ai
-  - login: svix
-    avatarUrl: https://avatars.githubusercontent.com/u/80175132?v=4
-    url: https://github.com/svix
   - login: databento-bot
     avatarUrl: https://avatars.githubusercontent.com/u/98378480?u=494f679996e39427f7ddb1a7de8441b7c96fb670&v=4
     url: https://github.com/databento-bot
   - login: VincentParedes
     avatarUrl: https://avatars.githubusercontent.com/u/103889729?v=4
     url: https://github.com/VincentParedes
-- - login: arcticfly
-    avatarUrl: https://avatars.githubusercontent.com/u/41524992?u=03c88529a86cf51f7a380e890d84d84c71468848&v=4
-    url: https://github.com/arcticfly
 - - login: getsentry
     avatarUrl: https://avatars.githubusercontent.com/u/1396951?v=4
     url: https://github.com/getsentry
@@ -89,18 +89,18 @@ sponsors:
 - - login: povilasb
     avatarUrl: https://avatars.githubusercontent.com/u/1213442?u=b11f58ed6ceea6e8297c9b310030478ebdac894d&v=4
     url: https://github.com/povilasb
+  - login: mukulmantosh
+    avatarUrl: https://avatars.githubusercontent.com/u/15572034?u=006f0a33c0e15bb2de57474a2cf7d2f8ee05f5a0&v=4
+    url: https://github.com/mukulmantosh
   - login: primer-io
     avatarUrl: https://avatars.githubusercontent.com/u/62146168?v=4
     url: https://github.com/primer-io
 - - login: indeedeng
     avatarUrl: https://avatars.githubusercontent.com/u/2905043?v=4
     url: https://github.com/indeedeng
-  - login: iguit0
-    avatarUrl: https://avatars.githubusercontent.com/u/12905770?u=63a1a96d1e6c27d85c4f946b84836599de047f65&v=4
-    url: https://github.com/iguit0
-  - login: JacobKochems
-    avatarUrl: https://avatars.githubusercontent.com/u/41692189?u=a75f62ddc0d060ee6233a91e19c433d2687b8eb6&v=4
-    url: https://github.com/JacobKochems
+  - login: NateXVI
+    avatarUrl: https://avatars.githubusercontent.com/u/48195620?u=4bc8751ae50cb087c40c1fe811764aa070b9eea6&v=4
+    url: https://github.com/NateXVI
 - - login: Kludex
     avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
     url: https://github.com/Kludex
@@ -200,12 +200,12 @@ sponsors:
   - login: hiancdtrsnm
     avatarUrl: https://avatars.githubusercontent.com/u/7343177?v=4
     url: https://github.com/hiancdtrsnm
-  - login: Shackelford-Arden
-    avatarUrl: https://avatars.githubusercontent.com/u/7362263?v=4
-    url: https://github.com/Shackelford-Arden
   - login: wdwinslow
     avatarUrl: https://avatars.githubusercontent.com/u/11562137?u=dc01daafb354135603a263729e3d26d939c0c452&v=4
     url: https://github.com/wdwinslow
+  - login: jsoques
+    avatarUrl: https://avatars.githubusercontent.com/u/12414216?u=620921d94196546cc8b9eae2cc4cbc3f95bab42f&v=4
+    url: https://github.com/jsoques
   - login: joeds13
     avatarUrl: https://avatars.githubusercontent.com/u/13631604?u=628eb122e08bef43767b3738752b883e8e7f6259&v=4
     url: https://github.com/joeds13
@@ -227,9 +227,6 @@ sponsors:
   - login: Filimoa
     avatarUrl: https://avatars.githubusercontent.com/u/21352040?u=0be845711495bbd7b756e13fcaeb8efc1ebd78ba&v=4
     url: https://github.com/Filimoa
-  - login: LarryGF
-    avatarUrl: https://avatars.githubusercontent.com/u/26148349?u=431bb34d36d41c172466252242175281ae132152&v=4
-    url: https://github.com/LarryGF
   - login: BrettskiPy
     avatarUrl: https://avatars.githubusercontent.com/u/30988215?u=d8a94a67e140d5ee5427724b292cc52d8827087a&v=4
     url: https://github.com/BrettskiPy
@@ -239,6 +236,9 @@ sponsors:
   - login: Leay15
     avatarUrl: https://avatars.githubusercontent.com/u/32212558?u=c4aa9c1737e515959382a5515381757b1fd86c53&v=4
     url: https://github.com/Leay15
+  - login: dvlpjrs
+    avatarUrl: https://avatars.githubusercontent.com/u/32254642?u=fbd6ad0324d4f1eb6231cf775be1c7bd4404e961&v=4
+    url: https://github.com/dvlpjrs
   - login: ygorpontelo
     avatarUrl: https://avatars.githubusercontent.com/u/32963605?u=35f7103f9c4c4c2589ae5737ee882e9375ef072e&v=4
     url: https://github.com/ygorpontelo
@@ -284,15 +284,15 @@ sponsors:
   - login: DelfinaCare
     avatarUrl: https://avatars.githubusercontent.com/u/83734439?v=4
     url: https://github.com/DelfinaCare
+  - login: hbakri
+    avatarUrl: https://avatars.githubusercontent.com/u/92298226?u=36eee6d75db1272264d3ee92f1871f70b8917bd8&v=4
+    url: https://github.com/hbakri
   - login: osawa-koki
     avatarUrl: https://avatars.githubusercontent.com/u/94336223?u=59c6fe6945bcbbaff87b2a794238671b060620d2&v=4
     url: https://github.com/osawa-koki
   - login: pyt3h
     avatarUrl: https://avatars.githubusercontent.com/u/99658549?v=4
     url: https://github.com/pyt3h
-  - login: Dagmaara
-    avatarUrl: https://avatars.githubusercontent.com/u/115501964?v=4
-    url: https://github.com/Dagmaara
 - - login: SebTota
     avatarUrl: https://avatars.githubusercontent.com/u/25122511?v=4
     url: https://github.com/SebTota
@@ -329,6 +329,9 @@ sponsors:
   - login: janfilips
     avatarUrl: https://avatars.githubusercontent.com/u/870699?u=80702ec63f14e675cd4cdcc6ce3821d2ed207fd7&v=4
     url: https://github.com/janfilips
+  - login: dodo5522
+    avatarUrl: https://avatars.githubusercontent.com/u/1362607?u=9bf1e0e520cccc547c046610c468ce6115bbcf9f&v=4
+    url: https://github.com/dodo5522
   - login: WillHogan
     avatarUrl: https://avatars.githubusercontent.com/u/1661551?u=7036c064cf29781470573865264ec8e60b6b809f&v=4
     url: https://github.com/WillHogan
@@ -374,9 +377,6 @@ sponsors:
   - login: katnoria
     avatarUrl: https://avatars.githubusercontent.com/u/7674948?u=09767eb13e07e09496c5fee4e5ce21d9eac34a56&v=4
     url: https://github.com/katnoria
-  - login: mattwelke
-    avatarUrl: https://avatars.githubusercontent.com/u/7719209?u=80f02a799323b1472b389b836d95957c93a6d856&v=4
-    url: https://github.com/mattwelke
   - login: harsh183
     avatarUrl: https://avatars.githubusercontent.com/u/7780198?v=4
     url: https://github.com/harsh183
@@ -422,6 +422,9 @@ sponsors:
   - login: jangia
     avatarUrl: https://avatars.githubusercontent.com/u/17927101?u=9261b9bb0c3e3bb1ecba43e8915dc58d8c9a077e&v=4
     url: https://github.com/jangia
+  - login: timzaz
+    avatarUrl: https://avatars.githubusercontent.com/u/19709244?u=e6658f6b0b188294ce2db20dad94a678fcea718d&v=4
+    url: https://github.com/timzaz
   - login: shuheng-liu
     avatarUrl: https://avatars.githubusercontent.com/u/22414322?u=813c45f30786c6b511b21a661def025d8f7b609e&v=4
     url: https://github.com/shuheng-liu
@@ -431,6 +434,9 @@ sponsors:
   - login: kxzk
     avatarUrl: https://avatars.githubusercontent.com/u/25046261?u=e185e58080090f9e678192cd214a14b14a2b232b&v=4
     url: https://github.com/kxzk
+  - login: nisutec
+    avatarUrl: https://avatars.githubusercontent.com/u/25281462?u=e562484c451fdfc59053163f64405f8eb262b8b0&v=4
+    url: https://github.com/nisutec
   - login: hoenie-ams
     avatarUrl: https://avatars.githubusercontent.com/u/25708487?u=cda07434f0509ac728d9edf5e681117c0f6b818b&v=4
     url: https://github.com/hoenie-ams
@@ -450,7 +456,7 @@ sponsors:
     avatarUrl: https://avatars.githubusercontent.com/u/33275230?u=eb223cad27017bb1e936ee9b429b450d092d0236&v=4
     url: https://github.com/engineerjoe440
   - login: bnkc
-    avatarUrl: https://avatars.githubusercontent.com/u/34930566?u=527044d90b5ebb7f8dad517db5da1f45253b774b&v=4
+    avatarUrl: https://avatars.githubusercontent.com/u/34930566?u=1a104991a2ea90bfe304bc0b9ef191c7e4891a0e&v=4
     url: https://github.com/bnkc
   - login: declon
     avatarUrl: https://avatars.githubusercontent.com/u/36180226?v=4
@@ -482,6 +488,15 @@ sponsors:
   - login: 0417taehyun
     avatarUrl: https://avatars.githubusercontent.com/u/63915557?u=47debaa860fd52c9b98c97ef357ddcec3b3fb399&v=4
     url: https://github.com/0417taehyun
+  - login: romabozhanovgithub
+    avatarUrl: https://avatars.githubusercontent.com/u/67696229?u=e4b921eef096415300425aca249348f8abb78ad7&v=4
+    url: https://github.com/romabozhanovgithub
+  - login: mnicolleUTC
+    avatarUrl: https://avatars.githubusercontent.com/u/68548924?u=1fdd7f436bb1f4857c3415e62aa8fbc055fc1a76&v=4
+    url: https://github.com/mnicolleUTC
+  - login: mbukeRepo
+    avatarUrl: https://avatars.githubusercontent.com/u/70356088?u=e125069c6ac5c49355e2b3ca2aa66a445fc4cccd&v=4
+    url: https://github.com/mbukeRepo
 - - login: ssbarnea
     avatarUrl: https://avatars.githubusercontent.com/u/102495?u=b4bf6818deefe59952ac22fec6ed8c76de1b8f7c&v=4
     url: https://github.com/ssbarnea
@@ -494,21 +509,18 @@ sponsors:
   - login: sadikkuzu
     avatarUrl: https://avatars.githubusercontent.com/u/23168063?u=d179c06bb9f65c4167fcab118526819f8e0dac17&v=4
     url: https://github.com/sadikkuzu
-  - login: ruizdiazever
-    avatarUrl: https://avatars.githubusercontent.com/u/29817086?u=2df54af55663d246e3a4dc8273711c37f1adb117&v=4
-    url: https://github.com/ruizdiazever
   - login: samnimoh
     avatarUrl: https://avatars.githubusercontent.com/u/33413170?u=147bc516be6cb647b28d7e3b3fea3a018a331145&v=4
     url: https://github.com/samnimoh
   - login: danburonline
     avatarUrl: https://avatars.githubusercontent.com/u/34251194?u=2cad4388c1544e539ecb732d656e42fb07b4ff2d&v=4
     url: https://github.com/danburonline
-  - login: iharshgor
-    avatarUrl: https://avatars.githubusercontent.com/u/35490011?u=2dea054476e752d9e92c9d71a9a7cc919b1c2f8e&v=4
-    url: https://github.com/iharshgor
+  - login: koalawangyang
+    avatarUrl: https://avatars.githubusercontent.com/u/40114367?u=3bb94010f0473b8d4c2edea5a8c1cab61e6a1b22&v=4
+    url: https://github.com/koalawangyang
   - login: rwxd
     avatarUrl: https://avatars.githubusercontent.com/u/40308458?u=cd04a39e3655923be4f25c2ba8a5a07b3da3230a&v=4
     url: https://github.com/rwxd
-  - login: ThomasPalma1
-    avatarUrl: https://avatars.githubusercontent.com/u/66331874?u=5763f7402d784ba189b60d704ff5849b4d0a63fb&v=4
-    url: https://github.com/ThomasPalma1
+  - login: lodine-software
+    avatarUrl: https://avatars.githubusercontent.com/u/133536046?v=4
+    url: https://github.com/lodine-software
diff --git a/docs/en/data/people.yml b/docs/en/data/people.yml
index 89d189564..8ebd2f84c 100644
--- a/docs/en/data/people.yml
+++ b/docs/en/data/people.yml
@@ -1,16 +1,16 @@
 maintainers:
 - login: tiangolo
-  answers: 1849
-  prs: 466
+  answers: 1866
+  prs: 486
   avatarUrl: https://avatars.githubusercontent.com/u/1326112?u=740f11212a731f56798f558ceddb0bd07642afa7&v=4
   url: https://github.com/tiangolo
 experts:
 - login: Kludex
-  count: 463
+  count: 480
   avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
   url: https://github.com/Kludex
 - login: dmontagu
-  count: 239
+  count: 240
   avatarUrl: https://avatars.githubusercontent.com/u/35119617?u=540f30c937a6450812628b9592a1dfe91bbe148e&v=4
   url: https://github.com/dmontagu
 - login: Mause
@@ -26,7 +26,7 @@ experts:
   avatarUrl: https://avatars.githubusercontent.com/u/13659033?u=e8bea32d07a5ef72f7dde3b2079ceb714923ca05&v=4
   url: https://github.com/JarroVGIT
 - login: jgould22
-  count: 157
+  count: 164
   avatarUrl: https://avatars.githubusercontent.com/u/4335847?u=ed77f67e0bb069084639b24d812dbb2a2b1dc554&v=4
   url: https://github.com/jgould22
 - login: euri10
@@ -38,7 +38,7 @@ experts:
   avatarUrl: https://avatars.githubusercontent.com/u/331403?v=4
   url: https://github.com/phy25
 - login: iudeen
-  count: 121
+  count: 122
   avatarUrl: https://avatars.githubusercontent.com/u/10519440?u=2843b3303282bff8b212dcd4d9d6689452e4470c&v=4
   url: https://github.com/iudeen
 - login: raphaelauv
@@ -61,34 +61,34 @@ experts:
   count: 49
   avatarUrl: https://avatars.githubusercontent.com/u/516999?u=437c0c5038558c67e887ccd863c1ba0f846c03da&v=4
   url: https://github.com/sm-Fifteen
-- login: insomnes
-  count: 45
-  avatarUrl: https://avatars.githubusercontent.com/u/16958893?u=f8be7088d5076d963984a21f95f44e559192d912&v=4
-  url: https://github.com/insomnes
 - login: yinziyan1206
   count: 45
   avatarUrl: https://avatars.githubusercontent.com/u/37829370?u=da44ca53aefd5c23f346fab8e9fd2e108294c179&v=4
   url: https://github.com/yinziyan1206
-- login: acidjunk
+- login: insomnes
   count: 45
-  avatarUrl: https://avatars.githubusercontent.com/u/685002?u=b5094ab4527fc84b006c0ac9ff54367bdebb2267&v=4
-  url: https://github.com/acidjunk
+  avatarUrl: https://avatars.githubusercontent.com/u/16958893?u=f8be7088d5076d963984a21f95f44e559192d912&v=4
+  url: https://github.com/insomnes
 - login: Dustyposa
   count: 45
   avatarUrl: https://avatars.githubusercontent.com/u/27180793?u=5cf2877f50b3eb2bc55086089a78a36f07042889&v=4
   url: https://github.com/Dustyposa
+- login: acidjunk
+  count: 45
+  avatarUrl: https://avatars.githubusercontent.com/u/685002?u=b5094ab4527fc84b006c0ac9ff54367bdebb2267&v=4
+  url: https://github.com/acidjunk
 - login: adriangb
   count: 44
   avatarUrl: https://avatars.githubusercontent.com/u/1755071?u=612704256e38d6ac9cbed24f10e4b6ac2da74ecb&v=4
   url: https://github.com/adriangb
-- login: frankie567
-  count: 43
-  avatarUrl: https://avatars.githubusercontent.com/u/1144727?u=85c025e3fcc7bd79a5665c63ee87cdf8aae13374&v=4
-  url: https://github.com/frankie567
 - login: odiseo0
   count: 43
   avatarUrl: https://avatars.githubusercontent.com/u/87550035?u=241a71f6b7068738b81af3e57f45ffd723538401&v=4
   url: https://github.com/odiseo0
+- login: frankie567
+  count: 43
+  avatarUrl: https://avatars.githubusercontent.com/u/1144727?u=c159fe047727aedecbbeeaa96a1b03ceb9d39add&v=4
+  url: https://github.com/frankie567
 - login: includeamin
   count: 40
   avatarUrl: https://avatars.githubusercontent.com/u/11836741?u=8bd5ef7e62fe6a82055e33c4c0e0a7879ff8cfb6&v=4
@@ -97,14 +97,14 @@ experts:
   count: 37
   avatarUrl: https://avatars.githubusercontent.com/u/5167622?u=de8f597c81d6336fcebc37b32dfd61a3f877160c&v=4
   url: https://github.com/STeveShary
+- login: chbndrhnns
+  count: 36
+  avatarUrl: https://avatars.githubusercontent.com/u/7534547?v=4
+  url: https://github.com/chbndrhnns
 - login: krishnardt
   count: 35
   avatarUrl: https://avatars.githubusercontent.com/u/31960541?u=47f4829c77f4962ab437ffb7995951e41eeebe9b&v=4
   url: https://github.com/krishnardt
-- login: chbndrhnns
-  count: 35
-  avatarUrl: https://avatars.githubusercontent.com/u/7534547?v=4
-  url: https://github.com/chbndrhnns
 - login: panla
   count: 32
   avatarUrl: https://avatars.githubusercontent.com/u/41326348?u=ba2fda6b30110411ecbf406d187907e2b420ac19&v=4
@@ -117,26 +117,30 @@ experts:
   count: 26
   avatarUrl: https://avatars.githubusercontent.com/u/43723790?u=9bcce836bbce55835291c5b2ac93a4e311f4b3c3&v=4
   url: https://github.com/dbanty
+- login: n8sty
+  count: 25
+  avatarUrl: https://avatars.githubusercontent.com/u/2964996?v=4
+  url: https://github.com/n8sty
 - login: wshayes
   count: 25
   avatarUrl: https://avatars.githubusercontent.com/u/365303?u=07ca03c5ee811eb0920e633cc3c3db73dbec1aa5&v=4
   url: https://github.com/wshayes
-- login: acnebs
-  count: 23
-  avatarUrl: https://avatars.githubusercontent.com/u/9054108?v=4
-  url: https://github.com/acnebs
 - login: SirTelemak
   count: 23
   avatarUrl: https://avatars.githubusercontent.com/u/9435877?u=719327b7d2c4c62212456d771bfa7c6b8dbb9eac&v=4
   url: https://github.com/SirTelemak
+- login: acnebs
+  count: 23
+  avatarUrl: https://avatars.githubusercontent.com/u/9054108?v=4
+  url: https://github.com/acnebs
 - login: rafsaf
   count: 21
-  avatarUrl: https://avatars.githubusercontent.com/u/51059348?u=f8f0d6d6e90fac39fa786228158ba7f013c74271&v=4
+  avatarUrl: https://avatars.githubusercontent.com/u/51059348?u=5fe59a56e1f2f9ccd8005d71752a8276f133ae1a&v=4
   url: https://github.com/rafsaf
-- login: n8sty
+- login: JavierSanchezCastro
   count: 20
-  avatarUrl: https://avatars.githubusercontent.com/u/2964996?v=4
-  url: https://github.com/n8sty
+  avatarUrl: https://avatars.githubusercontent.com/u/72013291?u=ae5679e6bd971d9d98cd5e76e8683f83642ba950&v=4
+  url: https://github.com/JavierSanchezCastro
 - login: nsidnev
   count: 20
   avatarUrl: https://avatars.githubusercontent.com/u/22559461?u=a9cc3238217e21dc8796a1a500f01b722adb082c&v=4
@@ -173,55 +177,51 @@ experts:
   count: 16
   avatarUrl: https://avatars.githubusercontent.com/u/26334101?u=071c062d2861d3dd127f6b4a5258cd8ef55d4c50&v=4
   url: https://github.com/jonatasoli
+- login: ebottos94
+  count: 16
+  avatarUrl: https://avatars.githubusercontent.com/u/100039558?u=e2c672da5a7977fd24d87ce6ab35f8bf5b1ed9fa&v=4
+  url: https://github.com/ebottos94
 - login: dstlny
   count: 16
   avatarUrl: https://avatars.githubusercontent.com/u/41964673?u=9f2174f9d61c15c6e3a4c9e3aeee66f711ce311f&v=4
   url: https://github.com/dstlny
-- login: abhint
+- login: chrisK824
   count: 15
-  avatarUrl: https://avatars.githubusercontent.com/u/25699289?u=b5d219277b4d001ac26fb8be357fddd88c29d51b&v=4
-  url: https://github.com/abhint
+  avatarUrl: https://avatars.githubusercontent.com/u/79946379?u=03d85b22d696a58a9603e55fbbbe2de6b0f4face&v=4
+  url: https://github.com/chrisK824
 - login: nymous
   count: 15
   avatarUrl: https://avatars.githubusercontent.com/u/4216559?u=360a36fb602cded27273cbfc0afc296eece90662&v=4
   url: https://github.com/nymous
-- login: ghost
-  count: 15
-  avatarUrl: https://avatars.githubusercontent.com/u/10137?u=b1951d34a583cf12ec0d3b0781ba19be97726318&v=4
-  url: https://github.com/ghost
-- login: simondale00
-  count: 15
-  avatarUrl: https://avatars.githubusercontent.com/u/33907262?v=4
-  url: https://github.com/simondale00
-- login: jorgerpo
+- login: abhint
   count: 15
-  avatarUrl: https://avatars.githubusercontent.com/u/12537771?u=7444d20019198e34911082780cc7ad73f2b97cb3&v=4
-  url: https://github.com/jorgerpo
+  avatarUrl: https://avatars.githubusercontent.com/u/25699289?u=b5d219277b4d001ac26fb8be357fddd88c29d51b&v=4
+  url: https://github.com/abhint
 last_month_active:
+- login: JavierSanchezCastro
+  count: 12
+  avatarUrl: https://avatars.githubusercontent.com/u/72013291?u=ae5679e6bd971d9d98cd5e76e8683f83642ba950&v=4
+  url: https://github.com/JavierSanchezCastro
 - login: Kludex
-  count: 24
+  count: 10
   avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
   url: https://github.com/Kludex
 - login: jgould22
-  count: 17
+  count: 8
   avatarUrl: https://avatars.githubusercontent.com/u/4335847?u=ed77f67e0bb069084639b24d812dbb2a2b1dc554&v=4
   url: https://github.com/jgould22
-- login: arjwilliams
-  count: 8
-  avatarUrl: https://avatars.githubusercontent.com/u/22227620?v=4
-  url: https://github.com/arjwilliams
-- login: Ahmed-Abdou14
-  count: 4
-  avatarUrl: https://avatars.githubusercontent.com/u/104530599?u=05365b155a1ff911532e8be316acfad2e0736f98&v=4
-  url: https://github.com/Ahmed-Abdou14
-- login: iudeen
-  count: 3
-  avatarUrl: https://avatars.githubusercontent.com/u/10519440?u=2843b3303282bff8b212dcd4d9d6689452e4470c&v=4
-  url: https://github.com/iudeen
-- login: mikeedjones
+- login: romabozhanovgithub
+  count: 5
+  avatarUrl: https://avatars.githubusercontent.com/u/67696229?u=e4b921eef096415300425aca249348f8abb78ad7&v=4
+  url: https://github.com/romabozhanovgithub
+- login: n8sty
+  count: 5
+  avatarUrl: https://avatars.githubusercontent.com/u/2964996?v=4
+  url: https://github.com/n8sty
+- login: chrisK824
   count: 3
-  avatarUrl: https://avatars.githubusercontent.com/u/4087139?u=cc4a242896ac2fcf88a53acfaf190d0fe0a1f0c9&v=4
-  url: https://github.com/mikeedjones
+  avatarUrl: https://avatars.githubusercontent.com/u/79946379?u=03d85b22d696a58a9603e55fbbbe2de6b0f4face&v=4
+  url: https://github.com/chrisK824
 top_contributors:
 - login: waynerv
   count: 25
@@ -235,22 +235,22 @@ top_contributors:
   count: 21
   avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
   url: https://github.com/Kludex
+- login: dmontagu
+  count: 17
+  avatarUrl: https://avatars.githubusercontent.com/u/35119617?u=540f30c937a6450812628b9592a1dfe91bbe148e&v=4
+  url: https://github.com/dmontagu
 - login: jaystone776
   count: 17
   avatarUrl: https://avatars.githubusercontent.com/u/11191137?u=299205a95e9b6817a43144a48b643346a5aac5cc&v=4
   url: https://github.com/jaystone776
-- login: dmontagu
-  count: 16
-  avatarUrl: https://avatars.githubusercontent.com/u/35119617?u=540f30c937a6450812628b9592a1dfe91bbe148e&v=4
-  url: https://github.com/dmontagu
+- login: Xewus
+  count: 14
+  avatarUrl: https://avatars.githubusercontent.com/u/85196001?u=f8e2dc7e5104f109cef944af79050ea8d1b8f914&v=4
+  url: https://github.com/Xewus
 - login: euri10
   count: 13
   avatarUrl: https://avatars.githubusercontent.com/u/1104190?u=321a2e953e6645a7d09b732786c7a8061e0f8a8b&v=4
   url: https://github.com/euri10
-- login: Xewus
-  count: 13
-  avatarUrl: https://avatars.githubusercontent.com/u/85196001?u=f8e2dc7e5104f109cef944af79050ea8d1b8f914&v=4
-  url: https://github.com/Xewus
 - login: mariacamilagl
   count: 12
   avatarUrl: https://avatars.githubusercontent.com/u/11489395?u=4adb6986bf3debfc2b8216ae701f2bd47d73da7d&v=4
@@ -360,6 +360,10 @@ top_reviewers:
   count: 78
   avatarUrl: https://avatars.githubusercontent.com/u/52716203?u=d7062cbc6eb7671d5dc9cc0e32a24ae335e0f225&v=4
   url: https://github.com/yezz123
+- login: iudeen
+  count: 53
+  avatarUrl: https://avatars.githubusercontent.com/u/10519440?u=2843b3303282bff8b212dcd4d9d6689452e4470c&v=4
+  url: https://github.com/iudeen
 - login: tokusumi
   count: 51
   avatarUrl: https://avatars.githubusercontent.com/u/41147016?u=55010621aece725aa702270b54fed829b6a1fe60&v=4
@@ -372,10 +376,6 @@ top_reviewers:
   count: 47
   avatarUrl: https://avatars.githubusercontent.com/u/59285379?v=4
   url: https://github.com/Laineyzhang55
-- login: iudeen
-  count: 46
-  avatarUrl: https://avatars.githubusercontent.com/u/10519440?u=2843b3303282bff8b212dcd4d9d6689452e4470c&v=4
-  url: https://github.com/iudeen
 - login: ycd
   count: 45
   avatarUrl: https://avatars.githubusercontent.com/u/62724709?u=bba5af018423a2858d49309bed2a899bb5c34ac5&v=4
@@ -385,7 +385,7 @@ top_reviewers:
   avatarUrl: https://avatars.githubusercontent.com/u/24587499?u=e772190a051ab0eaa9c8542fcff1892471638f2b&v=4
   url: https://github.com/cikay
 - login: Xewus
-  count: 38
+  count: 39
   avatarUrl: https://avatars.githubusercontent.com/u/85196001?u=f8e2dc7e5104f109cef944af79050ea8d1b8f914&v=4
   url: https://github.com/Xewus
 - login: JarroVGIT
@@ -482,7 +482,7 @@ top_reviewers:
   url: https://github.com/sh0nk
 - login: peidrao
   count: 13
-  avatarUrl: https://avatars.githubusercontent.com/u/32584628?u=5b94b548ef0002ef3219d7c07ac0fac17c6201a2&v=4
+  avatarUrl: https://avatars.githubusercontent.com/u/32584628?u=a66902b40c13647d0ed0e573d598128240a4dd04&v=4
   url: https://github.com/peidrao
 - login: r0b2g1t
   count: 13

From ee0b28a398db5e4f7bfe8d53284e9c0575c9543d Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 1 Sep 2023 23:33:31 +0000
Subject: [PATCH 139/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 198bf3823..3b10fe405 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 👥 Update FastAPI People. PR [#10186](https://github.com/tiangolo/fastapi/pull/10186) by [@tiangolo](https://github.com/tiangolo).
 * ✅ Add missing test for OpenAPI examples, it was missing in coverage. PR [#10188](https://github.com/tiangolo/fastapi/pull/10188) by [@tiangolo](https://github.com/tiangolo).
 
 ## 0.103.0

From bf952d345c36807b5931ce6f74c40aa4e7308ccf Mon Sep 17 00:00:00 2001
From: PieCat <53287533+funny-cat-happy@users.noreply.github.com>
Date: Sat, 2 Sep 2023 23:18:30 +0800
Subject: [PATCH 140/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Chinese=20translat?=
 =?UTF-8?q?ion=20for=20`docs/zh/docs/advanced/generate-clients.md`=20(#988?=
 =?UTF-8?q?3)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: xzmeng <aumo@foxmail.com>
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
---
 docs/zh/docs/advanced/generate-clients.md | 266 ++++++++++++++++++++++
 1 file changed, 266 insertions(+)
 create mode 100644 docs/zh/docs/advanced/generate-clients.md

diff --git a/docs/zh/docs/advanced/generate-clients.md b/docs/zh/docs/advanced/generate-clients.md
new file mode 100644
index 000000000..f3a58c062
--- /dev/null
+++ b/docs/zh/docs/advanced/generate-clients.md
@@ -0,0 +1,266 @@
+# 生成客户端
+
+因为 **FastAPI** 是基于OpenAPI规范的，自然您可以使用许多相匹配的工具，包括自动生成API文档 (由 Swagger UI 提供)。
+
+一个不太明显而又特别的优势是，你可以为你的API针对不同的**编程语言**来**生成客户端**(有时候被叫做 <abbr title="Software Development Kits">**SDKs**</abbr> )。
+
+## OpenAPI 客户端生成
+
+有许多工具可以从**OpenAPI**生成客户端。
+
+一个常见的工具是 <a href="https://openapi-generator.tech/" class="external-link" target="_blank">OpenAPI Generator</a>。
+
+如果您正在开发**前端**，一个非常有趣的替代方案是 <a href="https://github.com/ferdikoomen/openapi-typescript-codegen" class="external-link" target="_blank">openapi-typescript-codegen</a>。
+
+## 生成一个 TypeScript 前端客户端
+
+让我们从一个简单的 FastAPI 应用开始：
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="7-9  12-13  16-17  21"
+    {!> ../../../docs_src/generate_clients/tutorial001_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="9-11  14-15  18  19  23"
+    {!> ../../../docs_src/generate_clients/tutorial001.py!}
+    ```
+
+请注意，*路径操作* 定义了他们所用于请求数据和回应数据的模型，所使用的模型是`Item` 和 `ResponseMessage`。
+
+### API 文档
+
+如果您访问API文档，您将看到它具有在请求中发送和在响应中接收数据的**模式(schemas)**：
+
+<img src="/img/tutorial/generate-clients/image01.png">
+
+您可以看到这些模式，因为它们是用程序中的模型声明的。
+
+那些信息可以在应用的 **OpenAPI模式** 被找到，然后显示在API文档中（通过Swagger UI）。
+
+OpenAPI中所包含的模型里有相同的信息可以用于 **生成客户端代码**。
+
+### 生成一个TypeScript 客户端
+
+现在我们有了带有模型的应用，我们可以为前端生成客户端代码。
+
+#### 安装 `openapi-typescript-codegen`
+
+您可以使用以下工具在前端代码中安装 `openapi-typescript-codegen`:
+
+<div class="termy">
+
+```console
+$ npm install openapi-typescript-codegen --save-dev
+
+---> 100%
+```
+
+</div>
+
+#### 生成客户端代码
+
+要生成客户端代码，您可以使用现在将要安装的命令行应用程序 `openapi`。
+
+因为它安装在本地项目中，所以您可能无法直接使用此命令，但您可以将其放在 `package.json` 文件中。
+
+它可能看起来是这样的:
+
+```JSON  hl_lines="7"
+{
+  "name": "frontend-app",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "generate-client": "openapi --input http://localhost:8000/openapi.json --output ./src/client --client axios"
+  },
+  "author": "",
+  "license": "",
+  "devDependencies": {
+    "openapi-typescript-codegen": "^0.20.1",
+    "typescript": "^4.6.2"
+  }
+}
+```
+
+在这里添加 NPM `generate-client` 脚本后，您可以使用以下命令运行它:
+
+<div class="termy">
+
+```console
+$ npm run generate-client
+
+frontend-app@1.0.0 generate-client /home/user/code/frontend-app
+> openapi --input http://localhost:8000/openapi.json --output ./src/client --client axios
+```
+
+</div>
+
+此命令将在 `./src/client` 中生成代码，并将在其内部使用 `axios`（前端HTTP库）。
+
+### 尝试客户端代码
+
+现在您可以导入并使用客户端代码，它可能看起来像这样，请注意，您可以为这些方法使用自动补全：
+
+<img src="/img/tutorial/generate-clients/image02.png">
+
+您还将自动补全要发送的数据：
+
+<img src="/img/tutorial/generate-clients/image03.png">
+
+!!! tip
+    请注意， `name` 和 `price` 的自动补全，是通过其在`Item`模型(FastAPI)中的定义实现的。
+
+如果发送的数据字段不符，你也会看到编辑器的错误提示:
+
+<img src="/img/tutorial/generate-clients/image04.png">
+
+响应(response)对象也拥有自动补全:
+
+<img src="/img/tutorial/generate-clients/image05.png">
+
+## 带有标签的 FastAPI 应用
+
+在许多情况下，你的FastAPI应用程序会更复杂，你可能会使用标签来分隔不同组的*路径操作(path operations)*。
+
+例如，您可以有一个用 `items` 的部分和另一个用于 `users` 的部分，它们可以用标签来分隔：
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="21  26  34"
+    {!> ../../../docs_src/generate_clients/tutorial002_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="23  28  36"
+    {!> ../../../docs_src/generate_clients/tutorial002.py!}
+    ```
+
+### 生成带有标签的 TypeScript 客户端
+
+如果您使用标签为FastAPI应用生成客户端，它通常也会根据标签分割客户端代码。
+
+通过这种方式，您将能够为客户端代码进行正确地排序和分组：
+
+<img src="/img/tutorial/generate-clients/image06.png">
+
+在这个案例中，您有：
+
+* `ItemsService`
+* `UsersService`
+
+### 客户端方法名称
+
+现在生成的方法名像 `createItemItemsPost` 看起来不太简洁:
+
+```TypeScript
+ItemsService.createItemItemsPost({name: "Plumbus", price: 5})
+```
+
+...这是因为客户端生成器为每个 *路径操作* 使用OpenAPI的内部 **操作 ID(operation ID)**。
+
+OpenAPI要求每个操作 ID 在所有 *路径操作* 中都是唯一的，因此 FastAPI 使用**函数名**、**路径**和**HTTP方法/操作**来生成此操作ID，因为这样可以确保这些操作 ID 是唯一的。
+
+但接下来我会告诉你如何改进。 🤓
+
+## 自定义操作ID和更好的方法名
+
+您可以**修改**这些操作ID的**生成**方式，以使其更简洁，并在客户端中具有**更简洁的方法名称**。
+
+在这种情况下，您必须确保每个操作ID在其他方面是**唯一**的。
+
+例如，您可以确保每个*路径操作*都有一个标签，然后根据**标签**和*路径操作***名称**（函数名）来生成操作ID。
+
+### 自定义生成唯一ID函数
+
+FastAPI为每个*路径操作*使用一个**唯一ID**，它用于**操作ID**，也用于任何所需自定义模型的名称，用于请求或响应。
+
+你可以自定义该函数。它接受一个 `APIRoute` 对象作为输入，并输出一个字符串。
+
+例如，以下是一个示例，它使用第一个标签（你可能只有一个标签）和*路径操作*名称（函数名）。
+
+然后，你可以将这个自定义函数作为 `generate_unique_id_function` 参数传递给 **FastAPI**:
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="6-7  10"
+    {!> ../../../docs_src/generate_clients/tutorial003_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="8-9  12"
+    {!> ../../../docs_src/generate_clients/tutorial003.py!}
+    ```
+
+### 使用自定义操作ID生成TypeScript客户端
+
+现在，如果你再次生成客户端，你会发现它具有改善的方法名称：
+
+<img src="/img/tutorial/generate-clients/image07.png">
+
+正如你所见，现在方法名称中只包含标签和函数名，不再包含URL路径和HTTP操作的信息。
+
+### 预处理用于客户端生成器的OpenAPI规范
+
+生成的代码仍然存在一些**重复的信息**。
+
+我们已经知道该方法与 **items** 相关，因为它在 `ItemsService` 中（从标签中获取），但方法名中仍然有标签名作为前缀。😕
+
+一般情况下对于OpenAPI，我们可能仍然希望保留它，因为这将确保操作ID是**唯一的**。
+
+但对于生成的客户端，我们可以在生成客户端之前**修改** OpenAPI 操作ID，以使方法名称更加美观和**简洁**。
+
+我们可以将 OpenAPI JSON 下载到一个名为`openapi.json`的文件中，然后使用以下脚本**删除此前缀的标签**：
+
+```Python
+{!../../../docs_src/generate_clients/tutorial004.py!}
+```
+
+通过这样做，操作ID将从类似于 `items-get_items` 的名称重命名为 `get_items` ，这样客户端生成器就可以生成更简洁的方法名称。
+
+### 使用预处理的OpenAPI生成TypeScript客户端
+
+现在，由于最终结果保存在文件openapi.json中，你可以修改 package.json 文件以使用此本地文件，例如：
+
+```JSON  hl_lines="7"
+{
+  "name": "frontend-app",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "generate-client": "openapi --input ./openapi.json --output ./src/client --client axios"
+  },
+  "author": "",
+  "license": "",
+  "devDependencies": {
+    "openapi-typescript-codegen": "^0.20.1",
+    "typescript": "^4.6.2"
+  }
+}
+```
+
+生成新的客户端之后，你现在将拥有**清晰的方法名称**，具备**自动补全**、**错误提示**等功能：
+
+<img src="/img/tutorial/generate-clients/image08.png">
+
+## 优点
+
+当使用自动生成的客户端时，你将获得以下的自动补全功能：
+
+* 方法。
+* 请求体中的数据、查询参数等。
+* 响应数据。
+
+你还将获得针对所有内容的错误提示。
+
+每当你更新后端代码并**重新生成**前端代码时，新的*路径操作*将作为方法可用，旧的方法将被删除，并且其他任何更改将反映在生成的代码中。 🤓
+
+这也意味着如果有任何更改，它将自动**反映**在客户端代码中。如果你**构建**客户端，在使用的数据上存在**不匹配**时，它将报错。
+
+因此，你将在开发周期的早期**检测到许多错误**，而不必等待错误在生产环境中向最终用户展示，然后尝试调试问题所在。 ✨

From 82ff9a6920115f6b2c00acdf03452a297b926604 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 2 Sep 2023 15:19:08 +0000
Subject: [PATCH 141/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 3b10fe405..5852de5d0 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Chinese translation for `docs/zh/docs/advanced/generate-clients.md`. PR [#9883](https://github.com/tiangolo/fastapi/pull/9883) by [@funny-cat-happy](https://github.com/funny-cat-happy).
 * 👥 Update FastAPI People. PR [#10186](https://github.com/tiangolo/fastapi/pull/10186) by [@tiangolo](https://github.com/tiangolo).
 * ✅ Add missing test for OpenAPI examples, it was missing in coverage. PR [#10188](https://github.com/tiangolo/fastapi/pull/10188) by [@tiangolo](https://github.com/tiangolo).
 

From d8f2f39f6ddc07aa9bc25f7eea8cb752330d7374 Mon Sep 17 00:00:00 2001
From: xzmeng <aumo@foxmail.com>
Date: Sat, 2 Sep 2023 23:22:24 +0800
Subject: [PATCH 142/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20typos=20in?=
 =?UTF-8?q?=20`docs/en/docs/how-to/separate-openapi-schemas.md`=20and=20`d?=
 =?UTF-8?q?ocs/en/docs/tutorial/schema-extra-example.md`=20(#10189)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/how-to/separate-openapi-schemas.md | 2 +-
 docs/en/docs/tutorial/schema-extra-example.md   | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/en/docs/how-to/separate-openapi-schemas.md b/docs/en/docs/how-to/separate-openapi-schemas.md
index d289391ca..d38be3c59 100644
--- a/docs/en/docs/how-to/separate-openapi-schemas.md
+++ b/docs/en/docs/how-to/separate-openapi-schemas.md
@@ -160,7 +160,7 @@ If you interact with the docs and check the response, even though the code didn'
 
 This means that it will **always have a value**, it's just that sometimes the value could be `None` (or `null` in JSON).
 
-That means that, clients using your API don't have to check if the value exists or not, they can **asume the field will always be there**, but just that in some cases it will have the default value of `None`.
+That means that, clients using your API don't have to check if the value exists or not, they can **assume the field will always be there**, but just that in some cases it will have the default value of `None`.
 
 The way to describe this in OpenAPI, is to mark that field as **required**, because it will always be there.
 
diff --git a/docs/en/docs/tutorial/schema-extra-example.md b/docs/en/docs/tutorial/schema-extra-example.md
index 8cf1b9c09..9eeb3f1f2 100644
--- a/docs/en/docs/tutorial/schema-extra-example.md
+++ b/docs/en/docs/tutorial/schema-extra-example.md
@@ -38,13 +38,13 @@ That extra info will be added as-is to the output **JSON Schema** for that model
 
     In Pydantic version 2, you would use the attribute `model_config`, that takes a `dict` as described in <a href="https://docs.pydantic.dev/latest/usage/model_config/" class="external-link" target="_blank">Pydantic's docs: Model Config</a>.
 
-    You can set `"json_schema_extra"` with a `dict` containing any additonal data you would like to show up in the generated JSON Schema, including `examples`.
+    You can set `"json_schema_extra"` with a `dict` containing any additional data you would like to show up in the generated JSON Schema, including `examples`.
 
 === "Pydantic v1"
 
     In Pydantic version 1, you would use an internal class `Config` and `schema_extra`, as described in <a href="https://docs.pydantic.dev/1.10/usage/schema/#schema-customization" class="external-link" target="_blank">Pydantic's docs: Schema customization</a>.
 
-    You can set `schema_extra` with a `dict` containing any additonal data you would like to show up in the generated JSON Schema, including `examples`.
+    You can set `schema_extra` with a `dict` containing any additional data you would like to show up in the generated JSON Schema, including `examples`.
 
 !!! tip
     You could use the same technique to extend the JSON Schema and add your own custom extra info.

From 8cb33e9b477a32ccac867bd5be655e9426d4ccb9 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 2 Sep 2023 15:24:05 +0000
Subject: [PATCH 143/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 5852de5d0..357adc8d3 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ✏️ Fix typos in `docs/en/docs/how-to/separate-openapi-schemas.md` and `docs/en/docs/tutorial/schema-extra-example.md`. PR [#10189](https://github.com/tiangolo/fastapi/pull/10189) by [@xzmeng](https://github.com/xzmeng).
 * 🌐 Add Chinese translation for `docs/zh/docs/advanced/generate-clients.md`. PR [#9883](https://github.com/tiangolo/fastapi/pull/9883) by [@funny-cat-happy](https://github.com/funny-cat-happy).
 * 👥 Update FastAPI People. PR [#10186](https://github.com/tiangolo/fastapi/pull/10186) by [@tiangolo](https://github.com/tiangolo).
 * ✅ Add missing test for OpenAPI examples, it was missing in coverage. PR [#10188](https://github.com/tiangolo/fastapi/pull/10188) by [@tiangolo](https://github.com/tiangolo).

From 1d688a062e59b11b160191d77a9f11971b316cb5 Mon Sep 17 00:00:00 2001
From: Rostyslav <rostik1410@users.noreply.github.com>
Date: Sat, 2 Sep 2023 18:29:36 +0300
Subject: [PATCH 144/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Ukrainian=20transl?=
 =?UTF-8?q?ation=20for=20`docs/uk/docs/tutorial/index.md`=20(#10079)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/uk/docs/tutorial/index.md | 80 ++++++++++++++++++++++++++++++++++
 1 file changed, 80 insertions(+)
 create mode 100644 docs/uk/docs/tutorial/index.md

diff --git a/docs/uk/docs/tutorial/index.md b/docs/uk/docs/tutorial/index.md
new file mode 100644
index 000000000..e5bae74bc
--- /dev/null
+++ b/docs/uk/docs/tutorial/index.md
@@ -0,0 +1,80 @@
+# Туторіал - Посібник користувача
+
+У цьому посібнику показано, як користуватися **FastAPI** з більшістю його функцій, крок за кроком.
+
+Кожен розділ поступово надбудовується на попередні, але він структурований на окремі теми, щоб ви могли перейти безпосередньо до будь-якої конкретної, щоб вирішити ваші конкретні потреби API.
+
+Він також створений як довідник для роботи у майбутньому.
+
+Тож ви можете повернутися і побачити саме те, що вам потрібно.
+
+## Запустіть код
+
+Усі блоки коду можна скопіювати та використовувати безпосередньо (це фактично перевірені файли Python).
+
+Щоб запустити будь-який із прикладів, скопіюйте код у файл `main.py` і запустіть `uvicorn` за допомогою:
+
+<div class="termy">
+
+```console
+$ uvicorn main:app --reload
+
+<span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+<span style="color: green;">INFO</span>:     Started reloader process [28720]
+<span style="color: green;">INFO</span>:     Started server process [28722]
+<span style="color: green;">INFO</span>:     Waiting for application startup.
+<span style="color: green;">INFO</span>:     Application startup complete.
+```
+
+</div>
+
+**ДУЖЕ радимо** написати або скопіювати код, відредагувати його та запустити локально.
+
+Використання його у своєму редакторі – це те, що дійсно показує вам переваги FastAPI, бачите, як мало коду вам потрібно написати, всі перевірки типів, автозаповнення тощо.
+
+---
+
+## Встановлення FastAPI
+
+Першим кроком є встановлення FastAPI.
+
+Для туторіалу ви можете встановити його з усіма необов’язковими залежностями та функціями:
+
+<div class="termy">
+
+```console
+$ pip install "fastapi[all]"
+
+---> 100%
+```
+
+</div>
+
+...який також включає `uvicorn`, який ви можете використовувати як сервер, який запускає ваш код.
+
+!!! note
+    Ви також можете встановити його частина за частиною.
+
+    Це те, що ви, ймовірно, зробили б, коли захочете розгорнути свою програму у виробничому середовищі:
+
+    ```
+    pip install fastapi
+    ```
+
+    Також встановіть `uvicorn`, щоб він працював як сервер:
+
+    ```
+    pip install "uvicorn[standard]"
+    ```
+
+    І те саме для кожної з опціональних залежностей, які ви хочете використовувати.
+
+## Розширений посібник користувача
+
+Існує також **Розширений посібник користувача**, який ви зможете прочитати пізніше після цього **Туторіал - Посібник користувача**.
+
+**Розширений посібник користувача** засновано на цьому, використовує ті самі концепції та навчає вас деяким додатковим функціям.
+
+Але вам слід спочатку прочитати **Туторіал - Посібник користувача** (те, що ви зараз читаєте).
+
+Він розроблений таким чином, що ви можете створити повну програму лише за допомогою **Туторіал - Посібник користувача**, а потім розширити її різними способами, залежно від ваших потреб, використовуючи деякі з додаткових ідей з **Розширеного посібника користувача** .

From 48f6ccfe7d852867ca1be3aa0e0d782e613cfe61 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 2 Sep 2023 15:31:37 +0000
Subject: [PATCH 145/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 357adc8d3..09f19f0f6 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/index.md`. PR [#10079](https://github.com/tiangolo/fastapi/pull/10079) by [@rostik1410](https://github.com/rostik1410).
 * ✏️ Fix typos in `docs/en/docs/how-to/separate-openapi-schemas.md` and `docs/en/docs/tutorial/schema-extra-example.md`. PR [#10189](https://github.com/tiangolo/fastapi/pull/10189) by [@xzmeng](https://github.com/xzmeng).
 * 🌐 Add Chinese translation for `docs/zh/docs/advanced/generate-clients.md`. PR [#9883](https://github.com/tiangolo/fastapi/pull/9883) by [@funny-cat-happy](https://github.com/funny-cat-happy).
 * 👥 Update FastAPI People. PR [#10186](https://github.com/tiangolo/fastapi/pull/10186) by [@tiangolo](https://github.com/tiangolo).

From ad76dd1aa806fb62ad64a2b5c14fe00393ed2589 Mon Sep 17 00:00:00 2001
From: whysage <67018871+whysage@users.noreply.github.com>
Date: Sat, 2 Sep 2023 18:32:30 +0300
Subject: [PATCH 146/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Ukrainian=20transl?=
 =?UTF-8?q?ation=20for=20`docs/uk/docs/alternatives.md`=20(#10060)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
 docs/uk/docs/alternatives.md | 412 +++++++++++++++++++++++++++++++++++
 1 file changed, 412 insertions(+)
 create mode 100644 docs/uk/docs/alternatives.md

diff --git a/docs/uk/docs/alternatives.md b/docs/uk/docs/alternatives.md
new file mode 100644
index 000000000..e71257976
--- /dev/null
+++ b/docs/uk/docs/alternatives.md
@@ -0,0 +1,412 @@
+# Альтернативи, натхнення та порівняння
+
+Що надихнуло на створення **FastAPI**, який він у порінянні з іншими альтернативами та чого він у них навчився.
+
+## Вступ
+
+**FastAPI** не існувало б, якби не попередні роботи інших.
+
+Раніше було створено багато інструментів, які надихнули на його створення.
+
+Я кілька років уникав створення нового фреймворку. Спочатку я спробував вирішити всі функції, охоплені **FastAPI**, використовуючи багато різних фреймворків, плагінів та інструментів.
+
+Але в якийсь момент не було іншого виходу, окрім створення чогось, що надавало б усі ці функції, взявши найкращі ідеї з попередніх інструментів і поєднавши їх найкращим чином, використовуючи мовні функції, які навіть не були доступні раніше (Python 3.6+ підказки типів).
+
+## Попередні інструменти
+
+### <a href="https://www.djangoproject.com/" class="external-link" target="_blank">Django</a>
+
+Це найпопулярніший фреймворк Python, який користується широкою довірою. Він використовується для створення таких систем, як Instagram.
+
+Він відносно тісно пов’язаний з реляційними базами даних (наприклад, MySQL або PostgreSQL), тому мати базу даних NoSQL (наприклад, Couchbase, MongoDB, Cassandra тощо) як основний механізм зберігання не дуже просто.
+
+Він був створений для створення HTML у серверній частині, а не для створення API, які використовуються сучасним інтерфейсом (як-от React, Vue.js і Angular) або іншими системами (як-от <abbr title="Internet of Things">IoT</abbr > пристрої), які спілкуються з ним.
+
+### <a href="https://www.django-rest-framework.org/" class="external-link" target="_blank">Django REST Framework</a>
+
+Фреймворк Django REST був створений як гнучкий інструментарій для створення веб-інтерфейсів API використовуючи Django в основі, щоб покращити його можливості API.
+
+Його використовують багато компаній, включаючи Mozilla, Red Hat і Eventbrite.
+
+Це був один із перших прикладів **автоматичної документації API**, і саме це була одна з перших ідей, яка надихнула на «пошук» **FastAPI**.
+
+!!! Примітка
+     Django REST Framework створив Том Крісті. Той самий творець Starlette і Uvicorn, на яких базується **FastAPI**.
+
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Мати автоматичний веб-інтерфейс документації API.
+
+### <a href="https://flask.palletsprojects.com" class="external-link" target="_blank">Flask</a>
+
+Flask — це «мікрофреймворк», він не включає інтеграцію бази даних, а також багато речей, які за замовчуванням є в Django.
+
+Ця простота та гнучкість дозволяють використовувати бази даних NoSQL як основну систему зберігання даних.
+
+Оскільки він дуже простий, він порівняно легкий та інтуїтивний для освоєння, хоча в деяких моментах документація стає дещо технічною.
+
+Він також зазвичай використовується для інших програм, яким не обов’язково потрібна база даних, керування користувачами або будь-яка з багатьох функцій, які є попередньо вбудованими в Django. Хоча багато з цих функцій можна додати за допомогою плагінів.
+
+Відокремлення частин було ключовою особливістю, яку я хотів зберегти, при цьому залишаючись «мікрофреймворком», який можна розширити, щоб охопити саме те, що потрібно.
+
+Враховуючи простоту Flask, він здавався хорошим підходом для створення API. Наступним, що знайшов, був «Django REST Framework» для Flask.
+
+!!! Переглянте "Надихнуло **FastAPI** на"
+     Бути мікрофреймоворком. Зробити легким комбінування та поєднання необхідних інструментів та частин.
+
+     Мати просту та легку у використанні систему маршрутизації.
+
+
+### <a href="https://requests.readthedocs.io" class="external-link" target="_blank">Requests</a>
+
+**FastAPI** насправді не є альтернативою **Requests**. Сфера їх застосування дуже різна.
+
+Насправді цілком звична річ використовувати Requests *всередині* програми FastAPI.
+
+Але все ж FastAPI черпав натхнення з Requests.
+
+**Requests** — це бібліотека для *взаємодії* з API (як клієнт), а **FastAPI** — це бібліотека для *створення* API (як сервер).
+
+Вони більш-менш знаходяться на протилежних кінцях, доповнюючи одна одну.
+
+Requests мають дуже простий та інтуїтивно зрозумілий дизайн, дуже простий у використанні, з розумними параметрами за замовчуванням. Але в той же час він дуже потужний і налаштовується.
+
+Ось чому, як сказано на офіційному сайті:
+
+> Requests є одним із найбільш завантажуваних пакетів Python усіх часів
+
+Використовувати його дуже просто. Наприклад, щоб виконати запит `GET`, ви повинні написати:
+
+```Python
+response = requests.get("http://example.com/some/url")
+```
+
+Відповідна операція *роуту* API FastAPI може виглядати так:
+
+```Python hl_lines="1"
+@app.get("/some/url")
+def read_url():
+     return {"message": "Hello World"}
+```
+
+Зверніть увагу на схожість у `requests.get(...)` і `@app.get(...)`.
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     * Майте простий та інтуїтивно зрозумілий API.
+     * Використовуйте імена (операції) методів HTTP безпосередньо, простим та інтуїтивно зрозумілим способом.
+     * Розумні параметри за замовчуванням, але потужні налаштування.
+
+
+### <a href="https://swagger.io/" class="external-link" target="_blank">Swagger</a> / <a href="https://github.com/OAI /OpenAPI-Specification/" class="external-link" target="_blank">OpenAPI</a>
+
+Головною функцією, яку я хотів від Django REST Framework, була автоматична API документація.
+
+Потім я виявив, що існує стандарт для документування API з використанням JSON (або YAML, розширення JSON) під назвою Swagger.
+
+І вже був створений веб-інтерфейс користувача для Swagger API. Отже, можливість генерувати документацію Swagger для API дозволить використовувати цей веб-інтерфейс автоматично.
+
+У якийсь момент Swagger було передано Linux Foundation, щоб перейменувати його на OpenAPI.
+
+Тому, коли говорять про версію 2.0, прийнято говорити «Swagger», а про версію 3+ «OpenAPI».
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Прийняти і використовувати відкритий стандарт для специфікацій API замість спеціальної схеми.
+
+     Інтегрувати інструменти інтерфейсу на основі стандартів:
+
+     * <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Інтерфейс Swagger</a>
+     * <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a>
+
+     Ці два було обрано через те, що вони досить популярні та стабільні, але, виконавши швидкий пошук, ви можете знайти десятки додаткових альтернативних інтерфейсів для OpenAPI (які можна використовувати з **FastAPI**).
+
+### Фреймворки REST для Flask
+
+Існує кілька фреймворків Flask REST, але, витративши час і роботу на їх дослідження, я виявив, що багато з них припинено або залишено, з кількома постійними проблемами, які зробили їх непридатними.
+
+### <a href="https://marshmallow.readthedocs.io/en/stable/" class="external-link" target="_blank">Marshmallow</a>
+
+Однією з головних функцій, необхідних для систем API, є "<abbr title="також звана marshalling, conversion">серіалізація</abbr>", яка бере дані з коду (Python) і перетворює їх на щось, що можна надіслати через мережу. Наприклад, перетворення об’єкта, що містить дані з бази даних, на об’єкт JSON. Перетворення об’єктів `datetime` на строки тощо.
+
+Іншою важливою функцією, необхідною для API, є перевірка даних, яка забезпечує дійсність даних за певними параметрами. Наприклад, що деяке поле є `int`, а не деяка випадкова строка. Це особливо корисно для вхідних даних.
+
+Без системи перевірки даних вам довелося б виконувати всі перевірки вручну, у коді.
+
+Marshmallow створено для забезпечення цих функцій. Це чудова бібліотека, і я часто нею користувався раніше.
+
+Але він був створений до того, як існували підказки типу Python. Отже, щоб визначити кожну <abbr title="визначення того, як дані повинні бути сформовані">схему</abbr>, вам потрібно використовувати спеціальні утиліти та класи, надані Marshmallow.
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Використовувати код для автоматичного визначення "схем", які надають типи даних і перевірку.
+
+### <a href="https://webargs.readthedocs.io/en/latest/" class="external-link" target="_blank">Webargs</a>
+
+Іншою важливою функцією, необхідною для API, є <abbr title="читання та перетворення даних Python">аналіз</abbr> даних із вхідних запитів.
+
+Webargs — це інструмент, створений, щоб забезпечити це поверх кількох фреймворків, включаючи Flask.
+
+Він використовує Marshmallow в основі для перевірки даних. І створений тими ж розробниками.
+
+Це чудовий інструмент, і я також часто використовував його, перш ніж створити **FastAPI**.
+
+!!! Інформація
+     Webargs був створений тими ж розробниками Marshmallow.
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Мати автоматичну перевірку даних вхідного запиту.
+
+### <a href="https://apispec.readthedocs.io/en/stable/" class="external-link" target="_blank">APISpec</a>
+
+Marshmallow і Webargs забезпечують перевірку, аналіз і серіалізацію як плагіни.
+
+Але документація досі відсутня. Потім було створено APISpec.
+
+Це плагін для багатьох фреймворків (також є плагін для Starlette).
+
+Принцип роботи полягає в тому, що ви пишете визначення схеми, використовуючи формат YAML, у docstring кожної функції, що обробляє маршрут.
+
+І він генерує схеми OpenAPI.
+
+Так це працює у Flask, Starlette, Responder тощо.
+
+Але потім ми знову маємо проблему наявності мікросинтаксису всередині Python строки (великий YAML).
+
+Редактор тут нічим не може допомогти. І якщо ми змінимо параметри чи схеми Marshmallow і забудемо також змінити цю строку документа YAML, згенерована схема буде застарілою.
+
+!!! Інформація
+     APISpec був створений тими ж розробниками Marshmallow.
+
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Підтримувати відкритий стандарт API, OpenAPI.
+
+### <a href="https://flask-apispec.readthedocs.io/en/latest/" class="external-link" target="_blank">Flask-apispec</a>
+
+Це плагін Flask, який об’єднує Webargs, Marshmallow і APISpec.
+
+Він використовує інформацію з Webargs і Marshmallow для автоматичного створення схем OpenAPI за допомогою APISpec.
+
+Це чудовий інструмент, дуже недооцінений. Він має бути набагато популярнішим, ніж багато плагінів Flask. Це може бути пов’язано з тим, що його документація надто стисла й абстрактна.
+
+Це вирішило необхідність писати YAML (інший синтаксис) всередині рядків документів Python.
+
+Ця комбінація Flask, Flask-apispec із Marshmallow і Webargs була моїм улюбленим бекенд-стеком до створення **FastAPI**.
+
+Їі використання призвело до створення кількох генераторів повного стека Flask. Це основний стек, який я (та кілька зовнішніх команд) використовував досі:
+
+* <a href="https://github.com/tiangolo/full-stack" class="external-link" target="_blank">https://github.com/tiangolo/full-stack</a>
+* <a href="https://github.com/tiangolo/full-stack-flask-couchbase" class="external-link" target="_blank">https://github.com/tiangolo/full-stack-flask-couchbase</a>
+* <a href="https://github.com/tiangolo/full-stack-flask-couchdb" class="external-link" target="_blank">https://github.com/tiangolo/full-stack-flask-couchdb</a>
+
+І ці самі генератори повного стеку були основою [**FastAPI** генераторів проектів](project-generation.md){.internal-link target=_blank}.
+
+!!! Інформація
+     Flask-apispec був створений тими ж розробниками Marshmallow.
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Створення схеми OpenAPI автоматично з того самого коду, який визначає серіалізацію та перевірку.
+
+### <a href="https://nestjs.com/" class="external-link" target="_blank">NestJS</a> (та <a href="https://angular.io/ " class="external-link" target="_blank">Angular</a>)
+
+Це навіть не Python, NestJS — це фреймворк NodeJS JavaScript (TypeScript), натхненний Angular.
+
+Це досягає чогось подібного до того, що можна зробити з Flask-apispec.
+
+Він має інтегровану систему впровадження залежностей, натхненну Angular two. Він потребує попередньої реєстрації «injectables» (як і всі інші системи впровадження залежностей, які я знаю), тому це збільшує багатослівність та повторення коду.
+
+Оскільки параметри описані за допомогою типів TypeScript (подібно до підказок типу Python), підтримка редактора досить хороша.
+
+Але оскільки дані TypeScript не зберігаються після компіляції в JavaScript, вони не можуть покладатися на типи для визначення перевірки, серіалізації та документації одночасно. Через це та деякі дизайнерські рішення, щоб отримати перевірку, серіалізацію та автоматичну генерацію схеми, потрібно додати декоратори в багатьох місцях. Таким чином код стає досить багатослівним.
+
+Він не дуже добре обробляє вкладені моделі. Отже, якщо тіло JSON у запиті є об’єктом JSON із внутрішніми полями, які, у свою чергу, є вкладеними об’єктами JSON, його неможливо належним чином задокументувати та перевірити.
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Використовувати типи Python, щоб мати чудову підтримку редактора.
+
+     Мати потужну систему впровадження залежностей. Знайдіть спосіб звести до мінімуму повторення коду.
+
+### <a href="https://sanic.readthedocs.io/en/latest/" class="external-link" target="_blank">Sanic</a>
+
+Це був один із перших надзвичайно швидких фреймворків Python на основі `asyncio`. Він був дуже схожий на Flask.
+
+!!! Примітка "Технічні деталі"
+     Він використовував <a href="https://github.com/MagicStack/uvloop" class="external-link" target="_blank">`uvloop`</a> замість стандартного циклу Python `asyncio`. Ось що зробило його таким швидким.
+
+     Це явно надихнуло Uvicorn і Starlette, які зараз швидші за Sanic у відкритих тестах.
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Знайти спосіб отримати божевільну продуктивність.
+
+     Ось чому **FastAPI** базується на Starlette, оскільки це найшвидша доступна структура (перевірена тестами сторонніх розробників).
+
+### <a href="https://falconframework.org/" class="external-link" target="_blank">Falcon</a>
+
+Falcon — ще один високопродуктивний фреймворк Python, він розроблений як мінімальний і працює як основа інших фреймворків, таких як Hug.
+
+Він розроблений таким чином, щоб мати функції, які отримують два параметри, один «запит» і один «відповідь». Потім ви «читаєте» частини запиту та «записуєте» частини у відповідь. Через такий дизайн неможливо оголосити параметри запиту та тіла за допомогою стандартних підказок типу Python як параметри функції.
+
+Таким чином, перевірка даних, серіалізація та документація повинні виконуватися в коді, а не автоматично. Або вони повинні бути реалізовані як фреймворк поверх Falcon, як Hug. Така сама відмінність спостерігається в інших фреймворках, натхненних дизайном Falcon, що мають один об’єкт запиту та один об’єкт відповіді як параметри.
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Знайти способи отримати чудову продуктивність.
+
+     Разом із Hug (оскільки Hug базується на Falcon) надихнув **FastAPI** оголосити параметр `response` у функціях.
+
+     Хоча у FastAPI це необов’язково, і використовується в основному для встановлення заголовків, файлів cookie та альтернативних кодів стану.
+
+### <a href="https://moltenframework.com/" class="external-link" target="_blank">Molten</a>
+
+Я відкрив для себе Molten на перших етапах створення **FastAPI**. І він має досить схожі ідеї:
+
+* Базується на підказках типу Python.
+* Перевірка та документація цих типів.
+* Система впровадження залежностей.
+
+Він не використовує перевірку даних, серіалізацію та бібліотеку документації сторонніх розробників, як Pydantic, він має свою власну. Таким чином, ці визначення типів даних не можна було б використовувати повторно так легко.
+
+Це вимагає трохи більш докладних конфігурацій. І оскільки він заснований на WSGI (замість ASGI), він не призначений для використання високопродуктивних інструментів, таких як Uvicorn, Starlette і Sanic.
+
+Система впровадження залежностей вимагає попередньої реєстрації залежностей, і залежності вирішуються на основі оголошених типів. Отже, неможливо оголосити більше ніж один «компонент», який надає певний тип.
+
+Маршрути оголошуються в одному місці з використанням функцій, оголошених в інших місцях (замість використання декораторів, які можна розмістити безпосередньо поверх функції, яка обробляє кінцеву точку). Це ближче до того, як це робить Django, ніж до Flask (і Starlette). Він розділяє в коді речі, які відносно тісно пов’язані.
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Визначити додаткові перевірки для типів даних, використовуючи значення "за замовчуванням" атрибутів моделі. Це покращує підтримку редактора, а раніше вона була недоступна в Pydantic.
+
+     Це фактично надихнуло оновити частини Pydantic, щоб підтримувати той самий стиль оголошення перевірки (всі ці функції вже доступні в Pydantic).
+
+### <a href="https://www.hug.rest/" class="external-link" target="_blank">Hug</a>
+
+Hug був одним із перших фреймворків, який реалізував оголошення типів параметрів API за допомогою підказок типу Python. Це була чудова ідея, яка надихнула інші інструменти зробити те саме.
+
+Він використовував спеціальні типи у своїх оголошеннях замість стандартних типів Python, але це все одно був величезний крок вперед.
+
+Це також був один із перших фреймворків, який генерував спеціальну схему, що оголошувала весь API у JSON.
+
+Він не базувався на таких стандартах, як OpenAPI та JSON Schema. Тому було б непросто інтегрувати його з іншими інструментами, як-от Swagger UI. Але знову ж таки, це була дуже інноваційна ідея.
+
+Він має цікаву незвичайну функцію: використовуючи ту саму структуру, можна створювати API, а також CLI.
+
+Оскільки він заснований на попередньому стандарті для синхронних веб-фреймворків Python (WSGI), він не може працювати з Websockets та іншими речами, хоча він також має високу продуктивність.
+
+!!! Інформація
+     Hug створив Тімоті Крослі, той самий творець <a href="https://github.com/timothycrosley/isort" class="external-link" target="_blank">`isort`</a>, чудовий інструмент для автоматичного сортування імпорту у файлах Python.
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Hug надихнув частину APIStar і був одним із найбільш перспективних інструментів, поряд із APIStar.
+
+     Hug надихнув **FastAPI** на використання підказок типу Python для оголошення параметрів і автоматичного створення схеми, що визначає API.
+
+     Hug надихнув **FastAPI** оголосити параметр `response` у функціях для встановлення заголовків і файлів cookie.
+
+### <a href="https://github.com/encode/apistar" class="external-link" target="_blank">APIStar</a> (<= 0,5)
+
+Безпосередньо перед тим, як вирішити створити **FastAPI**, я знайшов сервер **APIStar**. Він мав майже все, що я шукав, і мав чудовий дизайн.
+
+Це була одна з перших реалізацій фреймворку, що використовує підказки типу Python для оголошення параметрів і запитів, яку я коли-небудь бачив (до NestJS і Molten). Я знайшов його більш-менш одночасно з Hug. Але APIStar використовував стандарт OpenAPI.
+
+Він мав автоматичну перевірку даних, серіалізацію даних і генерацію схеми OpenAPI на основі підказок того самого типу в кількох місцях.
+
+Визначення схеми тіла не використовували ті самі підказки типу Python, як Pydantic, воно було трохи схоже на Marshmallow, тому підтримка редактора була б не такою хорошою, але все ж APIStar був найкращим доступним варіантом.
+
+Він мав найкращі показники продуктивності на той час (перевершив лише Starlette).
+
+Спочатку він не мав автоматичного веб-інтерфейсу документації API, але я знав, що можу додати до нього інтерфейс користувача Swagger.
+
+Він мав систему введення залежностей. Він вимагав попередньої реєстрації компонентів, як і інші інструменти, розглянуті вище. Але все одно це була чудова функція.
+
+Я ніколи не міг використовувати його в повноцінному проекті, оскільки він не мав інтеграції безпеки, тому я не міг замінити всі функції, які мав, генераторами повного стеку на основі Flask-apispec. У моїх невиконаних проектах я мав створити запит на вилучення, додавши цю функцію.
+
+Але потім фокус проекту змінився.
+
+Це вже не був веб-фреймворк API, оскільки творцю потрібно було зосередитися на Starlette.
+
+Тепер APIStar — це набір інструментів для перевірки специфікацій OpenAPI, а не веб-фреймворк.
+
+!!! Інформація
+     APIStar створив Том Крісті. Той самий хлопець, який створив:
+
+     * Django REST Framework
+     * Starlette (на якому базується **FastAPI**)
+     * Uvicorn (використовується Starlette і **FastAPI**)
+
+!!! Перегляньте "Надихнуло **FastAPI** на"
+     Існувати.
+
+     Ідею оголошення кількох речей (перевірки даних, серіалізації та документації) за допомогою тих самих типів Python, які в той же час забезпечували чудову підтримку редактора, я вважав геніальною ідеєю.
+
+     І після тривалого пошуку подібної структури та тестування багатьох різних альтернатив, APIStar став найкращим доступним варіантом.
+
+     Потім APIStar перестав існувати як сервер, і було створено Starlette, який став новою кращою основою для такої системи. Це стало останнім джерелом натхнення для створення **FastAPI**. Я вважаю **FastAPI** «духовним спадкоємцем» APIStar, удосконалюючи та розширюючи функції, систему введення тексту та інші частини на основі досвіду, отриманого від усіх цих попередніх інструментів.
+
+## Використовується **FastAPI**
+
+### <a href="https://pydantic-docs.helpmanual.io/" class="external-link" target="_blank">Pydantic</a>
+
+Pydantic — це бібліотека для визначення перевірки даних, серіалізації та документації (за допомогою схеми JSON) на основі підказок типу Python.
+
+Це робить його надзвичайно інтуїтивним.
+
+Його можна порівняти з Marshmallow. Хоча він швидший за Marshmallow у тестах. Оскільки він базується на тих самих підказках типу Python, підтримка редактора чудова.
+
+!!! Перегляньте "**FastAPI** використовує його для"
+     Виконання перевірки всіх даних, серіалізації даних і автоматичної документацію моделі (на основі схеми JSON).
+
+     Потім **FastAPI** бере ці дані схеми JSON і розміщує їх у OpenAPI, окремо від усіх інших речей, які він робить.
+
+### <a href="https://www.starlette.io/" class="external-link" target="_blank">Starlette</a>
+
+Starlette — це легкий фреймворк/набір інструментів <abbr title="The new standard for build asynchronous Python web">ASGI</abbr>, який ідеально підходить для створення високопродуктивних asyncio сервісів.
+
+Він дуже простий та інтуїтивно зрозумілий. Його розроблено таким чином, щоб його можна було легко розширювати та мати модульні компоненти.
+
+Він має:
+
+* Серйозно вражаючу продуктивність.
+* Підтримку WebSocket.
+* Фонові завдання в процесі.
+* Події запуску та завершення роботи.
+* Тестового клієнта, побудований на HTTPX.
+* CORS, GZip, статичні файли, потокові відповіді.
+* Підтримку сеансів і файлів cookie.
+* 100% покриття тестом.
+* 100% анотовану кодову базу.
+* Кілька жорстких залежностей.
+
+Starlette наразі є найшвидшим фреймворком Python із перевірених. Перевершує лише Uvicorn, який є не фреймворком, а сервером.
+
+Starlette надає всі основні функції веб-мікрофреймворку.
+
+Але він не забезпечує автоматичної перевірки даних, серіалізації чи документації.
+
+Це одна з головних речей, які **FastAPI** додає зверху, все на основі підказок типу Python (з використанням Pydantic). Це, а також система впровадження залежностей, утиліти безпеки, створення схеми OpenAPI тощо.
+
+!!! Примітка "Технічні деталі"
+     ASGI — це новий «стандарт», який розробляється членами основної команди Django. Це ще не «стандарт Python» (PEP), хоча вони в процесі цього.
+
+     Тим не менш, він уже використовується як «стандарт» кількома інструментами. Це значно покращує сумісність, оскільки ви можете переключити Uvicorn на будь-який інший сервер ASGI (наприклад, Daphne або Hypercorn), або ви можете додати інструменти, сумісні з ASGI, як-от `python-socketio`.
+
+!!! Перегляньте "**FastAPI** використовує його для"
+     Керування всіма основними веб-частинами. Додавання функцій зверху.
+
+     Сам клас `FastAPI` безпосередньо успадковує клас `Starlette`.
+
+     Отже, усе, що ви можете робити зі Starlette, ви можете робити це безпосередньо за допомогою **FastAPI**, оскільки це, по суті, Starlette на стероїдах.
+
+### <a href="https://www.uvicorn.org/" class="external-link" target="_blank">Uvicorn</a>
+
+Uvicorn — це блискавичний сервер ASGI, побудований на uvloop і httptools.
+
+Це не веб-фреймворк, а сервер. Наприклад, він не надає інструментів для маршрутизації. Це те, що фреймворк на кшталт Starlette (або **FastAPI**) забезпечить поверх нього.
+
+Це рекомендований сервер для Starlette і **FastAPI**.
+
+!!! Перегляньте "**FastAPI** рекомендує це як"
+     Основний веб-сервер для запуску програм **FastAPI**.
+
+     Ви можете поєднати його з Gunicorn, щоб мати асинхронний багатопроцесний сервер.
+
+     Додаткову інформацію див. у розділі [Розгортання](deployment/index.md){.internal-link target=_blank}.
+
+## Орієнтири та швидкість
+
+Щоб зрозуміти, порівняти та побачити різницю між Uvicorn, Starlette і FastAPI, перегляньте розділ про [Бенчмарки](benchmarks.md){.internal-link target=_blank}.

From 4e93f8e0bc94f72adc79cf1517061f2a1bd17677 Mon Sep 17 00:00:00 2001
From: Ragul K <78537172+ragul-kachiappan@users.noreply.github.com>
Date: Sat, 2 Sep 2023 21:02:48 +0530
Subject: [PATCH 147/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20typo=20in=20?=
 =?UTF-8?q?`docs/en/docs/tutorial/dependencies/dependencies-in-path-operat?=
 =?UTF-8?q?ion-decorators.md`=20(#10172)?=
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>
---
 .../dependencies/dependencies-in-path-operation-decorators.md   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md b/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
index 935555339..ccef5aef4 100644
--- a/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
+++ b/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
@@ -35,7 +35,7 @@ It should be a `list` of `Depends()`:
     {!> ../../../docs_src/dependencies/tutorial006.py!}
     ```
 
-These dependencies will be executed/solved the same way normal dependencies. But their value (if they return any) won't be passed to your *path operation function*.
+These dependencies will be executed/solved the same way as normal dependencies. But their value (if they return any) won't be passed to your *path operation function*.
 
 !!! tip
     Some editors check for unused function parameters, and show them as errors.

From 59cbeccac02cf66cbdc55fd1d7ec2675fa5e8e9e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 2 Sep 2023 15:36:34 +0000
Subject: [PATCH 148/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 09f19f0f6..a74499d88 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Ukrainian translation for `docs/uk/docs/alternatives.md`. PR [#10060](https://github.com/tiangolo/fastapi/pull/10060) by [@whysage](https://github.com/whysage).
 * 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/index.md`. PR [#10079](https://github.com/tiangolo/fastapi/pull/10079) by [@rostik1410](https://github.com/rostik1410).
 * ✏️ Fix typos in `docs/en/docs/how-to/separate-openapi-schemas.md` and `docs/en/docs/tutorial/schema-extra-example.md`. PR [#10189](https://github.com/tiangolo/fastapi/pull/10189) by [@xzmeng](https://github.com/xzmeng).
 * 🌐 Add Chinese translation for `docs/zh/docs/advanced/generate-clients.md`. PR [#9883](https://github.com/tiangolo/fastapi/pull/9883) by [@funny-cat-happy](https://github.com/funny-cat-happy).

From 9fc33f8565be369ed7b40d8202a8cf4a49c951b6 Mon Sep 17 00:00:00 2001
From: Ahsan Sheraz <ahsansheraz250@gmail.com>
Date: Sat, 2 Sep 2023 20:37:40 +0500
Subject: [PATCH 149/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20typos=20in?=
 =?UTF-8?q?=20comment=20in=20`fastapi/applications.py`=20(#10045)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 fastapi/applications.py | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/fastapi/applications.py b/fastapi/applications.py
index b681e50b3..5cc568292 100644
--- a/fastapi/applications.py
+++ b/fastapi/applications.py
@@ -189,20 +189,20 @@ class FastAPI(Starlette):
                 # contextvars.
                 # This needs to happen after user middlewares because those create a
                 # new contextvars context copy by using a new AnyIO task group.
-                # The initial part of dependencies with yield is executed in the
-                # FastAPI code, inside all the middlewares, but the teardown part
-                # (after yield) is executed in the AsyncExitStack in this middleware,
-                # if the AsyncExitStack lived outside of the custom middlewares and
-                # contextvars were set in a dependency with yield in that internal
+                # The initial part of dependencies with 'yield' is executed in the
+                # FastAPI code, inside all the middlewares. However, the teardown part
+                # (after 'yield') is executed in the AsyncExitStack in this middleware.
+                # If the AsyncExitStack lived outside of the custom middlewares and
+                # contextvars were set in a dependency with 'yield' in that internal
                 # contextvars context, the values would not be available in the
-                # outside context of the AsyncExitStack.
-                # By putting the middleware and the AsyncExitStack here, inside all
-                # user middlewares, the code before and after yield in dependencies
-                # with yield is executed in the same contextvars context, so all values
-                # set in contextvars before yield is still available after yield as
-                # would be expected.
+                # outer context of the AsyncExitStack.
+                # By placing the middleware and the AsyncExitStack here, inside all
+                # user middlewares, the code before and after 'yield' in dependencies
+                # with 'yield' is executed in the same contextvars context. Thus, all values
+                # set in contextvars before 'yield' are still available after 'yield,' as
+                # expected.
                 # Additionally, by having this AsyncExitStack here, after the
-                # ExceptionMiddleware, now dependencies can catch handled exceptions,
+                # ExceptionMiddleware, dependencies can now catch handled exceptions,
                 # e.g. HTTPException, to customize the teardown code (e.g. DB session
                 # rollback).
                 Middleware(AsyncExitStackMiddleware),

From a55f3204ef2577045a0ab0585dd58c40686a2da2 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 2 Sep 2023 15:37:56 +0000
Subject: [PATCH 150/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index a74499d88..2a9ffc954 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ✏️ Fix typo in `docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md`. PR [#10172](https://github.com/tiangolo/fastapi/pull/10172) by [@ragul-kachiappan](https://github.com/ragul-kachiappan).
 * 🌐 Add Ukrainian translation for `docs/uk/docs/alternatives.md`. PR [#10060](https://github.com/tiangolo/fastapi/pull/10060) by [@whysage](https://github.com/whysage).
 * 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/index.md`. PR [#10079](https://github.com/tiangolo/fastapi/pull/10079) by [@rostik1410](https://github.com/rostik1410).
 * ✏️ Fix typos in `docs/en/docs/how-to/separate-openapi-schemas.md` and `docs/en/docs/tutorial/schema-extra-example.md`. PR [#10189](https://github.com/tiangolo/fastapi/pull/10189) by [@xzmeng](https://github.com/xzmeng).

From b2562c5c73440c992e2bd9a1ad07312f3358361f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 2 Sep 2023 15:41:53 +0000
Subject: [PATCH 151/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2a9ffc954..8af275623 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ✏️ Fix typos in comment in `fastapi/applications.py`. PR [#10045](https://github.com/tiangolo/fastapi/pull/10045) by [@AhsanSheraz](https://github.com/AhsanSheraz).
 * ✏️ Fix typo in `docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md`. PR [#10172](https://github.com/tiangolo/fastapi/pull/10172) by [@ragul-kachiappan](https://github.com/ragul-kachiappan).
 * 🌐 Add Ukrainian translation for `docs/uk/docs/alternatives.md`. PR [#10060](https://github.com/tiangolo/fastapi/pull/10060) by [@whysage](https://github.com/whysage).
 * 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/index.md`. PR [#10079](https://github.com/tiangolo/fastapi/pull/10079) by [@rostik1410](https://github.com/rostik1410).

From 2e3295719814fdfb957c31d0720c578053c230fc Mon Sep 17 00:00:00 2001
From: Poupapaa <3238986+poupapaa@users.noreply.github.com>
Date: Sat, 2 Sep 2023 22:43:16 +0700
Subject: [PATCH 152/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20typo=20in=20?=
 =?UTF-8?q?`docs/en/docs/tutorial/handling-errors.md`=20(#10170)?=
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/tutorial/handling-errors.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/docs/tutorial/handling-errors.md b/docs/en/docs/tutorial/handling-errors.md
index 8c30326ce..a03029e81 100644
--- a/docs/en/docs/tutorial/handling-errors.md
+++ b/docs/en/docs/tutorial/handling-errors.md
@@ -1,6 +1,6 @@
 # Handling Errors
 
-There are many situations in where you need to notify an error to a client that is using your API.
+There are many situations in which you need to notify an error to a client that is using your API.
 
 This client could be a browser with a frontend, a code from someone else, an IoT device, etc.
 

From 8979166bc308067951f5361df0cf85b0b73fb1bf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nguy=E1=BB=85n=20Kh=E1=BA=AFc=20Th=C3=A0nh?=
 <nguyenkhacthanh244@gmail.com>
Date: Sat, 2 Sep 2023 22:44:17 +0700
Subject: [PATCH 153/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Vietnamese=20trans?=
 =?UTF-8?q?lations=20for=20`docs/vi/docs/tutorial/first-steps.md`=20and=20?=
 =?UTF-8?q?`docs/vi/docs/tutorial/index.md`=20(#10088)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
---
 docs/vi/docs/tutorial/first-steps.md | 333 +++++++++++++++++++++++++++
 docs/vi/docs/tutorial/index.md       |  80 +++++++
 2 files changed, 413 insertions(+)
 create mode 100644 docs/vi/docs/tutorial/first-steps.md
 create mode 100644 docs/vi/docs/tutorial/index.md

diff --git a/docs/vi/docs/tutorial/first-steps.md b/docs/vi/docs/tutorial/first-steps.md
new file mode 100644
index 000000000..712f00852
--- /dev/null
+++ b/docs/vi/docs/tutorial/first-steps.md
@@ -0,0 +1,333 @@
+# Những bước đầu tiên
+
+Tệp tin FastAPI đơn giản nhất có thể trông như này:
+
+```Python
+{!../../../docs_src/first_steps/tutorial001.py!}
+```
+
+Sao chép sang một tệp tin `main.py`.
+
+Chạy live server:
+
+<div class="termy">
+
+```console
+$ uvicorn main:app --reload
+
+<span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+<span style="color: green;">INFO</span>:     Started reloader process [28720]
+<span style="color: green;">INFO</span>:     Started server process [28722]
+<span style="color: green;">INFO</span>:     Waiting for application startup.
+<span style="color: green;">INFO</span>:     Application startup complete.
+```
+
+</div>
+
+!!! note
+    Câu lệnh `uvicorn main:app` được giải thích như sau:
+
+    * `main`: tệp tin `main.py` (một Python "mô đun").
+    * `app`: một object được tạo ra bên trong `main.py` với dòng `app = FastAPI()`.
+    * `--reload`: làm server khởi động lại sau mỗi lần thay đổi. Chỉ sử dụng trong môi trường phát triển.
+
+Trong output, có một dòng giống như:
+
+```hl_lines="4"
+INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+```
+
+Dòng đó cho thấy URL, nơi mà app của bạn đang được chạy, trong máy local của bạn.
+
+### Kiểm tra
+
+Mở trình duyệt của bạn tại <a href="http://127.0.0.1:8000" class="external-link" target="_blank">http://127.0.0.1:8000</a>.
+
+Bạn sẽ thấy một JSON response như:
+
+```JSON
+{"message": "Hello World"}
+```
+
+### Tài liệu tương tác API
+
+Bây giờ tới <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>.
+
+Bạn sẽ thấy một tài liệu tương tác API (cung cấp bởi <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Swagger UI</a>):
+
+![Swagger UI](https://fastapi.tiangolo.com/img/index/index-01-swagger-ui-simple.png)
+
+### Phiên bản thay thế của tài liệu API
+
+Và bây giờ tới <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a>.
+
+Bạn sẽ thấy một bản thay thế của tài liệu (cung cấp bởi <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a>):
+
+![ReDoc](https://fastapi.tiangolo.com/img/index/index-02-redoc-simple.png)
+
+### OpenAPI
+
+**FastAPI** sinh một "schema" với tất cả API của bạn sử dụng tiêu chuẩn **OpenAPI** cho định nghĩa các API.
+
+#### "Schema"
+
+Một "schema" là một định nghĩa hoặc mô tả thứ gì đó. Không phải code triển khai của nó, nhưng chỉ là một bản mô tả trừu tượng.
+
+#### API "schema"
+
+Trong trường hợp này, <a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank">OpenAPI</a> là một bản mô tả bắt buộc cơ chế định nghĩa API của bạn.
+
+Định nghĩa cấu trúc này bao gồm những đường dẫn API của bạn, các tham số có thể có,...
+
+#### "Cấu trúc" dữ liệu
+
+Thuật ngữ "cấu trúc" (schema) cũng có thể được coi như là hình dạng của dữ liệu, tương tự như một JSON content.
+
+Trong trường hợp đó, nó có nghĩa là các thuộc tính JSON và các kiểu dữ liệu họ có,...
+
+#### OpenAPI và JSON Schema
+
+OpenAPI định nghĩa một cấu trúc API cho API của bạn. Và cấu trúc đó bao gồm các dịnh nghĩa (or "schema") về dữ liệu được gửi đi và nhận về bởi API của bạn, sử dụng **JSON Schema**, một tiêu chuẩn cho cấu trúc dữ liệu JSON.
+
+#### Kiểm tra `openapi.json`
+
+Nếu bạn tò mò về việc cấu trúc OpenAPI nhìn như thế nào thì FastAPI tự động sinh một JSON (schema) với các mô tả cho tất cả API của bạn.
+
+Bạn có thể thấy nó trực tiếp tại: <a href="http://127.0.0.1:8000/openapi.json" class="external-link" target="_blank">http://127.0.0.1:8000/openapi.json</a>.
+
+Nó sẽ cho thấy một JSON bắt đầu giống như:
+
+```JSON
+{
+    "openapi": "3.1.0",
+    "info": {
+        "title": "FastAPI",
+        "version": "0.1.0"
+    },
+    "paths": {
+        "/items/": {
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Successful Response",
+                        "content": {
+                            "application/json": {
+
+
+
+...
+```
+
+#### OpenAPI dùng để làm gì?
+
+Cấu trúc OpenAPI là sức mạnh của tài liệu tương tác.
+
+Và có hàng tá các bản thay thế, tất cả đều dựa trên OpenAPI. Bạn có thể dễ dàng thêm bất kì bản thay thế bào cho ứng dụng của bạn được xây dựng với **FastAPI**.
+
+Bạn cũng có thể sử dụng nó để sinh code tự động, với các client giao viết qua API của bạn. Ví dụ, frontend, mobile hoặc các ứng dụng IoT.
+
+## Tóm lại, từng bước một
+
+### Bước 1: import `FastAPI`
+
+```Python hl_lines="1"
+{!../../../docs_src/first_steps/tutorial001.py!}
+```
+
+`FastAPI` là một Python class cung cấp tất cả chức năng cho API của bạn.
+
+!!! note "Chi tiết kĩ thuật"
+    `FastAPI` là một class kế thừa trực tiếp `Starlette`.
+
+    Bạn cũng có thể sử dụng tất cả <a href="https://www.starlette.io/" class="external-link" target="_blank">Starlette</a> chức năng với `FastAPI`.
+
+### Bước 2: Tạo một `FastAPI` "instance"
+
+```Python hl_lines="3"
+{!../../../docs_src/first_steps/tutorial001.py!}
+```
+
+Biến `app` này là một "instance" của class `FastAPI`.
+
+Đây sẽ là điểm cốt lõi để tạo ra tất cả API của bạn.
+
+`app` này chính là điều được nhắc tới bởi `uvicorn` trong câu lệnh:
+
+<div class="termy">
+
+```console
+$ uvicorn main:app --reload
+
+<span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+```
+
+</div>
+
+Nếu bạn tạo ứng dụng của bạn giống như:
+
+```Python hl_lines="3"
+{!../../../docs_src/first_steps/tutorial002.py!}
+```
+
+Và đặt nó trong một tệp tin `main.py`, sau đó bạn sẽ gọi `uvicorn` giống như:
+
+<div class="termy">
+
+```console
+$ uvicorn main:my_awesome_api --reload
+
+<span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+```
+
+</div>
+
+### Bước 3: tạo một *đường dẫn toán tử*
+
+#### Đường dẫn
+
+"Đường dẫn" ở đây được nhắc tới là phần cuối cùng của URL bắt đầu từ `/`.
+
+Do đó, trong một URL nhìn giống như:
+
+```
+https://example.com/items/foo
+```
+
+...đường dẫn sẽ là:
+
+```
+/items/foo
+```
+
+!!! info
+    Một đường dẫn cũng là một cách gọi chung cho một "endpoint" hoặc một "route".
+
+Trong khi xây dựng một API, "đường dẫn" là các chính để phân tách "mối quan hệ" và "tài nguyên".
+
+#### Toán tử (Operation)
+
+"Toán tử" ở đây được nhắc tới là một trong các "phương thức" HTTP.
+
+Một trong những:
+
+* `POST`
+* `GET`
+* `PUT`
+* `DELETE`
+
+...và một trong những cái còn lại:
+
+* `OPTIONS`
+* `HEAD`
+* `PATCH`
+* `TRACE`
+
+Trong giao thức HTTP, bạn có thể giao tiếp trong mỗi đường dẫn sử dụng một (hoặc nhiều) trong các "phương thức này".
+
+---
+
+Khi xây dựng các API, bạn thường sử dụng cụ thể các phương thức HTTP này để thực hiện một hành động cụ thể.
+
+Thông thường, bạn sử dụng
+
+* `POST`: để tạo dữ liệu.
+* `GET`: để đọc dữ liệu.
+* `PUT`: để cập nhật dữ liệu.
+* `DELETE`: để xóa dữ liệu.
+
+Do đó, trong OpenAPI, mỗi phương thức HTTP được gọi là một "toán tử (operation)".
+
+Chúng ta cũng sẽ gọi chúng là "**các toán tử**".
+
+#### Định nghĩa moojt *decorator cho đường dẫn toán tử*
+
+```Python hl_lines="6"
+{!../../../docs_src/first_steps/tutorial001.py!}
+```
+
+`@app.get("/")` nói **FastAPI** rằng hàm bên dưới có trách nhiệm xử lí request tới:
+
+* đường dẫn `/`
+* sử dụng một <abbr title="an HTTP GET method">toán tử<code>get</code></abbr>
+
+!!! info Thông tin về "`@decorator`"
+    Cú pháp `@something` trong Python được gọi là một "decorator".
+
+    Bạn đặt nó trên một hàm. Giống như một chiếc mũ xinh xắn (Tôi ddonas đó là lí do mà thuật ngữ này ra đời).
+
+    Một "decorator" lấy một hàm bên dưới và thực hiện một vài thứ với nó.
+
+    Trong trường hợp của chúng ta, decorator này nói **FastAPI** rằng hàm bên dưới ứng với **đường dẫn** `/` và một **toán tử** `get`.
+
+    Nó là một "**decorator đường dẫn toán tử**".
+
+Bạn cũng có thể sử dụng với các toán tử khác:
+
+* `@app.post()`
+* `@app.put()`
+* `@app.delete()`
+
+Và nhiều hơn với các toán tử còn lại:
+
+* `@app.options()`
+* `@app.head()`
+* `@app.patch()`
+* `@app.trace()`
+
+!!! tip
+    Bạn thoải mái sử dụng mỗi toán tử (phương thức HTTP) như bạn mơ ước.
+
+    **FastAPI** không bắt buộc bất kì ý nghĩa cụ thể nào.
+
+    Thông tin ở đây được biểu thị như là một chỉ dẫn, không phải là một yêu cầu bắt buộc.
+
+    Ví dụ, khi sử dụng GraphQL bạn thông thường thực hiện tất cả các hành động chỉ bằng việc sử dụng các toán tử `POST`.
+
+### Step 4: Định nghĩa **hàm cho đường dẫn toán tử**
+
+Đây là "**hàm cho đường dẫn toán tử**":
+
+* **đường dẫn**: là `/`.
+* **toán tử**: là `get`.
+* **hàm**: là hàm bên dưới "decorator" (bên dưới `@app.get("/")`).
+
+```Python hl_lines="7"
+{!../../../docs_src/first_steps/tutorial001.py!}
+```
+
+Đây là một hàm Python.
+
+Nó sẽ được gọi bởi **FastAPI** bất cứ khi nào nó nhận một request tới URL "`/`" sử dụng một toán tử `GET`.
+
+Trong trường hợp này, nó là một hàm `async`.
+
+---
+
+Bạn cũng có thể định nghĩa nó như là một hàm thông thường thay cho `async def`:
+
+```Python hl_lines="7"
+{!../../../docs_src/first_steps/tutorial003.py!}
+```
+
+!!! note
+    Nếu bạn không biết sự khác nhau, kiểm tra [Async: *"Trong khi vội vàng?"*](../async.md#in-a-hurry){.internal-link target=_blank}.
+
+### Bước 5: Nội dung trả về
+
+```Python hl_lines="8"
+{!../../../docs_src/first_steps/tutorial001.py!}
+```
+
+Bạn có thể trả về một `dict`, `list`, một trong những giá trị đơn như `str`, `int`,...
+
+Bạn cũng có thể trả về Pydantic model (bạn sẽ thấy nhiều hơn về nó sau).
+
+Có nhiều object và model khác nhau sẽ được tự động chuyển đổi sang JSON (bao gồm cả ORM,...). Thử sử dụng loại ưa thích của bạn, nó có khả năng cao đã được hỗ trợ.
+
+## Tóm lại
+
+* Import `FastAPI`.
+* Tạo một `app` instance.
+* Viết một **decorator cho đường dẫn toán tử** (giống như `@app.get("/")`).
+* Viết một **hàm cho đường dẫn toán tử** (giống như  `def root(): ...` ở trên).
+* Chạy server trong môi trường phát triển (giống như `uvicorn main:app --reload`).
diff --git a/docs/vi/docs/tutorial/index.md b/docs/vi/docs/tutorial/index.md
new file mode 100644
index 000000000..e8a93fe40
--- /dev/null
+++ b/docs/vi/docs/tutorial/index.md
@@ -0,0 +1,80 @@
+# Hướng dẫn sử dụng
+
+Hướng dẫn này cho bạn thấy từng bước cách sử dụng **FastAPI** đa số các tính năng của nó.
+
+Mỗi phần được xây dựng từ những phần trước đó, nhưng nó được cấu trúc thành các chủ đề riêng biệt, do đó bạn có thể xem trực tiếp từng phần cụ thể bất kì để giải quyết những API cụ thể mà bạn cần.
+
+Nó cũng được xây dựng để làm việc như một tham chiếu trong tương lai.
+
+Do đó bạn có thể quay lại và tìm chính xác những gì bạn cần.
+
+## Chạy mã
+
+Tất cả các code block có thể được sao chép và sử dụng trực tiếp (chúng thực chất là các tệp tin Python đã được kiểm thử).
+
+Để chạy bất kì ví dụ nào, sao chép code tới tệp tin `main.py`, và bắt đầu `uvicorn` với:
+
+<div class="termy">
+
+```console
+$ uvicorn main:app --reload
+
+<span style="color: green;">INFO</span>:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+<span style="color: green;">INFO</span>:     Started reloader process [28720]
+<span style="color: green;">INFO</span>:     Started server process [28722]
+<span style="color: green;">INFO</span>:     Waiting for application startup.
+<span style="color: green;">INFO</span>:     Application startup complete.
+```
+
+</div>
+
+**Khuyến khích** bạn viết hoặc sao chép code, sửa và chạy nó ở local.
+
+Sử dụng nó trong trình soạn thảo của bạn thực sự cho bạn thấy những lợi ích của FastAPI, thấy được cách bạn viết code ít hơn, tất cả đều được type check, autocompletion,...
+
+---
+
+## Cài đặt FastAPI
+
+Bước đầu tiên là cài đặt FastAPI.
+
+Với hướng dẫn này, bạn có thể muốn cài đặt nó với tất cả các phụ thuộc và tính năng tùy chọn:
+
+<div class="termy">
+
+```console
+$ pip install "fastapi[all]"
+
+---> 100%
+```
+
+</div>
+
+...dó cũng bao gồm `uvicorn`, bạn có thể sử dụng như một server để chạy code của bạn.
+
+!!! note
+    Bạn cũng có thể cài đặt nó từng phần.
+
+    Đây là những gì bạn có thể sẽ làm một lần duy nhất bạn muốn triển khai ứng dụng của bạn lên production:
+
+    ```
+    pip install fastapi
+    ```
+
+    Cũng cài đặt `uvicorn` để làm việc như một server:
+
+    ```
+    pip install "uvicorn[standard]"
+    ```
+
+    Và tương tự với từng phụ thuộc tùy chọn mà bạn muốn sử dụng.
+
+## Hướng dẫn nâng cao
+
+Cũng có một **Hướng dẫn nâng cao** mà bạn có thể đọc nó sau **Hướng dẫn sử dụng**.
+
+**Hướng dẫn sử dụng nâng cao**, xây dựng dựa trên cái này, sử dụng các khái niệm tương tự, và dạy bạn những tính năng mở rộng.
+
+Nhưng bạn nên đọc **Hướng dẫn sử dụng** đầu tiên (những gì bạn đang đọc).
+
+Nó được thiết kế do đó bạn có thể xây dựng một ứng dụng hoàn chỉnh chỉ với **Hướng dẫn sử dụng**, và sau đó mở rộng nó theo các cách khác nhau, phụ thuộc vào những gì bạn cần, sử dụng một vài ý tưởng bổ sung từ **Hướng dẫn sử dụng nâng cao**.

From e6c4785959609097631fa37f393cd9f977377dfa Mon Sep 17 00:00:00 2001
From: Rostyslav <rostik1410@users.noreply.github.com>
Date: Sat, 2 Sep 2023 18:48:03 +0300
Subject: [PATCH 154/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Ukrainian=20transl?=
 =?UTF-8?q?ation=20for=20`docs/uk/docs/python-types.md`=20(#10080)?=
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/uk/docs/python-types.md | 448 +++++++++++++++++++++++++++++++++++
 1 file changed, 448 insertions(+)
 create mode 100644 docs/uk/docs/python-types.md

diff --git a/docs/uk/docs/python-types.md b/docs/uk/docs/python-types.md
new file mode 100644
index 000000000..f792e83a8
--- /dev/null
+++ b/docs/uk/docs/python-types.md
@@ -0,0 +1,448 @@
+# Вступ до типів Python
+
+Python підтримує додаткові "підказки типу" ("type hints") (також звані "анотаціями типу" ("type annotations")).
+
+Ці **"type hints"** є спеціальним синтаксисом, що дозволяє оголошувати <abbr title="наприклад: str, int, float, bool">тип</abbr> змінної.
+
+За допомогою оголошення типів для ваших змінних, редактори та інструменти можуть надати вам кращу підтримку.
+
+Це просто **швидкий посібник / нагадування** про анотації типів у Python. Він покриває лише мінімум, необхідний щоб використовувати їх з **FastAPI**... що насправді дуже мало.
+
+**FastAPI** повністю базується на цих анотаціях типів, вони дають йому багато переваг.
+
+Але навіть якщо ви ніколи не використаєте **FastAPI**, вам буде корисно дізнатись трохи про них.
+
+!!! note
+    Якщо ви експерт у Python і ви вже знаєте усе про анотації типів - перейдіть до наступного розділу.
+
+## Мотивація
+
+Давайте почнемо з простого прикладу:
+
+```Python
+{!../../../docs_src/python_types/tutorial001.py!}
+```
+
+Виклик цієї програми виводить:
+
+```
+John Doe
+```
+
+Функція виконує наступне:
+
+* Бере `first_name` та `last_name`.
+* Конвертує кожну літеру кожного слова у верхній регістр за допомогою `title()`.
+* <abbr title="З’єднує їх, як одне ціле. З вмістом один за одним.">Конкатенує</abbr> їх разом із пробілом по середині.
+
+```Python hl_lines="2"
+{!../../../docs_src/python_types/tutorial001.py!}
+```
+
+### Редагуйте це
+
+Це дуже проста програма.
+
+Але тепер уявіть, що ви писали це з нуля.
+
+У певний момент ви розпочали б визначення функції, у вас були б готові параметри...
+
+Але тоді вам потрібно викликати "той метод, який переводить першу літеру у верхній регістр".
+
+Це буде `upper`? Чи `uppercase`? `first_uppercase`? `capitalize`?
+
+Тоді ви спробуєте давнього друга програміста - автозаповнення редактора коду.
+
+Ви надрукуєте перший параметр функції, `first_name`, тоді крапку (`.`), а тоді натиснете `Ctrl+Space`, щоб запустити автозаповнення.
+
+Але, на жаль, ви не отримаєте нічого корисного:
+
+<img src="/img/python-types/image01.png">
+
+### Додайте типи
+
+Давайте змінимо один рядок з попередньої версії.
+
+Ми змінимо саме цей фрагмент, параметри функції, з:
+
+```Python
+    first_name, last_name
+```
+
+на:
+
+```Python
+    first_name: str, last_name: str
+```
+
+Ось і все.
+
+Це "type hints":
+
+```Python hl_lines="1"
+{!../../../docs_src/python_types/tutorial002.py!}
+```
+
+Це не те саме, що оголошення значень за замовчуванням, як це було б з:
+
+```Python
+    first_name="john", last_name="doe"
+```
+
+Це зовсім інше.
+
+Ми використовуємо двокрапку (`:`), не дорівнює (`=`).
+
+І додавання анотації типу зазвичай не змінює того, що сталось би без них.
+
+Але тепер, уявіть що ви посеред процесу створення функції, але з анотаціями типів.
+
+В цей же момент, ви спробуєте викликати автозаповнення з допомогою `Ctrl+Space` і побачите:
+
+<img src="/img/python-types/image02.png">
+
+Разом з цим, ви можете прокручувати, переглядати опції, допоки ви не знайдете одну, що звучить схоже:
+
+<img src="/img/python-types/image03.png">
+
+## Більше мотивації
+
+Перевірте цю функцію, вона вже має анотацію типу:
+
+```Python hl_lines="1"
+{!../../../docs_src/python_types/tutorial003.py!}
+```
+
+Оскільки редактор знає типи змінних, ви не тільки отримаєте автозаповнення, ви також отримаєте перевірку помилок:
+
+<img src="/img/python-types/image04.png">
+
+Тепер ви знаєте, щоб виправити це, вам потрібно перетворити `age` у строку з допомогою `str(age)`:
+
+```Python hl_lines="2"
+{!../../../docs_src/python_types/tutorial004.py!}
+```
+
+## Оголошення типів
+
+Щойно ви побачили основне місце для оголошення анотацій типу. Як параметри функції.
+
+Це також основне місце, де ви б їх використовували у **FastAPI**.
+
+### Прості типи
+
+Ви можете оголошувати усі стандартні типи у Python, не тільки `str`.
+
+Ви можете використовувати, наприклад:
+
+* `int`
+* `float`
+* `bool`
+* `bytes`
+
+```Python hl_lines="1"
+{!../../../docs_src/python_types/tutorial005.py!}
+```
+
+### Generic-типи з параметрами типів
+
+Існують деякі структури даних, які можуть містити інші значення, наприклад `dict`, `list`, `set` та `tuple`. І внутрішні значення також можуть мати свій тип.
+
+Ці типи, які мають внутрішні типи, називаються "**generic**" типами. І оголосити їх можна навіть із внутрішніми типами.
+
+Щоб оголосити ці типи та внутрішні типи, ви можете використовувати стандартний модуль Python `typing`. Він існує спеціально для підтримки анотацій типів.
+
+#### Новіші версії Python
+
+Синтаксис із використанням `typing` **сумісний** з усіма версіями, від Python 3.6 до останніх, включаючи Python 3.9, Python 3.10 тощо.
+
+У міру розвитку Python **новіші версії** мають покращену підтримку анотацій типів і в багатьох випадках вам навіть не потрібно буде імпортувати та використовувати модуль `typing` для оголошення анотацій типу.
+
+Якщо ви можете вибрати новішу версію Python для свого проекту, ви зможете скористатися цією додатковою простотою. Дивіться кілька прикладів нижче.
+
+#### List (список)
+
+Наприклад, давайте визначимо змінну, яка буде `list` із `str`.
+
+=== "Python 3.6 і вище"
+
+    З модуля `typing`, імпортуємо `List` (з великої літери `L`):
+
+    ``` Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial006.py!}
+    ```
+
+    Оголосимо змінну з тим самим синтаксисом двокрапки (`:`).
+
+    Як тип вкажемо `List`, який ви імпортували з `typing`.
+
+    Оскільки список є типом, який містить деякі внутрішні типи, ви поміщаєте їх у квадратні дужки:
+
+    ```Python hl_lines="4"
+    {!> ../../../docs_src/python_types/tutorial006.py!}
+    ```
+
+=== "Python 3.9 і вище"
+
+    Оголосимо змінну з тим самим синтаксисом двокрапки (`:`).
+
+    Як тип вкажемо `list`.
+
+    Оскільки список є типом, який містить деякі внутрішні типи, ви поміщаєте їх у квадратні дужки:
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial006_py39.py!}
+    ```
+
+!!! info
+    Ці внутрішні типи в квадратних дужках називаються "параметрами типу".
+
+    У цьому випадку, `str` це параметр типу переданий у `List` (або `list` у Python 3.9 і вище).
+
+Це означає: "змінна `items` це `list`, і кожен з елементів у цьому списку - `str`".
+
+!!! tip
+    Якщо ви використовуєте Python 3.9 і вище, вам не потрібно імпортувати `List` з `typing`, ви можете використовувати натомість тип `list`.
+
+Зробивши це, ваш редактор може надати підтримку навіть під час обробки елементів зі списку:
+
+<img src="/img/python-types/image05.png">
+
+Без типів цього майже неможливо досягти.
+
+Зверніть увагу, що змінна `item` є одним із елементів у списку `items`.
+
+І все ж редактор знає, що це `str`, і надає підтримку для цього.
+
+#### Tuple and Set (кортеж та набір)
+
+Ви повинні зробити те ж саме, щоб оголосити `tuple` і `set`:
+
+=== "Python 3.6 і вище"
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial007.py!}
+    ```
+
+=== "Python 3.9 і вище"
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial007_py39.py!}
+    ```
+
+Це означає:
+
+* Змінна `items_t` це `tuple` з 3 елементами, `int`, ще `int`, та `str`.
+* Змінна `items_s` це `set`, і кожен його елемент типу `bytes`.
+
+#### Dict (словник)
+
+Щоб оголосити `dict`, вам потрібно передати 2 параметри типу, розділені комами.
+
+Перший параметр типу для ключа у `dict`.
+
+Другий параметр типу для значення у `dict`:
+
+=== "Python 3.6 і вище"
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial008.py!}
+    ```
+
+=== "Python 3.9 і вище"
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial008_py39.py!}
+    ```
+
+Це означає:
+
+* Змінна `prices` це `dict`:
+    * Ключі цього `dict` типу `str` (наприклад, назва кожного елементу).
+    * Значення цього `dict` типу `float` (наприклад, ціна кожного елементу).
+
+#### Union (об'єднання)
+
+Ви можете оголосити, що змінна може бути будь-яким із **кількох типів**, наприклад, `int` або `str`.
+
+У Python 3.6 і вище (включаючи Python 3.10) ви можете використовувати тип `Union` з `typing` і вставляти в квадратні дужки можливі типи, які можна прийняти.
+
+У Python 3.10 також є **альтернативний синтаксис**, у якому ви можете розділити можливі типи за допомогою <abbr title='також називають «побітовим "або" оператором», але це значення тут не актуальне'>вертикальної смуги (`|`)</abbr>.
+
+=== "Python 3.6 і вище"
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial008b.py!}
+    ```
+
+=== "Python 3.10 і вище"
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial008b_py310.py!}
+    ```
+
+В обох випадках це означає, що `item` може бути `int` або `str`.
+
+#### Possibly `None` (Optional)
+
+Ви можете оголосити, що значення може мати тип, наприклад `str`, але також може бути `None`.
+
+У Python 3.6 і вище (включаючи Python 3.10) ви можете оголосити його, імпортувавши та використовуючи `Optional` з модуля `typing`.
+
+```Python hl_lines="1  4"
+{!../../../docs_src/python_types/tutorial009.py!}
+```
+
+Використання `Optional[str]` замість просто `str` дозволить редактору допомогти вам виявити помилки, коли ви могли б вважати, що значенням завжди є `str`, хоча насправді воно також може бути `None`.
+
+`Optional[Something]` насправді є скороченням для `Union[Something, None]`, вони еквівалентні.
+
+Це також означає, що в Python 3.10 ви можете використовувати `Something | None`:
+
+=== "Python 3.6 і вище"
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial009.py!}
+    ```
+
+=== "Python 3.6 і вище - альтернатива"
+
+    ```Python hl_lines="1  4"
+    {!> ../../../docs_src/python_types/tutorial009b.py!}
+    ```
+
+=== "Python 3.10 і вище"
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/python_types/tutorial009_py310.py!}
+    ```
+
+#### Generic типи
+
+Ці типи, які приймають параметри типу у квадратних дужках, називаються **Generic types** or **Generics**, наприклад:
+
+=== "Python 3.6 і вище"
+
+    * `List`
+    * `Tuple`
+    * `Set`
+    * `Dict`
+    * `Union`
+    * `Optional`
+    * ...та інші.
+
+=== "Python 3.9 і вище"
+
+    Ви можете використовувати ті самі вбудовані типи, як generic (з квадратними дужками та типами всередині):
+
+    * `list`
+    * `tuple`
+    * `set`
+    * `dict`
+
+    І те саме, що й у Python 3.6, із модуля `typing`:
+
+    * `Union`
+    * `Optional`
+    * ...та інші.
+
+=== "Python 3.10 і вище"
+
+    Ви можете використовувати ті самі вбудовані типи, як generic (з квадратними дужками та типами всередині):
+
+    * `list`
+    * `tuple`
+    * `set`
+    * `dict`
+
+    І те саме, що й у Python 3.6, із модуля `typing`:
+
+    * `Union`
+    * `Optional` (так само як у Python 3.6)
+    * ...та інші.
+
+    У Python 3.10, як альтернатива використанню `Union` та `Optional`, ви можете використовувати <abbr title='також називають «побітовим "або" оператором», але це значення тут не актуальне'>вертикальну смугу (`|`)</abbr> щоб оголосити об'єднання типів.
+
+### Класи як типи
+
+Ви також можете оголосити клас як тип змінної.
+
+Скажімо, у вас є клас `Person` з імʼям:
+
+```Python hl_lines="1-3"
+{!../../../docs_src/python_types/tutorial010.py!}
+```
+
+Потім ви можете оголосити змінну типу `Person`:
+
+```Python hl_lines="6"
+{!../../../docs_src/python_types/tutorial010.py!}
+```
+
+І знову ж таки, ви отримуєте всю підтримку редактора:
+
+<img src="/img/python-types/image06.png">
+
+## Pydantic моделі
+
+<a href="https://pydantic-docs.helpmanual.io/" class="external-link" target="_blank">Pydantic</a> це бібліотека Python для валідації даних.
+
+Ви оголошуєте «форму» даних як класи з атрибутами.
+
+І кожен атрибут має тип.
+
+Потім ви створюєте екземпляр цього класу з деякими значеннями, і він перевірить ці значення, перетворить їх у відповідний тип (якщо є потреба) і надасть вам об’єкт з усіма даними.
+
+І ви отримуєте всю підтримку редактора з цим отриманим об’єктом.
+
+Приклад з документації Pydantic:
+
+=== "Python 3.6 і вище"
+
+    ```Python
+    {!> ../../../docs_src/python_types/tutorial011.py!}
+    ```
+
+=== "Python 3.9 і вище"
+
+    ```Python
+    {!> ../../../docs_src/python_types/tutorial011_py39.py!}
+    ```
+
+=== "Python 3.10 і вище"
+
+    ```Python
+    {!> ../../../docs_src/python_types/tutorial011_py310.py!}
+    ```
+
+!!! info
+    Щоб дізнатись більше про <a href="https://pydantic-docs.helpmanual.io/" class="external-link" target="_blank">Pydantic, перегляньте його документацію</a>.
+
+**FastAPI** повністю базується на Pydantic.
+
+Ви побачите набагато більше цього всього на практиці в [Tutorial - User Guide](tutorial/index.md){.internal-link target=_blank}.
+
+## Анотації типів у **FastAPI**
+
+**FastAPI** використовує ці підказки для виконання кількох речей.
+
+З **FastAPI** ви оголошуєте параметри з підказками типу, і отримуєте:
+
+* **Підтримку редактора**.
+* **Перевірку типів**.
+
+...і **FastAPI** використовує ті самі оголошення для:
+
+* **Визначення вимог**: з параметрів шляху запиту, параметрів запиту, заголовків, тіл, залежностей тощо.
+* **Перетворення даних**: із запиту в необхідний тип.
+* **Перевірка даних**: що надходять від кожного запиту:
+    * Генерування **автоматичних помилок**, що повертаються клієнту, коли дані недійсні.
+* **Документування** API за допомогою OpenAPI:
+    * який потім використовується для автоматичної інтерактивної документації користувальницьких інтерфейсів.
+
+Все це може здатися абстрактним. Не хвилюйтеся. Ви побачите все це в дії в [Туторіал - Посібник користувача](tutorial/index.md){.internal-link target=_blank}.
+
+Важливо те, що за допомогою стандартних типів Python в одному місці (замість того, щоб додавати більше класів, декораторів тощо), **FastAPI** зробить багато роботи за вас.
+
+!!! info
+    Якщо ви вже пройшли весь навчальний посібник і повернулися, щоб дізнатися більше про типи, ось хороший ресурс <a href="https://mypy.readthedocs.io/en/latest/cheat_sheet_py3.html" class="external-link" target="_blank">"шпаргалка" від `mypy`</a>.

From 1866abffc1485bd09971d3c6f4a98fcfe4d96b0a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 2 Sep 2023 15:49:31 +0000
Subject: [PATCH 155/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 8af275623..44143af63 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ✏️ Fix typo in `docs/en/docs/tutorial/handling-errors.md`. PR [#10170](https://github.com/tiangolo/fastapi/pull/10170) by [@poupapaa](https://github.com/poupapaa).
 * ✏️ Fix typos in comment in `fastapi/applications.py`. PR [#10045](https://github.com/tiangolo/fastapi/pull/10045) by [@AhsanSheraz](https://github.com/AhsanSheraz).
 * ✏️ Fix typo in `docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md`. PR [#10172](https://github.com/tiangolo/fastapi/pull/10172) by [@ragul-kachiappan](https://github.com/ragul-kachiappan).
 * 🌐 Add Ukrainian translation for `docs/uk/docs/alternatives.md`. PR [#10060](https://github.com/tiangolo/fastapi/pull/10060) by [@whysage](https://github.com/whysage).

From 28bf4abf1fd81a6a930cca415604ebfa90898727 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 2 Sep 2023 15:50:11 +0000
Subject: [PATCH 156/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 44143af63..57fea97ef 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Vietnamese translations for `docs/vi/docs/tutorial/first-steps.md` and `docs/vi/docs/tutorial/index.md`. PR [#10088](https://github.com/tiangolo/fastapi/pull/10088) by [@magiskboy](https://github.com/magiskboy).
 * ✏️ Fix typo in `docs/en/docs/tutorial/handling-errors.md`. PR [#10170](https://github.com/tiangolo/fastapi/pull/10170) by [@poupapaa](https://github.com/poupapaa).
 * ✏️ Fix typos in comment in `fastapi/applications.py`. PR [#10045](https://github.com/tiangolo/fastapi/pull/10045) by [@AhsanSheraz](https://github.com/AhsanSheraz).
 * ✏️ Fix typo in `docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md`. PR [#10172](https://github.com/tiangolo/fastapi/pull/10172) by [@ragul-kachiappan](https://github.com/ragul-kachiappan).

From 7fe952f52255ebc2eef151fa9bb6c3a6f9d30909 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 2 Sep 2023 15:54:22 +0000
Subject: [PATCH 157/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 57fea97ef..7861a35ab 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Ukrainian translation for `docs/uk/docs/python-types.md`. PR [#10080](https://github.com/tiangolo/fastapi/pull/10080) by [@rostik1410](https://github.com/rostik1410).
 * 🌐 Add Vietnamese translations for `docs/vi/docs/tutorial/first-steps.md` and `docs/vi/docs/tutorial/index.md`. PR [#10088](https://github.com/tiangolo/fastapi/pull/10088) by [@magiskboy](https://github.com/magiskboy).
 * ✏️ Fix typo in `docs/en/docs/tutorial/handling-errors.md`. PR [#10170](https://github.com/tiangolo/fastapi/pull/10170) by [@poupapaa](https://github.com/poupapaa).
 * ✏️ Fix typos in comment in `fastapi/applications.py`. PR [#10045](https://github.com/tiangolo/fastapi/pull/10045) by [@AhsanSheraz](https://github.com/AhsanSheraz).

From 0ea23e2a8de9aad5c675f02f3ec54b9dd756a877 Mon Sep 17 00:00:00 2001
From: Hasnat Sajid <86589885+hasnatsajid@users.noreply.github.com>
Date: Sat, 2 Sep 2023 20:55:41 +0500
Subject: [PATCH 158/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20link=20to=20?=
 =?UTF-8?q?Pydantic=20docs=20in=20`docs/en/docs/tutorial/extra-data-types.?=
 =?UTF-8?q?md`=20(#10155)?=
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/tutorial/extra-data-types.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/docs/tutorial/extra-data-types.md b/docs/en/docs/tutorial/extra-data-types.md
index 7d6ffbc78..b34ccd26f 100644
--- a/docs/en/docs/tutorial/extra-data-types.md
+++ b/docs/en/docs/tutorial/extra-data-types.md
@@ -49,7 +49,7 @@ Here are some of the additional data types you can use:
 * `Decimal`:
     * Standard Python `Decimal`.
     * In requests and responses, handled the same as a `float`.
-* You can check all the valid pydantic data types here: <a href="https://pydantic-docs.helpmanual.io/usage/types" class="external-link" target="_blank">Pydantic data types</a>.
+* You can check all the valid pydantic data types here: <a href="https://docs.pydantic.dev/latest/usage/types/types/" class="external-link" target="_blank">Pydantic data types</a>.
 
 ## Example
 

From 0242ca756670e66aeb534054c9251176f08876bd Mon Sep 17 00:00:00 2001
From: Rahul Salgare <rsalgare95@gmail.com>
Date: Sat, 2 Sep 2023 21:26:35 +0530
Subject: [PATCH 159/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20Pydantic=20e?=
 =?UTF-8?q?xamples=20in=20tutorial=20for=20Python=20types=20(#9961)?=
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_src/python_types/tutorial011.py       | 2 +-
 docs_src/python_types/tutorial011_py310.py | 2 +-
 docs_src/python_types/tutorial011_py39.py  | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs_src/python_types/tutorial011.py b/docs_src/python_types/tutorial011.py
index c8634cbff..297a84db6 100644
--- a/docs_src/python_types/tutorial011.py
+++ b/docs_src/python_types/tutorial011.py
@@ -6,7 +6,7 @@ from pydantic import BaseModel
 
 class User(BaseModel):
     id: int
-    name = "John Doe"
+    name: str = "John Doe"
     signup_ts: Union[datetime, None] = None
     friends: List[int] = []
 
diff --git a/docs_src/python_types/tutorial011_py310.py b/docs_src/python_types/tutorial011_py310.py
index 7f173880f..842760c60 100644
--- a/docs_src/python_types/tutorial011_py310.py
+++ b/docs_src/python_types/tutorial011_py310.py
@@ -5,7 +5,7 @@ from pydantic import BaseModel
 
 class User(BaseModel):
     id: int
-    name = "John Doe"
+    name: str = "John Doe"
     signup_ts: datetime | None = None
     friends: list[int] = []
 
diff --git a/docs_src/python_types/tutorial011_py39.py b/docs_src/python_types/tutorial011_py39.py
index 468496f51..4eb40b405 100644
--- a/docs_src/python_types/tutorial011_py39.py
+++ b/docs_src/python_types/tutorial011_py39.py
@@ -6,7 +6,7 @@ from pydantic import BaseModel
 
 class User(BaseModel):
     id: int
-    name = "John Doe"
+    name: str = "John Doe"
     signup_ts: Union[datetime, None] = None
     friends: list[int] = []
 

From aa43afa4c0aeba4615d3fde9ac96abf7a1a2e08a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 2 Sep 2023 16:00:21 +0000
Subject: [PATCH 160/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 7861a35ab..c540d2426 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ✏️ Fix link to Pydantic docs in `docs/en/docs/tutorial/extra-data-types.md`. PR [#10155](https://github.com/tiangolo/fastapi/pull/10155) by [@hasnatsajid](https://github.com/hasnatsajid).
 * 🌐 Add Ukrainian translation for `docs/uk/docs/python-types.md`. PR [#10080](https://github.com/tiangolo/fastapi/pull/10080) by [@rostik1410](https://github.com/rostik1410).
 * 🌐 Add Vietnamese translations for `docs/vi/docs/tutorial/first-steps.md` and `docs/vi/docs/tutorial/index.md`. PR [#10088](https://github.com/tiangolo/fastapi/pull/10088) by [@magiskboy](https://github.com/magiskboy).
 * ✏️ Fix typo in `docs/en/docs/tutorial/handling-errors.md`. PR [#10170](https://github.com/tiangolo/fastapi/pull/10170) by [@poupapaa](https://github.com/poupapaa).

From 34028290f5386011f4638ea4e36f1619d60b9b0c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 2 Sep 2023 16:03:22 +0000
Subject: [PATCH 161/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c540d2426..622f6ddc5 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ✏️ Fix Pydantic examples in tutorial for Python types. PR [#9961](https://github.com/tiangolo/fastapi/pull/9961) by [@rahulsalgare](https://github.com/rahulsalgare).
 * ✏️ Fix link to Pydantic docs in `docs/en/docs/tutorial/extra-data-types.md`. PR [#10155](https://github.com/tiangolo/fastapi/pull/10155) by [@hasnatsajid](https://github.com/hasnatsajid).
 * 🌐 Add Ukrainian translation for `docs/uk/docs/python-types.md`. PR [#10080](https://github.com/tiangolo/fastapi/pull/10080) by [@rostik1410](https://github.com/rostik1410).
 * 🌐 Add Vietnamese translations for `docs/vi/docs/tutorial/first-steps.md` and `docs/vi/docs/tutorial/index.md`. PR [#10088](https://github.com/tiangolo/fastapi/pull/10088) by [@magiskboy](https://github.com/magiskboy).

From 1711c1e95f3eec71c9d29050c9901137117b54aa Mon Sep 17 00:00:00 2001
From: Olaoluwa Afolabi <contact@afolabiolaoluwa.com>
Date: Sat, 2 Sep 2023 17:12:44 +0100
Subject: [PATCH 162/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Yoruba=20translati?=
 =?UTF-8?q?on=20for=20`docs/yo/docs/index.md`=20(#10033)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
---
 docs/en/mkdocs.yml    |   3 +
 docs/yo/docs/index.md | 470 ++++++++++++++++++++++++++++++++++++++++++
 docs/yo/mkdocs.yml    |   1 +
 3 files changed, 474 insertions(+)
 create mode 100644 docs/yo/docs/index.md
 create mode 100644 docs/yo/mkdocs.yml

diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index c56e4c942..ba1ac7924 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -72,6 +72,7 @@ nav:
   - uk: /uk/
   - ur: /ur/
   - vi: /vi/
+  - yo: /yo/
   - zh: /zh/
 - features.md
 - fastapi-people.md
@@ -261,6 +262,8 @@ extra:
     name: ur
   - link: /vi/
     name: vi - Tiếng Việt
+  - link: /yo/
+    name: yo - Yorùbá
   - link: /zh/
     name: zh - 汉语
 extra_css:
diff --git a/docs/yo/docs/index.md b/docs/yo/docs/index.md
new file mode 100644
index 000000000..ca75a6b13
--- /dev/null
+++ b/docs/yo/docs/index.md
@@ -0,0 +1,470 @@
+<p align="center">
+  <a href="https://fastapi.tiangolo.com"><img src="https://fastapi.tiangolo.com/img/logo-margin/logo-teal.png" alt="FastAPI"></a>
+</p>
+<p align="center">
+    <em>Ìlànà wẹ́ẹ́bù FastAPI, iṣẹ́ gíga, ó rọrùn láti kọ̀, o yára láti kóòdù, ó sì ṣetán fún iṣelọpọ ní lílo</em>
+</p>
+<p align="center">
+<a href="https://github.com/tiangolo/fastapi/actions?query=workflow%3ATest+event%3Apush+branch%3Amaster" target="_blank">
+    <img src="https://github.com/tiangolo/fastapi/workflows/Test/badge.svg?event=push&branch=master" alt="Test">
+</a>
+<a href="https://coverage-badge.samuelcolvin.workers.dev/redirect/tiangolo/fastapi" target="_blank">
+    <img src="https://coverage-badge.samuelcolvin.workers.dev/tiangolo/fastapi.svg" alt="Coverage">
+</a>
+<a href="https://pypi.org/project/fastapi" target="_blank">
+    <img src="https://img.shields.io/pypi/v/fastapi?color=%2334D058&label=pypi%20package" alt="Package version">
+</a>
+<a href="https://pypi.org/project/fastapi" target="_blank">
+    <img src="https://img.shields.io/pypi/pyversions/fastapi.svg?color=%2334D058" alt="Supported Python versions">
+</a>
+</p>
+
+---
+
+**Àkọsílẹ̀**: <a href="https://fastapi.tiangolo.com" target="_blank">https://fastapi.tiangolo.com</a>
+
+**Orisun Kóòdù**: <a href="https://github.com/tiangolo/fastapi" target="_blank">https://github.com/tiangolo/fastapi</a>
+
+---
+
+FastAPI jẹ́ ìgbàlódé, tí ó yára (iṣẹ-giga), ìlànà wẹ́ẹ́bù fún kikọ àwọn API pẹ̀lú Python 3.7+ èyí tí ó da lori àwọn ìtọ́kasí àmì irúfẹ́ Python.
+
+Àwọn ẹya pàtàkì ni:
+
+* **Ó yára**: Iṣẹ tí ó ga púpọ̀, tí ó wa ni ibamu pẹ̀lú **NodeJS** àti **Go** (ọpẹ si Starlette àti Pydantic). [Ọkan nínú àwọn ìlànà Python ti o yára jùlọ ti o wa](#performance).
+* **Ó yára láti kóòdù**: O mu iyara pọ si láti kọ àwọn ẹya tuntun kóòdù nipasẹ "Igba ìdá ọgọ́rùn-ún" (i.e. 200%) si "ọ̀ọ́dúrún ìdá ọgọ́rùn-ún" (i.e. 300%).
+* **Àìtọ́ kékeré**: O n din aṣiṣe ku bi ọgbon ìdá ọgọ́rùn-ún (i.e. 40%) ti eda eniyan (oṣiṣẹ kóòdù) fa. *
+* **Ọgbọ́n àti ìmọ̀**: Atilẹyin olootu nla. <abbr title="a tun le pe ni olùrànlọ́wọ́ alaifiọwọkan alaifọwọyi, olùpari iṣẹ-ṣiṣe, Oloye">Ìparí</abbr> nibi gbogbo. Àkókò díẹ̀ nipa wíwá ibi tí ìṣòro kóòdù wà.
+* **Irọrun**: A kọ kí ó le rọrun láti lo àti láti kọ ẹkọ nínú rè. Ó máa fún ọ ní àkókò díẹ̀ látı ka àkọsílẹ.
+* **Ó kúkurú ní kikọ**: Ó dín àtúnkọ àti àtúntò kóòdù kù. Ìkéde àṣàyàn kọ̀ọ̀kan nínú rẹ̀ ní ọ̀pọ̀lọpọ̀ àwọn ìlò. O ṣe iranlọwọ láti má ṣe ní ọ̀pọ̀lọpọ̀ àṣìṣe.
+* **Ó lágbára**: Ó ń ṣe àgbéjáde kóòdù tí ó ṣetán fún ìṣelọ́pọ̀. Pẹ̀lú àkọsílẹ̀ tí ó máa ṣàlàyé ara rẹ̀ fún ẹ ní ìbáṣepọ̀ aládàáṣiṣẹ́ pẹ̀lú rè.
+* **Ajohunše/Ìtọ́kasí**: Ó da lori (àti ibamu ni kikun pẹ̀lú) àwọn ìmọ ajohunše/ìtọ́kasí fún àwọn API: <a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank">OpenAPI</a> (èyí tí a mọ tẹlẹ si Swagger) àti <a href="https://json-schema.org/" class="external-link" target="_blank">JSON Schema</a>.
+
+<small>* iṣiro yi da lori àwọn idanwo tí ẹgbẹ ìdàgbàsókè FastAPI ṣe, nígbàtí wọn kọ àwọn ohun elo iṣelọpọ kóòdù pẹ̀lú rẹ.</small>
+
+## Àwọn onígbọ̀wọ́
+
+<!-- sponsors -->
+
+{% if sponsors %}
+{% for sponsor in sponsors.gold -%}
+<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a>
+{% endfor -%}
+{%- for sponsor in sponsors.silver -%}
+<a href="{{ sponsor.url }}" target="_blank" title="{{ sponsor.title }}"><img src="{{ sponsor.img }}" style="border-radius:15px"></a>
+{% endfor %}
+{% endif %}
+
+<!-- /sponsors -->
+
+<a href="https://fastapi.tiangolo.com/fastapi-people/#sponsors" class="external-link" target="_blank">Àwọn onígbọ̀wọ́ míràn</a>
+
+## Àwọn ero àti èsì
+
+"_[...] Mò ń lo **FastAPI** púpọ̀ ní lẹ́nu àìpẹ́ yìí. [...] Mo n gbero láti lo o pẹ̀lú àwọn ẹgbẹ mi fún gbogbo iṣẹ **ML wa ni Microsoft**. Diẹ nínú wọn ni afikun ti ifilelẹ àwọn ẹya ara ti ọja **Windows** wa pẹ̀lú àwọn ti **Office**._"
+
+<div style="text-align: right; margin-right: 10%;">Kabir Khan - <strong>Microsoft</strong> <a href="https://github.com/tiangolo/fastapi/pull/26" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_A gba àwọn ohun èlò ìwé afọwọkọ **FastAPI** tí kò yí padà láti ṣẹ̀dá olùpín **REST** tí a lè béèrè lọ́wọ́ rẹ̀ láti gba **àsọtẹ́lẹ̀**. [fún Ludwig]_"
+
+<div style="text-align: right; margin-right: 10%;">Piero Molino, Yaroslav Dudin, and Sai Sumanth Miryala - <strong>Uber</strong> <a href="https://eng.uber.com/ludwig-v0-2/" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_**Netflix** ni inudidun láti kede itusilẹ orisun kóòdù ti ìlànà iṣọkan **iṣakoso Ìṣòro** wa: **Ìfiránṣẹ́**! [a kọ pẹ̀lú **FastAPI**]_"
+
+<div style="text-align: right; margin-right: 10%;">Kevin Glisson, Marc Vilanova, Forest Monsen - <strong>Netflix</strong> <a href="https://netflixtechblog.com/introducing-dispatch-da4b8a2a8072" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Inú mi dùn púpọ̀ nípa **FastAPI**. Ó mú inú ẹnì dùn púpọ̀!_"
+
+<div style="text-align: right; margin-right: 10%;">Brian Okken - <strong><a href="https://pythonbytes.fm/episodes/show/123/time-to-right-the-py-wrongs?time_in_sec=855" target="_blank">Python Bytes</a> podcast host</strong> <a href="https://twitter.com/brianokken/status/1112220079972728832" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Ní tòótọ́, ohun tí o kọ dára ó sì tún dán. Ní ọ̀pọ̀lọpọ̀ ọ̀nà, ohun tí mo fẹ́ kí **Hug** jẹ́ nìyẹn - ó wúni lórí gan-an láti rí ẹnìkan tí ó kọ́ nǹkan bí èyí._"
+
+<div style="text-align: right; margin-right: 10%;">Timothy Crosley - <strong><a href="https://www.hug.rest/" target="_blank">Hug</a> creator</strong> <a href="https://news.ycombinator.com/item?id=19455465" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Ti o ba n wa láti kọ ọkan **ìlànà igbalode** fún kikọ àwọn REST API, ṣayẹwo **FastAPI** [...] Ó yára, ó rọrùn láti lò, ó sì rọrùn láti kọ́[...]_"
+
+"_A ti yipada si **FastAPI** fún **APIs** wa [...] Mo lérò pé wà á fẹ́ràn rẹ̀ [...]_"
+
+<div style="text-align: right; margin-right: 10%;">Ines Montani - Matthew Honnibal - <strong><a href="https://explosion.ai" target="_blank">Explosion AI</a> founders - <a href="https://spacy.io" target="_blank">spaCy</a> creators</strong> <a href="https://twitter.com/_inesmontani/status/1144173225322143744" target="_blank"><small>(ref)</small></a> - <a href="https://twitter.com/honnibal/status/1144031421859655680" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+"_Ti ẹnikẹni ba n wa láti kọ iṣelọpọ API pẹ̀lú Python, èmi yóò ṣe'dúró fún **FastAPI**. Ó jẹ́ ohun tí **àgbékalẹ̀ rẹ̀ lẹ́wà**, **ó rọrùn láti lò** àti wipe ó ni **ìwọ̀n gíga**, o tí dí **bọtini paati** nínú alakọkọ API ìdàgbàsókè kikọ fún wa, àti pe o ni ipa lori adaṣiṣẹ àti àwọn iṣẹ gẹ́gẹ́ bíi Onímọ̀-ẹ̀rọ TAC tí órí Íńtánẹ́ẹ̀tì_"
+
+<div style="text-align: right; margin-right: 10%;">Deon Pillsbury - <strong>Cisco</strong> <a href="https://www.linkedin.com/posts/deonpillsbury_cisco-cx-python-activity-6963242628536487936-trAp/" target="_blank"><small>(ref)</small></a></div>
+
+---
+
+## **Typer**, FastAPI ti CLIs
+
+<a href="https://typer.tiangolo.com" target="_blank"><img src="https://typer.tiangolo.com/img/logo-margin/logo-margin-vector.svg" style="width: 20%;"></a>
+
+Ti o ba n kọ ohun èlò <abbr title="Command Line Interface">CLI</abbr> láti ṣeé lọ nínú ohun èlò lori ebute kọmputa dipo API, ṣayẹwo <a href="https://typer.tiangolo.com/" class="external-link" target="_blank">**Typer**</a>.
+
+**Typer** jẹ́ àbúrò ìyá FastAPI kékeré. Àti pé wọ́n kọ́ láti jẹ́ **FastAPI ti CLIs**. ⌨️ 🚀
+
+## Èròjà
+
+Python 3.7+
+
+FastAPI dúró lórí àwọn èjìká tí àwọn òmíràn:
+
+* <a href="https://www.starlette.io/" class="external-link" target="_blank">Starlette</a> fún àwọn ẹ̀yà ayélujára.
+* <a href="https://pydantic-docs.helpmanual.io/" class="external-link" target="_blank">Pydantic</a> fún àwọn ẹ̀yà àkójọf'áyẹ̀wò.
+
+## Fifi sórí ẹrọ
+
+<div class="termy">
+
+```console
+$ pip install fastapi
+
+---> 100%
+```
+
+</div>
+Iwọ yóò tún nílò olupin ASGI, fún iṣelọpọ bii <a href="https://www.uvicorn.org" class="external-link" target="_blank">Uvicorn</a> tabi <a href="https://github.com/pgjones/hypercorn" class="external-link" target="_blank">Hypercorn</a>.
+
+<div class="termy">
+
+```console
+$ pip install "uvicorn[standard]"
+
+---> 100%
+```
+
+</div>
+
+## Àpẹẹrẹ
+
+### Ṣẹ̀dá rẹ̀
+
+* Ṣẹ̀dá fáìlì `main.py (èyí tíí ṣe, akọkọ.py)` pẹ̀lú:
+
+```Python
+from typing import Union
+
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+def read_root():
+    return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+def read_item(item_id: int, q: Union[str, None] = None):
+    return {"item_id": item_id, "q": q}
+```
+
+<details markdown="1">
+<summary>Tàbí lò <code>async def</code>...</summary>
+
+Tí kóòdù rẹ̀ bá ń lò `async` / `await`, lò `async def`:
+
+```Python hl_lines="9  14"
+from typing import Union
+
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/")
+async def read_root():
+    return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+async def read_item(item_id: int, q: Union[str, None] = None):
+    return {"item_id": item_id, "q": q}
+```
+
+**Akiyesi**:
+
+Tí o kò bá mọ̀, ṣàyẹ̀wò ibi tí a ti ní _"In a hurry?"_ (i.e. _"Ní kíákíá?"_) nípa <a href="https://fastapi.tiangolo.com/async/#in-a-hurry" target="_blank">`async` and `await` nínú àkọsílẹ̀</a>.
+
+</details>
+
+### Mu ṣiṣẹ
+
+Mú olupin ṣiṣẹ pẹ̀lú:
+
+<div class="termy">
+
+```console
+$ uvicorn main:app --reload
+
+INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+INFO:     Started reloader process [28720]
+INFO:     Started server process [28722]
+INFO:     Waiting for application startup.
+INFO:     Application startup complete.
+```
+
+</div>
+
+<details markdown="1">
+<summary>Nipa aṣẹ kóòdù náà <code>uvicorn main:app --reload</code>...</summary>
+
+Àṣẹ `uvicorn main:app` ń tọ́ka sí:
+
+* `main`: fáìlì náà 'main.py' (Python "module").
+* `app` jẹ object( i.e. nǹkan) tí a ṣẹ̀dá nínú `main.py` pẹ̀lú ilà `app = FastAPI()`.
+* `--reload`: èyí yóò jẹ́ ki olupin tún bẹ̀rẹ̀ lẹ́hìn àwọn àyípadà kóòdù. Jọ̀wọ́, ṣe èyí fún ìdàgbàsókè kóòdù nìkan, má ṣe é ṣe lori àgbéjáde kóòdù tabi fún iṣelọpọ kóòdù.
+
+
+</details>
+
+### Ṣayẹwo rẹ
+
+Ṣii aṣàwákiri kọ̀ǹpútà rẹ ni <a href="http://127.0.0.1:8000/items/5?q=somequery" class="external-link" target="_blank">http://127.0.0.1:8000/items/5?q=somequery</a>.
+
+Ìwọ yóò sì rí ìdáhùn JSON bíi:
+
+```JSON
+{"item_id": 5, "q": "somequery"}
+```
+
+O tí ṣẹ̀dá API èyí tí yóò:
+
+* Gbà àwọn ìbéèrè HTTP ni àwọn _ipa ọ̀nà_ `/` àti `/items/{item_id}`.
+* Èyí tí àwọn _ipa ọ̀nà_ (i.e. _paths_) méjèèjì gbà àwọn <em>iṣẹ</em> `GET` (a tun mọ si _àwọn ọna_ HTTP).
+* Èyí tí _ipa ọ̀nà_  (i.e. _paths_) `/items/{item_id}` ní _àwọn ohun-ini ipa ọ̀nà_ tí ó yẹ kí ó jẹ́ `int` i.e. `ÒǸKÀ`.
+* Èyí tí _ipa ọ̀nà_  (i.e. _paths_) `/items/{item_id}` ní àṣàyàn `str` _àwọn ohun-ini_ (i.e. _query parameter_) `q`.
+
+### Ìbáṣepọ̀ àkọsílẹ̀ API
+
+Ní báyìí, lọ sí <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>.
+
+Lẹ́yìn náà, iwọ yóò rí ìdáhùn àkọsílẹ̀ API tí ó jẹ́ ìbáṣepọ̀ alaifọwọyi/aládàáṣiṣẹ́ (tí a pèṣè nípaṣẹ̀ <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Swagger UI</a>):
+
+![Swagger UI](https://fastapi.tiangolo.com/img/index/index-01-swagger-ui-simple.png)
+
+### Ìdàkejì àkọsílẹ̀ API
+
+Ní báyìí, lọ sí <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a>.
+
+Wà á rí àwọn àkọsílẹ̀ aládàáṣiṣẹ́ mìíràn (tí a pese nipasẹ <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a>):
+
+![ReDoc](https://fastapi.tiangolo.com/img/index/index-02-redoc-simple.png)
+
+## Àpẹẹrẹ ìgbésókè mìíràn
+
+Ní báyìí ṣe àtúnṣe fáìlì `main.py` láti gba kókó èsì láti inú ìbéèrè `PUT`.
+
+Ní báyìí, ṣe ìkéde kókó èsì API nínú kóòdù rẹ nipa lílo àwọn ìtọ́kasí àmì irúfẹ́ Python, ọpẹ́ pàtàkìsi sí Pydantic.
+
+```Python hl_lines="4  9-12  25-27"
+from typing import Union
+
+from fastapi import FastAPI
+from pydantic import BaseModel
+
+app = FastAPI()
+
+
+class Item(BaseModel):
+    name: str
+    price: float
+    is_offer: Union[bool, None] = None
+
+
+@app.get("/")
+def read_root():
+    return {"Hello": "World"}
+
+
+@app.get("/items/{item_id}")
+def read_item(item_id: int, q: Union[str, None] = None):
+    return {"item_id": item_id, "q": q}
+
+
+@app.put("/items/{item_id}")
+def update_item(item_id: int, item: Item):
+    return {"item_name": item.name, "item_id": item_id}
+```
+
+Olupin yóò tún ṣe àtúnṣe laifọwọyi/aládàáṣiṣẹ́ (nítorí wípé ó se àfikún `-reload` si àṣẹ kóòdù `uvicorn` lókè).
+
+### Ìbáṣepọ̀ ìgbésókè àkọsílẹ̀ API
+
+Ní báyìí, lọ sí <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>.
+
+* Ìbáṣepọ̀ àkọsílẹ̀ API yóò ṣe imudojuiwọn àkọsílẹ̀ API laifọwọyi, pẹ̀lú kókó èsì ìdáhùn API tuntun:
+
+![Swagger UI](https://fastapi.tiangolo.com/img/index/index-03-swagger-02.png)
+
+* Tẹ bọtini "Gbiyanju rẹ" i.e. "Try it out", yóò gbà ọ́ láàyè láti jẹ́ kí ó tẹ́ àlàyé tí ó nílò kí ó le sọ̀rọ̀ tààrà pẹ̀lú API:
+
+![Swagger UI interaction](https://fastapi.tiangolo.com/img/index/index-04-swagger-03.png)
+
+* Lẹhinna tẹ bọtini "Ṣiṣe" i.e. "Execute", olùmúlò (i.e. user interface) yóò sọrọ pẹ̀lú API rẹ, yóò ṣe afiranṣẹ àwọn èròjà, pàápàá jùlọ yóò gba àwọn àbájáde yóò si ṣafihan wọn loju ìbòjú:
+
+![Swagger UI interaction](https://fastapi.tiangolo.com/img/index/index-05-swagger-04.png)
+
+### Ìdàkejì ìgbésókè àkọsílẹ̀ API
+
+Ní báyìí, lọ sí <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a>.
+
+* Ìdàkejì àkọsílẹ̀ API yóò ṣ'afihan ìbéèrè èròjà/pàrámítà tuntun àti kókó èsì ti API:
+
+![ReDoc](https://fastapi.tiangolo.com/img/index/index-06-redoc-02.png)
+
+### Àtúnyẹ̀wò
+
+Ni akopọ, ìwọ yóò kéde ni **kete** àwọn iru èròjà/pàrámítà, kókó èsì API, abbl (i.e. àti bẹbẹ lọ), bi àwọn èròjà iṣẹ.
+
+O ṣe ìyẹn pẹ̀lú irúfẹ́ àmì ìtọ́kasí ìgbàlódé Python.
+
+O ò nílò láti kọ́ síńtáàsì tuntun, ìlànà tàbí ọ̀wọ́ kíláàsì kan pàtó, abbl (i.e. àti bẹbẹ lọ).
+
+Ìtọ́kasí **Python 3.7+**
+
+Fún àpẹẹrẹ, fún `int`:
+
+```Python
+item_id: int
+```
+
+tàbí fún àwòṣe `Item` tí ó nira díẹ̀ síi:
+
+```Python
+item: Item
+```
+
+... àti pẹ̀lú ìkéde kan ṣoṣo yẹn ìwọ yóò gbà:
+
+* Atilẹyin olootu, pẹ̀lú:
+    * Pipari.
+    * Àyẹ̀wò irúfẹ́ àmì ìtọ́kasí.
+* Ìfọwọ́sí àkójọf'áyẹ̀wò (i.e. data):
+    * Aṣiṣe alaifọwọyi/aládàáṣiṣẹ́ àti aṣiṣe ti ó hàn kedere nígbàtí àwọn àkójọf'áyẹ̀wò (i.e. data) kò wulo tabi tí kò fẹsẹ̀ múlẹ̀.
+    * Ìfọwọ́sí fún ohun elo JSON tí ó jìn gan-an.
+* <abbr title="also known as: serialization, parsing, marshalling">Ìyípadà</abbr> tí input àkójọf'áyẹ̀wò: tí ó wà láti nẹtiwọọki si àkójọf'áyẹ̀wò àti irúfẹ́ àmì ìtọ́kasí Python. Ó ń ka láti:
+    * JSON.
+    * èròjà ọ̀nà tí ò gbé gbà.
+    * èròjà ìbéèrè.
+    * Àwọn Kúkì
+    * Àwọn Àkọlé
+    * Àwọn Fọọmu
+    * Àwọn Fáìlì
+* <abbr title="a tún má ń pè ni: serialization, parsing, marshalling">Ìyípadà</abbr> èsì àkójọf'áyẹ̀wò: yíyípadà láti àkójọf'áyẹ̀wò àti irúfẹ́ àmì ìtọ́kasí Python si nẹtiwọọki (gẹ́gẹ́ bí JSON):
+    * Yí irúfẹ́ àmì ìtọ́kasí padà (`str`, `int`, `float`, `bool`, `list`, abbl i.e. àti bèbè ló).
+    * Àwọn ohun èlò `datetime`.
+    * Àwọn ohun èlò `UUID`.
+    * Àwọn awoṣẹ́ ibi ìpamọ́ àkójọf'áyẹ̀wò.
+    * ...àti ọ̀pọ̀lọpọ̀ díẹ̀ síi.
+* Ìbáṣepọ̀ àkọsílẹ̀ API aládàáṣiṣẹ́, pẹ̀lú ìdàkejì àgbékalẹ̀-àwọn-olùmúlò (i.e user interfaces) méjì:
+    * Àgbékalẹ̀-olùmúlò Swagger.
+    * ReDoc.
+
+---
+
+Nisinsin yi, tí ó padà sí àpẹẹrẹ ti tẹ́lẹ̀, **FastAPI** yóò:
+
+* Fọwọ́ sí i pé `item_id` wà nínú ọ̀nà ìbéèrè HTTP fún `GET` àti `PUT`.
+* Fọwọ́ sí i pé `item_id` jẹ́ irúfẹ́ àmì ìtọ́kasí `int` fún ìbéèrè HTTP `GET` àti `PUT`.
+    * Tí kìí bá ṣe bẹ, oníbàárà yóò ríi àṣìṣe tí ó wúlò, kedere.
+* Ṣàyẹ̀wò bóyá ìbéèrè àṣàyàn pàrámítà kan wà tí orúkọ rẹ̀ ń jẹ́ `q` (gẹ́gẹ́ bíi `http://127.0.0.1:8000/items/foo?q=somequery`) fún ìbéèrè HTTP `GET`.
+    * Bí wọ́n ṣe kéde pàrámítà `q` pẹ̀lú `= None`, ó jẹ́ àṣàyàn (i.e optional).
+    * Láìsí `None` yóò nílò (gẹ́gẹ́ bí kókó èsì ìbéèrè HTTP ṣe wà pẹ̀lú `PUT`).
+* Fún àwọn ìbéèrè HTTP `PUT` sí `/items/{item_id}`, kà kókó èsì ìbéèrè HTTP gẹ́gẹ́ bí JSON:
+    * Ṣàyẹ̀wò pé ó ní àbùdá tí ó nílò èyí tíí ṣe `name` i.e. `orúkọ` tí ó yẹ kí ó jẹ́ `str`.
+    * Ṣàyẹ̀wò pé ó ní àbùdá tí ó nílò èyí tíí ṣe `price` i.e. `iye` tí ó gbọ́dọ̀ jẹ́ `float`.
+    * Ṣàyẹ̀wò pé ó ní àbùdá àṣàyàn `is_offer`, tí ó yẹ kí ó jẹ́ `bool`, tí ó bá wà níbẹ̀.
+    * Gbogbo èyí yóò tún ṣiṣẹ́ fún àwọn ohun èlò JSON tí ó jìn gidi gan-an.
+* Yìí padà láti àti sí JSON lai fi ọwọ́ yi.
+* Ṣe àkọsílẹ̀ ohun gbogbo pẹ̀lú OpenAPI, èyí tí yóò wà ní lílo nípaṣẹ̀:
+    * Àwọn ètò àkọsílẹ̀ ìbáṣepọ̀.
+    * Aládàáṣiṣẹ́ oníbárà èlètò tíí ṣẹ̀dá kóòdù, fún ọ̀pọ̀lọpọ̀ àwọn èdè.
+* Pese àkọsílẹ̀ òní ìbáṣepọ̀ ti àwọn àgbékalẹ̀ ayélujára méjì tààrà.
+
+---
+
+A ń ṣẹ̀ṣẹ̀ ń mú ẹyẹ bọ́ làpò ní, ṣùgbọ́n ó ti ni òye bí gbogbo rẹ̀ ṣe ń ṣiṣẹ́.
+
+Gbiyanju láti yí ìlà padà pẹ̀lú:
+
+```Python
+    return {"item_name": item.name, "item_id": item_id}
+```
+
+...láti:
+
+```Python
+        ... "item_name": item.name ...
+```
+
+...ṣí:
+
+```Python
+        ... "item_price": item.price ...
+```
+
+.. kí o sì wo bí olóòtú rẹ yóò ṣe parí àwọn àbùdá náà fúnra rẹ̀, yóò sì mọ irúfẹ́ wọn:
+
+![editor support](https://fastapi.tiangolo.com/img/vscode-completion.png)
+
+Fún àpẹẹrẹ pípé síi pẹ̀lú àwọn àbùdá mìíràn, wo <a href="https://fastapi.tiangolo.com/tutorial/">Ìdánilẹ́kọ̀ọ́ - Ìtọ́sọ́nà Olùmúlò</a>.
+
+**Itaniji gẹ́gẹ́ bí isọ'ye**: ìdánilẹ́kọ̀ọ́ - itọsọna olùmúlò pẹ̀lú:
+
+* Ìkéde àṣàyàn **pàrámítà** láti àwọn oriṣiriṣi ibòmíràn gẹ́gẹ́ bíi: àwọn **àkọlé èsì API**, **kúkì**, **ààyè fọọmu**, àti **fáìlì**.
+* Bíi ó ṣe lé ṣètò **àwọn ìdíwọ́ ìfọwọ́sí** bí `maximum_length` tàbí `regex`.
+* Ó lágbára púpọ̀ ó sì rọrùn láti lo ètò **<abbr title="a tún mọ̀ sí ìrìnṣẹ́, àwọn ohun àmúlò iṣẹ́, olupese, àwọn ohun àfikún ">Àfikún Ìgbẹ́kẹ̀lé Kóòdù</abbr>**.
+* Ààbò àti ìfọwọ́sowọ́pọ̀, pẹ̀lú àtìlẹ́yìn fún **OAuth2** pẹ̀lú **àmì JWT** àti **HTTP Ipilẹ ìfọwọ́sowọ́pọ̀**.
+* Àwọn ìlànà ìlọsíwájú (ṣùgbọ́n tí ó rọrùn bákan náà) fún ìkéde **àwọn àwòṣe JSON tó jinlẹ̀** (ọpẹ́ pàtàkìsi sí Pydantic).
+* Iṣọpọ **GraphQL** pẹ̀lú <a href="https://strawberry.rocks" class="external-link" target="_blank">Strawberry</a> àti àwọn ohun èlò ìwé kóòdù afọwọkọ mìíràn tí kò yí padà.
+* Ọpọlọpọ àwọn àfikún àwọn ẹ̀yà (ọpẹ́ pàtàkìsi sí Starlette) bí:
+    * **WebSockets**
+    * àwọn ìdánwò tí ó rọrùn púpọ̀ lórí HTTPX àti `pytest`
+    * **CORS**
+    * **Cookie Sessions**
+    * ...àti síwájú síi.
+
+## Ìṣesí
+
+Àwọn àlá TechEmpower fi hàn pé **FastAPI** ń ṣiṣẹ́ lábẹ́ Uvicorn gẹ́gẹ́ bí <a href="https://www.techempower.com/benchmarks/#section=test&runid=7464e520-0dc2-473d-bd34-dbdfd7e85911&hw=ph&test=query&l=zijzen-7" class="external-link" target="_blank">ọ̀kan lára àwọn ìlànà Python tí ó yára jùlọ tí ó wà</a>, ní ìsàlẹ̀ Starlette àti Uvicorn fúnra wọn (tí FastAPI ń lò fúnra rẹ̀). (*)
+
+Láti ní òye síi nípa rẹ̀, wo abala àwọn <a href="https://fastapi.tiangolo.com/benchmarks/" class="internal-link" target="_blank">Àlá</a>.
+
+## Àṣàyàn Àwọn Àfikún Ìgbẹ́kẹ̀lé Kóòdù
+
+Èyí tí Pydantic ń lò:
+
+* <a href="https://github.com/JoshData/python-email-validator" target="_blank"><code>email_validator</code></a> - fún ifọwọsi ímeèlì.
+* <a href="https://docs.pydantic.dev/latest/usage/pydantic_settings/" target="_blank"><code>pydantic-settings</code></a> - fún ètò ìsàkóso.
+* <a href="https://docs.pydantic.dev/latest/usage/types/extra_types/extra_types/" target="_blank"><code>pydantic-extra-types</code></a> - fún àfikún oríṣi láti lọ pẹ̀lú Pydantic.
+
+Èyí tí Starlette ń lò:
+
+* <a href="https://www.python-httpx.org" target="_blank"><code>httpx</code></a> - Nílò tí ó bá fẹ́ láti lọ `TestClient`.
+* <a href="https://jinja.palletsprojects.com" target="_blank"><code>jinja2</code></a> - Nílò tí ó bá fẹ́ láti lọ iṣeto awoṣe aiyipada.
+* <a href="https://andrew-d.github.io/python-multipart/" target="_blank"><code>python-multipart</code></a> - Nílò tí ó bá fẹ́ láti ṣe àtìlẹ́yìn fún <abbr title="tí ó se ìyípadà ọ̀rọ̀-ìyọ̀/òkun-ọ̀rọ̀ tí ó wà láti ìbéèrè HTTP sí inú àkójọf'áyẹ̀wò Python">"àyẹ̀wò"</abbr> fọọmu, pẹ̀lú `request.form()`.
+* <a href="https://pythonhosted.org/itsdangerous/" target="_blank"><code>itsdangerous</code></a> - Nílò fún àtìlẹ́yìn `SessionMiddleware`.
+* <a href="https://pyyaml.org/wiki/PyYAMLDocumentation" target="_blank"><code>pyyaml</code></a> - Nílò fún àtìlẹ́yìn Starlette's `SchemaGenerator` (ó ṣe ṣe kí ó má nílò rẹ̀ fún FastAPI).
+* <a href="https://github.com/esnme/ultrajson" target="_blank"><code>ujson</code></a> - Nílò tí ó bá fẹ́ láti lọ `UJSONResponse`.
+
+Èyí tí FastAPI / Starlette ń lò:
+
+* <a href="https://www.uvicorn.org" target="_blank"><code>uvicorn</code></a> - Fún olupin tí yóò sẹ́ àmúyẹ àti tí yóò ṣe ìpèsè fún iṣẹ́ rẹ tàbí ohun èlò rẹ.
+* <a href="https://github.com/ijl/orjson" target="_blank"><code>orjson</code></a> - Nílò tí ó bá fẹ́ láti lọ `ORJSONResponse`.
+
+Ó lè fi gbogbo àwọn wọ̀nyí sórí ẹrọ pẹ̀lú `pip install "fastapi[all]"`.
+
+## Iwe-aṣẹ
+
+Iṣẹ́ yìí ni iwe-aṣẹ lábẹ́ àwọn òfin tí iwe-aṣẹ MIT.
diff --git a/docs/yo/mkdocs.yml b/docs/yo/mkdocs.yml
new file mode 100644
index 000000000..de18856f4
--- /dev/null
+++ b/docs/yo/mkdocs.yml
@@ -0,0 +1 @@
+INHERIT: ../en/mkdocs.yml

From a6d893fe981f270be660c3e8bceab888d38786c5 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 2 Sep 2023 16:16:38 +0000
Subject: [PATCH 163/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 622f6ddc5..21b3be50e 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Yoruba translation for `docs/yo/docs/index.md`. PR [#10033](https://github.com/tiangolo/fastapi/pull/10033) by [@AfolabiOlaoluwa](https://github.com/AfolabiOlaoluwa).
 * ✏️ Fix Pydantic examples in tutorial for Python types. PR [#9961](https://github.com/tiangolo/fastapi/pull/9961) by [@rahulsalgare](https://github.com/rahulsalgare).
 * ✏️ Fix link to Pydantic docs in `docs/en/docs/tutorial/extra-data-types.md`. PR [#10155](https://github.com/tiangolo/fastapi/pull/10155) by [@hasnatsajid](https://github.com/hasnatsajid).
 * 🌐 Add Ukrainian translation for `docs/uk/docs/python-types.md`. PR [#10080](https://github.com/tiangolo/fastapi/pull/10080) by [@rostik1410](https://github.com/rostik1410).

From caf0b688cd7e71da0a207ab5d611a57ce4ac5f13 Mon Sep 17 00:00:00 2001
From: Yusuke Tamura <62091034+tamtam-fitness@users.noreply.github.com>
Date: Sun, 3 Sep 2023 01:55:26 +0900
Subject: [PATCH 164/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20indent=20for?=
 =?UTF-8?q?mat=20in=20`docs/en/docs/deployment/server-workers.md`=20(#1006?=
 =?UTF-8?q?6)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
 docs/en/docs/deployment/server-workers.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/en/docs/deployment/server-workers.md b/docs/en/docs/deployment/server-workers.md
index 4ccd9d9f6..2df9f3d43 100644
--- a/docs/en/docs/deployment/server-workers.md
+++ b/docs/en/docs/deployment/server-workers.md
@@ -90,7 +90,9 @@ Let's see what each of those options mean:
         ```
 
     * So, the colon in `main:app` would be equivalent to the Python `import` part in `from main import app`.
+
 * `--workers`: The number of worker processes to use, each will run a Uvicorn worker, in this case, 4 workers.
+
 * `--worker-class`: The Gunicorn-compatible worker class to use in the worker processes.
     * Here we pass the class that Gunicorn can import and use with:
 

From 7802454131866a1af7b509702fb6de369f33c71d Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 2 Sep 2023 16:56:04 +0000
Subject: [PATCH 165/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 21b3be50e..624fc736b 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ✏️ Fix indent format in `docs/en/docs/deployment/server-workers.md`. PR [#10066](https://github.com/tiangolo/fastapi/pull/10066) by [@tamtam-fitness](https://github.com/tamtam-fitness).
 * 🌐 Add Yoruba translation for `docs/yo/docs/index.md`. PR [#10033](https://github.com/tiangolo/fastapi/pull/10033) by [@AfolabiOlaoluwa](https://github.com/AfolabiOlaoluwa).
 * ✏️ Fix Pydantic examples in tutorial for Python types. PR [#9961](https://github.com/tiangolo/fastapi/pull/9961) by [@rahulsalgare](https://github.com/rahulsalgare).
 * ✏️ Fix link to Pydantic docs in `docs/en/docs/tutorial/extra-data-types.md`. PR [#10155](https://github.com/tiangolo/fastapi/pull/10155) by [@hasnatsajid](https://github.com/hasnatsajid).

From 23511f1fdf5de1b47575c6d1e305c17a3851fbae Mon Sep 17 00:00:00 2001
From: Alex Rocha <62669972+LecoOliveira@users.noreply.github.com>
Date: Sat, 2 Sep 2023 14:01:06 -0300
Subject: [PATCH 166/317] =?UTF-8?q?=F0=9F=8C=90=20Remove=20duplicate=20lin?=
 =?UTF-8?q?e=20in=20translation=20for=20`docs/pt/docs/tutorial/path-params?=
 =?UTF-8?q?.md`=20(#10126)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/pt/docs/tutorial/path-params.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/pt/docs/tutorial/path-params.md b/docs/pt/docs/tutorial/path-params.md
index 5de3756ed..cd8c18858 100644
--- a/docs/pt/docs/tutorial/path-params.md
+++ b/docs/pt/docs/tutorial/path-params.md
@@ -236,7 +236,6 @@ Então, você poderia usar ele com:
 Com o **FastAPI**, usando as declarações de tipo do Python, você obtém:
 
 * Suporte no editor: verificação de erros, e opção de autocompletar, etc.
-* Parsing de dados
 * "<abbr title="convertendo uma string que vem de um request HTTP em dado Python">Parsing</abbr>" de dados
 * Validação de dados
 * Anotação da API e documentação automática

From 7f1dedac2c8f57aa1e976aaa492f5cbd77d25ab1 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 2 Sep 2023 17:01:44 +0000
Subject: [PATCH 167/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 624fc736b..54a00d9ed 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Remove duplicate line in translation for `docs/pt/docs/tutorial/path-params.md`. PR [#10126](https://github.com/tiangolo/fastapi/pull/10126) by [@LecoOliveira](https://github.com/LecoOliveira).
 * ✏️ Fix indent format in `docs/en/docs/deployment/server-workers.md`. PR [#10066](https://github.com/tiangolo/fastapi/pull/10066) by [@tamtam-fitness](https://github.com/tamtam-fitness).
 * 🌐 Add Yoruba translation for `docs/yo/docs/index.md`. PR [#10033](https://github.com/tiangolo/fastapi/pull/10033) by [@AfolabiOlaoluwa](https://github.com/AfolabiOlaoluwa).
 * ✏️ Fix Pydantic examples in tutorial for Python types. PR [#9961](https://github.com/tiangolo/fastapi/pull/9961) by [@rahulsalgare](https://github.com/rahulsalgare).

From c502197d7cffc6fe3f310fc2a72dd3148bcaa016 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pablo=20Dorr=C3=ADo=20V=C3=A1zquez?=
 <64154120+pablodorrio@users.noreply.github.com>
Date: Sat, 2 Sep 2023 19:02:26 +0200
Subject: [PATCH 168/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20validation?=
 =?UTF-8?q?=20parameter=20name=20in=20docs,=20from=20`regex`=20to=20`patte?=
 =?UTF-8?q?rn`=20(#10085)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/tutorial/query-params-str-validations.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/docs/tutorial/query-params-str-validations.md b/docs/en/docs/tutorial/query-params-str-validations.md
index f87adddcb..5d1c08add 100644
--- a/docs/en/docs/tutorial/query-params-str-validations.md
+++ b/docs/en/docs/tutorial/query-params-str-validations.md
@@ -932,7 +932,7 @@ Validations specific for strings:
 
 * `min_length`
 * `max_length`
-* `regex`
+* `pattern`
 
 In these examples you saw how to declare validations for `str` values.
 

From e1a1a367a74a64c330e11fb63a870a2c77a29a85 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 2 Sep 2023 19:03:43 +0200
Subject: [PATCH 169/317] =?UTF-8?q?=F0=9F=93=8C=20Pin=20AnyIO=20to=20<=204?=
 =?UTF-8?q?.0.0=20to=20handle=20an=20incompatibility=20while=20upgrading?=
 =?UTF-8?q?=20to=20Starlette=200.31.1=20(#10194)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 pyproject.toml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/pyproject.toml b/pyproject.toml
index 9b7cca9c9..2870b31a5 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -44,6 +44,8 @@ dependencies = [
     "starlette>=0.27.0,<0.28.0",
     "pydantic>=1.7.4,!=1.8,!=1.8.1,!=2.0.0,!=2.0.1,!=2.1.0,<3.0.0",
     "typing-extensions>=4.5.0",
+    # TODO: remove this pin after upgrading Starlette 0.31.1
+    "anyio>=3.7.1,<4.0.0",
 ]
 dynamic = ["version"]
 

From 8562cae44b18d0f1638bb6d338a85754468fc559 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 2 Sep 2023 17:05:59 +0000
Subject: [PATCH 170/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 54a00d9ed..24dd82085 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 📌 Pin AnyIO to < 4.0.0 to handle an incompatibility while upgrading to Starlette 0.31.1. PR [#10194](https://github.com/tiangolo/fastapi/pull/10194) by [@tiangolo](https://github.com/tiangolo).
 * 🌐 Remove duplicate line in translation for `docs/pt/docs/tutorial/path-params.md`. PR [#10126](https://github.com/tiangolo/fastapi/pull/10126) by [@LecoOliveira](https://github.com/LecoOliveira).
 * ✏️ Fix indent format in `docs/en/docs/deployment/server-workers.md`. PR [#10066](https://github.com/tiangolo/fastapi/pull/10066) by [@tamtam-fitness](https://github.com/tamtam-fitness).
 * 🌐 Add Yoruba translation for `docs/yo/docs/index.md`. PR [#10033](https://github.com/tiangolo/fastapi/pull/10033) by [@AfolabiOlaoluwa](https://github.com/AfolabiOlaoluwa).

From 118010ad5ebb98f602deee7e69c3bff94aadf16a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 2 Sep 2023 17:06:22 +0000
Subject: [PATCH 171/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 24dd82085..45d845f25 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ✏️ Fix validation parameter name in docs, from `regex` to `pattern`. PR [#10085](https://github.com/tiangolo/fastapi/pull/10085) by [@pablodorrio](https://github.com/pablodorrio).
 * 📌 Pin AnyIO to < 4.0.0 to handle an incompatibility while upgrading to Starlette 0.31.1. PR [#10194](https://github.com/tiangolo/fastapi/pull/10194) by [@tiangolo](https://github.com/tiangolo).
 * 🌐 Remove duplicate line in translation for `docs/pt/docs/tutorial/path-params.md`. PR [#10126](https://github.com/tiangolo/fastapi/pull/10126) by [@LecoOliveira](https://github.com/LecoOliveira).
 * ✏️ Fix indent format in `docs/en/docs/deployment/server-workers.md`. PR [#10066](https://github.com/tiangolo/fastapi/pull/10066) by [@tamtam-fitness](https://github.com/tamtam-fitness).

From ce8ee1410ae4ba37744ed818be05e2cc187601e3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 2 Sep 2023 19:09:47 +0200
Subject: [PATCH 172/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 28 +++++++++++++++++++++-------
 1 file changed, 21 insertions(+), 7 deletions(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 45d845f25..4f333119c 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,25 +2,39 @@
 
 ## Latest Changes
 
-* ✏️ Fix validation parameter name in docs, from `regex` to `pattern`. PR [#10085](https://github.com/tiangolo/fastapi/pull/10085) by [@pablodorrio](https://github.com/pablodorrio).
+### Fixes
+
 * 📌 Pin AnyIO to < 4.0.0 to handle an incompatibility while upgrading to Starlette 0.31.1. PR [#10194](https://github.com/tiangolo/fastapi/pull/10194) by [@tiangolo](https://github.com/tiangolo).
-* 🌐 Remove duplicate line in translation for `docs/pt/docs/tutorial/path-params.md`. PR [#10126](https://github.com/tiangolo/fastapi/pull/10126) by [@LecoOliveira](https://github.com/LecoOliveira).
+
+### Docs
+
+* ✏️ Fix validation parameter name in docs, from `regex` to `pattern`. PR [#10085](https://github.com/tiangolo/fastapi/pull/10085) by [@pablodorrio](https://github.com/pablodorrio).
 * ✏️ Fix indent format in `docs/en/docs/deployment/server-workers.md`. PR [#10066](https://github.com/tiangolo/fastapi/pull/10066) by [@tamtam-fitness](https://github.com/tamtam-fitness).
-* 🌐 Add Yoruba translation for `docs/yo/docs/index.md`. PR [#10033](https://github.com/tiangolo/fastapi/pull/10033) by [@AfolabiOlaoluwa](https://github.com/AfolabiOlaoluwa).
 * ✏️ Fix Pydantic examples in tutorial for Python types. PR [#9961](https://github.com/tiangolo/fastapi/pull/9961) by [@rahulsalgare](https://github.com/rahulsalgare).
 * ✏️ Fix link to Pydantic docs in `docs/en/docs/tutorial/extra-data-types.md`. PR [#10155](https://github.com/tiangolo/fastapi/pull/10155) by [@hasnatsajid](https://github.com/hasnatsajid).
-* 🌐 Add Ukrainian translation for `docs/uk/docs/python-types.md`. PR [#10080](https://github.com/tiangolo/fastapi/pull/10080) by [@rostik1410](https://github.com/rostik1410).
-* 🌐 Add Vietnamese translations for `docs/vi/docs/tutorial/first-steps.md` and `docs/vi/docs/tutorial/index.md`. PR [#10088](https://github.com/tiangolo/fastapi/pull/10088) by [@magiskboy](https://github.com/magiskboy).
 * ✏️ Fix typo in `docs/en/docs/tutorial/handling-errors.md`. PR [#10170](https://github.com/tiangolo/fastapi/pull/10170) by [@poupapaa](https://github.com/poupapaa).
-* ✏️ Fix typos in comment in `fastapi/applications.py`. PR [#10045](https://github.com/tiangolo/fastapi/pull/10045) by [@AhsanSheraz](https://github.com/AhsanSheraz).
 * ✏️ Fix typo in `docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md`. PR [#10172](https://github.com/tiangolo/fastapi/pull/10172) by [@ragul-kachiappan](https://github.com/ragul-kachiappan).
+
+### Translations
+
+* 🌐 Remove duplicate line in translation for `docs/pt/docs/tutorial/path-params.md`. PR [#10126](https://github.com/tiangolo/fastapi/pull/10126) by [@LecoOliveira](https://github.com/LecoOliveira).
+* 🌐 Add Yoruba translation for `docs/yo/docs/index.md`. PR [#10033](https://github.com/tiangolo/fastapi/pull/10033) by [@AfolabiOlaoluwa](https://github.com/AfolabiOlaoluwa).
+* 🌐 Add Ukrainian translation for `docs/uk/docs/python-types.md`. PR [#10080](https://github.com/tiangolo/fastapi/pull/10080) by [@rostik1410](https://github.com/rostik1410).
+* 🌐 Add Vietnamese translations for `docs/vi/docs/tutorial/first-steps.md` and `docs/vi/docs/tutorial/index.md`. PR [#10088](https://github.com/tiangolo/fastapi/pull/10088) by [@magiskboy](https://github.com/magiskboy).
 * 🌐 Add Ukrainian translation for `docs/uk/docs/alternatives.md`. PR [#10060](https://github.com/tiangolo/fastapi/pull/10060) by [@whysage](https://github.com/whysage).
 * 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/index.md`. PR [#10079](https://github.com/tiangolo/fastapi/pull/10079) by [@rostik1410](https://github.com/rostik1410).
 * ✏️ Fix typos in `docs/en/docs/how-to/separate-openapi-schemas.md` and `docs/en/docs/tutorial/schema-extra-example.md`. PR [#10189](https://github.com/tiangolo/fastapi/pull/10189) by [@xzmeng](https://github.com/xzmeng).
 * 🌐 Add Chinese translation for `docs/zh/docs/advanced/generate-clients.md`. PR [#9883](https://github.com/tiangolo/fastapi/pull/9883) by [@funny-cat-happy](https://github.com/funny-cat-happy).
-* 👥 Update FastAPI People. PR [#10186](https://github.com/tiangolo/fastapi/pull/10186) by [@tiangolo](https://github.com/tiangolo).
+
+### Refactors
+
+* ✏️ Fix typos in comment in `fastapi/applications.py`. PR [#10045](https://github.com/tiangolo/fastapi/pull/10045) by [@AhsanSheraz](https://github.com/AhsanSheraz).
 * ✅ Add missing test for OpenAPI examples, it was missing in coverage. PR [#10188](https://github.com/tiangolo/fastapi/pull/10188) by [@tiangolo](https://github.com/tiangolo).
 
+### Internal
+
+* 👥 Update FastAPI People. PR [#10186](https://github.com/tiangolo/fastapi/pull/10186) by [@tiangolo](https://github.com/tiangolo).
+
 ## 0.103.0
 
 ### Features

From bfde8f3ef20dc338bbce8a0ff0f4b441c54d5b64 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 2 Sep 2023 19:10:19 +0200
Subject: [PATCH 173/317] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.10?=
 =?UTF-8?q?3.1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 3 +++
 fastapi/__init__.py           | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 4f333119c..f03d54a9a 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,9 @@
 
 ## Latest Changes
 
+
+## 0.103.1
+
 ### Fixes
 
 * 📌 Pin AnyIO to < 4.0.0 to handle an incompatibility while upgrading to Starlette 0.31.1. PR [#10194](https://github.com/tiangolo/fastapi/pull/10194) by [@tiangolo](https://github.com/tiangolo).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index ff8b98d3b..329477e41 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.103.0"
+__version__ = "0.103.1"
 
 from starlette import status as status
 

From 766dfb5b38a4751c0706b1ef4a73dc276e81572b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sun, 10 Sep 2023 12:18:26 +0200
Subject: [PATCH 174/317] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors,=20add?=
 =?UTF-8?q?=20Bump.sh=20(#10227)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                                    |   1 +
 docs/en/data/sponsors.yml                    |   3 +++
 docs/en/docs/img/sponsors/bump-sh-banner.png | Bin 0 -> 10139 bytes
 docs/en/docs/img/sponsors/bump-sh.png        | Bin 0 -> 18609 bytes
 docs/en/overrides/main.html                  |   6 ++++++
 5 files changed, 10 insertions(+)
 create mode 100755 docs/en/docs/img/sponsors/bump-sh-banner.png
 create mode 100755 docs/en/docs/img/sponsors/bump-sh.png

diff --git a/README.md b/README.md
index 266213426..7aa9d4be6 100644
--- a/README.md
+++ b/README.md
@@ -50,6 +50,7 @@ The key features are:
 <a href="https://platform.sh/try-it-now/?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023" target="_blank" title="Build, run and scale your apps on a modern, reliable, and secure PaaS."><img src="https://fastapi.tiangolo.com/img/sponsors/platform-sh.png"></a>
 <a href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=main-badge" target="_blank" title="Fern | SDKs and API docs"><img src="https://fastapi.tiangolo.com/img/sponsors/fern.svg"></a>
 <a href="https://www.porter.run" target="_blank" title="Deploy FastAPI on AWS with a few clicks"><img src="https://fastapi.tiangolo.com/img/sponsors/porter.png"></a>
+<a href="https://bump.sh/fastapi?utm_source=fastapi&utm_medium=referral&utm_campaign=sponsor" target="_blank" title="Automate FastAPI documentation generation with Bump.sh"><img src="https://fastapi.tiangolo.com/img/sponsors/bump-sh.png"></a>
 <a href="https://www.deta.sh/?ref=fastapi" target="_blank" title="The launchpad for all your (team's) ideas"><img src="https://fastapi.tiangolo.com/img/sponsors/deta.svg"></a>
 <a href="https://training.talkpython.fm/fastapi-courses" target="_blank" title="FastAPI video courses on demand from people you trust"><img src="https://fastapi.tiangolo.com/img/sponsors/talkpython.png"></a>
 <a href="https://testdriven.io/courses/tdd-fastapi/" target="_blank" title="Learn to build high-quality web apps with best practices"><img src="https://fastapi.tiangolo.com/img/sponsors/testdriven.svg"></a>
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index 0d9597f07..504c373a2 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -11,6 +11,9 @@ gold:
   - url: https://www.porter.run
     title: Deploy FastAPI on AWS with a few clicks
     img: https://fastapi.tiangolo.com/img/sponsors/porter.png
+  - url: https://bump.sh/fastapi?utm_source=fastapi&utm_medium=referral&utm_campaign=sponsor
+    title: Automate FastAPI documentation generation with Bump.sh
+    img: https://fastapi.tiangolo.com/img/sponsors/bump-sh.png
 silver:
   - url: https://www.deta.sh/?ref=fastapi
     title: The launchpad for all your (team's) ideas
diff --git a/docs/en/docs/img/sponsors/bump-sh-banner.png b/docs/en/docs/img/sponsors/bump-sh-banner.png
new file mode 100755
index 0000000000000000000000000000000000000000..e75c0facd30acbee9121ae41cce236a99bea3646
GIT binary patch
literal 10139
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
JPDHLkV1j@T&F26B

literal 0
HcmV?d00001

diff --git a/docs/en/docs/img/sponsors/bump-sh.png b/docs/en/docs/img/sponsors/bump-sh.png
new file mode 100755
index 0000000000000000000000000000000000000000..61817e86fa1064e2ea239bb45a504998aa6274c2
GIT binary patch
literal 18609
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
IM6N<$f`MAJRsaA1

literal 0
HcmV?d00001

diff --git a/docs/en/overrides/main.html b/docs/en/overrides/main.html
index 983d7eb3e..d867d2ee5 100644
--- a/docs/en/overrides/main.html
+++ b/docs/en/overrides/main.html
@@ -46,6 +46,12 @@
         <img class="sponsor-image" src="/img/sponsors/porter-banner.png" />
       </a>
     </div>
+    <div class="item">
+      <a title="Automate FastAPI documentation generation with Bump.sh" style="display: block; position: relative;" href="https://bump.sh/fastapi?utm_source=fastapi&utm_medium=referral&utm_campaign=sponsor" target="_blank">
+        <span class="sponsor-badge">sponsor</span>
+        <img class="sponsor-image" src="/img/sponsors/bump-sh-banner.png" />
+      </a>
+    </div>
   </div>
 </div>
 {% endblock %}

From a10c35673d586d1e33dd8189e863ef17602773c3 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 10 Sep 2023 10:19:02 +0000
Subject: [PATCH 175/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f03d54a9a..29793749d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🔧 Update sponsors, add Bump.sh. PR [#10227](https://github.com/tiangolo/fastapi/pull/10227) by [@tiangolo](https://github.com/tiangolo).
 
 ## 0.103.1
 

From e0a99e24b8b96469b0a6ec51f3439a771d1767c8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sun, 10 Sep 2023 12:36:28 +0200
Subject: [PATCH 176/317] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors,=20rem?=
 =?UTF-8?q?ove=20Svix=20(#10228)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                 | 1 -
 docs/en/data/sponsors.yml | 3 ---
 2 files changed, 4 deletions(-)

diff --git a/README.md b/README.md
index 7aa9d4be6..73f70cd6a 100644
--- a/README.md
+++ b/README.md
@@ -56,7 +56,6 @@ The key features are:
 <a href="https://testdriven.io/courses/tdd-fastapi/" target="_blank" title="Learn to build high-quality web apps with best practices"><img src="https://fastapi.tiangolo.com/img/sponsors/testdriven.svg"></a>
 <a href="https://github.com/deepset-ai/haystack/" target="_blank" title="Build powerful search from composable, open source building blocks"><img src="https://fastapi.tiangolo.com/img/sponsors/haystack-fastapi.svg"></a>
 <a href="https://careers.powens.com/" target="_blank" title="Powens is hiring!"><img src="https://fastapi.tiangolo.com/img/sponsors/powens.png"></a>
-<a href="https://www.svix.com/" target="_blank" title="Svix - Webhooks as a service"><img src="https://fastapi.tiangolo.com/img/sponsors/svix.svg"></a>
 <a href="https://databento.com/" target="_blank" title="Pay as you go for market data"><img src="https://fastapi.tiangolo.com/img/sponsors/databento.svg"></a>
 <a href="https://speakeasyapi.dev?utm_source=fastapi+repo&utm_medium=github+sponsorship" target="_blank" title="SDKs for your API | Speakeasy"><img src="https://fastapi.tiangolo.com/img/sponsors/speakeasy.png"></a>
 
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index 504c373a2..e700a5770 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -30,9 +30,6 @@ silver:
   - url: https://careers.powens.com/
     title: Powens is hiring!
     img: https://fastapi.tiangolo.com/img/sponsors/powens.png
-  - url: https://www.svix.com/
-    title: Svix - Webhooks as a service
-    img: https://fastapi.tiangolo.com/img/sponsors/svix.svg
   - url: https://databento.com/
     title: Pay as you go for market data
     img: https://fastapi.tiangolo.com/img/sponsors/databento.svg

From c6437d555d2c0b29a0e3ec54f2cc83753714099c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 10 Sep 2023 10:37:04 +0000
Subject: [PATCH 177/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 29793749d..45a87e654 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🔧 Update sponsors, remove Svix. PR [#10228](https://github.com/tiangolo/fastapi/pull/10228) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, add Bump.sh. PR [#10227](https://github.com/tiangolo/fastapi/pull/10227) by [@tiangolo](https://github.com/tiangolo).
 
 ## 0.103.1

From 571c7a7aba8292fa8759b39f695daee01e6a636e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 15 Sep 2023 10:38:48 +0200
Subject: [PATCH 178/317] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors,=20ena?=
 =?UTF-8?q?ble=20Svix=20(revert=20#10228)=20(#10253)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 🔧 Update sponsors, remove Svix (revert #10228)

This reverts commit e0a99e24b8b96469b0a6ec51f3439a771d1767c8.

* 🔧 Tweak and update sponsors data
---
 README.md                       | 1 +
 docs/en/data/sponsors.yml       | 3 +++
 docs/en/data/sponsors_badge.yml | 2 +-
 3 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 73f70cd6a..b86143f3d 100644
--- a/README.md
+++ b/README.md
@@ -58,6 +58,7 @@ The key features are:
 <a href="https://careers.powens.com/" target="_blank" title="Powens is hiring!"><img src="https://fastapi.tiangolo.com/img/sponsors/powens.png"></a>
 <a href="https://databento.com/" target="_blank" title="Pay as you go for market data"><img src="https://fastapi.tiangolo.com/img/sponsors/databento.svg"></a>
 <a href="https://speakeasyapi.dev?utm_source=fastapi+repo&utm_medium=github+sponsorship" target="_blank" title="SDKs for your API | Speakeasy"><img src="https://fastapi.tiangolo.com/img/sponsors/speakeasy.png"></a>
+<a href="https://www.svix.com/" target="_blank" title="Svix - Webhooks as a service"><img src="https://fastapi.tiangolo.com/img/sponsors/svix.svg"></a>
 
 <!-- /sponsors -->
 
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index e700a5770..5d7752d29 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -36,6 +36,9 @@ silver:
   - url: https://speakeasyapi.dev?utm_source=fastapi+repo&utm_medium=github+sponsorship
     title: SDKs for your API | Speakeasy
     img: https://fastapi.tiangolo.com/img/sponsors/speakeasy.png
+  - url: https://www.svix.com/
+    title: Svix - Webhooks as a service
+    img: https://fastapi.tiangolo.com/img/sponsors/svix.svg
 bronze:
   - url: https://www.exoflare.com/open-source/?utm_source=FastAPI&utm_campaign=open_source
     title: Biosecurity risk assessments made easy.
diff --git a/docs/en/data/sponsors_badge.yml b/docs/en/data/sponsors_badge.yml
index 7b605e0ff..d67e27c87 100644
--- a/docs/en/data/sponsors_badge.yml
+++ b/docs/en/data/sponsors_badge.yml
@@ -12,7 +12,6 @@ logins:
   - ObliviousAI
   - Doist
   - nihpo
-  - svix
   - armand-sauzay
   - databento-bot
   - nanram22
@@ -20,3 +19,4 @@ logins:
   - porter-dev
   - fern-api
   - ndimares
+  - svixhq

From 46d1da08da73d8b4100e709edab9d84aa6b6a203 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 15 Sep 2023 08:39:26 +0000
Subject: [PATCH 179/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 45a87e654..5266e87c4 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🔧 Update sponsors, enable Svix (revert #10228). PR [#10253](https://github.com/tiangolo/fastapi/pull/10253) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, remove Svix. PR [#10228](https://github.com/tiangolo/fastapi/pull/10228) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, add Bump.sh. PR [#10227](https://github.com/tiangolo/fastapi/pull/10227) by [@tiangolo](https://github.com/tiangolo).
 

From 2fcd8ce8ec981fdd8ea876ac5b346b3be8274372 Mon Sep 17 00:00:00 2001
From: xzmeng <aumo@foxmail.com>
Date: Sat, 23 Sep 2023 07:30:46 +0800
Subject: [PATCH 180/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Chinese=20translat?=
 =?UTF-8?q?ion=20for=20`docs/zh/docs/deployment/versions.md`=20(#10276)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Big Yellow Dog <dognasus@outlook.com>
---
 docs/zh/docs/deployment/versions.md | 87 +++++++++++++++++++++++++++++
 1 file changed, 87 insertions(+)
 create mode 100644 docs/zh/docs/deployment/versions.md

diff --git a/docs/zh/docs/deployment/versions.md b/docs/zh/docs/deployment/versions.md
new file mode 100644
index 000000000..75b870139
--- /dev/null
+++ b/docs/zh/docs/deployment/versions.md
@@ -0,0 +1,87 @@
+# 关于 FastAPI 版本
+
+**FastAPI** 已在许多应用程序和系统的生产环境中使用。 并且测试覆盖率保持在100%。 但其开发进度仍在快速推进。
+
+经常添加新功能，定期修复错误，并且代码仍在持续改进。
+
+这就是为什么当前版本仍然是`0.x.x`，这反映出每个版本都可能有Breaking changes。 这遵循<a href="https://semver.org/" class="external-link" target="_blank">语义版本控制</a>的约定。
+
+你现在就可以使用 **FastAPI** 创建生产环境应用程序（你可能已经这样做了一段时间），你只需确保使用的版本可以与其余代码正确配合即可。
+
+## 固定你的 `fastapi` 版本
+
+你应该做的第一件事是将你正在使用的 **FastAPI** 版本“固定”到你知道适用于你的应用程序的特定最新版本。
+
+例如，假设你在应用程序中使用版本`0.45.0`。
+
+如果你使用`requirements.txt`文件，你可以使用以下命令指定版本：
+
+````txt
+fastapi==0.45.0
+````
+
+这意味着你将使用版本`0.45.0`。
+
+或者你也可以将其固定为：
+
+````txt
+fastapi>=0.45.0,<0.46.0
+````
+
+这意味着你将使用`0.45.0`或更高版本，但低于`0.46.0`，例如，版本`0.45.2`仍会被接受。
+
+如果你使用任何其他工具来管理你的安装，例如 Poetry、Pipenv 或其他工具，它们都有一种定义包的特定版本的方法。
+
+## 可用版本
+
+你可以在[发行说明](../release-notes.md){.internal-link target=_blank}中查看可用版本（例如查看当前最新版本）。
+
+## 关于版本
+
+遵循语义版本控制约定，任何低于`1.0.0`的版本都可能会添加 breaking changes。
+
+FastAPI 还遵循这样的约定：任何`PATCH`版本更改都是为了bug修复和non-breaking changes。
+
+!!! tip
+     "PATCH"是最后一个数字，例如，在`0.2.3`中，PATCH版本是`3`。
+
+因此，你应该能够固定到如下版本：
+
+```txt
+fastapi>=0.45.0,<0.46.0
+```
+
+"MINOR"版本中会添加breaking changes和新功能。
+
+!!! tip
+     "MINOR"是中间的数字，例如，在`0.2.3`中，MINOR版本是`2`。
+
+## 升级FastAPI版本
+
+你应该为你的应用程序添加测试。
+
+使用 **FastAPI** 编写测试非常简单（感谢 Starlette），请参考文档：[测试](../tutorial/testing.md){.internal-link target=_blank}
+
+添加测试后，你可以将 **FastAPI** 版本升级到更新版本，并通过运行测试来确保所有代码都能正常工作。
+
+如果一切正常，或者在进行必要的更改之后，并且所有测试都通过了，那么你可以将`fastapi`固定到新的版本。
+
+## 关于Starlette
+
+你不应该固定`starlette`的版本。
+
+不同版本的 **FastAPI** 将使用特定的较新版本的 Starlette。
+
+因此，**FastAPI** 自己可以使用正确的 Starlette 版本。
+
+## 关于 Pydantic
+
+Pydantic 包含针对 **FastAPI** 的测试及其自己的测试，因此 Pydantic 的新版本（`1.0.0`以上）始终与 FastAPI 兼容。
+
+你可以将 Pydantic 固定到适合你的`1.0.0`以上和`2.0.0`以下的任何版本。
+
+例如：
+
+````txt
+pydantic>=1.2.0,<2.0.0
+````

From f4bc0d8205e6cdcda73d274350aff5928ed2e2ce Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 22 Sep 2023 23:31:21 +0000
Subject: [PATCH 181/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 5266e87c4..e87ab47ae 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Chinese translation for `docs/zh/docs/deployment/versions.md`. PR [#10276](https://github.com/tiangolo/fastapi/pull/10276) by [@xzmeng](https://github.com/xzmeng).
 * 🔧 Update sponsors, enable Svix (revert #10228). PR [#10253](https://github.com/tiangolo/fastapi/pull/10253) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, remove Svix. PR [#10228](https://github.com/tiangolo/fastapi/pull/10228) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, add Bump.sh. PR [#10227](https://github.com/tiangolo/fastapi/pull/10227) by [@tiangolo](https://github.com/tiangolo).

From 84794221d98e963348aa10b9d4ccfeafa4bb470f Mon Sep 17 00:00:00 2001
From: Aleksandr Andrukhov <ieaiaio@bk.ru>
Date: Sat, 23 Sep 2023 02:36:59 +0300
Subject: [PATCH 182/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Russian=20translat?=
 =?UTF-8?q?ion=20for=20`docs/ru/docs/tutorial/header-params.md`=20(#10226)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Artem Golicyn <86262613+AGolicyn@users.noreply.github.com>
Co-authored-by: Nikita <omegastrikeclan@yandex.ru>
---
 docs/ru/docs/tutorial/header-params.md | 227 +++++++++++++++++++++++++
 1 file changed, 227 insertions(+)
 create mode 100644 docs/ru/docs/tutorial/header-params.md

diff --git a/docs/ru/docs/tutorial/header-params.md b/docs/ru/docs/tutorial/header-params.md
new file mode 100644
index 000000000..0ff8ea489
--- /dev/null
+++ b/docs/ru/docs/tutorial/header-params.md
@@ -0,0 +1,227 @@
+# Header-параметры
+
+Вы можете определить параметры заголовка таким же образом, как вы определяете параметры `Query`, `Path` и `Cookie`.
+
+## Импорт `Header`
+
+Сперва импортируйте `Header`:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/header_params/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/header_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ без Annotated"
+
+    !!! tip "Подсказка"
+        Предпочтительнее использовать версию с аннотацией, если это возможно.
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/header_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+ без Annotated"
+
+    !!! tip "Подсказка"
+        Предпочтительнее использовать версию с аннотацией, если это возможно.
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/header_params/tutorial001.py!}
+    ```
+
+## Объявление параметров `Header`
+
+Затем объявите параметры заголовка, используя ту же структуру, что и с `Path`, `Query` и `Cookie`.
+
+Первое значение является значением по умолчанию, вы можете передать все дополнительные параметры валидации или аннотации:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/header_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ без Annotated"
+
+    !!! tip "Подсказка"
+        Предпочтительнее использовать версию с аннотацией, если это возможно.
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/header_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+ без Annotated"
+
+    !!! tip "Подсказка"
+        Предпочтительнее использовать версию с аннотацией, если это возможно.
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial001.py!}
+    ```
+
+!!! note "Технические детали"
+    `Header` - это "родственный" класс `Path`, `Query` и `Cookie`. Он также наследуется от того же общего класса `Param`.
+
+    Но помните, что когда вы импортируете `Query`, `Path`, `Header` и другие из `fastapi`, на самом деле это функции, которые возвращают специальные классы.
+
+!!! info "Дополнительная информация"
+    Чтобы объявить заголовки, важно использовать `Header`, иначе параметры интерпретируются как query-параметры.
+
+## Автоматическое преобразование
+
+`Header` обладает небольшой дополнительной функциональностью в дополнение к тому, что предоставляют `Path`, `Query` и `Cookie`.
+
+Большинство стандартных заголовков разделены символом "дефис", также известным как "минус" (`-`).
+
+Но переменная вроде `user-agent` недопустима в Python.
+
+По умолчанию `Header` преобразует символы имен параметров из символа подчеркивания (`_`) в дефис (`-`) для извлечения и документирования заголовков.
+
+Кроме того, HTTP-заголовки не чувствительны к регистру, поэтому вы можете объявить их в стандартном стиле Python (также известном как "snake_case").
+
+Таким образом вы можете использовать `user_agent`, как обычно, в коде Python, вместо того, чтобы вводить заглавные буквы как `User_Agent` или что-то подобное.
+
+Если по какой-либо причине вам необходимо отключить автоматическое преобразование подчеркиваний в дефисы, установите для параметра `convert_underscores` в `Header` значение `False`:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/header_params/tutorial002_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="11"
+    {!> ../../../docs_src/header_params/tutorial002_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="12"
+    {!> ../../../docs_src/header_params/tutorial002_an.py!}
+    ```
+
+=== "Python 3.10+ без Annotated"
+
+    !!! tip "Подсказка"
+        Предпочтительнее использовать версию с аннотацией, если это возможно.
+
+    ```Python hl_lines="8"
+    {!> ../../../docs_src/header_params/tutorial002_py310.py!}
+    ```
+
+=== "Python 3.6+ без Annotated"
+
+    !!! tip "Подсказка"
+        Предпочтительнее использовать версию с аннотацией, если это возможно.
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/header_params/tutorial002.py!}
+    ```
+
+!!! warning "Внимание"
+    Прежде чем установить для `convert_underscores` значение `False`, имейте в виду, что некоторые HTTP-прокси и серверы запрещают использование заголовков с подчеркиванием.
+
+## Повторяющиеся заголовки
+
+Есть возможность получать несколько заголовков с одним и тем же именем, но разными значениями.
+
+Вы можете определить эти случаи, используя список в объявлении типа.
+
+Вы получите все значения из повторяющегося заголовка в виде `list` Python.
+
+Например, чтобы объявить заголовок `X-Token`, который может появляться более одного раза, вы можете написать:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial003_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial003_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/header_params/tutorial003_an.py!}
+    ```
+
+=== "Python 3.10+ без Annotated"
+
+    !!! tip "Подсказка"
+        Предпочтительнее использовать версию с аннотацией, если это возможно.
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/header_params/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.9+ без Annotated"
+
+    !!! tip "Подсказка"
+        Предпочтительнее использовать версию с аннотацией, если это возможно.
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial003_py39.py!}
+    ```
+
+=== "Python 3.6+ без Annotated"
+
+    !!! tip "Подсказка"
+        Предпочтительнее использовать версию с аннотацией, если это возможно.
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/header_params/tutorial003.py!}
+    ```
+
+Если вы взаимодействуете с этой *операцией пути*, отправляя два HTTP-заголовка, таких как:
+
+```
+X-Token: foo
+X-Token: bar
+```
+
+Ответ был бы таким:
+
+```JSON
+{
+    "X-Token values": [
+        "bar",
+        "foo"
+    ]
+}
+```
+
+## Резюме
+
+Объявляйте заголовки с помощью `Header`, используя тот же общий шаблон, как при `Query`, `Path` и `Cookie`.
+
+И не беспокойтесь о символах подчеркивания в ваших переменных, **FastAPI** позаботится об их преобразовании.

From 79399e43df61e05c92d93ac61c49ea5eb1080691 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 22 Sep 2023 23:37:34 +0000
Subject: [PATCH 183/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index e87ab47ae..2c27faa81 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Russian translation for `docs/ru/docs/tutorial/header-params.md`. PR [#10226](https://github.com/tiangolo/fastapi/pull/10226) by [@AlertRED](https://github.com/AlertRED).
 * 🌐 Add Chinese translation for `docs/zh/docs/deployment/versions.md`. PR [#10276](https://github.com/tiangolo/fastapi/pull/10276) by [@xzmeng](https://github.com/xzmeng).
 * 🔧 Update sponsors, enable Svix (revert #10228). PR [#10253](https://github.com/tiangolo/fastapi/pull/10253) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, remove Svix. PR [#10228](https://github.com/tiangolo/fastapi/pull/10228) by [@tiangolo](https://github.com/tiangolo).

From 89246313aad8c1d467cd08e88b1ec97030083945 Mon Sep 17 00:00:00 2001
From: Raman Bazhanau <67696229+romabozhanovgithub@users.noreply.github.com>
Date: Sat, 23 Sep 2023 01:38:53 +0200
Subject: [PATCH 184/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Polish=20translati?=
 =?UTF-8?q?on=20for=20`docs/pl/docs/help-fastapi.md`=20(#10121)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Igor Sulim <30448496+isulim@users.noreply.github.com>
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
Co-authored-by: Antek S. <antoni.szych@gmail.com>
---
 docs/pl/docs/help-fastapi.md | 265 +++++++++++++++++++++++++++++++++++
 1 file changed, 265 insertions(+)
 create mode 100644 docs/pl/docs/help-fastapi.md

diff --git a/docs/pl/docs/help-fastapi.md b/docs/pl/docs/help-fastapi.md
new file mode 100644
index 000000000..723df91d1
--- /dev/null
+++ b/docs/pl/docs/help-fastapi.md
@@ -0,0 +1,265 @@
+# Pomóż FastAPI - Uzyskaj pomoc
+
+Czy podoba Ci się **FastAPI**?
+
+Czy chciałbyś pomóc FastAPI, jego użytkownikom i autorowi?
+
+Może napotkałeś na trudności z **FastAPI** i potrzebujesz pomocy?
+
+Istnieje kilka bardzo łatwych sposobów, aby pomóc (czasami wystarczy jedno lub dwa kliknięcia).
+
+Istnieje również kilka sposobów uzyskania pomocy.
+
+## Zapisz się do newslettera
+
+Możesz zapisać się do rzadkiego [newslettera o **FastAPI i jego przyjaciołach**](/newsletter/){.internal-link target=_blank}, aby być na bieżąco z:
+
+* Aktualnościami o FastAPI i przyjaciołach 🚀
+* Przewodnikami 📝
+* Funkcjami ✨
+* Przełomowymi zmianami 🚨
+* Poradami i sztuczkami ✅
+
+## Śledź FastAPI na Twitterze
+
+<a href="https://twitter.com/fastapi" class="external-link" target="_blank">Śledź @fastapi na **Twitterze**</a> aby być na bieżąco z najnowszymi wiadomościami o **FastAPI**. 🐦
+
+## Dodaj gwiazdkę **FastAPI** na GitHubie
+
+Możesz "dodać gwiazdkę" FastAPI na GitHubie (klikając przycisk gwiazdki w prawym górnym rogu): <a href="https://github.com/tiangolo/fastapi" class="external-link" target="_blank">https://github.com/tiangolo/fastapi</a>. ⭐️
+
+Dodając gwiazdkę, inni użytkownicy będą mogli łatwiej znaleźć projekt i zobaczyć, że był już przydatny dla innych.
+
+## Obserwuj repozytorium GitHub w poszukiwaniu nowych wydań
+
+Możesz "obserwować" FastAPI na GitHubie (klikając przycisk "obserwuj" w prawym górnym rogu): <a href="https://github.com/tiangolo/fastapi" class="external-link" target="_blank">https://github.com/tiangolo/fastapi</a>. 👀
+
+Wybierz opcję "Tylko wydania".
+
+Dzięki temu będziesz otrzymywać powiadomienia (na swój adres e-mail) za każdym razem, gdy pojawi się nowe wydanie (nowa wersja) **FastAPI** z poprawkami błędów i nowymi funkcjami.
+
+## Skontaktuj się z autorem
+
+Możesz skontaktować się <a href="https://tiangolo.com" class="external-link" target="_blank">ze mną (Sebastián Ramírez / `tiangolo`)</a>, autorem.
+
+Możesz:
+
+* <a href="https://github.com/tiangolo" class="external-link" target="_blank">Śledzić mnie na **GitHubie**</a>.
+    * Zobacz inne projekty open source, które stworzyłem, a mogą być dla Ciebie pomocne.
+    * Śledź mnie, aby dostać powiadomienie, gdy utworzę nowy projekt open source.
+* <a href="https://twitter.com/tiangolo" class="external-link" target="_blank">Śledzić mnie na **Twitterze**</a> lub na <a href="https://fosstodon.org/@tiangolo" class="external-link" target="_blank">Mastodonie</a>.
+    * Napisz mi, w jaki sposób korzystasz z FastAPI (uwielbiam o tym czytać).
+    * Dowiedz się, gdy ogłoszę coś nowego lub wypuszczę nowe narzędzia.
+    * Możesz także <a href="https://twitter.com/fastapi" class="external-link" target="_blank">śledzić @fastapi na Twitterze</a> (to oddzielne konto).
+* <a href="https://www.linkedin.com/in/tiangolo/" class="external-link" target="_blank">Nawiąż ze mną kontakt na **Linkedinie**</a>.
+    * Dowiedz się, gdy ogłoszę coś nowego lub wypuszczę nowe narzędzia (chociaż częściej korzystam z Twittera 🤷‍♂).
+* Czytaj moje posty (lub śledź mnie) na <a href="https://dev.to/tiangolo" class="external-link" target="_blank">**Dev.to**</a> lub na <a href="https://medium.com/@tiangolo" class="external-link" target="_blank">**Medium**</a>.
+    * Czytaj o innych pomysłach, artykułach i dowiedz się o narzędziach, które stworzyłem.
+    * Śledź mnie, by wiedzieć gdy opublikuję coś nowego.
+
+## Napisz tweeta o **FastAPI**
+
+<a href="https://twitter.com/compose/tweet?text=I'm loving @fastapi because... https://github.com/tiangolo/fastapi" class="external-link" target="_blank">Napisz tweeta o **FastAPI**</a> i powiedz czemu Ci się podoba. 🎉
+
+Uwielbiam czytać w jaki sposób **FastAPI** jest używane, co Ci się w nim podobało, w jakim projekcie/firmie go używasz itp.
+
+## Głosuj na FastAPI
+
+* <a href="https://www.slant.co/options/34241/~fastapi-review" class="external-link" target="_blank">Głosuj na **FastAPI** w Slant</a>.
+* <a href="https://alternativeto.net/software/fastapi/" class="external-link" target="_blank">Głosuj na **FastAPI** w AlternativeTo</a>.
+* <a href="https://stackshare.io/pypi-fastapi" class="external-link" target="_blank">Powiedz, że używasz **FastAPI** na StackShare</a>.
+
+## Pomagaj innym, odpowiadając na ich pytania na GitHubie
+
+Możesz spróbować pomóc innym, odpowiadając w:
+
+* <a href="https://github.com/tiangolo/fastapi/discussions/categories/questions?discussions_q=category%3AQuestions+is%3Aunanswered" class="external-link" target="_blank">Dyskusjach na GitHubie</a>
+* <a href="https://github.com/tiangolo/fastapi/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Aquestion+-label%3Aanswered+" class="external-link" target="_blank">Problemach na GitHubie</a>
+
+W wielu przypadkach możesz już znać odpowiedź na te pytania. 🤓
+
+Jeśli pomożesz wielu ludziom, możesz zostać oficjalnym [Ekspertem FastAPI](fastapi-people.md#experts){.internal-link target=_blank}. 🎉
+
+Pamiętaj tylko o najważniejszym: bądź życzliwy. Ludzie przychodzą sfrustrowani i w wielu przypadkach nie zadają pytań w najlepszy sposób, ale mimo to postaraj się być dla nich jak najbardziej życzliwy. 🤗
+
+Chciałbym, by społeczność **FastAPI** była życzliwa i przyjazna. Nie akceptuj prześladowania ani braku szacunku wobec innych. Dbajmy o siebie nawzajem.
+
+---
+
+Oto, jak pomóc innym z pytaniami (w dyskusjach lub problemach):
+
+### Zrozum pytanie
+
+* Upewnij się, czy rozumiesz **cel** i przypadek użycia osoby pytającej.
+
+* Następnie sprawdź, czy pytanie (większość to pytania) jest **jasne**.
+
+* W wielu przypadkach zadane pytanie dotyczy rozwiązania wymyślonego przez użytkownika, ale może istnieć **lepsze** rozwiązanie. Jeśli dokładnie zrozumiesz problem i przypadek użycia, być może będziesz mógł zaproponować lepsze **alternatywne rozwiązanie**.
+
+* Jeśli nie rozumiesz pytania, poproś o więcej **szczegółów**.
+
+### Odtwórz problem
+
+W większości przypadków problem wynika z **autorskiego kodu** osoby pytającej.
+
+Często pytający umieszczają tylko fragment kodu, niewystarczający do **odtworzenia problemu**.
+
+* Możesz poprosić ich o dostarczenie <a href="https://stackoverflow.com/help/minimal-reproducible-example" class="external-link" target="_blank">minimalnego, odtwarzalnego przykładu</a>, który możesz **skopiować i wkleić** i uruchomić lokalnie, aby zobaczyć ten sam błąd lub zachowanie, które widzą, lub lepiej zrozumieć ich przypadki użycia.
+
+* Jeśli jesteś wyjątkowo pomocny, możesz spróbować **stworzyć taki przykład** samodzielnie, opierając się tylko na opisie problemu. Miej na uwadze, że może to zająć dużo czasu i lepiej może być najpierw poprosić ich o wyjaśnienie problemu.
+
+### Proponuj rozwiązania
+
+* Po zrozumieniu pytania możesz podać im możliwą **odpowiedź**.
+
+* W wielu przypadkach lepiej zrozumieć ich **podstawowy problem lub przypadek użycia**, ponieważ może istnieć lepszy sposób rozwiązania niż to, co próbują zrobić.
+
+### Poproś o zamknięcie
+
+Jeśli odpowiedzą, jest duża szansa, że rozwiązałeś ich problem, gratulacje, **jesteś bohaterem**! 🦸
+
+* Jeśli Twoja odpowiedź rozwiązała problem, możesz poprosić o:
+
+    * W Dyskusjach na GitHubie: oznaczenie komentarza jako **odpowiedź**.
+    * W Problemach na GitHubie: **zamknięcie** problemu.
+
+## Obserwuj repozytorium na GitHubie
+
+Możesz "obserwować" FastAPI na GitHubie (klikając przycisk "obserwuj" w prawym górnym rogu): <a href="https://github.com/tiangolo/fastapi" class="external-link" target="_blank">https://github.com/tiangolo/fastapi</a>. 👀
+
+Jeśli wybierzesz "Obserwuj" zamiast "Tylko wydania", otrzymasz powiadomienia, gdy ktoś utworzy nowy problem lub pytanie. Możesz również określić, że chcesz być powiadamiany tylko o nowych problemach, dyskusjach, PR-ach itp.
+
+Następnie możesz spróbować pomóc rozwiązać te problemy.
+
+## Zadawaj pytania
+
+Możesz <a href="https://github.com/tiangolo/fastapi/discussions/new?category=questions" class="external-link" target="_blank">utworzyć nowe pytanie</a> w repozytorium na GitHubie, na przykład aby:
+
+* Zadać **pytanie** lub zapytać o **problem**.
+* Zaproponować nową **funkcję**.
+
+**Uwaga**: jeśli to zrobisz, poproszę Cię również o pomoc innym. 😉
+
+## Przeglądaj Pull Requesty
+
+Możesz pomóc mi w przeglądaniu pull requestów autorstwa innych osób.
+
+Jak wcześniej wspomniałem, postaraj się być jak najbardziej życzliwy. 🤗
+
+---
+
+Oto, co warto mieć na uwadze podczas oceny pull requestu:
+
+### Zrozum problem
+
+* Najpierw upewnij się, że **rozumiesz problem**, który próbuje rozwiązać pull request. Może być osadzony w większym kontekście w GitHubowej dyskusji lub problemie.
+
+* Jest też duża szansa, że pull request nie jest konieczny, ponieważ problem można rozwiązać w **inny sposób**. Wtedy możesz to zasugerować lub o to zapytać.
+
+### Nie martw się stylem
+
+* Nie przejmuj się zbytnio rzeczami takimi jak style wiadomości commitów, przy wcielaniu pull requesta łączę commity i modyfikuję opis sumarycznego commita ręcznie.
+
+* Nie przejmuj się również stylem kodu, automatyczne narzędzia w repozytorium sprawdzają to samodzielnie.
+
+A jeśli istnieje jakaś konkretna potrzeba dotycząca stylu lub spójności, sam poproszę o zmiany lub dodam commity z takimi zmianami.
+
+### Sprawdź kod
+
+* Przeczytaj kod, zastanów się czy ma sens, **uruchom go lokalnie** i potwierdź czy faktycznie rozwiązuje problem.
+
+* Następnie dodaj **komentarz** z informacją o tym, że sprawdziłeś kod, dzięki temu będę miał pewność, że faktycznie go sprawdziłeś.
+
+!!! info
+    Niestety, nie mogę ślepo ufać PR-om, nawet jeśli mają kilka zatwierdzeń.
+
+    Kilka razy zdarzyło się, że PR-y miały 3, 5 lub więcej zatwierdzeń (prawdopodobnie dlatego, że opis obiecuje rozwiązanie ważnego problemu), ale gdy sam sprawdziłem danego PR-a, okazał się być zbugowany lub nie rozwiązywał problemu, który rzekomo miał rozwiązywać. 😅
+
+    Dlatego tak ważne jest, abyś faktycznie przeczytał i uruchomił kod oraz napisał w komentarzu, że to zrobiłeś. 🤓
+
+* Jeśli PR można uprościć w jakiś sposób, możesz o to poprosić, ale nie ma potrzeby być zbyt wybrednym, może być wiele subiektywnych punktów widzenia (a ja też będę miał swój 🙈), więc lepiej żebyś skupił się na kluczowych rzeczach.
+
+### Testy
+
+* Pomóż mi sprawdzić, czy PR ma **testy**.
+
+* Sprawdź, czy testy **nie przechodzą** przed PR. 🚨
+
+* Następnie sprawdź, czy testy **przechodzą** po PR. ✅
+
+* Wiele PR-ów nie ma testów, możesz **przypomnieć** im o dodaniu testów, a nawet **zaproponować** samemu jakieś testy. To jedna z rzeczy, które pochłaniają najwięcej czasu i możesz w tym bardzo pomóc.
+
+* Następnie skomentuj również to, czego spróbowałeś, wtedy będę wiedział, że to sprawdziłeś. 🤓
+
+## Utwórz Pull Request
+
+Możesz [wnieść wkład](contributing.md){.internal-link target=_blank} do kodu źródłowego za pomocą Pull Requestu, na przykład:
+
+* Naprawić literówkę, którą znalazłeś w dokumentacji.
+* Podzielić się artykułem, filmem lub podcastem, który stworzyłeś lub znalazłeś na temat FastAPI, <a href="https://github.com/tiangolo/fastapi/edit/master/docs/en/data/external_links.yml" class="external-link" target="_blank">edytując ten plik</a>.
+    * Upewnij się, że dodajesz swój link na początku odpowiedniej sekcji.
+* Pomóc w [tłumaczeniu dokumentacji](contributing.md#translations){.internal-link target=_blank} na Twój język.
+    * Możesz również pomóc w weryfikacji tłumaczeń stworzonych przez innych.
+* Zaproponować nowe sekcje dokumentacji.
+* Naprawić istniejący problem/błąd.
+    * Upewnij się, że dodajesz testy.
+* Dodać nową funkcję.
+    * Upewnij się, że dodajesz testy.
+    * Upewnij się, że dodajesz dokumentację, jeśli jest to istotne.
+
+## Pomóż w utrzymaniu FastAPI
+
+Pomóż mi utrzymać **FastAPI**! 🤓
+
+Jest wiele pracy do zrobienia, a w większości przypadków **TY** możesz to zrobić.
+
+Główne zadania, które możesz wykonać teraz to:
+
+* [Pomóc innym z pytaniami na GitHubie](#help-others-with-questions-in-github){.internal-link target=_blank} (zobacz sekcję powyżej).
+* [Oceniać Pull Requesty](#review-pull-requests){.internal-link target=_blank} (zobacz sekcję powyżej).
+
+Te dwie czynności **zajmują najwięcej czasu**. To główna praca związana z utrzymaniem FastAPI.
+
+Jeśli możesz mi w tym pomóc, **pomożesz mi utrzymać FastAPI** i zapewnisz że będzie **rozwijać się szybciej i lepiej**. 🚀
+
+## Dołącz do czatu
+
+Dołącz do 👥 <a href="https://discord.gg/VQjSZaeJmf" class="external-link" target="_blank">serwera czatu na Discordzie</a> 👥 i spędzaj czas z innymi w społeczności FastAPI.
+
+!!! wskazówka
+    Jeśli masz pytania, zadaj je w <a href="https://github.com/tiangolo/fastapi/discussions/new?category=questions" class="external-link" target="_blank">Dyskusjach na GitHubie</a>, jest dużo większa szansa, że otrzymasz pomoc od [Ekspertów FastAPI](fastapi-people.md#experts){.internal-link target=_blank}.
+
+    Używaj czatu tylko do innych ogólnych rozmów.
+
+Istnieje również poprzedni <a href="https://gitter.im/tiangolo/fastapi" class="external-link" target="_blank">czat na Gitter</a>, ale ponieważ nie ma tam kanałów i zaawansowanych funkcji, rozmowy są trudniejsze, dlatego teraz zalecany jest Discord.
+
+### Nie zadawaj pytań na czacie
+
+Miej na uwadze, że ponieważ czaty pozwalają na bardziej "swobodną rozmowę", łatwo jest zadawać pytania, które są zbyt ogólne i trudniejsze do odpowiedzi, więc możesz nie otrzymać odpowiedzi.
+
+Na GitHubie szablon poprowadzi Cię do napisania odpowiedniego pytania, dzięki czemu łatwiej uzyskasz dobrą odpowiedź, a nawet rozwiążesz problem samodzielnie, zanim zapytasz. Ponadto na GitHubie mogę się upewnić, że zawsze odpowiadam na wszystko, nawet jeśli zajmuje to trochę czasu. Osobiście nie mogę tego zrobić z systemami czatu. 😅
+
+Rozmów w systemach czatu nie można tak łatwo przeszukiwać, jak na GitHubie, więc pytania i odpowiedzi mogą zaginąć w rozmowie. A tylko te na GitHubie liczą się do zostania [Ekspertem FastAPI](fastapi-people.md#experts){.internal-link target=_blank}, więc najprawdopodobniej otrzymasz więcej uwagi na GitHubie.
+
+Z drugiej strony w systemach czatu są tysiące użytkowników, więc jest duża szansa, że znajdziesz tam kogoś do rozmowy, prawie w każdej chwili. 😄
+
+## Wspieraj autora
+
+Możesz również finansowo wesprzeć autora (mnie) poprzez <a href="https://github.com/sponsors/tiangolo" class="external-link" target="_blank">sponsoring na GitHubie</a>.
+
+Tam możesz postawić mi kawę ☕️ aby podziękować. 😄
+
+Możesz także zostać srebrnym lub złotym sponsorem FastAPI. 🏅🎉
+
+## Wspieraj narzędzia, które napędzają FastAPI
+
+Jak widziałeś w dokumentacji, FastAPI stoi na ramionach gigantów, Starlette i Pydantic.
+
+Możesz również wesprzeć:
+
+* <a href="https://github.com/sponsors/samuelcolvin" class="external-link" target="_blank">Samuel Colvin (Pydantic)</a>
+* <a href="https://github.com/sponsors/encode" class="external-link" target="_blank">Encode (Starlette, Uvicorn)</a>
+
+---
+
+Dziękuję! 🚀

From 69a7c99b447c9ef103dc03e93d172cabd99ac832 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 22 Sep 2023 23:39:37 +0000
Subject: [PATCH 185/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2c27faa81..b026929d1 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Polish translation for `docs/pl/docs/help-fastapi.md`. PR [#10121](https://github.com/tiangolo/fastapi/pull/10121) by [@romabozhanovgithub](https://github.com/romabozhanovgithub).
 * 🌐 Add Russian translation for `docs/ru/docs/tutorial/header-params.md`. PR [#10226](https://github.com/tiangolo/fastapi/pull/10226) by [@AlertRED](https://github.com/AlertRED).
 * 🌐 Add Chinese translation for `docs/zh/docs/deployment/versions.md`. PR [#10276](https://github.com/tiangolo/fastapi/pull/10276) by [@xzmeng](https://github.com/xzmeng).
 * 🔧 Update sponsors, enable Svix (revert #10228). PR [#10253](https://github.com/tiangolo/fastapi/pull/10253) by [@tiangolo](https://github.com/tiangolo).

From cb410d301583ddf8cb3aadcb4cd57dc27ef47497 Mon Sep 17 00:00:00 2001
From: Aleksandr Andrukhov <drammtv@gmail.com>
Date: Tue, 26 Sep 2023 02:00:09 +0300
Subject: [PATCH 186/317] =?UTF-8?q?=F0=9F=8C=90=20Fix=20typo=20in=20Russia?=
 =?UTF-8?q?n=20translation=20for=20`docs/ru/docs/tutorial/body-fields.md`?=
 =?UTF-8?q?=20(#10224)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Vladislav Kramorenko <85196001+Xewus@users.noreply.github.com>
---
 docs/ru/docs/tutorial/body-fields.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/ru/docs/tutorial/body-fields.md b/docs/ru/docs/tutorial/body-fields.md
index 674b8bde4..2dc6c1e26 100644
--- a/docs/ru/docs/tutorial/body-fields.md
+++ b/docs/ru/docs/tutorial/body-fields.md
@@ -37,7 +37,7 @@
     {!> ../../../docs_src/body_fields/tutorial001.py!}
     ```
 
-Функция `Field` работает так же, как `Query`, `Path` и `Body`, у ее такие же параметры и т.д.
+Функция `Field` работает так же, как `Query`, `Path` и `Body`, у неё такие же параметры и т.д.
 
 !!! note "Технические детали"
     На самом деле, `Query`, `Path` и другие функции, которые вы увидите в дальнейшем, создают объекты подклассов общего класса `Param`, который сам по себе является подклассом `FieldInfo` из Pydantic.

From c75cdc6d9ac210513b8832c01b8f5fe4e4d278ab Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 25 Sep 2023 23:00:56 +0000
Subject: [PATCH 187/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b026929d1..033e73193 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Fix typo in Russian translation for `docs/ru/docs/tutorial/body-fields.md`. PR [#10224](https://github.com/tiangolo/fastapi/pull/10224) by [@AlertRED](https://github.com/AlertRED).
 * 🌐 Add Polish translation for `docs/pl/docs/help-fastapi.md`. PR [#10121](https://github.com/tiangolo/fastapi/pull/10121) by [@romabozhanovgithub](https://github.com/romabozhanovgithub).
 * 🌐 Add Russian translation for `docs/ru/docs/tutorial/header-params.md`. PR [#10226](https://github.com/tiangolo/fastapi/pull/10226) by [@AlertRED](https://github.com/AlertRED).
 * 🌐 Add Chinese translation for `docs/zh/docs/deployment/versions.md`. PR [#10276](https://github.com/tiangolo/fastapi/pull/10276) by [@xzmeng](https://github.com/xzmeng).

From 3106a3a50e7e3f9ef3a3c62c041010e4d395a8d9 Mon Sep 17 00:00:00 2001
From: Yusuke Tamura <62091034+tamtam-fitness@users.noreply.github.com>
Date: Tue, 26 Sep 2023 08:01:57 +0900
Subject: [PATCH 188/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Japanese=20transla?=
 =?UTF-8?q?tion=20for=20`docs/ja/docs/deployment/https.md`=20(#10298)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
 docs/ja/docs/deployment/https.md | 200 +++++++++++++++++++++++++++++++
 1 file changed, 200 insertions(+)
 create mode 100644 docs/ja/docs/deployment/https.md

diff --git a/docs/ja/docs/deployment/https.md b/docs/ja/docs/deployment/https.md
new file mode 100644
index 000000000..a291f870f
--- /dev/null
+++ b/docs/ja/docs/deployment/https.md
@@ -0,0 +1,200 @@
+# HTTPS について
+
+HTTPSは単に「有効」か「無効」かで決まるものだと思いがちです。
+
+しかし、それよりもはるかに複雑です。
+
+!!! tip
+    もし急いでいたり、HTTPSの仕組みについて気にしないのであれば、次のセクションに進み、さまざまなテクニックを使ってすべてをセットアップするステップ・バイ・ステップの手順をご覧ください。
+
+利用者の視点から **HTTPS の基本を学ぶ**に当たっては、次のリソースをオススメします: <a href="https://howhttps.works/" class="external-link" target="_blank">https://howhttps.works/</a>.
+
+さて、**開発者の視点**から、HTTPSについて考える際に念頭に置くべきことをいくつかみていきましょう：
+
+* HTTPSの場合、**サーバ**は**第三者**によって生成された**「証明書」を持つ**必要があります。
+    * これらの証明書は「生成」されたものではなく、実際には第三者から**取得**されたものです。
+* 証明書には**有効期限**があります。
+    * つまりいずれ失効します。
+    * そのため**更新**をし、第三者から**再度取得**する必要があります。
+* 接続の暗号化は**TCPレベル**で行われます。
+    * それは**HTTPの1つ下**のレイヤーです。
+    * つまり、**証明書と暗号化**の処理は、**HTTPの前**に行われます。
+* **TCPは "ドメイン "について知りません**。IPアドレスについてのみ知っています。
+    * 要求された**特定のドメイン**に関する情報は、**HTTPデータ**に入ります。
+* **HTTPS証明書**は、**特定のドメイン**を「証明」しますが、プロトコルと暗号化はTCPレベルで行われ、どのドメインが扱われているかを**知る前**に行われます。
+* **デフォルトでは**、**IPアドレスごとに1つのHTTPS証明書**しか持てないことになります。
+    * これは、サーバーの規模やアプリケーションの規模に寄りません。
+    * しかし、これには**解決策**があります。
+* **TLS**プロトコル(HTTPの前に、TCPレベルで暗号化を処理するもの)には、**<a href="https://en.wikipedia.org/wiki/Server_Name_Indication" class="external-link" target="_blank"><abbr title="サーバー名表示">SNI</abbr></a>**と呼ばれる**拡張**があります。
+    * このSNI拡張機能により、1つのサーバー（**単一のIPアドレス**を持つ）が**複数のHTTPS証明書**を持ち、**複数のHTTPSドメイン/アプリケーション**にサービスを提供できるようになります。
+    * これが機能するためには、**パブリックIPアドレス**でリッスンしている、サーバー上で動作している**単一の**コンポーネント(プログラム)が、サーバー内の**すべてのHTTPS証明書**を持っている必要があります。
+
+* セキュアな接続を取得した**後**でも、通信プロトコルは**HTTPのまま**です。
+    * コンテンツは**HTTPプロトコル**で送信されているにもかかわらず、**暗号化**されています。
+
+
+サーバー（マシン、ホストなど）上で**1つのプログラム/HTTPサーバー**を実行させ、**HTTPSに関する全てのこと**を管理するのが一般的です。
+
+**暗号化された HTTPS リクエスト** を受信し、**復号化された HTTP リクエスト** を同じサーバーで実行されている実際の HTTP アプリケーション（この場合は **FastAPI** アプリケーション）に送信し、アプリケーションから **HTTP レスポンス** を受け取り、適切な **HTTPS 証明書** を使用して **暗号化** し、そして**HTTPS** を使用してクライアントに送り返します。
+
+このサーバーはしばしば **<a href="https://en.wikipedia.org/wiki/TLS_termination_proxy" class="external-link" target="_blank">TLS Termination Proxy</a>**と呼ばれます。
+
+TLS Termination Proxyとして使えるオプションには、以下のようなものがあります：
+
+* Traefik（証明書の更新も対応）
+* Caddy (証明書の更新も対応)
+* Nginx
+* HAProxy
+
+
+## Let's Encrypt
+
+Let's Encrypt以前は、これらの**HTTPS証明書**は信頼できる第三者によって販売されていました。
+
+これらの証明書を取得するための手続きは面倒で、かなりの書類を必要とし、証明書はかなり高価なものでした。
+
+しかしその後、**<a href="https://letsencrypt.org/" class="external-link" target="_blank">Let's Encrypt</a>** が作られました。
+
+これはLinux Foundationのプロジェクトから生まれたものです。 自動化された方法で、**HTTPS証明書を無料で**提供します。これらの証明書は、すべての標準的な暗号化セキュリティを使用し、また短命（約3ヶ月）ですが、こういった寿命の短さによって、**セキュリティは実際に優れています**。
+
+ドメインは安全に検証され、証明書は自動的に生成されます。また、証明書の更新も自動化されます。
+
+このアイデアは、これらの証明書の取得と更新を自動化することで、**安全なHTTPSを、無料で、永遠に**利用できるようにすることです。
+
+## 開発者のための HTTPS
+
+ここでは、HTTPS APIがどのように見えるかの例を、主に開発者にとって重要なアイデアに注意を払いながら、ステップ・バイ・ステップで説明します。
+
+### ドメイン名
+
+ステップの初めは、**ドメイン名**を**取得すること**から始まるでしょう。その後、DNSサーバー（おそらく同じクラウドプロバイダー）に設定します。
+
+おそらくクラウドサーバー（仮想マシン）かそれに類するものを手に入れ、<abbr title="変わらない">固定の</abbr> **パブリックIPアドレス**を持つことになるでしょう。
+
+DNSサーバーでは、**取得したドメイン**をあなたのサーバーのパプリック**IPアドレス**に向けるレコード（「`Aレコード`」）を設定します。
+
+これはおそらく、最初の1回だけあり、すべてをセットアップするときに行うでしょう。
+
+!!! tip
+    ドメイン名の話はHTTPSに関する話のはるか前にありますが、すべてがドメインとIPアドレスに依存するため、ここで言及する価値があります。
+
+### DNS
+
+では、実際のHTTPSの部分に注目してみよう。
+
+まず、ブラウザは**DNSサーバー**に**ドメインに対するIP**が何であるかを確認します。今回は、`someapp.example.com`とします。
+
+DNSサーバーは、ブラウザに特定の**IPアドレス**を使用するように指示します。このIPアドレスは、DNSサーバーで設定した、あなたのサーバーが使用するパブリックIPアドレスになります。
+
+<img src="/img/deployment/https/https01.svg">
+
+### TLS Handshake の開始
+
+ブラウザはIPアドレスと**ポート443**（HTTPSポート）で通信します。
+
+通信の最初の部分は、クライアントとサーバー間の接続を確立し、使用する暗号鍵などを決めるだけです。
+
+<img src="/img/deployment/https/https02.svg">
+
+TLS接続を確立するためのクライアントとサーバー間のこのやりとりは、**TLSハンドシェイク**と呼ばれます。
+
+### SNI拡張機能付きのTLS
+
+サーバー内の**1つのプロセス**だけが、特定 の**IPアドレス**の特定の**ポート** で待ち受けることができます。
+
+同じIPアドレスの他のポートで他のプロセスがリッスンしている可能性もありますが、IPアドレスとポートの組み合わせごとに1つだけです。
+
+TLS（HTTPS）はデフォルトで`443`という特定のポートを使用する。つまり、これが必要なポートです。
+
+このポートをリッスンできるのは1つのプロセスだけなので、これを実行するプロセスは**TLS Termination Proxy**となります。
+
+TLS Termination Proxyは、1つ以上の**TLS証明書**（HTTPS証明書）にアクセスできます。
+
+前述した**SNI拡張機能**を使用して、TLS Termination Proxy は、利用可能なTLS (HTTPS)証明書のどれを接続先として使用すべきかをチェックし、クライアントが期待するドメインに一致するものを使用します。
+
+今回は、`someapp.example.com`の証明書を使うことになります。
+
+<img src="/img/deployment/https/https03.svg">
+
+クライアントは、そのTLS証明書を生成したエンティティ（この場合はLet's Encryptですが、これについては後述します）をすでに**信頼**しているため、その証明書が有効であることを**検証**することができます。
+
+次に証明書を使用して、クライアントとTLS Termination Proxy は、 **TCP通信**の残りを**どのように暗号化するかを決定**します。これで**TLSハンドシェイク**の部分が完了します。
+
+この後、クライアントとサーバーは**暗号化されたTCP接続**を持ちます。そして、その接続を使って実際の**HTTP通信**を開始することができます。
+
+これが**HTTPS**であり、純粋な（暗号化されていない）TCP接続ではなく、**セキュアなTLS接続**の中に**HTTP**があるだけです。
+
+!!! tip
+    通信の暗号化は、HTTPレベルではなく、**TCPレベル**で行われることに注意してください。
+
+### HTTPS リクエスト
+
+これでクライアントとサーバー（具体的にはブラウザとTLS Termination Proxy）は**暗号化されたTCP接続**を持つことになり、**HTTP通信**を開始することができます。
+
+そこで、クライアントは**HTTPSリクエスト**を送信します。これは、暗号化されたTLSコネクションを介した単なるHTTPリクエストです。
+
+<img src="/img/deployment/https/https04.svg">
+
+### リクエストの復号化
+
+TLS Termination Proxy は、合意が取れている暗号化を使用して、**リクエストを復号化**し、**プレーン (復号化された) HTTP リクエスト** をアプリケーションを実行しているプロセス (例えば、FastAPI アプリケーションを実行している Uvicorn を持つプロセス) に送信します。
+
+<img src="/img/deployment/https/https05.svg">
+
+### HTTP レスポンス
+
+アプリケーションはリクエストを処理し、**プレーン(暗号化されていない)HTTPレスポンス** をTLS Termination Proxyに送信します。
+
+<img src="/img/deployment/https/https06.svg">
+
+### HTTPS レスポンス
+
+TLS Termination Proxyは次に、事前に合意が取れている暗号(`someapp.example.com`の証明書から始まる)を使って**レスポンスを暗号化し**、ブラウザに送り返す。
+
+その後ブラウザでは、レスポンスが有効で正しい暗号キーで暗号化されていることなどを検証します。そして、ブラウザはレスポンスを**復号化**して処理します。
+
+<img src="/img/deployment/https/https07.svg">
+
+クライアント（ブラウザ）は、レスポンスが正しいサーバーから来たことを知ることができます。 なぜなら、そのサーバーは、以前に**HTTPS証明書**を使って合意した暗号を使っているからです。
+
+### 複数のアプリケーション
+
+同じサーバー（または複数のサーバー）に、例えば他のAPIプログラムやデータベースなど、**複数のアプリケーション**が存在する可能性があります。
+
+特定のIPとポート（この例ではTLS Termination Proxy）を扱うことができるのは1つのプロセスだけですが、他のアプリケーション/プロセスも、同じ**パブリックIPとポート**の組み合わせを使用しようとしない限り、サーバー上で実行することができます。
+
+<img src="/img/deployment/https/https08.svg">
+
+そうすれば、TLS Termination Proxy は、**複数のドメイン**や複数のアプリケーションのHTTPSと証明書を処理し、それぞれのケースで適切なアプリケーションにリクエストを送信することができます。
+
+### 証明書の更新
+
+将来のある時点で、各証明書は（取得後約3ヶ月で）**失効**します。
+
+その後、Let's Encryptと通信する別のプログラム（別のプログラムである場合もあれば、同じTLS Termination Proxyである場合もある）によって、証明書を更新します。
+
+<img src="/img/deployment/https/https.svg">
+
+**TLS証明書**は、IPアドレスではなく、**ドメイン名に関連付けられて**います。
+
+したがって、証明書を更新するために、更新プログラムは、認証局（Let's Encrypt）に対して、**そのドメインが本当に「所有」し、管理している**ことを**証明**する必要があります。
+
+そのために、またさまざまなアプリケーションのニーズに対応するために、いくつかの方法があります。よく使われる方法としては:
+
+* **いくつかのDNSレコードを修正します。**
+    * これをするためには、更新プログラムはDNSプロバイダーのAPIをサポートする必要があります。したがって、使用しているDNSプロバイダーによっては、このオプションが使える場合もあれば、使えない場合もあります。
+* ドメインに関連付けられたパブリックIPアドレス上で、（少なくとも証明書取得プロセス中は）**サーバー**として実行します。
+    * 上で述べたように、特定のIPとポートでリッスンできるプロセスは1つだけです。
+    * これは、同じTLS Termination Proxyが証明書の更新処理も行う場合に非常に便利な理由の1つです。
+    * そうでなければ、TLS Termination Proxyを一時的に停止し、証明書を取得するために更新プログラムを起動し、TLS Termination Proxyで証明書を設定し、TLS Termination Proxyを再起動しなければならないかもしれません。TLS Termination Proxyが停止している間はアプリが利用できなくなるため、これは理想的ではありません。
+
+
+アプリを提供しながらこのような更新処理を行うことは、アプリケーション・サーバー（Uvicornなど）でTLS証明書を直接使用するのではなく、TLS Termination Proxyを使用して**HTTPSを処理する別のシステム**を用意したくなる主な理由の1つです。
+
+## まとめ
+
+**HTTPS**を持つことは非常に重要であり、ほとんどの場合、かなり**クリティカル**です。開発者として HTTPS に関わる労力のほとんどは、これらの**概念とその仕組みを理解する**ことです。
+
+しかし、ひとたび**開発者向けHTTPS**の基本的な情報を知れば、簡単な方法ですべてを管理するために、さまざまなツールを組み合わせて設定することができます。
+
+次の章では、**FastAPI** アプリケーションのために **HTTPS** をセットアップする方法について、いくつかの具体例を紹介します。🔒

From 14e0914fcf7275f8de40c8df586350349b30f443 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 25 Sep 2023 23:02:43 +0000
Subject: [PATCH 189/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 033e73193..4c6d8e288 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Japanese translation for `docs/ja/docs/deployment/https.md`. PR [#10298](https://github.com/tiangolo/fastapi/pull/10298) by [@tamtam-fitness](https://github.com/tamtam-fitness).
 * 🌐 Fix typo in Russian translation for `docs/ru/docs/tutorial/body-fields.md`. PR [#10224](https://github.com/tiangolo/fastapi/pull/10224) by [@AlertRED](https://github.com/AlertRED).
 * 🌐 Add Polish translation for `docs/pl/docs/help-fastapi.md`. PR [#10121](https://github.com/tiangolo/fastapi/pull/10121) by [@romabozhanovgithub](https://github.com/romabozhanovgithub).
 * 🌐 Add Russian translation for `docs/ru/docs/tutorial/header-params.md`. PR [#10226](https://github.com/tiangolo/fastapi/pull/10226) by [@AlertRED](https://github.com/AlertRED).

From c89549c7037d6f9cc3a9535b22afbceaa0aae354 Mon Sep 17 00:00:00 2001
From: Sion Shin <82511301+Sion99@users.noreply.github.com>
Date: Tue, 26 Sep 2023 08:02:59 +0900
Subject: [PATCH 190/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translati?=
 =?UTF-8?q?on=20for=20`docs/ko/docs/deployment/cloud.md`=20(#10191)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Joona Yoon <joonas-yoon@users.noreply.github.com>
---
 docs/ko/docs/deployment/cloud.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 docs/ko/docs/deployment/cloud.md

diff --git a/docs/ko/docs/deployment/cloud.md b/docs/ko/docs/deployment/cloud.md
new file mode 100644
index 000000000..f2b965a91
--- /dev/null
+++ b/docs/ko/docs/deployment/cloud.md
@@ -0,0 +1,17 @@
+# FastAPI를 클라우드 제공업체에서 배포하기
+
+사실상 거의 **모든 클라우드 제공업체**를 사용하여 여러분의 FastAPI 애플리케이션을 배포할 수 있습니다.
+
+대부분의 경우, 주요 클라우드 제공업체에서는 FastAPI를 배포할 수 있도록 가이드를 제공합니다.
+
+## 클라우드 제공업체 - 후원자들
+
+몇몇 클라우드 제공업체들은 [**FastAPI를 후원하며**](../help-fastapi.md#sponsor-the-author){.internal-link target=_blank} ✨, 이를 통해 FastAPI와 FastAPI **생태계**가 지속적이고 건전한 **발전**을 할 수 있습니다.
+
+이는 FastAPI와 **커뮤니티** (여러분)에 대한 진정한 헌신을 보여줍니다. 그들은 여러분에게 **좋은 서비스**를 제공할 뿐 만이 아니라 여러분이 **훌륭하고 건강한 프레임워크인** FastAPI 를 사용하길 원하기 때문입니다. 🙇
+
+아래와 같은 서비스를 사용해보고 각 서비스의 가이드를 따를 수도 있습니다:
+
+* <a href="https://docs.platform.sh/languages/python.html?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023" class="external-link" target="_blank">Platform.sh</a>
+* <a href="https://docs.porter.run/language-specific-guides/fastapi" class="external-link" target="_blank">Porter</a>
+* <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Deta</a>

From 255e743f98ecb89482705424a8f73079ace2a93a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 25 Sep 2023 23:05:48 +0000
Subject: [PATCH 191/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 4c6d8e288..feb72f444 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Korean translation for `docs/ko/docs/deployment/cloud.md`. PR [#10191](https://github.com/tiangolo/fastapi/pull/10191) by [@Sion99](https://github.com/Sion99).
 * 🌐 Add Japanese translation for `docs/ja/docs/deployment/https.md`. PR [#10298](https://github.com/tiangolo/fastapi/pull/10298) by [@tamtam-fitness](https://github.com/tamtam-fitness).
 * 🌐 Fix typo in Russian translation for `docs/ru/docs/tutorial/body-fields.md`. PR [#10224](https://github.com/tiangolo/fastapi/pull/10224) by [@AlertRED](https://github.com/AlertRED).
 * 🌐 Add Polish translation for `docs/pl/docs/help-fastapi.md`. PR [#10121](https://github.com/tiangolo/fastapi/pull/10121) by [@romabozhanovgithub](https://github.com/romabozhanovgithub).

From 0e2ca1cacb0a6e7bf88476a85bd3c9bb1278f009 Mon Sep 17 00:00:00 2001
From: jaystone776 <jilei776@gmail.com>
Date: Tue, 26 Sep 2023 07:06:09 +0800
Subject: [PATCH 192/317] =?UTF-8?q?=F0=9F=8C=90=20Update=20Chinese=20trans?=
 =?UTF-8?q?lation=20for=20`docs/tutorial/security/simple-oauth2.md`=20(#38?=
 =?UTF-8?q?44)?=
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>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
 .../docs/tutorial/security/simple-oauth2.md   | 214 +++++++++---------
 1 file changed, 111 insertions(+), 103 deletions(-)

diff --git a/docs/zh/docs/tutorial/security/simple-oauth2.md b/docs/zh/docs/tutorial/security/simple-oauth2.md
index 276f3d63b..c7f46177f 100644
--- a/docs/zh/docs/tutorial/security/simple-oauth2.md
+++ b/docs/zh/docs/tutorial/security/simple-oauth2.md
@@ -1,94 +1,98 @@
-# 使用密码和 Bearer 的简单 OAuth2
+# OAuth2 实现简单的 Password 和 Bearer 验证
 
-现在让我们接着上一章继续开发，并添加缺少的部分以实现一个完整的安全性流程。
+本章添加上一章示例中欠缺的部分，实现完整的安全流。
 
 ## 获取 `username` 和 `password`
 
-我们将使用 **FastAPI** 的安全性实用工具来获取 `username` 和 `password`。
+首先，使用 **FastAPI** 安全工具获取 `username` 和 `password`。
 
-OAuth2 规定在使用（我们打算用的）「password 流程」时，客户端/用户必须将 `username` 和 `password` 字段作为表单数据发送。
+OAuth2 规范要求使用**密码流**时，客户端或用户必须以表单数据形式发送 `username` 和 `password` 字段。
 
-而且规范明确了字段必须这样命名。因此 `user-name` 或 `email` 是行不通的。
+并且，这两个字段必须命名为 `username` 和 `password` ，不能使用 `user-name` 或 `email` 等其它名称。
 
-不过不用担心，你可以在前端按照你的想法将它展示给最终用户。
+不过也不用担心，前端仍可以显示终端用户所需的名称。
 
-而且你的数据库模型也可以使用你想用的任何其他名称。
+数据库模型也可以使用所需的名称。
 
-但是对于登录*路径操作*，我们需要使用这些名称来与规范兼容（以具备例如使用集成的 API 文档系统的能力）。
+但对于登录*路径操作*，则要使用兼容规范的 `username` 和 `password`，（例如，实现与 API 文档集成）。
 
-规范还写明了 `username` 和 `password` 必须作为表单数据发送（因此，此处不能使用 JSON）。
+该规范要求必须以表单数据形式发送 `username` 和 `password`，因此，不能使用 JSON 对象。
 
-### `scope`
+### `Scope`（作用域）
 
-规范还提到客户端可以发送另一个表单字段「`scope`」。
+OAuth2 还支持客户端发送**`scope`**表单字段。
 
-这个表单字段的名称为 `scope`（单数形式），但实际上它是一个由空格分隔的「作用域」组成的长字符串。
+虽然表单字段的名称是 `scope`（单数），但实际上，它是以空格分隔的，由多个**scope**组成的长字符串。
 
-每个「作用域」只是一个字符串（中间没有空格）。
+**作用域**只是不带空格的字符串。
 
-它们通常用于声明特定的安全权限，例如：
+常用于声明指定安全权限，例如：
 
-* `users:read` 或者 `users:write` 是常见的例子。
-* Facebook / Instagram 使用 `instagram_basic`。
-* Google 使用了 `https://www.googleapis.com/auth/drive` 。
+* 常见用例为，`users:read` 或 `users:write`
+* 脸书和 Instagram 使用 `instagram_basic`
+* 谷歌使用 `https://www.googleapis.com/auth/drive`
 
-!!! info
-    在 OAuth2 中「作用域」只是一个声明所需特定权限的字符串。
+!!! info "说明"
 
-    它有没有 `:` 这样的其他字符或者是不是 URL 都没有关系。
+    OAuth2 中，**作用域**只是声明指定权限的字符串。
 
-    这些细节是具体的实现。
+    是否使用冒号 `:` 等符号，或是不是 URL 并不重要。
 
-    对 OAuth2 来说它们就只是字符串而已。
+    这些细节只是特定的实现方式。
+
+    对 OAuth2 来说，都只是字符串而已。
 
 ## 获取 `username` 和 `password` 的代码
 
-现在，让我们使用 **FastAPI** 提供的实用工具来处理此问题。
+接下来，使用 **FastAPI** 工具获取用户名与密码。
 
 ### `OAuth2PasswordRequestForm`
 
-首先，导入 `OAuth2PasswordRequestForm`，然后在 `token` 的*路径操作*中通过 `Depends` 将其作为依赖项使用。
+首先，导入 `OAuth2PasswordRequestForm`，然后，在 `/token` *路径操作* 中，用 `Depends` 把该类作为依赖项。
 
 ```Python hl_lines="4  76"
 {!../../../docs_src/security/tutorial003.py!}
 ```
 
-`OAuth2PasswordRequestForm` 是一个类依赖项，声明了如下的请求表单：
+`OAuth2PasswordRequestForm` 是用以下几项内容声明表单请求体的类依赖项：
+
+* `username`
+* `password`
+* 可选的 `scope` 字段，由多个空格分隔的字符串组成的长字符串
+* 可选的 `grant_type`
 
-* `username`。
-* `password`。
-* 一个可选的 `scope` 字段，是一个由空格分隔的字符串组成的大字符串。
-* 一个可选的 `grant_type`.
+!!! tip "提示"
 
-!!! tip
-    OAuth2 规范实际上*要求* `grant_type` 字段使用一个固定的值 `password`，但是 `OAuth2PasswordRequestForm` 没有作强制约束。
+    实际上，OAuth2 规范*要求* `grant_type` 字段使用固定值 `password`，但 `OAuth2PasswordRequestForm` 没有作强制约束。
 
-    如果你需要强制要求这一点，请使用 `OAuth2PasswordRequestFormStrict` 而不是 `OAuth2PasswordRequestForm`。
+    如需强制使用固定值 `password`，则不要用 `OAuth2PasswordRequestForm`，而是用 `OAuth2PasswordRequestFormStrict`。
 
-* 一个可选的 `client_id`（我们的示例不需要它）。
-* 一个可选的 `client_secret`（我们的示例不需要它）。
+* 可选的 `client_id`（本例未使用）
+* 可选的 `client_secret`（本例未使用）
 
-!!! info
-    `OAuth2PasswordRequestForm` 并不像 `OAuth2PasswordBearer` 一样是 FastAPI 的一个特殊的类。
+!!! info "说明"
 
-    `OAuth2PasswordBearer` 使得 **FastAPI** 明白它是一个安全方案。所以它得以通过这种方式添加到 OpenAPI 中。
+    `OAuth2PasswordRequestForm` 与 `OAuth2PasswordBearer` 一样，都不是 FastAPI 的特殊类。
 
-    但 `OAuth2PasswordRequestForm` 只是一个你可以自己编写的类依赖项，或者你也可以直接声明 `Form` 参数。
+    **FastAPI** 把 `OAuth2PasswordBearer` 识别为安全方案。因此，可以通过这种方式把它添加至 OpenAPI。
 
-    但是由于这是一种常见的使用场景，因此 FastAPI 出于简便直接提供了它。
+    但 `OAuth2PasswordRequestForm` 只是可以自行编写的类依赖项，也可以直接声明 `Form` 参数。
+
+    但由于这种用例很常见，FastAPI 为了简便，就直接提供了对它的支持。
 
 ### 使用表单数据
 
-!!! tip
-    类依赖项 `OAuth2PasswordRequestForm` 的实例不会有用空格分隔的长字符串属性 `scope`，而是具有一个 `scopes` 属性，该属性将包含实际被发送的每个作用域字符串组成的列表。
+!!! tip "提示"
+
+    `OAuth2PasswordRequestForm` 类依赖项的实例没有以空格分隔的长字符串属性 `scope`，但它支持 `scopes` 属性，由已发送的 scope 字符串列表组成。
 
-    在此示例中我们没有使用 `scopes`，但如果你需要的话可以使用该功能。
+    本例没有使用 `scopes`，但开发者也可以根据需要使用该属性。
 
-现在，使用表单字段中的 `username` 从（伪）数据库中获取用户数据。
+现在，即可使用表单字段 `username`，从（伪）数据库中获取用户数据。
 
-如果没有这个用户，我们将返回一个错误消息，提示「用户名或密码错误」。
+如果不存在指定用户，则返回错误消息，提示**用户名或密码错误**。
 
-对于这个错误，我们使用 `HTTPException` 异常：
+本例使用 `HTTPException` 异常显示此错误：
 
 ```Python hl_lines="3  77-79"
 {!../../../docs_src/security/tutorial003.py!}
@@ -96,27 +100,27 @@ OAuth2 规定在使用（我们打算用的）「password 流程」时，客户
 
 ### 校验密码
 
-目前我们已经从数据库中获取了用户数据，但尚未校验密码。
+至此，我们已经从数据库中获取了用户数据，但尚未校验密码。
 
-让我们首先将这些数据放入 Pydantic `UserInDB` 模型中。
+接下来，首先将数据放入 Pydantic 的 `UserInDB` 模型。
 
-永远不要保存明文密码，因此，我们将使用（伪）哈希密码系统。
+注意：永远不要保存明文密码，本例暂时先使用（伪）哈希密码系统。
 
-如果密码不匹配，我们将返回同一个错误。
+如果密码不匹配，则返回与上面相同的错误。
 
-#### 哈希密码
+#### 密码哈希
 
-「哈希」的意思是：将某些内容（在本例中为密码）转换为看起来像乱码的字节序列（只是一个字符串）。
+**哈希**是指，将指定内容（本例中为密码）转换为形似乱码的字节序列（其实就是字符串）。
 
-每次你传入完全相同的内容（完全相同的密码）时，你都会得到完全相同的乱码。
+每次传入完全相同的内容（比如，完全相同的密码）时，得到的都是完全相同的乱码。
 
-但是你不能从乱码转换回密码。
+但这个乱码无法转换回传入的密码。
 
-##### 为什么使用哈希密码
+##### 为什么使用密码哈希
 
-如果你的数据库被盗，小偷将无法获得用户的明文密码，只有哈希值。
+原因很简单，假如数据库被盗，窃贼无法获取用户的明文密码，得到的只是哈希值。
 
-因此，小偷将无法尝试在另一个系统中使用这些相同的密码（由于许多用户在任何地方都使用相同的密码，因此这很危险）。
+这样一来，窃贼就无法在其它应用中使用窃取的密码，要知道，很多用户在所有系统中都使用相同的密码，风险超大。
 
 ```Python hl_lines="80-83"
 {!../../../docs_src/security/tutorial003.py!}
@@ -124,9 +128,9 @@ OAuth2 规定在使用（我们打算用的）「password 流程」时，客户
 
 #### 关于 `**user_dict`
 
-`UserInDB(**user_dict)` 表示：
+`UserInDB(**user_dict)` 是指：
 
-*直接将 `user_dict` 的键和值作为关键字参数传递，等同于：*
+*直接把 `user_dict` 的键与值当作关键字参数传递，等效于：*
 
 ```Python
 UserInDB(
@@ -138,75 +142,79 @@ UserInDB(
 )
 ```
 
-!!! info
-    有关 `user_dict` 的更完整说明，请参阅[**额外的模型**文档](../extra-models.md#about-user_indict){.internal-link target=_blank}。
+!!! info "说明"
 
-## 返回令牌
+    `user_dict` 的说明，详见[**更多模型**一章](../extra-models.md#about-user_indict){.internal-link target=_blank}。
 
-`token` 端点的响应必须是一个 JSON 对象。
+## 返回 Token
 
-它应该有一个 `token_type`。在我们的例子中，由于我们使用的是「Bearer」令牌，因此令牌类型应为「`bearer`」。
+`token` 端点的响应必须是 JSON 对象。
 
-并且还应该有一个 `access_token` 字段，它是一个包含我们的访问令牌的字符串。
+响应返回的内容应该包含 `token_type`。本例中用的是**Bearer**Token，因此， Token 类型应为**`bearer`**。
 
-对于这个简单的示例，我们将极其不安全地返回相同的 `username` 作为令牌。
+返回内容还应包含 `access_token` 字段，它是包含权限 Token 的字符串。
 
-!!! tip
-    在下一章中，你将看到一个真实的安全实现，使用了哈希密码和 <abbr title="JSON Web Tokens">JWT</abbr> 令牌。
+本例只是简单的演示，返回的 Token 就是 `username`，但这种方式极不安全。
 
-    但现在，让我们仅关注我们需要的特定细节。
+!!! tip "提示"
+
+    下一章介绍使用哈希密码和 <abbr title="JSON Web Tokens">JWT</abbr> Token 的真正安全机制。
+
+    但现在，仅关注所需的特定细节。
 
 ```Python hl_lines="85"
 {!../../../docs_src/security/tutorial003.py!}
 ```
 
-!!! tip
-    根据规范，你应该像本示例一样，返回一个带有 `access_token` 和 `token_type` 的 JSON。
+!!! tip "提示"
 
-    这是你必须在代码中自行完成的工作，并且要确保使用了这些 JSON 字段。
+    按规范的要求，应像本示例一样，返回带有 `access_token` 和 `token_type` 的 JSON 对象。
 
-    这几乎是唯一的你需要自己记住并正确地执行以符合规范的事情。
+    这是开发者必须在代码中自行完成的工作，并且要确保使用这些 JSON 的键。
 
-    其余的，**FastAPI** 都会为你处理。
+    这几乎是唯一需要开发者牢记在心，并按规范要求正确执行的事。
+
+    **FastAPI** 则负责处理其它的工作。
 
 ## 更新依赖项
 
-现在我们将更新我们的依赖项。
+接下来，更新依赖项。
 
-我们想要仅当此用户处于启用状态时才能获取 `current_user`。
+使之仅在当前用户为激活状态时，才能获取 `current_user`。
 
-因此，我们创建了一个额外的依赖项 `get_current_active_user`，而该依赖项又以 `get_current_user` 作为依赖项。
+为此，要再创建一个依赖项 `get_current_active_user`，此依赖项以 `get_current_user` 依赖项为基础。
 
-如果用户不存在或处于未启用状态，则这两个依赖项都将仅返回 HTTP 错误。
+如果用户不存在，或状态为未激活，这两个依赖项都会返回 HTTP 错误。
 
-因此，在我们的端点中，只有当用户存在，身份认证通过且处于启用状态时，我们才能获得该用户：
+因此，在端点中，只有当用户存在、通过身份验证、且状态为激活时，才能获得该用户：
 
 ```Python hl_lines="58-67  69-72  90"
 {!../../../docs_src/security/tutorial003.py!}
 ```
 
-!!! info
-    我们在此处返回的值为 `Bearer` 的额外响应头 `WWW-Authenticate` 也是规范的一部分。
+!!! info "说明"
+
+    此处返回值为 `Bearer` 的响应头 `WWW-Authenticate` 也是规范的一部分。
 
-    任何的 401「未认证」HTTP（错误）状态码都应该返回 `WWW-Authenticate` 响应头。
+    任何 401**UNAUTHORIZED**HTTP（错误）状态码都应返回 `WWW-Authenticate` 响应头。
 
-    对于 bearer 令牌（我们的例子），该响应头的值应为 `Bearer`。
+    本例中，因为使用的是 Bearer Token，该响应头的值应为 `Bearer`。
 
-    实际上你可以忽略这个额外的响应头，不会有什么问题。
+    实际上，忽略这个附加响应头，也不会有什么问题。
 
-    但此处提供了它以符合规范。
+    之所以在此提供这个附加响应头，是为了符合规范的要求。
 
-    而且，（现在或将来）可能会有工具期望得到并使用它，然后对你或你的用户有用处。
+    说不定什么时候，就有工具用得上它，而且，开发者或用户也可能用得上。
 
-    这就是遵循标准的好处...
+    这就是遵循标准的好处……
 
 ## 实际效果
 
-打开交互式文档：<a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>。
+打开 API 文档：<a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>。
 
-### 身份认证
+### 身份验证
 
-点击「Authorize」按钮。
+点击**Authorize**按钮。
 
 使用以下凭证：
 
@@ -216,15 +224,15 @@ UserInDB(
 
 <img src="https://fastapi.tiangolo.com/img/tutorial/security/image04.png">
 
-在系统中进行身份认证后，你将看到：
+通过身份验证后，显示下图所示的内容：
 
 <img src="https://fastapi.tiangolo.com/img/tutorial/security/image05.png">
 
-### 获取本人的用户数据
+### 获取当前用户数据
 
-现在执行 `/users/me` 路径的 `GET` 操作。
+使用 `/users/me` 路径的 `GET` 操作。
 
-你将获得你的用户数据，如：
+可以提取如下当前用户数据：
 
 ```JSON
 {
@@ -238,7 +246,7 @@ UserInDB(
 
 <img src="https://fastapi.tiangolo.com/img/tutorial/security/image06.png">
 
-如果你点击锁定图标并注销，然后再次尝试同一操作，则会得到 HTTP 401 错误：
+点击小锁图标，注销后，再执行同样的操作，则会得到 HTTP 401 错误：
 
 ```JSON
 {
@@ -246,17 +254,17 @@ UserInDB(
 }
 ```
 
-### 未启用的用户
+### 未激活用户
 
-现在尝试使用未启用的用户，并通过以下方式进行身份认证：
+测试未激活用户，输入以下信息，进行身份验证：
 
 用户名：`alice`
 
 密码：`secret2`
 
-然后尝试执行 `/users/me` 路径的 `GET` 操作。
+然后，执行 `/users/me` 路径的 `GET` 操作。
 
-你将得到一个「未启用的用户」错误，如：
+显示下列**未激活用户**错误信息：
 
 ```JSON
 {
@@ -264,12 +272,12 @@ UserInDB(
 }
 ```
 
-## 总结
+## 小结
 
-现在你掌握了为你的 API 实现一个基于 `username` 和 `password` 的完整安全系统的工具。
+使用本章的工具实现基于 `username` 和 `password` 的完整 API 安全系统。
 
-使用这些工具，你可以使安全系统与任何数据库以及任何用户或数据模型兼容。
+这些工具让安全系统兼容任何数据库、用户及数据模型。
 
-唯一缺少的细节是它实际上还并不「安全」。
+唯一欠缺的是，它仍然不是真的**安全**。
 
-在下一章中，你将看到如何使用一个安全的哈希密码库和 <abbr title="JSON Web Tokens">JWT</abbr> 令牌。
+下一章，介绍使用密码哈希支持库与 <abbr title="JSON Web Tokens">JWT</abbr> 令牌实现真正的安全机制。

From 073e7fc950f1af24634b304afbb34bf212756dff Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 25 Sep 2023 23:08:51 +0000
Subject: [PATCH 193/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index feb72f444..58eb8ece0 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Update Chinese translation for `docs/tutorial/security/simple-oauth2.md`. PR [#3844](https://github.com/tiangolo/fastapi/pull/3844) by [@jaystone776](https://github.com/jaystone776).
 * 🌐 Add Korean translation for `docs/ko/docs/deployment/cloud.md`. PR [#10191](https://github.com/tiangolo/fastapi/pull/10191) by [@Sion99](https://github.com/Sion99).
 * 🌐 Add Japanese translation for `docs/ja/docs/deployment/https.md`. PR [#10298](https://github.com/tiangolo/fastapi/pull/10298) by [@tamtam-fitness](https://github.com/tamtam-fitness).
 * 🌐 Fix typo in Russian translation for `docs/ru/docs/tutorial/body-fields.md`. PR [#10224](https://github.com/tiangolo/fastapi/pull/10224) by [@AlertRED](https://github.com/AlertRED).

From 1453cea4043c895cc6e9aff27762e72c64bc8619 Mon Sep 17 00:00:00 2001
From: mkdir700 <mkdir700@gmail.com>
Date: Thu, 28 Sep 2023 04:47:21 +0800
Subject: [PATCH 194/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Chinese=20translat?=
 =?UTF-8?q?ion=20for=20`docs/zh/docs/async.md`=20(#5591)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Jedore <jedore_fight@189.cn>
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
Co-authored-by: 吴定焕 <108172295+wdh99@users.noreply.github.com>
---
 docs/zh/docs/async.md | 430 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 430 insertions(+)
 create mode 100644 docs/zh/docs/async.md

diff --git a/docs/zh/docs/async.md b/docs/zh/docs/async.md
new file mode 100644
index 000000000..7cc76fc86
--- /dev/null
+++ b/docs/zh/docs/async.md
@@ -0,0 +1,430 @@
+# 并发 async / await
+
+有关路径操作函数的 `async def` 语法以及异步代码、并发和并行的一些背景知识。
+
+## 赶时间吗？
+
+<abbr title="too long; didn't read(长文警告)"><strong>TL;DR:</strong></abbr>
+
+如果你正在使用第三方库，它们会告诉你使用 `await` 关键字来调用它们，就像这样：
+
+```Python
+results = await some_library()
+```
+
+然后，通过 `async def` 声明你的 *路径操作函数*：
+
+```Python hl_lines="2"
+@app.get('/')
+async def read_results():
+    results = await some_library()
+    return results
+```
+
+!!! note
+    你只能在被 `async def` 创建的函数内使用 `await`
+
+---
+
+如果你正在使用一个第三方库和某些组件（比如：数据库、API、文件系统...）进行通信，第三方库又不支持使用 `await` （目前大多数数据库三方库都是这样），这种情况你可以像平常那样使用 `def` 声明一个路径操作函数，就像这样：
+
+```Python hl_lines="2"
+@app.get('/')
+def results():
+    results = some_library()
+    return results
+```
+
+---
+
+如果你的应用程序不需要与其他任何东西通信而等待其响应，请使用 `async def`。
+
+---
+
+如果你不清楚，使用 `def` 就好.
+
+---
+
+**注意**：你可以根据需要在路径操作函数中混合使用 `def` 和 `async def`，并使用最适合你的方式去定义每个函数。FastAPI 将为他们做正确的事情。
+
+无论如何，在上述任何情况下，FastAPI 仍将异步工作，速度也非常快。
+
+但是，通过遵循上述步骤，它将能够进行一些性能优化。
+
+## 技术细节
+
+Python 的现代版本支持通过一种叫**"协程"**——使用 `async` 和 `await` 语法的东西来写**”异步代码“**。
+
+让我们在下面的部分中逐一介绍：
+
+* **异步代码**
+* **`async` 和 `await`**
+* **协程**
+
+## 异步代码
+
+异步代码仅仅意味着编程语言 💬 有办法告诉计算机/程序 🤖 在代码中的某个点，它 🤖 将不得不等待在某些地方完成一些事情。让我们假设一些事情被称为 "慢文件"📝.
+
+所以，在等待"慢文件"📝完成的这段时间，计算机可以做一些其他工作。
+
+然后计算机/程序 🤖 每次有机会都会回来，因为它又在等待，或者它 🤖 完成了当前所有的工作。而且它 🤖 将查看它等待的所有任务中是否有已经完成的，做它必须做的任何事情。
+
+接下来，它 🤖 完成第一个任务（比如是我们的"慢文件"📝) 并继续与之相关的一切。
+
+这个"等待其他事情"通常指的是一些相对较慢（与处理器和 RAM 存储器的速度相比）的 <abbr title="Input and Output">I/O</abbr> 操作，比如说：
+
+* 通过网络发送来自客户端的数据
+* 客户端接收来自网络中的数据
+* 磁盘中要由系统读取并提供给程序的文件的内容
+* 程序提供给系统的要写入磁盘的内容
+* 一个 API 的远程调用
+* 一个数据库操作，直到完成
+* 一个数据库查询，直到返回结果
+* 等等.
+
+这个执行的时间大多是在等待 <abbr title="Input and Output">I/O</abbr> 操作，因此它们被叫做 "I/O 密集型" 操作。
+
+它被称为"异步"的原因是因为计算机/程序不必与慢任务"同步"，去等待任务完成的确切时刻，而在此期间不做任何事情直到能够获取任务结果才继续工作。
+
+相反，作为一个"异步"系统，一旦完成，任务就可以排队等待一段时间（几微秒），等待计算机程序完成它要做的任何事情，然后回来获取结果并继续处理它们。
+
+对于"同步"（与"异步"相反），他们通常也使用"顺序"一词，因为计算机程序在切换到另一个任务之前是按顺序执行所有步骤，即使这些步骤涉及到等待。
+
+### 并发与汉堡
+
+上述异步代码的思想有时也被称为“并发”，它不同于“并行”。
+
+并发和并行都与“不同的事情或多或少同时发生”有关。
+
+但是并发和并行之间的细节是完全不同的。
+
+要了解差异，请想象以下关于汉堡的故事：
+
+### 并发汉堡
+
+你和你的恋人一起去快餐店，你排队在后面，收银员从你前面的人接单。😍
+
+<img src="/img/async/concurrent-burgers/concurrent-burgers-01.png" class="illustration">
+
+然后轮到你了，你为你的恋人和你选了两个非常豪华的汉堡。🍔🍔
+
+<img src="/img/async/concurrent-burgers/concurrent-burgers-02.png" class="illustration">
+
+收银员对厨房里的厨师说了一些话，让他们知道他们必须为你准备汉堡（尽管他们目前正在为之前的顾客准备汉堡）。
+
+<img src="/img/async/concurrent-burgers/concurrent-burgers-03.png" class="illustration">
+
+你付钱了。 💸
+
+收银员给你轮到的号码。
+
+<img src="/img/async/concurrent-burgers/concurrent-burgers-04.png" class="illustration">
+
+当你在等待的时候，你和你的恋人一起去挑选一张桌子，然后你们坐下来聊了很长时间（因为汉堡很豪华，需要一些时间来准备）。
+
+当你和你的恋人坐在桌子旁，等待汉堡的时候，你可以用这段时间来欣赏你的恋人是多么的棒、可爱和聪明✨😍✨。
+
+<img src="/img/async/concurrent-burgers/concurrent-burgers-05.png" class="illustration">
+
+在等待中和你的恋人交谈时，你会不时地查看柜台上显示的号码，看看是否已经轮到你了。
+
+然后在某个时刻，终于轮到你了。你去柜台拿汉堡然后回到桌子上。
+
+<img src="/img/async/concurrent-burgers/concurrent-burgers-06.png" class="illustration">
+
+你们享用了汉堡，整个过程都很开心。✨
+
+<img src="/img/async/concurrent-burgers/concurrent-burgers-07.png" class="illustration">
+
+!!! info
+    漂亮的插画来自 <a href="https://www.instagram.com/ketrinadrawsalot" class="external-link" target="_blank">Ketrina Thompson</a>. 🎨
+
+---
+
+在那个故事里，假设你是计算机程序 🤖 。
+
+当你在排队时，你只是闲着😴， 轮到你前不做任何事情（仅排队）。但排队很快，因为收银员只接订单（不准备订单），所以这一切都还好。
+
+然后，当轮到你时，需要你做一些实际性的工作，比如查看菜单，决定你想要什么，让你的恋人选择，支付，检查你是否提供了正确的账单或卡，检查你的收费是否正确，检查订单是否有正确的项目，等等。
+
+此时，即使你仍然没有汉堡，你和收银员的工作也"暂停"了⏸， 因为你必须等待一段时间 🕙 让你的汉堡做好。
+
+但是，当你离开柜台并坐在桌子旁，在轮到你的号码前的这段时间，你可以将焦点切换到 🔀 你的恋人上，并做一些"工作"⏯ 🤓。你可以做一些非常"有成效"的事情，比如和你的恋人调情😍.
+
+之后，收银员 💁 把号码显示在显示屏上，并说到 "汉堡做好了"，而当显示的号码是你的号码时，你不会立刻疯狂地跳起来。因为你知道没有人会偷你的汉堡，因为你有你的号码，而其他人又有他们自己的号码。
+
+所以你要等待你的恋人完成故事（完成当前的工作⏯ /正在做的事🤓)， 轻轻微笑，说你要吃汉堡⏸.
+
+然后你去柜台🔀， 到现在初始任务已经完成⏯， 拿起汉堡，说声谢谢，然后把它们送到桌上。这就完成了与计数器交互的步骤/任务⏹. 这反过来又产生了一项新任务，即"吃汉堡"🔀 ⏯， 上一个"拿汉堡"的任务已经结束了⏹.
+
+### 并行汉堡
+
+现在让我们假设不是"并发汉堡"，而是"并行汉堡"。
+
+你和你的恋人一起去吃并行快餐。
+
+你站在队伍中，同时是厨师的几个收银员（比方说8个）从前面的人那里接单。
+
+你之前的每个人都在等待他们的汉堡准备好后才离开柜台，因为8名收银员都会在下一份订单前马上准备好汉堡。
+
+<img src="/img/async/parallel-burgers/parallel-burgers-01.png" class="illustration">
+
+然后，终于轮到你了，你为你的恋人和你订购了两个非常精美的汉堡。
+
+你付钱了 💸。
+
+<img src="/img/async/parallel-burgers/parallel-burgers-02.png" class="illustration">
+
+收银员去厨房。
+
+你站在柜台前 🕙等待着，这样就不会有人在你之前抢走你的汉堡，因为没有轮流的号码。
+
+<img src="/img/async/parallel-burgers/parallel-burgers-03.png" class="illustration">
+
+当你和你的恋人忙于不让任何人出现在你面前，并且在他们到来的时候拿走你的汉堡时，你无法关注到你的恋人。😞
+
+这是"同步"的工作，你被迫与服务员/厨师 👨‍🍳"同步"。你在此必须等待 🕙 ，在收银员/厨师 👨‍🍳 完成汉堡并将它们交给你的确切时间到达之前一直等待，否则其他人可能会拿走它们。
+
+<img src="/img/async/parallel-burgers/parallel-burgers-04.png" class="illustration">
+
+你经过长时间的等待 🕙 ，收银员/厨师 👨‍🍳终于带着汉堡回到了柜台。
+
+<img src="/img/async/parallel-burgers/parallel-burgers-05.png" class="illustration">
+
+你拿着汉堡，和你的情人一起上桌。
+
+你们仅仅是吃了它们，就结束了。⏹
+
+<img src="/img/async/parallel-burgers/parallel-burgers-06.png" class="illustration">
+
+没有太多的交谈或调情，因为大部分时间 🕙 都在柜台前等待😞。
+
+!!! info
+    漂亮的插画来自 <a href="https://www.instagram.com/ketrinadrawsalot" class="external-link" target="_blank">Ketrina Thompson</a>. 🎨
+
+---
+
+在这个并行汉堡的场景中，你是一个计算机程序 🤖 且有两个处理器（你和你的恋人），都在等待 🕙 ，并投入他们的注意力 ⏯ 在柜台上等待了很长一段时间。
+
+这家快餐店有 8 个处理器（收银员/厨师）。而并发汉堡店可能只有 2 个（一个收银员和一个厨师）。
+
+但最终的体验仍然不是最好的。😞
+
+---
+
+这将是与汉堡的类似故事。🍔
+
+一种更"贴近生活"的例子，想象一家银行。
+
+直到最近，大多数银行都有多个出纳员 👨‍💼👨‍💼👨‍💼👨‍💼 还有一条长长排队队伍🕙🕙🕙🕙🕙🕙🕙🕙。
+
+所有收银员都是一个接一个的在客户面前做完所有的工作👨‍💼⏯.
+
+你必须经过 🕙 较长时间排队，否则你就没机会了。
+
+你可不会想带你的恋人 😍 和你一起去银行办事🏦.
+
+### 汉堡结论
+
+在"你与恋人一起吃汉堡"的这个场景中，因为有很多人在等待🕙， 使用并发系统更有意义⏸🔀⏯.
+
+大多数 Web 应用都是这样的。
+
+你的服务器正在等待很多很多用户通过他们不太好的网络发送来的请求。
+
+然后再次等待 🕙 响应回来。
+
+这个"等待" 🕙 是以微秒为单位测量的，但总的来说，最后还是等待很久。
+
+这就是为什么使用异步对于 Web API 很有意义的原因 ⏸🔀⏯。
+
+这种异步机制正是 NodeJS 受到欢迎的原因（尽管 NodeJS 不是并行的），以及 Go 作为编程语言的优势所在。
+
+这与 **FastAPI** 的性能水平相同。
+
+您可以同时拥有并行性和异步性，您可以获得比大多数经过测试的 NodeJS 框架更高的性能，并且与 Go 不相上下， Go 是一种更接近于 C 的编译语言（<a href="https://www.techempower.com/benchmarks/#section=data-r17&hw=ph&test=query&l=zijmkf-1" class="external-link" target="_blank">全部归功于 Starlette</a>）。
+
+### 并发比并行好吗？
+
+不！这不是故事的本意。
+
+并发不同于并行。而是在需要大量等待的特定场景下效果更好。因此，在 Web 应用程序开发中，它通常比并行要好得多，但这并不意味着全部。
+
+因此，为了平衡这一点，想象一下下面的短篇故事：
+
+> 你必须打扫一个又大又脏的房子。
+
+*是的，这就是完整的故事。*
+
+---
+
+在任何地方， 都不需要等待 🕙 ，只需要在房子的多个地方做着很多工作。
+
+你可以像汉堡的例子那样轮流执行，先是客厅，然后是厨房，但因为你不需要等待 🕙 ，对于任何事情都是清洁，清洁，还是清洁，轮流不会影响任何事情。
+
+无论是否轮流执行（并发），都需要相同的时间来完成，而你也会完成相同的工作量。
+
+但在这种情况下，如果你能带上 8 名前收银员/厨师，现在是清洁工一起清扫，他们中的每一个人（加上你）都能占据房子的一个区域来清扫，你就可以在额外的帮助下并行的更快地完成所有工作。
+
+在这个场景中，每个清洁工（包括您）都将是一个处理器，完成这个工作的一部分。
+
+由于大多数执行时间是由实际工作（而不是等待）占用的，并且计算机中的工作是由 <abbr title="Central Processing Unit">CPU</abbr> 完成的，所以他们称这些问题为"CPU 密集型"。
+
+---
+
+CPU 密集型操作的常见示例是需要复杂的数学处理。
+
+例如：
+
+* **音频**或**图像**处理；
+* **计算机视觉**: 一幅图像由数百万像素组成，每个像素有3种颜色值，处理通常需要同时对这些像素进行计算；
+* **机器学习**: 它通常需要大量的"矩阵"和"向量"乘法。想象一个包含数字的巨大电子表格，并同时将所有数字相乘；
+* **深度学习**: 这是机器学习的一个子领域，同样适用。只是没有一个数字的电子表格可以相乘，而是一个庞大的数字集合，在很多情况下，你需要使用一个特殊的处理器来构建和使用这些模型。
+
+### 并发 + 并行: Web + 机器学习
+
+使用 **FastAPI**，您可以利用 Web 开发中常见的并发机制的优势（NodeJS 的主要吸引力）。
+
+并且，您也可以利用并行和多进程（让多个进程并行运行）的优点来处理与机器学习系统中类似的 **CPU 密集型** 工作。
+
+这一点，再加上 Python 是**数据科学**、机器学习（尤其是深度学习）的主要语言这一简单事实，使得 **FastAPI** 与数据科学/机器学习 Web API 和应用程序（以及其他许多应用程序）非常匹配。
+
+了解如何在生产环境中实现这种并行性，可查看此文 [Deployment](deployment/index.md){.internal-link target=_blank}。
+
+## `async` 和 `await`
+
+现代版本的 Python 有一种非常直观的方式来定义异步代码。这使它看起来就像正常的"顺序"代码，并在适当的时候"等待"。
+
+当有一个操作需要等待才能给出结果，且支持这个新的 Python 特性时，您可以编写如下代码：
+
+```Python
+burgers = await get_burgers(2)
+```
+
+这里的关键是 `await`。它告诉 Python 它必须等待 ⏸ `get_burgers(2)` 完成它的工作 🕙 ，然后将结果存储在 `burgers` 中。这样，Python 就会知道此时它可以去做其他事情 🔀 ⏯ （比如接收另一个请求）。
+
+要使 `await` 工作，它必须位于支持这种异步机制的函数内。因此，只需使用 `async def` 声明它：
+
+```Python hl_lines="1"
+async def get_burgers(number: int):
+    # Do some asynchronous stuff to create the burgers
+    return burgers
+```
+
+...而不是 `def`:
+
+```Python hl_lines="2"
+# This is not asynchronous
+def get_sequential_burgers(number: int):
+    # Do some sequential stuff to create the burgers
+    return burgers
+```
+
+使用 `async def`，Python 就知道在该函数中，它将遇上 `await`，并且它可以"暂停" ⏸ 执行该函数，直至执行其他操作 🔀 后回来。
+
+当你想调用一个 `async def` 函数时，你必须"等待"它。因此，这不会起作用：
+
+```Python
+# This won't work, because get_burgers was defined with: async def
+burgers = get_burgers(2)
+```
+
+---
+
+因此，如果您使用的库告诉您可以使用 `await` 调用它，则需要使用 `async def` 创建路径操作函数 ，如：
+
+```Python hl_lines="2-3"
+@app.get('/burgers')
+async def read_burgers():
+    burgers = await get_burgers(2)
+    return burgers
+```
+
+### 更多技术细节
+
+您可能已经注意到，`await` 只能在 `async def` 定义的函数内部使用。
+
+但与此同时，必须"等待"通过 `async def` 定义的函数。因此，带 `async def` 的函数也只能在 `async def` 定义的函数内部调用。
+
+那么，这关于先有鸡还是先有蛋的问题，如何调用第一个 `async` 函数？
+
+如果您使用 **FastAPI**，你不必担心这一点，因为"第一个"函数将是你的路径操作函数，FastAPI 将知道如何做正确的事情。
+
+但如果您想在没有 FastAPI 的情况下使用 `async` / `await`，则可以这样做。
+
+### 编写自己的异步代码
+
+Starlette （和 **FastAPI**） 是基于 <a href="https://anyio.readthedocs.io/en/stable/" class="external-link" target="_blank">AnyIO</a> 实现的，这使得它们可以兼容 Python 的标准库 <a href="https://docs.python.org/3/library/asyncio-task.html" class="external-link" target="_blank">asyncio</a> 和 <a href="https://trio.readthedocs.io/en/stable/" class="external-link" target="_blank">Trio</a>。
+
+特别是，你可以直接使用 <a href="https://anyio.readthedocs.io/en/stable/" class="external-link" target="_blank">AnyIO</a> 来处理高级的并发用例，这些用例需要在自己的代码中使用更高级的模式。
+
+即使您没有使用 **FastAPI**，您也可以使用 <a href="https://anyio.readthedocs.io/en/stable/" class="external-link" target="_blank">AnyIO</a> 编写自己的异步程序，使其拥有较高的兼容性并获得一些好处（例如， 结构化并发）。
+
+### 其他形式的异步代码
+
+这种使用 `async` 和 `await` 的风格在语言中相对较新。
+
+但它使处理异步代码变得容易很多。
+
+这种相同的语法（或几乎相同）最近也包含在现代版本的 JavaScript 中（在浏览器和 NodeJS 中）。
+
+但在此之前，处理异步代码非常复杂和困难。
+
+在以前版本的 Python，你可以使用多线程或者 <a href="https://www.gevent.org/" class="external-link" target="_blank">Gevent</a>。但代码的理解、调试和思考都要复杂许多。
+
+在以前版本的 NodeJS / 浏览器 JavaScript 中，你会使用"回调"，因此也可能导致<a href="http://callbackhell.com/" class="external-link" target="_blank">回调地狱</a>。
+
+## 协程
+
+**协程**只是 `async def` 函数返回的一个非常奇特的东西的称呼。Python 知道它有点像一个函数，它可以启动，也会在某个时刻结束，而且它可能会在内部暂停 ⏸ ，只要内部有一个 `await`。
+
+通过使用 `async` 和 `await` 的异步代码的所有功能大多数被概括为"协程"。它可以与 Go 的主要关键特性 "Goroutines" 相媲美。
+
+## 结论
+
+让我们再来回顾下上文所说的：
+
+> Python 的现代版本可以通过使用 `async` 和 `await` 语法创建**协程**，并用于支持**异步代码**。
+
+现在应该能明白其含义了。✨
+
+所有这些使得 FastAPI（通过 Starlette）如此强大，也是它拥有如此令人印象深刻的性能的原因。
+
+## 非常技术性的细节
+
+!!! warning
+    你可以跳过这里。
+
+    这些都是 FastAPI 如何在内部工作的技术细节。
+
+    如果您有相当多的技术知识（协程、线程、阻塞等），并且对 FastAPI 如何处理 `async def` 与常规 `def` 感到好奇，请继续。
+
+### 路径操作函数
+
+当你使用 `def` 而不是 `async def` 来声明一个*路径操作函数*时，它运行在外部的线程池中并等待其结果，而不是直接调用（因为它会阻塞服务器）。
+
+如果您使用过另一个不以上述方式工作的异步框架，并且您习惯于用普通的 `def` 定义普通的仅计算路径操作函数，以获得微小的性能增益（大约100纳秒），请注意，在 FastAPI 中，效果将完全相反。在这些情况下，最好使用 `async def`，除非路径操作函数内使用执行阻塞 <abbr title="输入/输出：磁盘读写，网络通讯.">I/O</abbr> 的代码。
+
+在这两种情况下，与您之前的框架相比，**FastAPI** 可能[仍然很快](/#performance){.internal-link target=_blank}。
+
+### 依赖
+
+这同样适用于[依赖](/tutorial/dependencies/index.md){.internal-link target=_blank}。如果一个依赖是标准的 `def` 函数而不是 `async def`，它将被运行在外部线程池中。
+
+### 子依赖
+
+你可以拥有多个相互依赖的依赖以及[子依赖](/tutorial/dependencies/sub-dependencies.md){.internal-link target=_blank} （作为函数的参数），它们中的一些可能是通过 `async def` 声明，也可能是通过 `def` 声明。它们仍然可以正常工作，这些通过 `def` 声明的函数将会在外部线程中调用（来自线程池），而不是"被等待"。
+
+### 其他函数
+
+您可直接调用通过 `def` 或 `async def` 创建的任何其他函数，FastAPI 不会影响您调用它们的方式。
+
+这与 FastAPI 为您调用*路径操作函数*和依赖项的逻辑相反。
+
+如果你的函数是通过 `def` 声明的，它将被直接调用（在代码中编写的地方），而不会在线程池中，如果这个函数通过 `async def` 声明，当在代码中调用时，你就应该使用 `await` 等待函数的结果。
+
+---
+
+再次提醒，这些是非常技术性的细节，如果你来搜索它可能对你有用。
+
+否则，您最好应该遵守的指导原则<a href="#_1">赶时间吗？</a>.

From 27870e20f54e5cb938f5f030e767de41a4fef2b9 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 27 Sep 2023 20:48:01 +0000
Subject: [PATCH 195/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 58eb8ece0..f32565438 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Chinese translation for `docs/zh/docs/async.md`. PR [#5591](https://github.com/tiangolo/fastapi/pull/5591) by [@mkdir700](https://github.com/mkdir700).
 * 🌐 Update Chinese translation for `docs/tutorial/security/simple-oauth2.md`. PR [#3844](https://github.com/tiangolo/fastapi/pull/3844) by [@jaystone776](https://github.com/jaystone776).
 * 🌐 Add Korean translation for `docs/ko/docs/deployment/cloud.md`. PR [#10191](https://github.com/tiangolo/fastapi/pull/10191) by [@Sion99](https://github.com/Sion99).
 * 🌐 Add Japanese translation for `docs/ja/docs/deployment/https.md`. PR [#10298](https://github.com/tiangolo/fastapi/pull/10298) by [@tamtam-fitness](https://github.com/tamtam-fitness).

From 69f82e5222ca6fff6c40db79c2b4518508a6c659 Mon Sep 17 00:00:00 2001
From: Samuel Rigaud <46346622+s-rigaud@users.noreply.github.com>
Date: Wed, 27 Sep 2023 16:52:31 -0400
Subject: [PATCH 196/317] =?UTF-8?q?=F0=9F=8C=90=20Fix=20typos=20in=20Frenc?=
 =?UTF-8?q?h=20translations=20for=20`docs/fr/docs/advanced/path-operation-?=
 =?UTF-8?q?advanced-configuration.md`,=20`docs/fr/docs/alternatives.md`,?=
 =?UTF-8?q?=20`docs/fr/docs/async.md`,=20`docs/fr/docs/features.md`,=20`do?=
 =?UTF-8?q?cs/fr/docs/help-fastapi.md`,=20`docs/fr/docs/index.md`,=20`docs?=
 =?UTF-8?q?/fr/docs/python-types.md`,=20`docs/fr/docs/tutorial/body.md`,?=
 =?UTF-8?q?=20`docs/fr/docs/tutorial/first-steps.md`,=20`docs/fr/docs/tuto?=
 =?UTF-8?q?rial/query-params.md`=20(#10154)?=
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>
---
 .../path-operation-advanced-configuration.md       |  2 +-
 docs/fr/docs/alternatives.md                       |  2 +-
 docs/fr/docs/async.md                              |  2 +-
 docs/fr/docs/features.md                           | 14 +++++++-------
 docs/fr/docs/help-fastapi.md                       |  4 ++--
 docs/fr/docs/index.md                              |  4 ++--
 docs/fr/docs/python-types.md                       |  2 +-
 docs/fr/docs/tutorial/body.md                      |  2 +-
 docs/fr/docs/tutorial/first-steps.md               |  2 +-
 docs/fr/docs/tutorial/query-params.md              |  2 +-
 10 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/docs/fr/docs/advanced/path-operation-advanced-configuration.md b/docs/fr/docs/advanced/path-operation-advanced-configuration.md
index ace9f19f9..7ded97ce1 100644
--- a/docs/fr/docs/advanced/path-operation-advanced-configuration.md
+++ b/docs/fr/docs/advanced/path-operation-advanced-configuration.md
@@ -66,7 +66,7 @@ Il y a un chapitre entier ici dans la documentation à ce sujet, vous pouvez le
 Lorsque vous déclarez un *chemin* dans votre application, **FastAPI** génère automatiquement les métadonnées concernant ce *chemin* à inclure dans le schéma OpenAPI.
 
 !!! note "Détails techniques"
-    La spécification OpenAPI appelle ces métaonnées des <a href="https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#operation-object" class="external-link" target="_blank">Objets d'opération</a>.
+    La spécification OpenAPI appelle ces métadonnées des <a href="https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#operation-object" class="external-link" target="_blank">Objets d'opération</a>.
 
 Il contient toutes les informations sur le *chemin* et est utilisé pour générer automatiquement la documentation.
 
diff --git a/docs/fr/docs/alternatives.md b/docs/fr/docs/alternatives.md
index ee20438c3..8e58a3dfa 100644
--- a/docs/fr/docs/alternatives.md
+++ b/docs/fr/docs/alternatives.md
@@ -387,7 +387,7 @@ Gérer toute la validation des données, leur sérialisation et la documentation
 
 ### <a href="https://www.starlette.io/" class="external-link" target="_blank">Starlette</a>
 
-Starlette est un framework/toolkit léger <abbr title="Le nouveau standard pour construire des applications web assynchrones en Python">ASGI</abbr>, qui est idéal pour construire des services asyncio performants.
+Starlette est un framework/toolkit léger <abbr title="Le nouveau standard pour construire des applications web asynchrones en Python">ASGI</abbr>, qui est idéal pour construire des services asyncio performants.
 
 Il est très simple et intuitif. Il est conçu pour être facilement extensible et avoir des composants modulaires.
 
diff --git a/docs/fr/docs/async.md b/docs/fr/docs/async.md
index db88c4663..af4d6ca06 100644
--- a/docs/fr/docs/async.md
+++ b/docs/fr/docs/async.md
@@ -250,7 +250,7 @@ Par exemple :
 
 ### Concurrence + Parallélisme : Web + Machine Learning
 
-Avec **FastAPI** vous pouvez bénéficier de la concurrence qui est très courante en developement web (c'est l'attrait principal de NodeJS).
+Avec **FastAPI** vous pouvez bénéficier de la concurrence qui est très courante en développement web (c'est l'attrait principal de NodeJS).
 
 Mais vous pouvez aussi profiter du parallélisme et multiprocessing afin de gérer des charges **CPU bound** qui sont récurrentes dans les systèmes de *Machine Learning*.
 
diff --git a/docs/fr/docs/features.md b/docs/fr/docs/features.md
index dcc0e39ed..f5faa46b6 100644
--- a/docs/fr/docs/features.md
+++ b/docs/fr/docs/features.md
@@ -71,9 +71,9 @@ my_second_user: User = User(**second_user_data)
 
 Tout le framework a été conçu pour être facile et intuitif d'utilisation, toutes les décisions de design ont été testées sur de nombreux éditeurs avant même de commencer le développement final afin d'assurer la meilleure expérience de développement possible.
 
-Dans le dernier sondage effectué auprès de développeurs python il était clair que <a href="https://www.jetbrains.com/research/python-developers-survey-2017/#tools-and-features" class="external-link" target="_blank">la fonctionnalité la plus utilisée est "l'autocomplètion"</a>.
+Dans le dernier sondage effectué auprès de développeurs python il était clair que <a href="https://www.jetbrains.com/research/python-developers-survey-2017/#tools-and-features" class="external-link" target="_blank">la fonctionnalité la plus utilisée est "l’autocomplétion"</a>.
 
-Tout le framwork **FastAPI** a été conçu avec cela en tête. L'autocomplétion fonctionne partout.
+Tout le framework **FastAPI** a été conçu avec cela en tête. L'autocomplétion fonctionne partout.
 
 Vous devrez rarement revenir à la documentation.
 
@@ -136,7 +136,7 @@ FastAPI contient un système simple mais extrêmement puissant d'<abbr title='au
 
 * Même les dépendances peuvent avoir des dépendances, créant une hiérarchie ou un **"graph" de dépendances**
 * Tout est **automatiquement géré** par le framework
-* Toutes les dépendances peuvent éxiger des données d'une requêtes et **Augmenter les contraintes d'un path operation** et de la documentation automatique.
+* Toutes les dépendances peuvent exiger des données d'une requêtes et **Augmenter les contraintes d'un path operation** et de la documentation automatique.
 * **Validation automatique** même pour les paramètres de *path operation* définis dans les dépendances.
 * Supporte les systèmes d'authentification d'utilisateurs complexes, les **connexions de base de données**, etc.
 * **Aucun compromis** avec les bases de données, les frontends, etc. Mais une intégration facile avec n'importe lequel d'entre eux.
@@ -157,11 +157,11 @@ Tout intégration est conçue pour être si simple à utiliser (avec des dépend
 
 **FastAPI** est complètement compatible (et basé sur) <a href="https://www.starlette.io/" class="external-link" target="_blank"><strong>Starlette</strong></a>. Le code utilisant Starlette que vous ajouterez fonctionnera donc aussi.
 
-En fait, `FastAPI` est un sous compposant de `Starlette`. Donc, si vous savez déjà comment utiliser Starlette, la plupart des fonctionnalités fonctionneront de la même manière.
+En fait, `FastAPI` est un sous composant de `Starlette`. Donc, si vous savez déjà comment utiliser Starlette, la plupart des fonctionnalités fonctionneront de la même manière.
 
 Avec **FastAPI** vous aurez toutes les fonctionnalités de **Starlette** (FastAPI est juste Starlette sous stéroïdes):
 
-* Des performances vraiments impressionnantes. C'est l'<a href="https://github.com/encode/starlette#performance" class="external-link" target="_blank">un des framework Python les plus rapide, à égalité avec **NodeJS** et **GO**</a>.
+* Des performances vraiment impressionnantes. C'est l'<a href="https://github.com/encode/starlette#performance" class="external-link" target="_blank">un des framework Python les plus rapide, à égalité avec **NodeJS** et **GO**</a>.
 * Le support des **WebSockets**.
 * Le support de **GraphQL**.
 * Les <abbr title="En anglais: In-process background tasks">tâches d'arrière-plan.</abbr>
@@ -180,7 +180,7 @@ Inclus des librairies externes basées, aussi, sur Pydantic, servent d'<abbr tit
 
 Cela signifie aussi que, dans la plupart des cas, vous pouvez fournir l'objet reçu d'une requête **directement à la base de données**, comme tout est validé automatiquement.
 
-Inversément, dans la plupart des cas vous pourrez juste envoyer l'objet récupéré de la base de données **directement au client**
+Inversement, dans la plupart des cas vous pourrez juste envoyer l'objet récupéré de la base de données **directement au client**
 
 Avec **FastAPI** vous aurez toutes les fonctionnalités de **Pydantic**  (comme FastAPI est basé sur Pydantic pour toutes les manipulations de données):
 
@@ -194,7 +194,7 @@ Avec **FastAPI** vous aurez toutes les fonctionnalités de **Pydantic**  (comme
 * Valide les **structures complexes**:
     * Utilise les modèles hiérarchique de Pydantic, le `typage` Python pour les `Lists`, `Dict`, etc.
     * Et les validateurs permettent aux schémas de données complexes d'être clairement et facilement définis, validés et documentés sous forme d'un schéma JSON.
-    * Vous pouvez avoir des objets **JSON fortements imbriqués** tout en ayant, pour chacun, de la validation et des annotations.
+    * Vous pouvez avoir des objets **JSON fortement imbriqués** tout en ayant, pour chacun, de la validation et des annotations.
 * **Renouvelable**:
     * Pydantic permet de définir de nouveaux types de données ou vous pouvez étendre la validation avec des méthodes sur un modèle décoré avec le<abbr title="en anglais: validator decorator"> décorateur de validation</abbr>
 * 100% de couverture de test.
diff --git a/docs/fr/docs/help-fastapi.md b/docs/fr/docs/help-fastapi.md
index 0995721e1..3bc3c3a8a 100644
--- a/docs/fr/docs/help-fastapi.md
+++ b/docs/fr/docs/help-fastapi.md
@@ -36,8 +36,8 @@ Vous pouvez :
 * <a href="https://twitter.com/tiangolo" class="external-link" target="_blank">Me suivre sur **Twitter**</a>.
     * Dites-moi comment vous utilisez FastAPI (j'adore entendre ça).
     * Entendre quand je fais des annonces ou que je lance de nouveaux outils.
-* <a href="https://www.linkedin.com/in/tiangolo/" class="external-link" target="_blank">Vous connectez à moi sur **Linkedin**</a>.
-    * Etre notifié quand je fais des annonces ou que je lance de nouveaux outils (bien que j'utilise plus souvent Twitte 🤷‍♂).
+* <a href="https://www.linkedin.com/in/tiangolo/" class="external-link" target="_blank">Vous connectez à moi sur **LinkedIn**</a>.
+    * Etre notifié quand je fais des annonces ou que je lance de nouveaux outils (bien que j'utilise plus souvent Twitter 🤷‍♂).
 * Lire ce que j’écris (ou me suivre) sur <a href="https://dev.to/tiangolo" class="external-link" target="_blank">**Dev.to**</a> ou <a href="https://medium.com/@tiangolo" class="external-link" target="_blank">**Medium**</a>.
     * Lire d'autres idées, articles, et sur les outils que j'ai créés.
     * Suivez-moi pour lire quand je publie quelque chose de nouveau.
diff --git a/docs/fr/docs/index.md b/docs/fr/docs/index.md
index 7c7547be1..4ac9864ec 100644
--- a/docs/fr/docs/index.md
+++ b/docs/fr/docs/index.md
@@ -424,7 +424,7 @@ Pour un exemple plus complet comprenant plus de fonctionnalités, voir le <a hre
 
 * Déclaration de **paramètres** provenant d'autres endroits différents comme : **<abbr title="en anglais : headers">en-têtes</abbr>.**, **cookies**, **champs de formulaire** et **fichiers**.
 * L'utilisation de **contraintes de validation** comme `maximum_length` ou `regex`.
-* Un **<abbr title="aussi connu sous le nom de composants, ressources, fournisseurs, services, injectables">systéme d'injection de dépendance </abbr>** très puissant et facile à utiliser .
+* Un **<abbr title="aussi connu sous le nom de composants, ressources, fournisseurs, services, injectables">système d'injection de dépendance </abbr>** très puissant et facile à utiliser .
 * Sécurité et authentification, y compris la prise en charge de **OAuth2** avec les **<abbr title="en anglais : JWT tokens">jetons <abbr title="JSON Web Tokens">JWT</abbr></abbr>** et l'authentification **HTTP Basic**.
 * Des techniques plus avancées (mais tout aussi faciles) pour déclarer les **modèles <abbr title="JavaScript Object Notation">JSON</abbr> profondément imbriqués** (grâce à Pydantic).
 * Intégration de **GraphQL** avec <a href="https://strawberry.rocks" class="external-link" target="_blank">Strawberry</a> et d'autres bibliothèques.
@@ -450,7 +450,7 @@ Utilisées par Pydantic:
 Utilisées par Starlette :
 
 * <a href="https://requests.readthedocs.io" target="_blank"><code>requests</code></a> - Obligatoire si vous souhaitez utiliser `TestClient`.
-* <a href="https://jinja.palletsprojects.com" target="_blank"><code>jinja2</code></a> - Obligatoire si vous souhaitez utiliser la configuration de template par defaut.
+* <a href="https://jinja.palletsprojects.com" target="_blank"><code>jinja2</code></a> - Obligatoire si vous souhaitez utiliser la configuration de template par défaut.
 * <a href="https://andrew-d.github.io/python-multipart/" target="_blank"><code>python-multipart</code></a> - Obligatoire si vous souhaitez supporter le <abbr title="convertit la chaine de caractère d'une requête HTTP en donnée Python">"décodage"</abbr> de formulaire avec `request.form()`.
 * <a href="https://pythonhosted.org/itsdangerous/" target="_blank"><code>itsdangerous</code></a> - Obligatoire pour la prise en charge de `SessionMiddleware`.
 * <a href="https://pyyaml.org/wiki/PyYAMLDocumentation" target="_blank"><code>pyyaml</code></a> - Obligatoire pour le support `SchemaGenerator` de Starlette (vous n'en avez probablement pas besoin avec FastAPI).
diff --git a/docs/fr/docs/python-types.md b/docs/fr/docs/python-types.md
index 4008ed96f..f49fbafd3 100644
--- a/docs/fr/docs/python-types.md
+++ b/docs/fr/docs/python-types.md
@@ -119,7 +119,7 @@ Comme l'éditeur connaît le type des variables, vous n'avez pas seulement l'aut
 
 <img src="/img/python-types/image04.png">
 
-Maintenant que vous avez connaissance du problème, convertissez `age` en <abbr title="string">chaine de caractères</abbr> grâce à `str(age)` :
+Maintenant que vous avez connaissance du problème, convertissez `age` en <abbr title="string">chaîne de caractères</abbr> grâce à `str(age)` :
 
 ```Python hl_lines="2"
 {!../../../docs_src/python_types/tutorial004.py!}
diff --git a/docs/fr/docs/tutorial/body.md b/docs/fr/docs/tutorial/body.md
index 1e732d336..89720c973 100644
--- a/docs/fr/docs/tutorial/body.md
+++ b/docs/fr/docs/tutorial/body.md
@@ -98,7 +98,7 @@ Et vous obtenez aussi de la vérification d'erreur pour les opérations incorrec
 
 <img src="/img/tutorial/body/image04.png">
 
-Ce n'est pas un hasard, ce framework entier a été bati avec ce design comme objectif.
+Ce n'est pas un hasard, ce framework entier a été bâti avec ce design comme objectif.
 
 Et cela a été rigoureusement testé durant la phase de design, avant toute implémentation, pour s'assurer que cela fonctionnerait avec tous les éditeurs.
 
diff --git a/docs/fr/docs/tutorial/first-steps.md b/docs/fr/docs/tutorial/first-steps.md
index 224c340c6..e98283f1e 100644
--- a/docs/fr/docs/tutorial/first-steps.md
+++ b/docs/fr/docs/tutorial/first-steps.md
@@ -170,7 +170,7 @@ Si vous créez votre app avec :
 {!../../../docs_src/first_steps/tutorial002.py!}
 ```
 
-Et la mettez dans un fichier `main.py`, alors vous appeleriez `uvicorn` avec :
+Et la mettez dans un fichier `main.py`, alors vous appelleriez `uvicorn` avec :
 
 <div class="termy">
 
diff --git a/docs/fr/docs/tutorial/query-params.md b/docs/fr/docs/tutorial/query-params.md
index 7bf3b9e79..962135f63 100644
--- a/docs/fr/docs/tutorial/query-params.md
+++ b/docs/fr/docs/tutorial/query-params.md
@@ -75,7 +75,7 @@ Ici, le paramètre `q` sera optionnel, et aura `None` comme valeur par défaut.
 !!! note
     **FastAPI** saura que `q` est optionnel grâce au `=None`.
 
-    Le `Optional` dans `Optional[str]` n'est pas utilisé par **FastAPI** (**FastAPI** n'en utilisera que la partie `str`), mais il servira tout de même à votre editeur de texte pour détecter des erreurs dans votre code.
+    Le `Optional` dans `Optional[str]` n'est pas utilisé par **FastAPI** (**FastAPI** n'en utilisera que la partie `str`), mais il servira tout de même à votre éditeur de texte pour détecter des erreurs dans votre code.
 
 
 ## Conversion des types des paramètres de requête

From 99ffbcdee0c9bd21855f259fb9983b5d823bed6e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 27 Sep 2023 20:53:18 +0000
Subject: [PATCH 197/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f32565438..0ab8b5f17 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Fix typos in French translations for `docs/fr/docs/advanced/path-operation-advanced-configuration.md`, `docs/fr/docs/alternatives.md`, `docs/fr/docs/async.md`, `docs/fr/docs/features.md`, `docs/fr/docs/help-fastapi.md`, `docs/fr/docs/index.md`, `docs/fr/docs/python-types.md`, `docs/fr/docs/tutorial/body.md`, `docs/fr/docs/tutorial/first-steps.md`, `docs/fr/docs/tutorial/query-params.md`. PR [#10154](https://github.com/tiangolo/fastapi/pull/10154) by [@s-rigaud](https://github.com/s-rigaud).
 * 🌐 Add Chinese translation for `docs/zh/docs/async.md`. PR [#5591](https://github.com/tiangolo/fastapi/pull/5591) by [@mkdir700](https://github.com/mkdir700).
 * 🌐 Update Chinese translation for `docs/tutorial/security/simple-oauth2.md`. PR [#3844](https://github.com/tiangolo/fastapi/pull/3844) by [@jaystone776](https://github.com/jaystone776).
 * 🌐 Add Korean translation for `docs/ko/docs/deployment/cloud.md`. PR [#10191](https://github.com/tiangolo/fastapi/pull/10191) by [@Sion99](https://github.com/Sion99).

From b2f8ac6a83d8938afbe1476462c694d8a6e0b6a7 Mon Sep 17 00:00:00 2001
From: ArtemKhymenko <artem.khymenko@gmail.com>
Date: Wed, 27 Sep 2023 23:53:36 +0300
Subject: [PATCH 198/317] =?UTF-8?q?=F0=9F=8C=90=20Add=20Ukrainian=20transl?=
 =?UTF-8?q?ation=20for=20`docs/uk/docs/tutorial/extra-data-types.md`=20(#1?=
 =?UTF-8?q?0132)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: ArtemKhymenko <ak@workconsult.ua>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Rostyslav <rostik1410@users.noreply.github.com>
---
 docs/uk/docs/tutorial/encoder.md          |  42 +++++++
 docs/uk/docs/tutorial/extra-data-types.md | 130 ++++++++++++++++++++++
 2 files changed, 172 insertions(+)
 create mode 100644 docs/uk/docs/tutorial/encoder.md
 create mode 100644 docs/uk/docs/tutorial/extra-data-types.md

diff --git a/docs/uk/docs/tutorial/encoder.md b/docs/uk/docs/tutorial/encoder.md
new file mode 100644
index 000000000..d660447b4
--- /dev/null
+++ b/docs/uk/docs/tutorial/encoder.md
@@ -0,0 +1,42 @@
+# JSON Compatible Encoder
+
+Існують випадки, коли вам може знадобитися перетворити тип даних (наприклад, модель Pydantic) в щось сумісне з JSON (наприклад, `dict`, `list`, і т. д.).
+
+Наприклад, якщо вам потрібно зберегти це в базі даних.
+
+Для цього, **FastAPI** надає `jsonable_encoder()` функцію.
+
+## Використання `jsonable_encoder`
+
+Давайте уявимо, що у вас є база даних `fake_db`, яка приймає лише дані, сумісні з JSON.
+
+Наприклад, вона не приймає об'єкти типу `datetime`, оскільки вони не сумісні з JSON.
+
+Отже, об'єкт типу `datetime` потрібно перетворити в рядок `str`, який містить дані в <a href="https://en.wikipedia.org/wiki/ISO_8601" class="external-link" target="_blank">ISO форматі</a>.
+
+Тим самим способом ця база даних не прийматиме об'єкт типу Pydantic model (об'єкт з атрибутами), а лише `dict`.
+
+Ви можете використовувати `jsonable_encoder` для цього.
+
+Вона приймає об'єкт, такий як Pydantic model, і повертає його версію, сумісну з JSON:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="4  21"
+    {!> ../../../docs_src/encoder/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="5  22"
+    {!> ../../../docs_src/encoder/tutorial001.py!}
+    ```
+
+У цьому прикладі вона конвертує Pydantic model у `dict`, а `datetime` у `str`.
+
+Результат виклику цієї функції - це щось, що можна кодувати з використанням стандарту Python <a href="https://docs.python.org/3/library/json.html#json.dumps" class="external-link" target="_blank">`json.dumps()`</a>.
+
+Вона не повертає велику строку `str`, яка містить дані у форматі JSON (як строка). Вона повертає стандартну структуру даних Python (наприклад `dict`) із значеннями та підзначеннями, які є сумісними з JSON.
+
+!!! Примітка
+    `jsonable_encoder` фактично використовується **FastAPI** внутрішньо для перетворення даних. Проте вона корисна в багатьох інших сценаріях.
diff --git a/docs/uk/docs/tutorial/extra-data-types.md b/docs/uk/docs/tutorial/extra-data-types.md
new file mode 100644
index 000000000..ba75ee627
--- /dev/null
+++ b/docs/uk/docs/tutorial/extra-data-types.md
@@ -0,0 +1,130 @@
+# Додаткові типи даних
+
+До цього часу, ви використовували загальнопоширені типи даних, такі як:
+
+* `int`
+* `float`
+* `str`
+* `bool`
+
+Але можна також використовувати більш складні типи даних.
+
+І ви все ще матимете ті ж можливості, які були показані до цього:
+
+* Чудова підтримка редактора.
+* Конвертація даних з вхідних запитів.
+* Конвертація даних для відповіді.
+* Валідація даних.
+* Автоматична анотація та документація.
+
+## Інші типи даних
+
+Ось додаткові типи даних для використання:
+
+* `UUID`:
+    * Стандартний "Універсальний Унікальний Ідентифікатор", який часто використовується як ідентифікатор у багатьох базах даних та системах.
+    * У запитах та відповідях буде представлений як `str`.
+* `datetime.datetime`:
+    * Пайтонівський `datetime.datetime`.
+    * У запитах та відповідях буде представлений як `str` в форматі ISO 8601, як: `2008-09-15T15:53:00+05:00`.
+* `datetime.date`:
+    * Пайтонівський `datetime.date`.
+    * У запитах та відповідях буде представлений як `str` в форматі ISO 8601, як: `2008-09-15`.
+* `datetime.time`:
+    * Пайтонівський `datetime.time`.
+    * У запитах та відповідях буде представлений як `str` в форматі ISO 8601, як: `14:23:55.003`.
+* `datetime.timedelta`:
+    * Пайтонівський `datetime.timedelta`.
+    * У запитах та відповідях буде представлений як `float` загальної кількості секунд.
+    * Pydantic також дозволяє представляти це як "ISO 8601 time diff encoding", <a href="https://pydantic-docs.helpmanual.io/usage/exporting_models/#json_encoders" class="external-link" target="_blank">більше інформації дивись у документації</a>.
+* `frozenset`:
+    * У запитах і відповідях це буде оброблено так само, як і `set`:
+        * У запитах список буде зчитано, дублікати будуть видалені та він буде перетворений на `set`.
+        * У відповідях, `set` буде перетворений на `list`.
+        * Згенерована схема буде вказувати, що значення `set` є унікальними (з використанням JSON Schema's `uniqueItems`).
+* `bytes`:
+    * Стандартний Пайтонівський `bytes`.
+    * У запитах і відповідях це буде оброблено як `str`.
+    * Згенерована схема буде вказувати, що це `str` з "форматом" `binary`.
+* `Decimal`:
+    * Стандартний Пайтонівський `Decimal`.
+    * У запитах і відповідях це буде оброблено так само, як і `float`.
+* Ви можете перевірити всі дійсні типи даних Pydantic тут: <a href="https://pydantic-docs.helpmanual.io/usage/types" class="external-link" target="_blank">типи даних Pydantic</a>.
+
+## Приклад
+
+Ось приклад *path operation* з параметрами, використовуючи деякі з вищезазначених типів.
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="1  3  12-16"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="1  3  12-16"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="1  3  13-17"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        Бажано використовувати `Annotated` версію, якщо це можливо.
+
+    ```Python hl_lines="1  2  11-15"
+    {!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        Бажано використовувати `Annotated` версію, якщо це можливо.
+
+    ```Python hl_lines="1  2  12-16"
+    {!> ../../../docs_src/extra_data_types/tutorial001.py!}
+    ```
+
+Зверніть увагу, що параметри всередині функції мають свій звичайний тип даних, і ви можете, наприклад, виконувати звичайні маніпуляції з датами, такі як:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="18-19"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="18-19"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
+    ```
+
+=== "Python 3.6+"
+
+    ```Python hl_lines="19-20"
+    {!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ non-Annotated"
+
+    !!! tip
+        Бажано використовувати `Annotated` версію, якщо це можливо.
+
+    ```Python hl_lines="17-18"
+    {!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.6+ non-Annotated"
+
+    !!! tip
+        Бажано використовувати `Annotated` версію, якщо це можливо.
+
+    ```Python hl_lines="18-19"
+    {!> ../../../docs_src/extra_data_types/tutorial001.py!}
+    ```

From 1c4a9e91b67a370b35f793ab746d32f3fc026621 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 27 Sep 2023 20:55:18 +0000
Subject: [PATCH 199/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 0ab8b5f17..ddd761240 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/extra-data-types.md`. PR [#10132](https://github.com/tiangolo/fastapi/pull/10132) by [@ArtemKhymenko](https://github.com/ArtemKhymenko).
 * 🌐 Fix typos in French translations for `docs/fr/docs/advanced/path-operation-advanced-configuration.md`, `docs/fr/docs/alternatives.md`, `docs/fr/docs/async.md`, `docs/fr/docs/features.md`, `docs/fr/docs/help-fastapi.md`, `docs/fr/docs/index.md`, `docs/fr/docs/python-types.md`, `docs/fr/docs/tutorial/body.md`, `docs/fr/docs/tutorial/first-steps.md`, `docs/fr/docs/tutorial/query-params.md`. PR [#10154](https://github.com/tiangolo/fastapi/pull/10154) by [@s-rigaud](https://github.com/s-rigaud).
 * 🌐 Add Chinese translation for `docs/zh/docs/async.md`. PR [#5591](https://github.com/tiangolo/fastapi/pull/5591) by [@mkdir700](https://github.com/mkdir700).
 * 🌐 Update Chinese translation for `docs/tutorial/security/simple-oauth2.md`. PR [#3844](https://github.com/tiangolo/fastapi/pull/3844) by [@jaystone776](https://github.com/jaystone776).

From 74cf05117b21b90ac4da40bba8dad527220c465f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 27 Sep 2023 18:01:46 -0500
Subject: [PATCH 200/317] =?UTF-8?q?=F0=9F=94=A7=20Rename=20label=20"awaiti?=
 =?UTF-8?q?ng=20review"=20to=20"awaiting-review"=20to=20simplify=20search?=
 =?UTF-8?q?=20queries=20(#10343)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/actions/notify-translations/app/main.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/actions/notify-translations/app/main.py b/.github/actions/notify-translations/app/main.py
index 494fe6ad8..8ac1f233d 100644
--- a/.github/actions/notify-translations/app/main.py
+++ b/.github/actions/notify-translations/app/main.py
@@ -9,7 +9,7 @@ import httpx
 from github import Github
 from pydantic import BaseModel, BaseSettings, SecretStr
 
-awaiting_label = "awaiting review"
+awaiting_label = "awaiting-review"
 lang_all_label = "lang-all"
 approved_label = "approved-2"
 translations_path = Path(__file__).parent / "translations.yml"

From b944b55dfc5e5cacccd9a7125fe883f80a45cba7 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 27 Sep 2023 23:02:35 +0000
Subject: [PATCH 201/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ddd761240..52ee4c7fd 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🔧 Rename label "awaiting review" to "awaiting-review" to simplify search queries. PR [#10343](https://github.com/tiangolo/fastapi/pull/10343) by [@tiangolo](https://github.com/tiangolo).
 * 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/extra-data-types.md`. PR [#10132](https://github.com/tiangolo/fastapi/pull/10132) by [@ArtemKhymenko](https://github.com/ArtemKhymenko).
 * 🌐 Fix typos in French translations for `docs/fr/docs/advanced/path-operation-advanced-configuration.md`, `docs/fr/docs/alternatives.md`, `docs/fr/docs/async.md`, `docs/fr/docs/features.md`, `docs/fr/docs/help-fastapi.md`, `docs/fr/docs/index.md`, `docs/fr/docs/python-types.md`, `docs/fr/docs/tutorial/body.md`, `docs/fr/docs/tutorial/first-steps.md`, `docs/fr/docs/tutorial/query-params.md`. PR [#10154](https://github.com/tiangolo/fastapi/pull/10154) by [@s-rigaud](https://github.com/s-rigaud).
 * 🌐 Add Chinese translation for `docs/zh/docs/async.md`. PR [#5591](https://github.com/tiangolo/fastapi/pull/5591) by [@mkdir700](https://github.com/mkdir700).

From bc935e08b6d9069280ed34625930a1461235db9e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 27 Sep 2023 23:14:40 -0500
Subject: [PATCH 202/317] =?UTF-8?q?=E2=AC=86=EF=B8=8F=20Upgrade=20compatib?=
 =?UTF-8?q?ility=20with=20Pydantic=20v2.4,=20new=20renamed=20functions=20a?=
 =?UTF-8?q?nd=20JSON=20Schema=20input/output=20models=20with=20default=20v?=
 =?UTF-8?q?alues=20(#10344)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 🚚 Refactor deprecated import general_plain_validator_function to with_info_plain_validator_function

* 🚚 Rename deprecated FieldValidationInfo to ValidationInfo

* ✅ Update tests with new defaults for JSON Schema for default values

* ♻️ Add Pydantic v1 version of with_info_plain_validator_function

* 👷 Invalidate cache

* ✅ Fix tests for Pydantic v1

* ✅ Tweak tests coverage for older Pydantic v2 versions
---
 .github/workflows/test.yml                    |  4 +-
 fastapi/_compat.py                            | 14 +++++--
 fastapi/datastructures.py                     |  4 +-
 fastapi/openapi/models.py                     |  4 +-
 tests/test_compat.py                          |  2 +-
 tests/test_filter_pydantic_sub_model_pv2.py   |  4 +-
 ...t_openapi_separate_input_output_schemas.py |  6 ++-
 .../test_body_updates/test_tutorial001.py     | 38 ++-----------------
 .../test_tutorial001_py310.py                 | 38 ++-----------------
 .../test_tutorial001_py39.py                  | 38 ++-----------------
 .../test_dataclasses/test_tutorial003.py      | 22 ++---------
 .../test_tutorial004.py                       | 32 ++--------------
 .../test_tutorial005.py                       | 32 ++--------------
 .../test_tutorial005_py310.py                 | 32 ++--------------
 .../test_tutorial005_py39.py                  | 32 ++--------------
 .../test_path_params/test_tutorial005.py      |  4 +-
 .../test_tutorial001.py                       | 20 ++--------
 .../test_tutorial001_py310.py                 | 20 ++--------
 .../test_tutorial001_py39.py                  | 20 ++--------
 19 files changed, 63 insertions(+), 303 deletions(-)

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index c9723b25b..4ebc64a14 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -29,7 +29,7 @@ jobs:
         id: cache
         with:
           path: ${{ env.pythonLocation }}
-          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-pydantic-v2-${{ hashFiles('pyproject.toml', 'requirements-tests.txt') }}-test-v05
+          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-pydantic-v2-${{ hashFiles('pyproject.toml', 'requirements-tests.txt') }}-test-v06
       - name: Install Dependencies
         if: steps.cache.outputs.cache-hit != 'true'
         run: pip install -r requirements-tests.txt
@@ -62,7 +62,7 @@ jobs:
         id: cache
         with:
           path: ${{ env.pythonLocation }}
-          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-${{ matrix.pydantic-version }}-${{ hashFiles('pyproject.toml', 'requirements-tests.txt') }}-test-v05
+          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-${{ matrix.pydantic-version }}-${{ hashFiles('pyproject.toml', 'requirements-tests.txt') }}-test-v06
       - name: Install Dependencies
         if: steps.cache.outputs.cache-hit != 'true'
         run: pip install -r requirements-tests.txt
diff --git a/fastapi/_compat.py b/fastapi/_compat.py
index eb55b08f2..a4b305d42 100644
--- a/fastapi/_compat.py
+++ b/fastapi/_compat.py
@@ -58,9 +58,15 @@ if PYDANTIC_V2:
     from pydantic_core import CoreSchema as CoreSchema
     from pydantic_core import PydanticUndefined, PydanticUndefinedType
     from pydantic_core import Url as Url
-    from pydantic_core.core_schema import (
-        general_plain_validator_function as general_plain_validator_function,
-    )
+
+    try:
+        from pydantic_core.core_schema import (
+            with_info_plain_validator_function as with_info_plain_validator_function,
+        )
+    except ImportError:  # pragma: no cover
+        from pydantic_core.core_schema import (
+            general_plain_validator_function as with_info_plain_validator_function,  # noqa: F401
+        )
 
     Required = PydanticUndefined
     Undefined = PydanticUndefined
@@ -345,7 +351,7 @@ else:
     class PydanticSchemaGenerationError(Exception):  # type: ignore[no-redef]
         pass
 
-    def general_plain_validator_function(  # type: ignore[misc]
+    def with_info_plain_validator_function(  # type: ignore[misc]
         function: Callable[..., Any],
         *,
         ref: Union[str, None] = None,
diff --git a/fastapi/datastructures.py b/fastapi/datastructures.py
index 3c96c56c7..b2865cd40 100644
--- a/fastapi/datastructures.py
+++ b/fastapi/datastructures.py
@@ -5,7 +5,7 @@ from fastapi._compat import (
     CoreSchema,
     GetJsonSchemaHandler,
     JsonSchemaValue,
-    general_plain_validator_function,
+    with_info_plain_validator_function,
 )
 from starlette.datastructures import URL as URL  # noqa: F401
 from starlette.datastructures import Address as Address  # noqa: F401
@@ -49,7 +49,7 @@ class UploadFile(StarletteUploadFile):
     def __get_pydantic_core_schema__(
         cls, source: Type[Any], handler: Callable[[Any], CoreSchema]
     ) -> CoreSchema:
-        return general_plain_validator_function(cls._validate)
+        return with_info_plain_validator_function(cls._validate)
 
 
 class DefaultPlaceholder:
diff --git a/fastapi/openapi/models.py b/fastapi/openapi/models.py
index 3d982eb9a..5f3bdbb20 100644
--- a/fastapi/openapi/models.py
+++ b/fastapi/openapi/models.py
@@ -7,7 +7,7 @@ from fastapi._compat import (
     GetJsonSchemaHandler,
     JsonSchemaValue,
     _model_rebuild,
-    general_plain_validator_function,
+    with_info_plain_validator_function,
 )
 from fastapi.logger import logger
 from pydantic import AnyUrl, BaseModel, Field
@@ -52,7 +52,7 @@ except ImportError:  # pragma: no cover
         def __get_pydantic_core_schema__(
             cls, source: Type[Any], handler: Callable[[Any], CoreSchema]
         ) -> CoreSchema:
-            return general_plain_validator_function(cls._validate)
+            return with_info_plain_validator_function(cls._validate)
 
 
 class Contact(BaseModel):
diff --git a/tests/test_compat.py b/tests/test_compat.py
index 47160ee76..bf268b860 100644
--- a/tests/test_compat.py
+++ b/tests/test_compat.py
@@ -24,7 +24,7 @@ def test_model_field_default_required():
 
 
 @needs_pydanticv1
-def test_upload_file_dummy_general_plain_validator_function():
+def test_upload_file_dummy_with_info_plain_validator_function():
     # For coverage
     assert UploadFile.__get_pydantic_core_schema__(str, lambda x: None) == {}
 
diff --git a/tests/test_filter_pydantic_sub_model_pv2.py b/tests/test_filter_pydantic_sub_model_pv2.py
index 9f5e6b08f..9097d2ce5 100644
--- a/tests/test_filter_pydantic_sub_model_pv2.py
+++ b/tests/test_filter_pydantic_sub_model_pv2.py
@@ -12,7 +12,7 @@ from .utils import needs_pydanticv2
 
 @pytest.fixture(name="client")
 def get_client():
-    from pydantic import BaseModel, FieldValidationInfo, field_validator
+    from pydantic import BaseModel, ValidationInfo, field_validator
 
     app = FastAPI()
 
@@ -28,7 +28,7 @@ def get_client():
         foo: ModelB
 
         @field_validator("name")
-        def lower_username(cls, name: str, info: FieldValidationInfo):
+        def lower_username(cls, name: str, info: ValidationInfo):
             if not name.endswith("A"):
                 raise ValueError("name must end in A")
             return name
diff --git a/tests/test_openapi_separate_input_output_schemas.py b/tests/test_openapi_separate_input_output_schemas.py
index 70f4b90d7..aeb85f735 100644
--- a/tests/test_openapi_separate_input_output_schemas.py
+++ b/tests/test_openapi_separate_input_output_schemas.py
@@ -4,19 +4,23 @@ from fastapi import FastAPI
 from fastapi.testclient import TestClient
 from pydantic import BaseModel
 
-from .utils import needs_pydanticv2
+from .utils import PYDANTIC_V2, needs_pydanticv2
 
 
 class SubItem(BaseModel):
     subname: str
     sub_description: Optional[str] = None
     tags: List[str] = []
+    if PYDANTIC_V2:
+        model_config = {"json_schema_serialization_defaults_required": True}
 
 
 class Item(BaseModel):
     name: str
     description: Optional[str] = None
     sub: Optional[SubItem] = None
+    if PYDANTIC_V2:
+        model_config = {"json_schema_serialization_defaults_required": True}
 
 
 def get_app_client(separate_input_output_schemas: bool = True) -> TestClient:
diff --git a/tests/test_tutorial/test_body_updates/test_tutorial001.py b/tests/test_tutorial/test_body_updates/test_tutorial001.py
index 58587885e..e586534a0 100644
--- a/tests/test_tutorial/test_body_updates/test_tutorial001.py
+++ b/tests/test_tutorial/test_body_updates/test_tutorial001.py
@@ -52,9 +52,7 @@ def test_openapi_schema(client: TestClient):
                             "description": "Successful Response",
                             "content": {
                                 "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/Item-Output"
-                                    }
+                                    "schema": {"$ref": "#/components/schemas/Item"}
                                 }
                             },
                         },
@@ -86,9 +84,7 @@ def test_openapi_schema(client: TestClient):
                             "description": "Successful Response",
                             "content": {
                                 "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/Item-Output"
-                                    }
+                                    "schema": {"$ref": "#/components/schemas/Item"}
                                 }
                             },
                         },
@@ -116,7 +112,7 @@ def test_openapi_schema(client: TestClient):
                     "requestBody": {
                         "content": {
                             "application/json": {
-                                "schema": {"$ref": "#/components/schemas/Item-Input"}
+                                "schema": {"$ref": "#/components/schemas/Item"}
                             }
                         },
                         "required": True,
@@ -126,35 +122,9 @@ def test_openapi_schema(client: TestClient):
         },
         "components": {
             "schemas": {
-                "Item-Input": {
-                    "title": "Item",
+                "Item": {
                     "type": "object",
-                    "properties": {
-                        "name": {
-                            "title": "Name",
-                            "anyOf": [{"type": "string"}, {"type": "null"}],
-                        },
-                        "description": {
-                            "title": "Description",
-                            "anyOf": [{"type": "string"}, {"type": "null"}],
-                        },
-                        "price": {
-                            "title": "Price",
-                            "anyOf": [{"type": "number"}, {"type": "null"}],
-                        },
-                        "tax": {"title": "Tax", "type": "number", "default": 10.5},
-                        "tags": {
-                            "title": "Tags",
-                            "type": "array",
-                            "items": {"type": "string"},
-                            "default": [],
-                        },
-                    },
-                },
-                "Item-Output": {
                     "title": "Item",
-                    "type": "object",
-                    "required": ["name", "description", "price", "tax", "tags"],
                     "properties": {
                         "name": {
                             "anyOf": [{"type": "string"}, {"type": "null"}],
diff --git a/tests/test_tutorial/test_body_updates/test_tutorial001_py310.py b/tests/test_tutorial/test_body_updates/test_tutorial001_py310.py
index d8a62502f..6bc969d43 100644
--- a/tests/test_tutorial/test_body_updates/test_tutorial001_py310.py
+++ b/tests/test_tutorial/test_body_updates/test_tutorial001_py310.py
@@ -55,9 +55,7 @@ def test_openapi_schema(client: TestClient):
                             "description": "Successful Response",
                             "content": {
                                 "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/Item-Output"
-                                    }
+                                    "schema": {"$ref": "#/components/schemas/Item"}
                                 }
                             },
                         },
@@ -89,9 +87,7 @@ def test_openapi_schema(client: TestClient):
                             "description": "Successful Response",
                             "content": {
                                 "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/Item-Output"
-                                    }
+                                    "schema": {"$ref": "#/components/schemas/Item"}
                                 }
                             },
                         },
@@ -119,7 +115,7 @@ def test_openapi_schema(client: TestClient):
                     "requestBody": {
                         "content": {
                             "application/json": {
-                                "schema": {"$ref": "#/components/schemas/Item-Input"}
+                                "schema": {"$ref": "#/components/schemas/Item"}
                             }
                         },
                         "required": True,
@@ -129,35 +125,9 @@ def test_openapi_schema(client: TestClient):
         },
         "components": {
             "schemas": {
-                "Item-Input": {
-                    "title": "Item",
+                "Item": {
                     "type": "object",
-                    "properties": {
-                        "name": {
-                            "title": "Name",
-                            "anyOf": [{"type": "string"}, {"type": "null"}],
-                        },
-                        "description": {
-                            "title": "Description",
-                            "anyOf": [{"type": "string"}, {"type": "null"}],
-                        },
-                        "price": {
-                            "title": "Price",
-                            "anyOf": [{"type": "number"}, {"type": "null"}],
-                        },
-                        "tax": {"title": "Tax", "type": "number", "default": 10.5},
-                        "tags": {
-                            "title": "Tags",
-                            "type": "array",
-                            "items": {"type": "string"},
-                            "default": [],
-                        },
-                    },
-                },
-                "Item-Output": {
                     "title": "Item",
-                    "type": "object",
-                    "required": ["name", "description", "price", "tax", "tags"],
                     "properties": {
                         "name": {
                             "anyOf": [{"type": "string"}, {"type": "null"}],
diff --git a/tests/test_tutorial/test_body_updates/test_tutorial001_py39.py b/tests/test_tutorial/test_body_updates/test_tutorial001_py39.py
index c604df6ec..a1edb3370 100644
--- a/tests/test_tutorial/test_body_updates/test_tutorial001_py39.py
+++ b/tests/test_tutorial/test_body_updates/test_tutorial001_py39.py
@@ -55,9 +55,7 @@ def test_openapi_schema(client: TestClient):
                             "description": "Successful Response",
                             "content": {
                                 "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/Item-Output"
-                                    }
+                                    "schema": {"$ref": "#/components/schemas/Item"}
                                 }
                             },
                         },
@@ -89,9 +87,7 @@ def test_openapi_schema(client: TestClient):
                             "description": "Successful Response",
                             "content": {
                                 "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/Item-Output"
-                                    }
+                                    "schema": {"$ref": "#/components/schemas/Item"}
                                 }
                             },
                         },
@@ -119,7 +115,7 @@ def test_openapi_schema(client: TestClient):
                     "requestBody": {
                         "content": {
                             "application/json": {
-                                "schema": {"$ref": "#/components/schemas/Item-Input"}
+                                "schema": {"$ref": "#/components/schemas/Item"}
                             }
                         },
                         "required": True,
@@ -129,35 +125,9 @@ def test_openapi_schema(client: TestClient):
         },
         "components": {
             "schemas": {
-                "Item-Input": {
-                    "title": "Item",
+                "Item": {
                     "type": "object",
-                    "properties": {
-                        "name": {
-                            "title": "Name",
-                            "anyOf": [{"type": "string"}, {"type": "null"}],
-                        },
-                        "description": {
-                            "title": "Description",
-                            "anyOf": [{"type": "string"}, {"type": "null"}],
-                        },
-                        "price": {
-                            "title": "Price",
-                            "anyOf": [{"type": "number"}, {"type": "null"}],
-                        },
-                        "tax": {"title": "Tax", "type": "number", "default": 10.5},
-                        "tags": {
-                            "title": "Tags",
-                            "type": "array",
-                            "items": {"type": "string"},
-                            "default": [],
-                        },
-                    },
-                },
-                "Item-Output": {
                     "title": "Item",
-                    "type": "object",
-                    "required": ["name", "description", "price", "tax", "tags"],
                     "properties": {
                         "name": {
                             "anyOf": [{"type": "string"}, {"type": "null"}],
diff --git a/tests/test_tutorial/test_dataclasses/test_tutorial003.py b/tests/test_tutorial/test_dataclasses/test_tutorial003.py
index f2ca85823..dd0e36735 100644
--- a/tests/test_tutorial/test_dataclasses/test_tutorial003.py
+++ b/tests/test_tutorial/test_dataclasses/test_tutorial003.py
@@ -79,9 +79,7 @@ def test_openapi_schema():
                                 "schema": {
                                     "title": "Items",
                                     "type": "array",
-                                    "items": {
-                                        "$ref": "#/components/schemas/Item-Input"
-                                    },
+                                    "items": {"$ref": "#/components/schemas/Item"},
                                 }
                             }
                         },
@@ -136,14 +134,14 @@ def test_openapi_schema():
             "schemas": {
                 "Author": {
                     "title": "Author",
-                    "required": ["name", "items"],
+                    "required": ["name"],
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
                         "items": {
                             "title": "Items",
                             "type": "array",
-                            "items": {"$ref": "#/components/schemas/Item-Output"},
+                            "items": {"$ref": "#/components/schemas/Item"},
                         },
                     },
                 },
@@ -158,27 +156,15 @@ def test_openapi_schema():
                         }
                     },
                 },
-                "Item-Input": {
+                "Item": {
                     "title": "Item",
                     "required": ["name"],
                     "type": "object",
                     "properties": {
                         "name": {"title": "Name", "type": "string"},
                         "description": {
-                            "title": "Description",
                             "anyOf": [{"type": "string"}, {"type": "null"}],
-                        },
-                    },
-                },
-                "Item-Output": {
-                    "title": "Item",
-                    "required": ["name", "description"],
-                    "type": "object",
-                    "properties": {
-                        "name": {"title": "Name", "type": "string"},
-                        "description": {
                             "title": "Description",
-                            "anyOf": [{"type": "string"}, {"type": "null"}],
                         },
                     },
                 },
diff --git a/tests/test_tutorial/test_path_operation_advanced_configurations/test_tutorial004.py b/tests/test_tutorial/test_path_operation_advanced_configurations/test_tutorial004.py
index c5b2fb670..4f69e4646 100644
--- a/tests/test_tutorial/test_path_operation_advanced_configurations/test_tutorial004.py
+++ b/tests/test_tutorial/test_path_operation_advanced_configurations/test_tutorial004.py
@@ -34,9 +34,7 @@ def test_openapi_schema():
                             "description": "Successful Response",
                             "content": {
                                 "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/Item-Output"
-                                    }
+                                    "schema": {"$ref": "#/components/schemas/Item"}
                                 }
                             },
                         },
@@ -57,7 +55,7 @@ def test_openapi_schema():
                     "requestBody": {
                         "content": {
                             "application/json": {
-                                "schema": {"$ref": "#/components/schemas/Item-Input"}
+                                "schema": {"$ref": "#/components/schemas/Item"}
                             }
                         },
                         "required": True,
@@ -67,7 +65,7 @@ def test_openapi_schema():
         },
         "components": {
             "schemas": {
-                "Item-Input": {
+                "Item": {
                     "title": "Item",
                     "required": ["name", "price"],
                     "type": "object",
@@ -91,30 +89,6 @@ def test_openapi_schema():
                         },
                     },
                 },
-                "Item-Output": {
-                    "title": "Item",
-                    "required": ["name", "description", "price", "tax", "tags"],
-                    "type": "object",
-                    "properties": {
-                        "name": {"title": "Name", "type": "string"},
-                        "description": {
-                            "title": "Description",
-                            "anyOf": [{"type": "string"}, {"type": "null"}],
-                        },
-                        "price": {"title": "Price", "type": "number"},
-                        "tax": {
-                            "title": "Tax",
-                            "anyOf": [{"type": "number"}, {"type": "null"}],
-                        },
-                        "tags": {
-                            "title": "Tags",
-                            "uniqueItems": True,
-                            "type": "array",
-                            "items": {"type": "string"},
-                            "default": [],
-                        },
-                    },
-                },
                 "ValidationError": {
                     "title": "ValidationError",
                     "required": ["loc", "msg", "type"],
diff --git a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005.py b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005.py
index 458923b5a..d3792e701 100644
--- a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005.py
+++ b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005.py
@@ -34,9 +34,7 @@ def test_openapi_schema():
                             "description": "The created item",
                             "content": {
                                 "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/Item-Output"
-                                    }
+                                    "schema": {"$ref": "#/components/schemas/Item"}
                                 }
                             },
                         },
@@ -57,7 +55,7 @@ def test_openapi_schema():
                     "requestBody": {
                         "content": {
                             "application/json": {
-                                "schema": {"$ref": "#/components/schemas/Item-Input"}
+                                "schema": {"$ref": "#/components/schemas/Item"}
                             }
                         },
                         "required": True,
@@ -67,7 +65,7 @@ def test_openapi_schema():
         },
         "components": {
             "schemas": {
-                "Item-Input": {
+                "Item": {
                     "title": "Item",
                     "required": ["name", "price"],
                     "type": "object",
@@ -91,30 +89,6 @@ def test_openapi_schema():
                         },
                     },
                 },
-                "Item-Output": {
-                    "title": "Item",
-                    "required": ["name", "description", "price", "tax", "tags"],
-                    "type": "object",
-                    "properties": {
-                        "name": {"title": "Name", "type": "string"},
-                        "description": {
-                            "anyOf": [{"type": "string"}, {"type": "null"}],
-                            "title": "Description",
-                        },
-                        "price": {"title": "Price", "type": "number"},
-                        "tax": {
-                            "title": "Tax",
-                            "anyOf": [{"type": "number"}, {"type": "null"}],
-                        },
-                        "tags": {
-                            "title": "Tags",
-                            "uniqueItems": True,
-                            "type": "array",
-                            "items": {"type": "string"},
-                            "default": [],
-                        },
-                    },
-                },
                 "ValidationError": {
                     "title": "ValidationError",
                     "required": ["loc", "msg", "type"],
diff --git a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py310.py b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py310.py
index 1fcc5c4e0..a68deb3df 100644
--- a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py310.py
+++ b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py310.py
@@ -41,9 +41,7 @@ def test_openapi_schema(client: TestClient):
                             "description": "The created item",
                             "content": {
                                 "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/Item-Output"
-                                    }
+                                    "schema": {"$ref": "#/components/schemas/Item"}
                                 }
                             },
                         },
@@ -64,7 +62,7 @@ def test_openapi_schema(client: TestClient):
                     "requestBody": {
                         "content": {
                             "application/json": {
-                                "schema": {"$ref": "#/components/schemas/Item-Input"}
+                                "schema": {"$ref": "#/components/schemas/Item"}
                             }
                         },
                         "required": True,
@@ -74,7 +72,7 @@ def test_openapi_schema(client: TestClient):
         },
         "components": {
             "schemas": {
-                "Item-Input": {
+                "Item": {
                     "title": "Item",
                     "required": ["name", "price"],
                     "type": "object",
@@ -98,30 +96,6 @@ def test_openapi_schema(client: TestClient):
                         },
                     },
                 },
-                "Item-Output": {
-                    "title": "Item",
-                    "required": ["name", "description", "price", "tax", "tags"],
-                    "type": "object",
-                    "properties": {
-                        "name": {"title": "Name", "type": "string"},
-                        "description": {
-                            "anyOf": [{"type": "string"}, {"type": "null"}],
-                            "title": "Description",
-                        },
-                        "price": {"title": "Price", "type": "number"},
-                        "tax": {
-                            "title": "Tax",
-                            "anyOf": [{"type": "number"}, {"type": "null"}],
-                        },
-                        "tags": {
-                            "title": "Tags",
-                            "uniqueItems": True,
-                            "type": "array",
-                            "items": {"type": "string"},
-                            "default": [],
-                        },
-                    },
-                },
                 "ValidationError": {
                     "title": "ValidationError",
                     "required": ["loc", "msg", "type"],
diff --git a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py39.py b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py39.py
index 470fe032b..e17f2592d 100644
--- a/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py39.py
+++ b/tests/test_tutorial/test_path_operation_configurations/test_tutorial005_py39.py
@@ -41,9 +41,7 @@ def test_openapi_schema(client: TestClient):
                             "description": "The created item",
                             "content": {
                                 "application/json": {
-                                    "schema": {
-                                        "$ref": "#/components/schemas/Item-Output"
-                                    }
+                                    "schema": {"$ref": "#/components/schemas/Item"}
                                 }
                             },
                         },
@@ -64,7 +62,7 @@ def test_openapi_schema(client: TestClient):
                     "requestBody": {
                         "content": {
                             "application/json": {
-                                "schema": {"$ref": "#/components/schemas/Item-Input"}
+                                "schema": {"$ref": "#/components/schemas/Item"}
                             }
                         },
                         "required": True,
@@ -74,7 +72,7 @@ def test_openapi_schema(client: TestClient):
         },
         "components": {
             "schemas": {
-                "Item-Input": {
+                "Item": {
                     "title": "Item",
                     "required": ["name", "price"],
                     "type": "object",
@@ -98,30 +96,6 @@ def test_openapi_schema(client: TestClient):
                         },
                     },
                 },
-                "Item-Output": {
-                    "title": "Item",
-                    "required": ["name", "description", "price", "tax", "tags"],
-                    "type": "object",
-                    "properties": {
-                        "name": {"title": "Name", "type": "string"},
-                        "description": {
-                            "anyOf": [{"type": "string"}, {"type": "null"}],
-                            "title": "Description",
-                        },
-                        "price": {"title": "Price", "type": "number"},
-                        "tax": {
-                            "title": "Tax",
-                            "anyOf": [{"type": "number"}, {"type": "null"}],
-                        },
-                        "tags": {
-                            "title": "Tags",
-                            "uniqueItems": True,
-                            "type": "array",
-                            "items": {"type": "string"},
-                            "default": [],
-                        },
-                    },
-                },
                 "ValidationError": {
                     "title": "ValidationError",
                     "required": ["loc", "msg", "type"],
diff --git a/tests/test_tutorial/test_path_params/test_tutorial005.py b/tests/test_tutorial/test_path_params/test_tutorial005.py
index 90fa6adaf..2e4b0146b 100644
--- a/tests/test_tutorial/test_path_params/test_tutorial005.py
+++ b/tests/test_tutorial/test_path_params/test_tutorial005.py
@@ -33,9 +33,9 @@ def test_get_enums_invalid():
                 {
                     "type": "enum",
                     "loc": ["path", "model_name"],
-                    "msg": "Input should be 'alexnet','resnet' or 'lenet'",
+                    "msg": "Input should be 'alexnet', 'resnet' or 'lenet'",
                     "input": "foo",
-                    "ctx": {"expected": "'alexnet','resnet' or 'lenet'"},
+                    "ctx": {"expected": "'alexnet', 'resnet' or 'lenet'"},
                 }
             ]
         }
diff --git a/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001.py b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001.py
index 8079c1134..cdfae9f8c 100644
--- a/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001.py
+++ b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001.py
@@ -48,9 +48,7 @@ def test_openapi_schema(client: TestClient) -> None:
                             "content": {
                                 "application/json": {
                                     "schema": {
-                                        "items": {
-                                            "$ref": "#/components/schemas/Item-Output"
-                                        },
+                                        "items": {"$ref": "#/components/schemas/Item"},
                                         "type": "array",
                                         "title": "Response Read Items Items  Get",
                                     }
@@ -65,7 +63,7 @@ def test_openapi_schema(client: TestClient) -> None:
                     "requestBody": {
                         "content": {
                             "application/json": {
-                                "schema": {"$ref": "#/components/schemas/Item-Input"}
+                                "schema": {"$ref": "#/components/schemas/Item"}
                             }
                         },
                         "required": True,
@@ -102,7 +100,7 @@ def test_openapi_schema(client: TestClient) -> None:
                     "type": "object",
                     "title": "HTTPValidationError",
                 },
-                "Item-Input": {
+                "Item": {
                     "properties": {
                         "name": {"type": "string", "title": "Name"},
                         "description": {
@@ -114,18 +112,6 @@ def test_openapi_schema(client: TestClient) -> None:
                     "required": ["name"],
                     "title": "Item",
                 },
-                "Item-Output": {
-                    "properties": {
-                        "name": {"type": "string", "title": "Name"},
-                        "description": {
-                            "anyOf": [{"type": "string"}, {"type": "null"}],
-                            "title": "Description",
-                        },
-                    },
-                    "type": "object",
-                    "required": ["name", "description"],
-                    "title": "Item",
-                },
                 "ValidationError": {
                     "properties": {
                         "loc": {
diff --git a/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py310.py b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py310.py
index 4fa98ccbe..3b22146f6 100644
--- a/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py310.py
+++ b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py310.py
@@ -51,9 +51,7 @@ def test_openapi_schema(client: TestClient) -> None:
                             "content": {
                                 "application/json": {
                                     "schema": {
-                                        "items": {
-                                            "$ref": "#/components/schemas/Item-Output"
-                                        },
+                                        "items": {"$ref": "#/components/schemas/Item"},
                                         "type": "array",
                                         "title": "Response Read Items Items  Get",
                                     }
@@ -68,7 +66,7 @@ def test_openapi_schema(client: TestClient) -> None:
                     "requestBody": {
                         "content": {
                             "application/json": {
-                                "schema": {"$ref": "#/components/schemas/Item-Input"}
+                                "schema": {"$ref": "#/components/schemas/Item"}
                             }
                         },
                         "required": True,
@@ -105,7 +103,7 @@ def test_openapi_schema(client: TestClient) -> None:
                     "type": "object",
                     "title": "HTTPValidationError",
                 },
-                "Item-Input": {
+                "Item": {
                     "properties": {
                         "name": {"type": "string", "title": "Name"},
                         "description": {
@@ -117,18 +115,6 @@ def test_openapi_schema(client: TestClient) -> None:
                     "required": ["name"],
                     "title": "Item",
                 },
-                "Item-Output": {
-                    "properties": {
-                        "name": {"type": "string", "title": "Name"},
-                        "description": {
-                            "anyOf": [{"type": "string"}, {"type": "null"}],
-                            "title": "Description",
-                        },
-                    },
-                    "type": "object",
-                    "required": ["name", "description"],
-                    "title": "Item",
-                },
                 "ValidationError": {
                     "properties": {
                         "loc": {
diff --git a/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py39.py b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py39.py
index ad36582ed..991abe811 100644
--- a/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py39.py
+++ b/tests/test_tutorial/test_separate_openapi_schemas/test_tutorial001_py39.py
@@ -51,9 +51,7 @@ def test_openapi_schema(client: TestClient) -> None:
                             "content": {
                                 "application/json": {
                                     "schema": {
-                                        "items": {
-                                            "$ref": "#/components/schemas/Item-Output"
-                                        },
+                                        "items": {"$ref": "#/components/schemas/Item"},
                                         "type": "array",
                                         "title": "Response Read Items Items  Get",
                                     }
@@ -68,7 +66,7 @@ def test_openapi_schema(client: TestClient) -> None:
                     "requestBody": {
                         "content": {
                             "application/json": {
-                                "schema": {"$ref": "#/components/schemas/Item-Input"}
+                                "schema": {"$ref": "#/components/schemas/Item"}
                             }
                         },
                         "required": True,
@@ -105,7 +103,7 @@ def test_openapi_schema(client: TestClient) -> None:
                     "type": "object",
                     "title": "HTTPValidationError",
                 },
-                "Item-Input": {
+                "Item": {
                     "properties": {
                         "name": {"type": "string", "title": "Name"},
                         "description": {
@@ -117,18 +115,6 @@ def test_openapi_schema(client: TestClient) -> None:
                     "required": ["name"],
                     "title": "Item",
                 },
-                "Item-Output": {
-                    "properties": {
-                        "name": {"type": "string", "title": "Name"},
-                        "description": {
-                            "anyOf": [{"type": "string"}, {"type": "null"}],
-                            "title": "Description",
-                        },
-                    },
-                    "type": "object",
-                    "required": ["name", "description"],
-                    "title": "Item",
-                },
                 "ValidationError": {
                     "properties": {
                         "loc": {

From 831b5d5402a65ee9f415670f4116522c8e874ed3 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 28 Sep 2023 04:15:17 +0000
Subject: [PATCH 203/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 52ee4c7fd..a8b9bba03 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ⬆️ Upgrade compatibility with Pydantic v2.4, new renamed functions and JSON Schema input/output models with default values. PR [#10344](https://github.com/tiangolo/fastapi/pull/10344) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Rename label "awaiting review" to "awaiting-review" to simplify search queries. PR [#10343](https://github.com/tiangolo/fastapi/pull/10343) by [@tiangolo](https://github.com/tiangolo).
 * 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/extra-data-types.md`. PR [#10132](https://github.com/tiangolo/fastapi/pull/10132) by [@ArtemKhymenko](https://github.com/ArtemKhymenko).
 * 🌐 Fix typos in French translations for `docs/fr/docs/advanced/path-operation-advanced-configuration.md`, `docs/fr/docs/alternatives.md`, `docs/fr/docs/async.md`, `docs/fr/docs/features.md`, `docs/fr/docs/help-fastapi.md`, `docs/fr/docs/index.md`, `docs/fr/docs/python-types.md`, `docs/fr/docs/tutorial/body.md`, `docs/fr/docs/tutorial/first-steps.md`, `docs/fr/docs/tutorial/query-params.md`. PR [#10154](https://github.com/tiangolo/fastapi/pull/10154) by [@s-rigaud](https://github.com/s-rigaud).

From 2f50ae882589e26aa725555a88adcb3cdd793137 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 28 Sep 2023 14:41:17 -0500
Subject: [PATCH 204/317] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors,=20rem?=
 =?UTF-8?q?ove=20Flint=20(#10349)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/data/sponsors.yml | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index 5d7752d29..cea547a10 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -43,9 +43,6 @@ bronze:
   - url: https://www.exoflare.com/open-source/?utm_source=FastAPI&utm_campaign=open_source
     title: Biosecurity risk assessments made easy.
     img: https://fastapi.tiangolo.com/img/sponsors/exoflare.png
-  - url: https://www.flint.sh
-    title: IT expertise, consulting and development by passionate people
-    img: https://fastapi.tiangolo.com/img/sponsors/flint.png
   - url: https://bit.ly/3JJ7y5C
     title: Build cross-modal and multimodal applications on the cloud
     img: https://fastapi.tiangolo.com/img/sponsors/jina2.svg

From d769da3c38a2b882799a69499b862a5e964e9d4e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 28 Sep 2023 19:42:38 +0000
Subject: [PATCH 205/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index a8b9bba03..ed5598551 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🔧 Update sponsors, remove Flint. PR [#10349](https://github.com/tiangolo/fastapi/pull/10349) by [@tiangolo](https://github.com/tiangolo).
 * ⬆️ Upgrade compatibility with Pydantic v2.4, new renamed functions and JSON Schema input/output models with default values. PR [#10344](https://github.com/tiangolo/fastapi/pull/10344) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Rename label "awaiting review" to "awaiting-review" to simplify search queries. PR [#10343](https://github.com/tiangolo/fastapi/pull/10343) by [@tiangolo](https://github.com/tiangolo).
 * 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/extra-data-types.md`. PR [#10132](https://github.com/tiangolo/fastapi/pull/10132) by [@ArtemKhymenko](https://github.com/ArtemKhymenko).

From d0b17dd49c299404e60f78a349f547a460357a3c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 28 Sep 2023 14:51:39 -0500
Subject: [PATCH 206/317] =?UTF-8?q?=E2=AC=86=EF=B8=8F=20Upgrade=20Python?=
 =?UTF-8?q?=20version=20in=20Docker=20images=20for=20GitHub=20Actions=20(#?=
 =?UTF-8?q?10350)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/actions/comment-docs-preview-in-pr/Dockerfile | 2 +-
 .github/actions/notify-translations/Dockerfile        | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/actions/comment-docs-preview-in-pr/Dockerfile b/.github/actions/comment-docs-preview-in-pr/Dockerfile
index 4f20c5f10..14b0d0269 100644
--- a/.github/actions/comment-docs-preview-in-pr/Dockerfile
+++ b/.github/actions/comment-docs-preview-in-pr/Dockerfile
@@ -1,4 +1,4 @@
-FROM python:3.7
+FROM python:3.9
 
 RUN pip install httpx "pydantic==1.5.1" pygithub
 
diff --git a/.github/actions/notify-translations/Dockerfile b/.github/actions/notify-translations/Dockerfile
index fa4197e6a..b68b4bb1a 100644
--- a/.github/actions/notify-translations/Dockerfile
+++ b/.github/actions/notify-translations/Dockerfile
@@ -1,4 +1,4 @@
-FROM python:3.7
+FROM python:3.9
 
 RUN pip install httpx PyGithub "pydantic==1.5.1" "pyyaml>=5.3.1,<6.0.0"
 

From fcda32d2311b79606f8a5c3f0556d0a30ea082a2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 28 Sep 2023 14:56:50 -0500
Subject: [PATCH 207/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ed5598551..1a74cc17f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,9 +2,12 @@
 
 ## Latest Changes
 
-* 🔧 Update sponsors, remove Flint. PR [#10349](https://github.com/tiangolo/fastapi/pull/10349) by [@tiangolo](https://github.com/tiangolo).
+### Refactors
+
 * ⬆️ Upgrade compatibility with Pydantic v2.4, new renamed functions and JSON Schema input/output models with default values. PR [#10344](https://github.com/tiangolo/fastapi/pull/10344) by [@tiangolo](https://github.com/tiangolo).
-* 🔧 Rename label "awaiting review" to "awaiting-review" to simplify search queries. PR [#10343](https://github.com/tiangolo/fastapi/pull/10343) by [@tiangolo](https://github.com/tiangolo).
+
+### Translations
+
 * 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/extra-data-types.md`. PR [#10132](https://github.com/tiangolo/fastapi/pull/10132) by [@ArtemKhymenko](https://github.com/ArtemKhymenko).
 * 🌐 Fix typos in French translations for `docs/fr/docs/advanced/path-operation-advanced-configuration.md`, `docs/fr/docs/alternatives.md`, `docs/fr/docs/async.md`, `docs/fr/docs/features.md`, `docs/fr/docs/help-fastapi.md`, `docs/fr/docs/index.md`, `docs/fr/docs/python-types.md`, `docs/fr/docs/tutorial/body.md`, `docs/fr/docs/tutorial/first-steps.md`, `docs/fr/docs/tutorial/query-params.md`. PR [#10154](https://github.com/tiangolo/fastapi/pull/10154) by [@s-rigaud](https://github.com/s-rigaud).
 * 🌐 Add Chinese translation for `docs/zh/docs/async.md`. PR [#5591](https://github.com/tiangolo/fastapi/pull/5591) by [@mkdir700](https://github.com/mkdir700).
@@ -15,6 +18,11 @@
 * 🌐 Add Polish translation for `docs/pl/docs/help-fastapi.md`. PR [#10121](https://github.com/tiangolo/fastapi/pull/10121) by [@romabozhanovgithub](https://github.com/romabozhanovgithub).
 * 🌐 Add Russian translation for `docs/ru/docs/tutorial/header-params.md`. PR [#10226](https://github.com/tiangolo/fastapi/pull/10226) by [@AlertRED](https://github.com/AlertRED).
 * 🌐 Add Chinese translation for `docs/zh/docs/deployment/versions.md`. PR [#10276](https://github.com/tiangolo/fastapi/pull/10276) by [@xzmeng](https://github.com/xzmeng).
+
+### Internal
+
+* 🔧 Update sponsors, remove Flint. PR [#10349](https://github.com/tiangolo/fastapi/pull/10349) by [@tiangolo](https://github.com/tiangolo).
+* 🔧 Rename label "awaiting review" to "awaiting-review" to simplify search queries. PR [#10343](https://github.com/tiangolo/fastapi/pull/10343) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, enable Svix (revert #10228). PR [#10253](https://github.com/tiangolo/fastapi/pull/10253) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, remove Svix. PR [#10228](https://github.com/tiangolo/fastapi/pull/10228) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, add Bump.sh. PR [#10227](https://github.com/tiangolo/fastapi/pull/10227) by [@tiangolo](https://github.com/tiangolo).

From 1bf5e7a10e33d6f65e0f701ec271785fbc9b463c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 28 Sep 2023 14:57:42 -0500
Subject: [PATCH 208/317] =?UTF-8?q?=F0=9F=94=96=20Release=200.103.2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 2 ++
 fastapi/__init__.py           | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 1a74cc17f..11333a712 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,8 @@
 
 ## Latest Changes
 
+## 0.103.2
+
 ### Refactors
 
 * ⬆️ Upgrade compatibility with Pydantic v2.4, new renamed functions and JSON Schema input/output models with default values. PR [#10344](https://github.com/tiangolo/fastapi/pull/10344) by [@tiangolo](https://github.com/tiangolo).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index 329477e41..981ca4945 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.103.1"
+__version__ = "0.103.2"
 
 from starlette import status as status
 

From 568b35f3dfbc4c4c5e02c292c672dc509d62b460 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Mon, 2 Oct 2023 18:11:52 -0500
Subject: [PATCH 209/317] =?UTF-8?q?=F0=9F=91=A5=20Update=20FastAPI=20Peopl?=
 =?UTF-8?q?e=20(#10363)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: github-actions <github-actions@github.com>
---
 docs/en/data/github_sponsors.yml |  80 +++++++-----------
 docs/en/data/people.yml          | 138 +++++++++++++++----------------
 2 files changed, 100 insertions(+), 118 deletions(-)

diff --git a/docs/en/data/github_sponsors.yml b/docs/en/data/github_sponsors.yml
index 1ec71dd49..b9d74ea7b 100644
--- a/docs/en/data/github_sponsors.yml
+++ b/docs/en/data/github_sponsors.yml
@@ -1,5 +1,8 @@
 sponsors:
-- - login: cryptapi
+- - login: bump-sh
+    avatarUrl: https://avatars.githubusercontent.com/u/33217836?v=4
+    url: https://github.com/bump-sh
+  - login: cryptapi
     avatarUrl: https://avatars.githubusercontent.com/u/44925437?u=61369138589bc7fee6c417f3fbd50fbd38286cc4&v=4
     url: https://github.com/cryptapi
   - login: porter-dev
@@ -29,15 +32,15 @@ sponsors:
   - login: deepset-ai
     avatarUrl: https://avatars.githubusercontent.com/u/51827949?v=4
     url: https://github.com/deepset-ai
+  - login: svix
+    avatarUrl: https://avatars.githubusercontent.com/u/80175132?v=4
+    url: https://github.com/svix
   - login: databento-bot
     avatarUrl: https://avatars.githubusercontent.com/u/98378480?u=494f679996e39427f7ddb1a7de8441b7c96fb670&v=4
     url: https://github.com/databento-bot
   - login: VincentParedes
     avatarUrl: https://avatars.githubusercontent.com/u/103889729?v=4
     url: https://github.com/VincentParedes
-- - login: getsentry
-    avatarUrl: https://avatars.githubusercontent.com/u/1396951?v=4
-    url: https://github.com/getsentry
 - - login: acsone
     avatarUrl: https://avatars.githubusercontent.com/u/7601056?v=4
     url: https://github.com/acsone
@@ -50,9 +53,6 @@ sponsors:
   - login: marvin-robot
     avatarUrl: https://avatars.githubusercontent.com/u/41086007?u=091c5cb75af363123d66f58194805a97220ee1a7&v=4
     url: https://github.com/marvin-robot
-  - login: Flint-company
-    avatarUrl: https://avatars.githubusercontent.com/u/48908872?u=355cd3d8992d4be8173058e7000728757c55ad49&v=4
-    url: https://github.com/Flint-company
   - login: BoostryJP
     avatarUrl: https://avatars.githubusercontent.com/u/57932412?v=4
     url: https://github.com/BoostryJP
@@ -77,9 +77,6 @@ sponsors:
   - login: AccentDesign
     avatarUrl: https://avatars.githubusercontent.com/u/2429332?v=4
     url: https://github.com/AccentDesign
-  - login: RodneyU215
-    avatarUrl: https://avatars.githubusercontent.com/u/3329665?u=ec6a9adf8e7e8e306eed7d49687c398608d1604f&v=4
-    url: https://github.com/RodneyU215
   - login: americanair
     avatarUrl: https://avatars.githubusercontent.com/u/12281813?v=4
     url: https://github.com/americanair
@@ -89,16 +86,10 @@ sponsors:
 - - login: povilasb
     avatarUrl: https://avatars.githubusercontent.com/u/1213442?u=b11f58ed6ceea6e8297c9b310030478ebdac894d&v=4
     url: https://github.com/povilasb
-  - login: mukulmantosh
-    avatarUrl: https://avatars.githubusercontent.com/u/15572034?u=006f0a33c0e15bb2de57474a2cf7d2f8ee05f5a0&v=4
-    url: https://github.com/mukulmantosh
   - login: primer-io
     avatarUrl: https://avatars.githubusercontent.com/u/62146168?v=4
     url: https://github.com/primer-io
-- - login: indeedeng
-    avatarUrl: https://avatars.githubusercontent.com/u/2905043?v=4
-    url: https://github.com/indeedeng
-  - login: NateXVI
+- - login: NateXVI
     avatarUrl: https://avatars.githubusercontent.com/u/48195620?u=4bc8751ae50cb087c40c1fe811764aa070b9eea6&v=4
     url: https://github.com/NateXVI
 - - login: Kludex
@@ -113,9 +104,6 @@ sponsors:
   - login: jstanden
     avatarUrl: https://avatars.githubusercontent.com/u/63288?u=c3658d57d2862c607a0e19c2101c3c51876e36ad&v=4
     url: https://github.com/jstanden
-  - login: dekoza
-    avatarUrl: https://avatars.githubusercontent.com/u/210980?u=c03c78a8ae1039b500dfe343665536ebc51979b2&v=4
-    url: https://github.com/dekoza
   - login: pamelafox
     avatarUrl: https://avatars.githubusercontent.com/u/297042?v=4
     url: https://github.com/pamelafox
@@ -143,9 +131,6 @@ sponsors:
   - login: mickaelandrieu
     avatarUrl: https://avatars.githubusercontent.com/u/1247388?u=599f6e73e452a9453f2bd91e5c3100750e731ad4&v=4
     url: https://github.com/mickaelandrieu
-  - login: jonakoudijs
-    avatarUrl: https://avatars.githubusercontent.com/u/1906344?u=5ca0c9a1a89b6a2ba31abe35c66bdc07af60a632&v=4
-    url: https://github.com/jonakoudijs
   - login: Shark009
     avatarUrl: https://avatars.githubusercontent.com/u/3163309?u=0c6f4091b0eda05c44c390466199826e6dc6e431&v=4
     url: https://github.com/Shark009
@@ -227,6 +212,9 @@ sponsors:
   - login: Filimoa
     avatarUrl: https://avatars.githubusercontent.com/u/21352040?u=0be845711495bbd7b756e13fcaeb8efc1ebd78ba&v=4
     url: https://github.com/Filimoa
+  - login: rahulsalgare
+    avatarUrl: https://avatars.githubusercontent.com/u/21974430?u=ade6f182b94554ab8491d7421de5e78f711dcaf8&v=4
+    url: https://github.com/rahulsalgare
   - login: BrettskiPy
     avatarUrl: https://avatars.githubusercontent.com/u/30988215?u=d8a94a67e140d5ee5427724b292cc52d8827087a&v=4
     url: https://github.com/BrettskiPy
@@ -245,9 +233,6 @@ sponsors:
   - login: ProteinQure
     avatarUrl: https://avatars.githubusercontent.com/u/33707203?v=4
     url: https://github.com/ProteinQure
-  - login: askurihin
-    avatarUrl: https://avatars.githubusercontent.com/u/37978981?v=4
-    url: https://github.com/askurihin
   - login: arleybri18
     avatarUrl: https://avatars.githubusercontent.com/u/39681546?u=5c028f81324b0e8c73b3c15bc4e7b0218d2ba0c3&v=4
     url: https://github.com/arleybri18
@@ -266,27 +251,18 @@ sponsors:
   - login: dudikbender
     avatarUrl: https://avatars.githubusercontent.com/u/53487583?u=3a57542938ebfd57579a0111db2b297e606d9681&v=4
     url: https://github.com/dudikbender
-  - login: thisistheplace
-    avatarUrl: https://avatars.githubusercontent.com/u/57633545?u=a3f3a7f8ace8511c6c067753f6eb6aee0db11ac6&v=4
-    url: https://github.com/thisistheplace
   - login: yakkonaut
     avatarUrl: https://avatars.githubusercontent.com/u/60633704?u=90a71fd631aa998ba4a96480788f017c9904e07b&v=4
     url: https://github.com/yakkonaut
   - login: patsatsia
     avatarUrl: https://avatars.githubusercontent.com/u/61111267?u=3271b85f7a37b479c8d0ae0a235182e83c166edf&v=4
     url: https://github.com/patsatsia
-  - login: daverin
-    avatarUrl: https://avatars.githubusercontent.com/u/70378377?u=6d1814195c0de7162820eaad95a25b423a3869c0&v=4
-    url: https://github.com/daverin
   - login: anthonycepeda
     avatarUrl: https://avatars.githubusercontent.com/u/72019805?u=4252c6b6dc5024af502a823a3ac5e7a03a69963f&v=4
     url: https://github.com/anthonycepeda
   - login: DelfinaCare
     avatarUrl: https://avatars.githubusercontent.com/u/83734439?v=4
     url: https://github.com/DelfinaCare
-  - login: hbakri
-    avatarUrl: https://avatars.githubusercontent.com/u/92298226?u=36eee6d75db1272264d3ee92f1871f70b8917bd8&v=4
-    url: https://github.com/hbakri
   - login: osawa-koki
     avatarUrl: https://avatars.githubusercontent.com/u/94336223?u=59c6fe6945bcbbaff87b2a794238671b060620d2&v=4
     url: https://github.com/osawa-koki
@@ -305,6 +281,9 @@ sponsors:
   - login: bryanculbertson
     avatarUrl: https://avatars.githubusercontent.com/u/144028?u=defda4f90e93429221cc667500944abde60ebe4a&v=4
     url: https://github.com/bryanculbertson
+  - login: yourkin
+    avatarUrl: https://avatars.githubusercontent.com/u/178984?u=b43a7e5f8818f7d9083d3b110118d9c27d48a794&v=4
+    url: https://github.com/yourkin
   - login: slafs
     avatarUrl: https://avatars.githubusercontent.com/u/210173?v=4
     url: https://github.com/slafs
@@ -320,9 +299,6 @@ sponsors:
   - login: securancy
     avatarUrl: https://avatars.githubusercontent.com/u/606673?v=4
     url: https://github.com/securancy
-  - login: hardbyte
-    avatarUrl: https://avatars.githubusercontent.com/u/855189?u=aa29e92f34708814d6b67fcd47ca4cf2ce1c04ed&v=4
-    url: https://github.com/hardbyte
   - login: browniebroke
     avatarUrl: https://avatars.githubusercontent.com/u/861044?u=5abfca5588f3e906b31583d7ee62f6de4b68aa24&v=4
     url: https://github.com/browniebroke
@@ -423,7 +399,7 @@ sponsors:
     avatarUrl: https://avatars.githubusercontent.com/u/17927101?u=9261b9bb0c3e3bb1ecba43e8915dc58d8c9a077e&v=4
     url: https://github.com/jangia
   - login: timzaz
-    avatarUrl: https://avatars.githubusercontent.com/u/19709244?u=e6658f6b0b188294ce2db20dad94a678fcea718d&v=4
+    avatarUrl: https://avatars.githubusercontent.com/u/19709244?u=264d7db95c28156363760229c30ee1116efd4eeb&v=4
     url: https://github.com/timzaz
   - login: shuheng-liu
     avatarUrl: https://avatars.githubusercontent.com/u/22414322?u=813c45f30786c6b511b21a661def025d8f7b609e&v=4
@@ -443,6 +419,9 @@ sponsors:
   - login: joerambo
     avatarUrl: https://avatars.githubusercontent.com/u/26282974?v=4
     url: https://github.com/joerambo
+  - login: msniezynski
+    avatarUrl: https://avatars.githubusercontent.com/u/27588547?u=0e3be5ac57dcfdf124f470bcdf74b5bf79af1b6c&v=4
+    url: https://github.com/msniezynski
   - login: rlnchow
     avatarUrl: https://avatars.githubusercontent.com/u/28018479?u=a93ca9cf1422b9ece155784a72d5f2fdbce7adff&v=4
     url: https://github.com/rlnchow
@@ -464,6 +443,12 @@ sponsors:
   - login: miraedbswo
     avatarUrl: https://avatars.githubusercontent.com/u/36796047?u=9e7a5b3e558edc61d35d0f9dfac37541bae7f56d&v=4
     url: https://github.com/miraedbswo
+  - login: DSMilestone6538
+    avatarUrl: https://avatars.githubusercontent.com/u/37230924?u=f299dce910366471523155e0cb213356d34aadc1&v=4
+    url: https://github.com/DSMilestone6538
+  - login: curegit
+    avatarUrl: https://avatars.githubusercontent.com/u/37978051?u=1733c322079118c0cdc573c03d92813f50a9faec&v=4
+    url: https://github.com/curegit
   - login: kristiangronberg
     avatarUrl: https://avatars.githubusercontent.com/u/42678548?v=4
     url: https://github.com/kristiangronberg
@@ -491,11 +476,8 @@ sponsors:
   - login: romabozhanovgithub
     avatarUrl: https://avatars.githubusercontent.com/u/67696229?u=e4b921eef096415300425aca249348f8abb78ad7&v=4
     url: https://github.com/romabozhanovgithub
-  - login: mnicolleUTC
-    avatarUrl: https://avatars.githubusercontent.com/u/68548924?u=1fdd7f436bb1f4857c3415e62aa8fbc055fc1a76&v=4
-    url: https://github.com/mnicolleUTC
   - login: mbukeRepo
-    avatarUrl: https://avatars.githubusercontent.com/u/70356088?u=e125069c6ac5c49355e2b3ca2aa66a445fc4cccd&v=4
+    avatarUrl: https://avatars.githubusercontent.com/u/70356088?u=d2eb23e2b222a3b316c4183b05a3236b32819dc2&v=4
     url: https://github.com/mbukeRepo
 - - login: ssbarnea
     avatarUrl: https://avatars.githubusercontent.com/u/102495?u=b4bf6818deefe59952ac22fec6ed8c76de1b8f7c&v=4
@@ -515,12 +497,12 @@ sponsors:
   - login: danburonline
     avatarUrl: https://avatars.githubusercontent.com/u/34251194?u=2cad4388c1544e539ecb732d656e42fb07b4ff2d&v=4
     url: https://github.com/danburonline
-  - login: koalawangyang
-    avatarUrl: https://avatars.githubusercontent.com/u/40114367?u=3bb94010f0473b8d4c2edea5a8c1cab61e6a1b22&v=4
-    url: https://github.com/koalawangyang
   - login: rwxd
     avatarUrl: https://avatars.githubusercontent.com/u/40308458?u=cd04a39e3655923be4f25c2ba8a5a07b3da3230a&v=4
     url: https://github.com/rwxd
-  - login: lodine-software
-    avatarUrl: https://avatars.githubusercontent.com/u/133536046?v=4
-    url: https://github.com/lodine-software
+  - login: shywn-mrk
+    avatarUrl: https://avatars.githubusercontent.com/u/51455763?u=389e2608e4056fe5e1f23e9ad56a9415277504d3&v=4
+    url: https://github.com/shywn-mrk
+  - login: almeida-matheus
+    avatarUrl: https://avatars.githubusercontent.com/u/66216198?u=54335eaa0ced626be5c1ff52fead1ebc032286ec&v=4
+    url: https://github.com/almeida-matheus
diff --git a/docs/en/data/people.yml b/docs/en/data/people.yml
index 8ebd2f84c..db06cbdaf 100644
--- a/docs/en/data/people.yml
+++ b/docs/en/data/people.yml
@@ -1,12 +1,12 @@
 maintainers:
 - login: tiangolo
-  answers: 1866
-  prs: 486
+  answers: 1868
+  prs: 496
   avatarUrl: https://avatars.githubusercontent.com/u/1326112?u=740f11212a731f56798f558ceddb0bd07642afa7&v=4
   url: https://github.com/tiangolo
 experts:
 - login: Kludex
-  count: 480
+  count: 501
   avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
   url: https://github.com/Kludex
 - login: dmontagu
@@ -26,7 +26,7 @@ experts:
   avatarUrl: https://avatars.githubusercontent.com/u/13659033?u=e8bea32d07a5ef72f7dde3b2079ceb714923ca05&v=4
   url: https://github.com/JarroVGIT
 - login: jgould22
-  count: 164
+  count: 168
   avatarUrl: https://avatars.githubusercontent.com/u/4335847?u=ed77f67e0bb069084639b24d812dbb2a2b1dc554&v=4
   url: https://github.com/jgould22
 - login: euri10
@@ -61,10 +61,10 @@ experts:
   count: 49
   avatarUrl: https://avatars.githubusercontent.com/u/516999?u=437c0c5038558c67e887ccd863c1ba0f846c03da&v=4
   url: https://github.com/sm-Fifteen
-- login: yinziyan1206
+- login: acidjunk
   count: 45
-  avatarUrl: https://avatars.githubusercontent.com/u/37829370?u=da44ca53aefd5c23f346fab8e9fd2e108294c179&v=4
-  url: https://github.com/yinziyan1206
+  avatarUrl: https://avatars.githubusercontent.com/u/685002?u=b5094ab4527fc84b006c0ac9ff54367bdebb2267&v=4
+  url: https://github.com/acidjunk
 - login: insomnes
   count: 45
   avatarUrl: https://avatars.githubusercontent.com/u/16958893?u=f8be7088d5076d963984a21f95f44e559192d912&v=4
@@ -73,14 +73,14 @@ experts:
   count: 45
   avatarUrl: https://avatars.githubusercontent.com/u/27180793?u=5cf2877f50b3eb2bc55086089a78a36f07042889&v=4
   url: https://github.com/Dustyposa
-- login: acidjunk
-  count: 45
-  avatarUrl: https://avatars.githubusercontent.com/u/685002?u=b5094ab4527fc84b006c0ac9ff54367bdebb2267&v=4
-  url: https://github.com/acidjunk
 - login: adriangb
-  count: 44
+  count: 45
   avatarUrl: https://avatars.githubusercontent.com/u/1755071?u=612704256e38d6ac9cbed24f10e4b6ac2da74ecb&v=4
   url: https://github.com/adriangb
+- login: yinziyan1206
+  count: 44
+  avatarUrl: https://avatars.githubusercontent.com/u/37829370?u=da44ca53aefd5c23f346fab8e9fd2e108294c179&v=4
+  url: https://github.com/yinziyan1206
 - login: odiseo0
   count: 43
   avatarUrl: https://avatars.githubusercontent.com/u/87550035?u=241a71f6b7068738b81af3e57f45ffd723538401&v=4
@@ -93,18 +93,22 @@ experts:
   count: 40
   avatarUrl: https://avatars.githubusercontent.com/u/11836741?u=8bd5ef7e62fe6a82055e33c4c0e0a7879ff8cfb6&v=4
   url: https://github.com/includeamin
+- login: chbndrhnns
+  count: 38
+  avatarUrl: https://avatars.githubusercontent.com/u/7534547?v=4
+  url: https://github.com/chbndrhnns
 - login: STeveShary
   count: 37
   avatarUrl: https://avatars.githubusercontent.com/u/5167622?u=de8f597c81d6336fcebc37b32dfd61a3f877160c&v=4
   url: https://github.com/STeveShary
-- login: chbndrhnns
-  count: 36
-  avatarUrl: https://avatars.githubusercontent.com/u/7534547?v=4
-  url: https://github.com/chbndrhnns
 - login: krishnardt
   count: 35
   avatarUrl: https://avatars.githubusercontent.com/u/31960541?u=47f4829c77f4962ab437ffb7995951e41eeebe9b&v=4
   url: https://github.com/krishnardt
+- login: n8sty
+  count: 32
+  avatarUrl: https://avatars.githubusercontent.com/u/2964996?v=4
+  url: https://github.com/n8sty
 - login: panla
   count: 32
   avatarUrl: https://avatars.githubusercontent.com/u/41326348?u=ba2fda6b30110411ecbf406d187907e2b420ac19&v=4
@@ -117,10 +121,6 @@ experts:
   count: 26
   avatarUrl: https://avatars.githubusercontent.com/u/43723790?u=9bcce836bbce55835291c5b2ac93a4e311f4b3c3&v=4
   url: https://github.com/dbanty
-- login: n8sty
-  count: 25
-  avatarUrl: https://avatars.githubusercontent.com/u/2964996?v=4
-  url: https://github.com/n8sty
 - login: wshayes
   count: 25
   avatarUrl: https://avatars.githubusercontent.com/u/365303?u=07ca03c5ee811eb0920e633cc3c3db73dbec1aa5&v=4
@@ -149,6 +149,10 @@ experts:
   count: 20
   avatarUrl: https://avatars.githubusercontent.com/u/565544?v=4
   url: https://github.com/chris-allnutt
+- login: chrisK824
+  count: 19
+  avatarUrl: https://avatars.githubusercontent.com/u/79946379?u=03d85b22d696a58a9603e55fbbbe2de6b0f4face&v=4
+  url: https://github.com/chrisK824
 - login: zoliknemet
   count: 18
   avatarUrl: https://avatars.githubusercontent.com/u/22326718?u=31ba446ac290e23e56eea8e4f0c558aaf0b40779&v=4
@@ -157,6 +161,10 @@ experts:
   count: 18
   avatarUrl: https://avatars.githubusercontent.com/u/24581770?v=4
   url: https://github.com/retnikt
+- login: ebottos94
+  count: 17
+  avatarUrl: https://avatars.githubusercontent.com/u/100039558?u=e2c672da5a7977fd24d87ce6ab35f8bf5b1ed9fa&v=4
+  url: https://github.com/ebottos94
 - login: Hultner
   count: 17
   avatarUrl: https://avatars.githubusercontent.com/u/2669034?u=115e53df959309898ad8dc9443fbb35fee71df07&v=4
@@ -173,55 +181,39 @@ experts:
   count: 17
   avatarUrl: https://avatars.githubusercontent.com/u/16540232?u=05d2beb8e034d584d0a374b99d8826327bd7f614&v=4
   url: https://github.com/caeser1996
+- login: nymous
+  count: 16
+  avatarUrl: https://avatars.githubusercontent.com/u/4216559?u=360a36fb602cded27273cbfc0afc296eece90662&v=4
+  url: https://github.com/nymous
 - login: jonatasoli
   count: 16
   avatarUrl: https://avatars.githubusercontent.com/u/26334101?u=071c062d2861d3dd127f6b4a5258cd8ef55d4c50&v=4
   url: https://github.com/jonatasoli
-- login: ebottos94
-  count: 16
-  avatarUrl: https://avatars.githubusercontent.com/u/100039558?u=e2c672da5a7977fd24d87ce6ab35f8bf5b1ed9fa&v=4
-  url: https://github.com/ebottos94
 - login: dstlny
   count: 16
   avatarUrl: https://avatars.githubusercontent.com/u/41964673?u=9f2174f9d61c15c6e3a4c9e3aeee66f711ce311f&v=4
   url: https://github.com/dstlny
-- login: chrisK824
-  count: 15
-  avatarUrl: https://avatars.githubusercontent.com/u/79946379?u=03d85b22d696a58a9603e55fbbbe2de6b0f4face&v=4
-  url: https://github.com/chrisK824
-- login: nymous
-  count: 15
-  avatarUrl: https://avatars.githubusercontent.com/u/4216559?u=360a36fb602cded27273cbfc0afc296eece90662&v=4
-  url: https://github.com/nymous
 - login: abhint
   count: 15
   avatarUrl: https://avatars.githubusercontent.com/u/25699289?u=b5d219277b4d001ac26fb8be357fddd88c29d51b&v=4
   url: https://github.com/abhint
 last_month_active:
-- login: JavierSanchezCastro
-  count: 12
-  avatarUrl: https://avatars.githubusercontent.com/u/72013291?u=ae5679e6bd971d9d98cd5e76e8683f83642ba950&v=4
-  url: https://github.com/JavierSanchezCastro
 - login: Kludex
-  count: 10
+  count: 8
   avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
   url: https://github.com/Kludex
-- login: jgould22
-  count: 8
-  avatarUrl: https://avatars.githubusercontent.com/u/4335847?u=ed77f67e0bb069084639b24d812dbb2a2b1dc554&v=4
-  url: https://github.com/jgould22
-- login: romabozhanovgithub
-  count: 5
-  avatarUrl: https://avatars.githubusercontent.com/u/67696229?u=e4b921eef096415300425aca249348f8abb78ad7&v=4
-  url: https://github.com/romabozhanovgithub
 - login: n8sty
-  count: 5
+  count: 7
   avatarUrl: https://avatars.githubusercontent.com/u/2964996?v=4
   url: https://github.com/n8sty
 - login: chrisK824
-  count: 3
+  count: 4
   avatarUrl: https://avatars.githubusercontent.com/u/79946379?u=03d85b22d696a58a9603e55fbbbe2de6b0f4face&v=4
   url: https://github.com/chrisK824
+- login: danielfcollier
+  count: 3
+  avatarUrl: https://avatars.githubusercontent.com/u/38995330?u=5799be795fc310f75f3a5fe9242307d59b194520&v=4
+  url: https://github.com/danielfcollier
 top_contributors:
 - login: waynerv
   count: 25
@@ -235,14 +227,14 @@ top_contributors:
   count: 21
   avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
   url: https://github.com/Kludex
+- login: jaystone776
+  count: 18
+  avatarUrl: https://avatars.githubusercontent.com/u/11191137?u=299205a95e9b6817a43144a48b643346a5aac5cc&v=4
+  url: https://github.com/jaystone776
 - login: dmontagu
   count: 17
   avatarUrl: https://avatars.githubusercontent.com/u/35119617?u=540f30c937a6450812628b9592a1dfe91bbe148e&v=4
   url: https://github.com/dmontagu
-- login: jaystone776
-  count: 17
-  avatarUrl: https://avatars.githubusercontent.com/u/11191137?u=299205a95e9b6817a43144a48b643346a5aac5cc&v=4
-  url: https://github.com/jaystone776
 - login: Xewus
   count: 14
   avatarUrl: https://avatars.githubusercontent.com/u/85196001?u=f8e2dc7e5104f109cef944af79050ea8d1b8f914&v=4
@@ -307,6 +299,10 @@ top_contributors:
   count: 5
   avatarUrl: https://avatars.githubusercontent.com/u/43503750?u=f440bc9062afb3c43b9b9c6cdfdcfe31d58699ef&v=4
   url: https://github.com/ComicShrimp
+- login: tamtam-fitness
+  count: 5
+  avatarUrl: https://avatars.githubusercontent.com/u/62091034?u=8da19a6bd3d02f5d6ba30c7247d5b46c98dd1403&v=4
+  url: https://github.com/tamtam-fitness
 - login: jekirl
   count: 4
   avatarUrl: https://avatars.githubusercontent.com/u/2546697?u=a027452387d85bd4a14834e19d716c99255fb3b7&v=4
@@ -347,21 +343,25 @@ top_contributors:
   count: 4
   avatarUrl: https://avatars.githubusercontent.com/u/36765187?u=c6e0ba571c1ccb6db9d94e62e4b8b5eda811a870&v=4
   url: https://github.com/ivan-abc
+- login: rostik1410
+  count: 4
+  avatarUrl: https://avatars.githubusercontent.com/u/11443899?u=e26a635c2ba220467b308a326a579b8ccf4a8701&v=4
+  url: https://github.com/rostik1410
 top_reviewers:
 - login: Kludex
-  count: 136
+  count: 139
   avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
   url: https://github.com/Kludex
+- login: yezz123
+  count: 80
+  avatarUrl: https://avatars.githubusercontent.com/u/52716203?u=d7062cbc6eb7671d5dc9cc0e32a24ae335e0f225&v=4
+  url: https://github.com/yezz123
 - login: BilalAlpaslan
   count: 79
   avatarUrl: https://avatars.githubusercontent.com/u/47563997?u=63ed66e304fe8d765762c70587d61d9196e5c82d&v=4
   url: https://github.com/BilalAlpaslan
-- login: yezz123
-  count: 78
-  avatarUrl: https://avatars.githubusercontent.com/u/52716203?u=d7062cbc6eb7671d5dc9cc0e32a24ae335e0f225&v=4
-  url: https://github.com/yezz123
 - login: iudeen
-  count: 53
+  count: 54
   avatarUrl: https://avatars.githubusercontent.com/u/10519440?u=2843b3303282bff8b212dcd4d9d6689452e4470c&v=4
   url: https://github.com/iudeen
 - login: tokusumi
@@ -380,14 +380,14 @@ top_reviewers:
   count: 45
   avatarUrl: https://avatars.githubusercontent.com/u/62724709?u=bba5af018423a2858d49309bed2a899bb5c34ac5&v=4
   url: https://github.com/ycd
+- login: Xewus
+  count: 44
+  avatarUrl: https://avatars.githubusercontent.com/u/85196001?u=f8e2dc7e5104f109cef944af79050ea8d1b8f914&v=4
+  url: https://github.com/Xewus
 - login: cikay
   count: 41
   avatarUrl: https://avatars.githubusercontent.com/u/24587499?u=e772190a051ab0eaa9c8542fcff1892471638f2b&v=4
   url: https://github.com/cikay
-- login: Xewus
-  count: 39
-  avatarUrl: https://avatars.githubusercontent.com/u/85196001?u=f8e2dc7e5104f109cef944af79050ea8d1b8f914&v=4
-  url: https://github.com/Xewus
 - login: JarroVGIT
   count: 34
   avatarUrl: https://avatars.githubusercontent.com/u/13659033?u=e8bea32d07a5ef72f7dde3b2079ceb714923ca05&v=4
@@ -460,6 +460,10 @@ top_reviewers:
   count: 16
   avatarUrl: https://avatars.githubusercontent.com/u/1334088?u=9667041f5b15dc002b6f9665fda8c0412933ac04&v=4
   url: https://github.com/axel584
+- login: Alexandrhub
+  count: 16
+  avatarUrl: https://avatars.githubusercontent.com/u/119126536?u=9fc0d48f3307817bafecc5861eb2168401a6cb04&v=4
+  url: https://github.com/Alexandrhub
 - login: DevDae
   count: 16
   avatarUrl: https://avatars.githubusercontent.com/u/87962045?u=08e10fa516e844934f4b3fc7c38b33c61697e4a1&v=4
@@ -472,10 +476,6 @@ top_reviewers:
   count: 15
   avatarUrl: https://avatars.githubusercontent.com/u/63476957?u=6c86e59b48e0394d4db230f37fc9ad4d7e2c27c7&v=4
   url: https://github.com/delhi09
-- login: Alexandrhub
-  count: 15
-  avatarUrl: https://avatars.githubusercontent.com/u/119126536?u=9fc0d48f3307817bafecc5861eb2168401a6cb04&v=4
-  url: https://github.com/Alexandrhub
 - login: sh0nk
   count: 13
   avatarUrl: https://avatars.githubusercontent.com/u/6478810?u=af15d724875cec682ed8088a86d36b2798f981c0&v=4
@@ -484,6 +484,10 @@ top_reviewers:
   count: 13
   avatarUrl: https://avatars.githubusercontent.com/u/32584628?u=a66902b40c13647d0ed0e573d598128240a4dd04&v=4
   url: https://github.com/peidrao
+- login: wdh99
+  count: 13
+  avatarUrl: https://avatars.githubusercontent.com/u/108172295?u=8a8fb95d5afe3e0fa33257b2aecae88d436249eb&v=4
+  url: https://github.com/wdh99
 - login: r0b2g1t
   count: 13
   avatarUrl: https://avatars.githubusercontent.com/u/5357541?u=6428442d875d5d71aaa1bb38bb11c4be1a526bc2&v=4
@@ -500,10 +504,6 @@ top_reviewers:
   count: 11
   avatarUrl: https://avatars.githubusercontent.com/u/46193920?u=789927ee09cfabd752d3bd554fa6baf4850d2777&v=4
   url: https://github.com/solomein-sv
-- login: wdh99
-  count: 11
-  avatarUrl: https://avatars.githubusercontent.com/u/108172295?u=8a8fb95d5afe3e0fa33257b2aecae88d436249eb&v=4
-  url: https://github.com/wdh99
 - login: mariacamilagl
   count: 10
   avatarUrl: https://avatars.githubusercontent.com/u/11489395?u=4adb6986bf3debfc2b8216ae701f2bd47d73da7d&v=4

From cb4f0e57ce792b7538ad0f82f0772a57c86b80ca Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 2 Oct 2023 23:12:28 +0000
Subject: [PATCH 210/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 11333a712..87476fd1e 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 👥 Update FastAPI People. PR [#10363](https://github.com/tiangolo/fastapi/pull/10363) by [@tiangolo](https://github.com/tiangolo).
 ## 0.103.2
 
 ### Refactors

From 89789c80aeb3743bd76486f3d28a174f1815c771 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 4 Oct 2023 17:51:10 -0500
Subject: [PATCH 211/317] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors,=20Bum?=
 =?UTF-8?q?p.sh=20images=20(#10381)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                                    |  2 +-
 docs/en/data/sponsors.yml                    |  2 +-
 docs/en/docs/img/sponsors/bump-sh-banner.svg | 48 +++++++++++++++++
 docs/en/docs/img/sponsors/bump-sh.svg        | 56 ++++++++++++++++++++
 docs/en/overrides/main.html                  |  2 +-
 5 files changed, 107 insertions(+), 3 deletions(-)
 create mode 100644 docs/en/docs/img/sponsors/bump-sh-banner.svg
 create mode 100644 docs/en/docs/img/sponsors/bump-sh.svg

diff --git a/README.md b/README.md
index b86143f3d..3f125e60e 100644
--- a/README.md
+++ b/README.md
@@ -50,7 +50,7 @@ The key features are:
 <a href="https://platform.sh/try-it-now/?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023" target="_blank" title="Build, run and scale your apps on a modern, reliable, and secure PaaS."><img src="https://fastapi.tiangolo.com/img/sponsors/platform-sh.png"></a>
 <a href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=main-badge" target="_blank" title="Fern | SDKs and API docs"><img src="https://fastapi.tiangolo.com/img/sponsors/fern.svg"></a>
 <a href="https://www.porter.run" target="_blank" title="Deploy FastAPI on AWS with a few clicks"><img src="https://fastapi.tiangolo.com/img/sponsors/porter.png"></a>
-<a href="https://bump.sh/fastapi?utm_source=fastapi&utm_medium=referral&utm_campaign=sponsor" target="_blank" title="Automate FastAPI documentation generation with Bump.sh"><img src="https://fastapi.tiangolo.com/img/sponsors/bump-sh.png"></a>
+<a href="https://bump.sh/fastapi?utm_source=fastapi&utm_medium=referral&utm_campaign=sponsor" target="_blank" title="Automate FastAPI documentation generation with Bump.sh"><img src="https://fastapi.tiangolo.com/img/sponsors/bump-sh.svg"></a>
 <a href="https://www.deta.sh/?ref=fastapi" target="_blank" title="The launchpad for all your (team's) ideas"><img src="https://fastapi.tiangolo.com/img/sponsors/deta.svg"></a>
 <a href="https://training.talkpython.fm/fastapi-courses" target="_blank" title="FastAPI video courses on demand from people you trust"><img src="https://fastapi.tiangolo.com/img/sponsors/talkpython.png"></a>
 <a href="https://testdriven.io/courses/tdd-fastapi/" target="_blank" title="Learn to build high-quality web apps with best practices"><img src="https://fastapi.tiangolo.com/img/sponsors/testdriven.svg"></a>
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index cea547a10..dac47d2f0 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -13,7 +13,7 @@ gold:
     img: https://fastapi.tiangolo.com/img/sponsors/porter.png
   - url: https://bump.sh/fastapi?utm_source=fastapi&utm_medium=referral&utm_campaign=sponsor
     title: Automate FastAPI documentation generation with Bump.sh
-    img: https://fastapi.tiangolo.com/img/sponsors/bump-sh.png
+    img: https://fastapi.tiangolo.com/img/sponsors/bump-sh.svg
 silver:
   - url: https://www.deta.sh/?ref=fastapi
     title: The launchpad for all your (team's) ideas
diff --git a/docs/en/docs/img/sponsors/bump-sh-banner.svg b/docs/en/docs/img/sponsors/bump-sh-banner.svg
new file mode 100644
index 000000000..c8ec7675a
--- /dev/null
+++ b/docs/en/docs/img/sponsors/bump-sh-banner.svg
@@ -0,0 +1,48 @@
+<svg width="300" height="40" viewBox="0 0 300 40" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_12187_586)">
+<rect width="300" height="40" fill="#2E303E"/>
+<g opacity="0.3" filter="url(#filter0_f_12187_586)">
+<rect width="300" height="40" fill="url(#paint0_radial_12187_586)"/>
+<rect width="300" height="40" fill="url(#paint1_radial_12187_586)"/>
+<rect width="300" height="40" fill="url(#paint2_radial_12187_586)"/>
+</g>
+<rect x="0.1" y="0.1" width="299.8" height="39.8" rx="19.9" stroke="url(#paint3_linear_12187_586)" stroke-opacity="0.2" stroke-width="0.2"/>
+<path d="M27.9124 13.9215C29.3259 13.9215 30.4718 15.0584 30.4718 16.4608C30.4718 17.8631 29.3259 19 27.9124 19L24.5 19L24.5 13.9215L27.9124 13.9215Z" fill="white"/>
+<path d="M36.5905 16.4608C36.5905 17.8631 35.4446 19 34.0312 19C32.6177 19 31.4718 17.8631 31.4718 16.4608C31.4718 15.0584 32.6177 13.9215 34.0312 13.9215C35.4446 13.9215 36.5905 15.0584 36.5905 16.4608Z" fill="url(#paint4_linear_12187_586)"/>
+<path d="M34.7374 20C36.1508 20 37.2967 21.1369 37.2967 22.5393C37.2967 23.9417 36.1508 25.0785 34.7374 25.0785L24.5 25.0785L24.5 20L34.7374 20Z" fill="white"/>
+<path d="M51.7018 18.355C51.7018 18.789 51.6213 19.1565 51.4603 19.4575C51.2993 19.7515 51.0823 19.9895 50.8093 20.1715C50.5363 20.3535 50.2213 20.4865 49.8643 20.5705C49.5073 20.6545 49.1363 20.6965 48.7513 20.6965H47.8588V23.5H46.0633V16.066H48.7933C49.1993 16.066 49.5773 16.108 49.9273 16.192C50.2843 16.269 50.5923 16.3985 50.8513 16.5805C51.1173 16.7555 51.3238 16.99 51.4708 17.284C51.6248 17.571 51.7018 17.928 51.7018 18.355ZM49.9063 18.3655C49.9063 18.1905 49.8713 18.047 49.8013 17.935C49.7313 17.823 49.6368 17.7355 49.5178 17.6725C49.3988 17.6095 49.2623 17.5675 49.1083 17.5465C48.9613 17.5255 48.8073 17.515 48.6463 17.515H47.8588V19.2685H48.6148C48.7828 19.2685 48.9438 19.2545 49.0978 19.2265C49.2518 19.1985 49.3883 19.1495 49.5073 19.0795C49.6333 19.0095 49.7313 18.9185 49.8013 18.8065C49.8713 18.6875 49.9063 18.5405 49.9063 18.3655ZM55.6779 23.5V22.7755H55.6569C55.5939 22.8945 55.5099 23.0065 55.4049 23.1115C55.3069 23.2165 55.1879 23.3075 55.0479 23.3845C54.9149 23.4615 54.7644 23.5245 54.5964 23.5735C54.4354 23.6225 54.2639 23.647 54.0819 23.647C53.7319 23.647 53.4344 23.584 53.1894 23.458C52.9514 23.332 52.7554 23.171 52.6014 22.975C52.4544 22.772 52.3459 22.5445 52.2759 22.2925C52.2129 22.0335 52.1814 21.771 52.1814 21.505V18.271H53.9139V21.106C53.9139 21.253 53.9244 21.393 53.9454 21.526C53.9664 21.659 54.0049 21.778 54.0609 21.883C54.1239 21.988 54.2044 22.072 54.3024 22.135C54.4004 22.191 54.5299 22.219 54.6909 22.219C54.9919 22.219 55.2194 22.107 55.3734 21.883C55.5344 21.659 55.6149 21.3965 55.6149 21.0955V18.271H57.3369V23.5H55.6779ZM64.5111 20.8645C64.5111 21.2285 64.4551 21.5785 64.3431 21.9145C64.2311 22.2505 64.0666 22.548 63.8496 22.807C63.6396 23.059 63.3806 23.262 63.0726 23.416C62.7646 23.57 62.4146 23.647 62.0226 23.647C61.6726 23.647 61.3401 23.577 61.0251 23.437C60.7171 23.29 60.4791 23.0835 60.3111 22.8175H60.2901V23.5H58.7046V15.562H60.4266V18.8275H60.4476C60.5946 18.6525 60.8011 18.4915 61.0671 18.3445C61.3331 18.1975 61.6586 18.124 62.0436 18.124C62.4216 18.124 62.7611 18.1975 63.0621 18.3445C63.3701 18.4915 63.6291 18.691 63.8391 18.943C64.0561 19.195 64.2206 19.489 64.3326 19.825C64.4516 20.154 64.5111 20.5005 64.5111 20.8645ZM62.8521 20.8645C62.8521 20.6965 62.8241 20.532 62.7681 20.371C62.7191 20.21 62.6421 20.07 62.5371 19.951C62.4321 19.825 62.3026 19.7235 62.1486 19.6465C61.9946 19.5695 61.8161 19.531 61.6131 19.531C61.4171 19.531 61.2421 19.5695 61.0881 19.6465C60.9341 19.7235 60.8011 19.825 60.6891 19.951C60.5841 20.077 60.5001 20.2205 60.4371 20.3815C60.3811 20.5425 60.3531 20.707 60.3531 20.875C60.3531 21.043 60.3811 21.2075 60.4371 21.3685C60.5001 21.5295 60.5841 21.673 60.6891 21.799C60.8011 21.925 60.9341 22.0265 61.0881 22.1035C61.2421 22.1805 61.4171 22.219 61.6131 22.219C61.8161 22.219 61.9946 22.1805 62.1486 22.1035C62.3026 22.0265 62.4321 21.925 62.5371 21.799C62.6421 21.673 62.7191 21.5295 62.7681 21.3685C62.8241 21.2005 62.8521 21.0325 62.8521 20.8645ZM65.626 23.5V15.562H67.369V23.5H65.626ZM70.6014 16.6015C70.6014 16.7345 70.5734 16.8605 70.5174 16.9795C70.4684 17.0915 70.3984 17.1895 70.3074 17.2735C70.2234 17.3575 70.1184 17.424 69.9924 17.473C69.8734 17.522 69.7474 17.5465 69.6144 17.5465C69.3344 17.5465 69.0999 17.4555 68.9109 17.2735C68.7219 17.0845 68.6274 16.8605 68.6274 16.6015C68.6274 16.4755 68.6519 16.3565 68.7009 16.2445C68.7499 16.1255 68.8199 16.024 68.9109 15.94C69.0019 15.856 69.1069 15.7895 69.2259 15.7405C69.3449 15.6845 69.4744 15.6565 69.6144 15.6565C69.7474 15.6565 69.8734 15.681 69.9924 15.73C70.1184 15.779 70.2234 15.8455 70.3074 15.9295C70.3984 16.0135 70.4684 16.115 70.5174 16.234C70.5734 16.346 70.6014 16.4685 70.6014 16.6015ZM68.7534 23.5V18.271H70.4754V23.5H68.7534ZM74.9159 19.8145C74.7759 19.6815 74.6114 19.5695 74.4224 19.4785C74.2334 19.3875 74.0339 19.342 73.8239 19.342C73.6629 19.342 73.5124 19.3735 73.3724 19.4365C73.2394 19.4995 73.1729 19.608 73.1729 19.762C73.1729 19.909 73.2464 20.014 73.3934 20.077C73.5474 20.14 73.7924 20.21 74.1284 20.287C74.3244 20.329 74.5204 20.3885 74.7164 20.4655C74.9194 20.5425 75.1014 20.644 75.2624 20.77C75.4234 20.896 75.5529 21.05 75.6509 21.232C75.7489 21.414 75.7979 21.631 75.7979 21.883C75.7979 22.212 75.7314 22.492 75.5984 22.723C75.4654 22.947 75.2904 23.129 75.0734 23.269C74.8634 23.409 74.6254 23.5105 74.3594 23.5735C74.0934 23.6365 73.8274 23.668 73.5614 23.668C73.1344 23.668 72.7144 23.6015 72.3014 23.4685C71.8954 23.3285 71.5559 23.1255 71.2829 22.8595L72.2489 21.841C72.4029 22.009 72.5919 22.149 72.8159 22.261C73.0399 22.373 73.2779 22.429 73.5299 22.429C73.6699 22.429 73.8064 22.3975 73.9394 22.3345C74.0794 22.2645 74.1494 22.1455 74.1494 21.9775C74.1494 21.8165 74.0654 21.6975 73.8974 21.6205C73.7294 21.5435 73.4669 21.463 73.1099 21.379C72.9279 21.337 72.7459 21.281 72.5639 21.211C72.3819 21.141 72.2174 21.0465 72.0704 20.9275C71.9304 20.8085 71.8149 20.6615 71.7239 20.4865C71.6329 20.3115 71.5874 20.1015 71.5874 19.8565C71.5874 19.5415 71.6539 19.2755 71.7869 19.0585C71.9199 18.8345 72.0914 18.6525 72.3014 18.5125C72.5114 18.3725 72.7424 18.271 72.9944 18.208C73.2534 18.138 73.5089 18.103 73.7609 18.103C74.1529 18.103 74.5344 18.166 74.9054 18.292C75.2834 18.411 75.6019 18.593 75.8609 18.838L74.9159 19.8145ZM80.236 23.5V20.665C80.236 20.518 80.2255 20.378 80.2045 20.245C80.1835 20.112 80.1415 19.9965 80.0785 19.8985C80.0225 19.7935 79.9455 19.713 79.8475 19.657C79.7495 19.594 79.6235 19.5625 79.4695 19.5625C79.1685 19.5625 78.9375 19.671 78.7765 19.888C78.6155 20.098 78.535 20.3605 78.535 20.6755V23.5H76.813V15.562H78.535V18.9325H78.556C78.675 18.7225 78.864 18.537 79.123 18.376C79.382 18.208 79.6935 18.124 80.0575 18.124C80.4145 18.124 80.712 18.187 80.95 18.313C81.195 18.439 81.391 18.6035 81.538 18.8065C81.692 19.0025 81.8005 19.23 81.8635 19.489C81.9335 19.748 81.9685 20.007 81.9685 20.266V23.5H80.236ZM90.8474 23.5L90.2699 22.0405H87.3929L86.8469 23.5H84.8939L88.0124 16.066H89.7554L92.8424 23.5H90.8474ZM88.8524 18.0505L87.9074 20.602H89.7764L88.8524 18.0505ZM99.0953 18.355C99.0953 18.789 99.0148 19.1565 98.8538 19.4575C98.6928 19.7515 98.4758 19.9895 98.2028 20.1715C97.9298 20.3535 97.6148 20.4865 97.2578 20.5705C96.9008 20.6545 96.5298 20.6965 96.1448 20.6965H95.2523V23.5H93.4568V16.066H96.1868C96.5928 16.066 96.9708 16.108 97.3208 16.192C97.6778 16.269 97.9858 16.3985 98.2448 16.5805C98.5108 16.7555 98.7173 16.99 98.8643 17.284C99.0183 17.571 99.0953 17.928 99.0953 18.355ZM97.2998 18.3655C97.2998 18.1905 97.2648 18.047 97.1948 17.935C97.1248 17.823 97.0303 17.7355 96.9113 17.6725C96.7923 17.6095 96.6558 17.5675 96.5018 17.5465C96.3548 17.5255 96.2008 17.515 96.0398 17.515H95.2523V19.2685H96.0083C96.1763 19.2685 96.3373 19.2545 96.4913 19.2265C96.6453 19.1985 96.7818 19.1495 96.9008 19.0795C97.0268 19.0095 97.1248 18.9185 97.1948 18.8065C97.2648 18.6875 97.2998 18.5405 97.2998 18.3655ZM100.173 23.5V16.066H101.979V23.5H100.173ZM110.005 23.5V22.8175H109.984C109.816 23.0835 109.574 23.29 109.259 23.437C108.951 23.577 108.622 23.647 108.272 23.647C107.88 23.647 107.53 23.57 107.222 23.416C106.914 23.262 106.652 23.059 106.435 22.807C106.225 22.548 106.064 22.2505 105.952 21.9145C105.84 21.5785 105.784 21.2285 105.784 20.8645C105.784 20.5005 105.84 20.154 105.952 19.825C106.071 19.489 106.235 19.195 106.445 18.943C106.662 18.691 106.921 18.4915 107.222 18.3445C107.53 18.1975 107.873 18.124 108.251 18.124C108.636 18.124 108.962 18.1975 109.228 18.3445C109.494 18.4915 109.7 18.6525 109.847 18.8275H109.868V15.562H111.59V23.5H110.005ZM109.942 20.875C109.942 20.707 109.91 20.5425 109.847 20.3815C109.791 20.2205 109.707 20.077 109.595 19.951C109.49 19.825 109.361 19.7235 109.207 19.6465C109.053 19.5695 108.878 19.531 108.682 19.531C108.479 19.531 108.3 19.5695 108.146 19.6465C107.992 19.7235 107.863 19.825 107.758 19.951C107.653 20.07 107.572 20.21 107.516 20.371C107.467 20.532 107.443 20.6965 107.443 20.8645C107.443 21.0325 107.467 21.2005 107.516 21.3685C107.572 21.5295 107.653 21.673 107.758 21.799C107.863 21.925 107.992 22.0265 108.146 22.1035C108.3 22.1805 108.479 22.219 108.682 22.219C108.878 22.219 109.053 22.1805 109.207 22.1035C109.361 22.0265 109.49 21.925 109.595 21.799C109.707 21.673 109.791 21.5295 109.847 21.3685C109.91 21.2075 109.942 21.043 109.942 20.875ZM118.502 20.8645C118.502 21.2915 118.425 21.68 118.271 22.03C118.117 22.373 117.907 22.667 117.641 22.912C117.375 23.15 117.067 23.3355 116.717 23.4685C116.367 23.6015 115.992 23.668 115.593 23.668C115.201 23.668 114.827 23.6015 114.47 23.4685C114.12 23.3355 113.812 23.15 113.546 22.912C113.287 22.667 113.08 22.373 112.926 22.03C112.772 21.68 112.695 21.2915 112.695 20.8645C112.695 20.4375 112.772 20.0525 112.926 19.7095C113.08 19.3665 113.287 19.076 113.546 18.838C113.812 18.6 114.12 18.418 114.47 18.292C114.827 18.166 115.201 18.103 115.593 18.103C115.992 18.103 116.367 18.166 116.717 18.292C117.067 18.418 117.375 18.6 117.641 18.838C117.907 19.076 118.117 19.3665 118.271 19.7095C118.425 20.0525 118.502 20.4375 118.502 20.8645ZM116.843 20.8645C116.843 20.6965 116.815 20.532 116.759 20.371C116.703 20.21 116.622 20.07 116.517 19.951C116.412 19.825 116.283 19.7235 116.129 19.6465C115.975 19.5695 115.796 19.531 115.593 19.531C115.39 19.531 115.212 19.5695 115.058 19.6465C114.904 19.7235 114.774 19.825 114.669 19.951C114.571 20.07 114.494 20.21 114.438 20.371C114.389 20.532 114.365 20.6965 114.365 20.8645C114.365 21.0325 114.389 21.197 114.438 21.358C114.494 21.519 114.575 21.666 114.68 21.799C114.785 21.925 114.914 22.0265 115.068 22.1035C115.222 22.1805 115.401 22.219 115.604 22.219C115.807 22.219 115.985 22.1805 116.139 22.1035C116.293 22.0265 116.423 21.925 116.528 21.799C116.633 21.666 116.71 21.519 116.759 21.358C116.815 21.197 116.843 21.0325 116.843 20.8645ZM123.193 19.9615C123.095 19.8355 122.962 19.734 122.794 19.657C122.626 19.58 122.455 19.5415 122.28 19.5415C122.098 19.5415 121.933 19.58 121.786 19.657C121.639 19.727 121.513 19.825 121.408 19.951C121.303 20.07 121.219 20.21 121.156 20.371C121.1 20.532 121.072 20.7035 121.072 20.8855C121.072 21.0675 121.1 21.239 121.156 21.4C121.212 21.561 121.293 21.7045 121.398 21.8305C121.51 21.9495 121.639 22.044 121.786 22.114C121.94 22.184 122.112 22.219 122.301 22.219C122.476 22.219 122.647 22.1875 122.815 22.1245C122.99 22.0545 123.13 21.9565 123.235 21.8305L124.191 22.996C123.974 23.206 123.694 23.3705 123.351 23.4895C123.008 23.6085 122.644 23.668 122.259 23.668C121.846 23.668 121.461 23.605 121.104 23.479C120.747 23.353 120.435 23.171 120.169 22.933C119.91 22.688 119.704 22.394 119.55 22.051C119.403 21.708 119.329 21.3195 119.329 20.8855C119.329 20.4585 119.403 20.0735 119.55 19.7305C119.704 19.3875 119.91 19.097 120.169 18.859C120.435 18.614 120.747 18.4285 121.104 18.3025C121.461 18.1695 121.842 18.103 122.248 18.103C122.437 18.103 122.623 18.1205 122.805 18.1555C122.994 18.1905 123.172 18.2395 123.34 18.3025C123.515 18.3585 123.673 18.432 123.813 18.523C123.96 18.607 124.086 18.7015 124.191 18.8065L123.193 19.9615ZM127.949 19.8145C127.809 19.6815 127.645 19.5695 127.456 19.4785C127.267 19.3875 127.067 19.342 126.857 19.342C126.696 19.342 126.546 19.3735 126.406 19.4365C126.273 19.4995 126.206 19.608 126.206 19.762C126.206 19.909 126.28 20.014 126.427 20.077C126.581 20.14 126.826 20.21 127.162 20.287C127.358 20.329 127.554 20.3885 127.75 20.4655C127.953 20.5425 128.135 20.644 128.296 20.77C128.457 20.896 128.586 21.05 128.684 21.232C128.782 21.414 128.831 21.631 128.831 21.883C128.831 22.212 128.765 22.492 128.632 22.723C128.499 22.947 128.324 23.129 128.107 23.269C127.897 23.409 127.659 23.5105 127.393 23.5735C127.127 23.6365 126.861 23.668 126.595 23.668C126.168 23.668 125.748 23.6015 125.335 23.4685C124.929 23.3285 124.589 23.1255 124.316 22.8595L125.282 21.841C125.436 22.009 125.625 22.149 125.849 22.261C126.073 22.373 126.311 22.429 126.563 22.429C126.703 22.429 126.84 22.3975 126.973 22.3345C127.113 22.2645 127.183 22.1455 127.183 21.9775C127.183 21.8165 127.099 21.6975 126.931 21.6205C126.763 21.5435 126.5 21.463 126.143 21.379C125.961 21.337 125.779 21.281 125.597 21.211C125.415 21.141 125.251 21.0465 125.104 20.9275C124.964 20.8085 124.848 20.6615 124.757 20.4865C124.666 20.3115 124.621 20.1015 124.621 19.8565C124.621 19.5415 124.687 19.2755 124.82 19.0585C124.953 18.8345 125.125 18.6525 125.335 18.5125C125.545 18.3725 125.776 18.271 126.028 18.208C126.287 18.138 126.542 18.103 126.794 18.103C127.186 18.103 127.568 18.166 127.939 18.292C128.317 18.411 128.635 18.593 128.894 18.838L127.949 19.8145ZM135.537 21.2215H135.317C135.128 21.2215 134.935 21.232 134.739 21.253C134.55 21.267 134.379 21.2985 134.225 21.3475C134.078 21.3965 133.955 21.47 133.857 21.568C133.759 21.659 133.71 21.7815 133.71 21.9355C133.71 22.0335 133.731 22.1175 133.773 22.1875C133.822 22.2575 133.882 22.3135 133.952 22.3555C134.022 22.3975 134.102 22.429 134.193 22.45C134.284 22.464 134.372 22.471 134.456 22.471C134.806 22.471 135.072 22.3765 135.254 22.1875C135.443 21.9915 135.537 21.729 135.537 21.4V21.2215ZM132.377 18.985C132.685 18.691 133.042 18.4705 133.448 18.3235C133.861 18.1765 134.281 18.103 134.708 18.103C135.149 18.103 135.52 18.159 135.821 18.271C136.129 18.376 136.377 18.544 136.566 18.775C136.755 18.999 136.892 19.286 136.976 19.636C137.067 19.979 137.112 20.3885 137.112 20.8645V23.5H135.537V22.9435H135.506C135.373 23.1605 135.17 23.3285 134.897 23.4475C134.631 23.5665 134.34 23.626 134.025 23.626C133.815 23.626 133.598 23.598 133.374 23.542C133.15 23.486 132.944 23.395 132.755 23.269C132.573 23.143 132.422 22.975 132.303 22.765C132.184 22.555 132.125 22.296 132.125 21.988C132.125 21.61 132.226 21.3055 132.429 21.0745C132.639 20.8435 132.905 20.665 133.227 20.539C133.556 20.413 133.92 20.329 134.319 20.287C134.718 20.245 135.107 20.224 135.485 20.224V20.14C135.485 19.881 135.394 19.692 135.212 19.573C135.03 19.447 134.806 19.384 134.54 19.384C134.295 19.384 134.057 19.4365 133.826 19.5415C133.602 19.6465 133.409 19.7725 133.248 19.9195L132.377 18.985ZM141.831 23.5V20.644C141.831 20.497 141.817 20.357 141.789 20.224C141.768 20.091 141.729 19.9755 141.673 19.8775C141.617 19.7725 141.537 19.692 141.432 19.636C141.334 19.573 141.208 19.5415 141.054 19.5415C140.9 19.5415 140.763 19.573 140.644 19.636C140.532 19.692 140.438 19.7725 140.361 19.8775C140.284 19.9825 140.224 20.105 140.182 20.245C140.147 20.378 140.13 20.518 140.13 20.665V23.5H138.397V18.271H140.067V18.9955H140.088C140.151 18.8835 140.231 18.775 140.329 18.67C140.434 18.558 140.553 18.4635 140.686 18.3865C140.826 18.3095 140.977 18.2465 141.138 18.1975C141.299 18.1485 141.47 18.124 141.652 18.124C142.002 18.124 142.3 18.187 142.545 18.313C142.79 18.439 142.986 18.6035 143.133 18.8065C143.287 19.0025 143.395 19.23 143.458 19.489C143.528 19.748 143.563 20.007 143.563 20.266V23.5H141.831ZM148.826 23.5V22.8175H148.805C148.637 23.0835 148.396 23.29 148.081 23.437C147.773 23.577 147.444 23.647 147.094 23.647C146.702 23.647 146.352 23.57 146.044 23.416C145.736 23.262 145.473 23.059 145.256 22.807C145.046 22.548 144.885 22.2505 144.773 21.9145C144.661 21.5785 144.605 21.2285 144.605 20.8645C144.605 20.5005 144.661 20.154 144.773 19.825C144.892 19.489 145.057 19.195 145.267 18.943C145.484 18.691 145.743 18.4915 146.044 18.3445C146.352 18.1975 146.695 18.124 147.073 18.124C147.458 18.124 147.783 18.1975 148.049 18.3445C148.315 18.4915 148.522 18.6525 148.669 18.8275H148.69V15.562H150.412V23.5H148.826ZM148.763 20.875C148.763 20.707 148.732 20.5425 148.669 20.3815C148.613 20.2205 148.529 20.077 148.417 19.951C148.312 19.825 148.182 19.7235 148.028 19.6465C147.874 19.5695 147.699 19.531 147.503 19.531C147.3 19.531 147.122 19.5695 146.968 19.6465C146.814 19.7235 146.684 19.825 146.579 19.951C146.474 20.07 146.394 20.21 146.338 20.371C146.289 20.532 146.264 20.6965 146.264 20.8645C146.264 21.0325 146.289 21.2005 146.338 21.3685C146.394 21.5295 146.474 21.673 146.579 21.799C146.684 21.925 146.814 22.0265 146.968 22.1035C147.122 22.1805 147.3 22.219 147.503 22.219C147.699 22.219 147.874 22.1805 148.028 22.1035C148.182 22.0265 148.312 21.925 148.417 21.799C148.529 21.673 148.613 21.5295 148.669 21.3685C148.732 21.2075 148.763 21.043 148.763 20.875ZM158.005 19.9615C157.907 19.8355 157.774 19.734 157.606 19.657C157.438 19.58 157.267 19.5415 157.092 19.5415C156.91 19.5415 156.745 19.58 156.598 19.657C156.451 19.727 156.325 19.825 156.22 19.951C156.115 20.07 156.031 20.21 155.968 20.371C155.912 20.532 155.884 20.7035 155.884 20.8855C155.884 21.0675 155.912 21.239 155.968 21.4C156.024 21.561 156.105 21.7045 156.21 21.8305C156.322 21.9495 156.451 22.044 156.598 22.114C156.752 22.184 156.924 22.219 157.113 22.219C157.288 22.219 157.459 22.1875 157.627 22.1245C157.802 22.0545 157.942 21.9565 158.047 21.8305L159.003 22.996C158.786 23.206 158.506 23.3705 158.163 23.4895C157.82 23.6085 157.456 23.668 157.071 23.668C156.658 23.668 156.273 23.605 155.916 23.479C155.559 23.353 155.247 23.171 154.981 22.933C154.722 22.688 154.516 22.394 154.362 22.051C154.215 21.708 154.141 21.3195 154.141 20.8855C154.141 20.4585 154.215 20.0735 154.362 19.7305C154.516 19.3875 154.722 19.097 154.981 18.859C155.247 18.614 155.559 18.4285 155.916 18.3025C156.273 18.1695 156.654 18.103 157.06 18.103C157.249 18.103 157.435 18.1205 157.617 18.1555C157.806 18.1905 157.984 18.2395 158.152 18.3025C158.327 18.3585 158.485 18.432 158.625 18.523C158.772 18.607 158.898 18.7015 159.003 18.8065L158.005 19.9615ZM163.129 23.5V20.665C163.129 20.518 163.118 20.378 163.097 20.245C163.076 20.112 163.034 19.9965 162.971 19.8985C162.915 19.7935 162.838 19.713 162.74 19.657C162.642 19.594 162.516 19.5625 162.362 19.5625C162.061 19.5625 161.83 19.671 161.669 19.888C161.508 20.098 161.428 20.3605 161.428 20.6755V23.5H159.706V15.562H161.428V18.9325H161.449C161.568 18.7225 161.757 18.537 162.016 18.376C162.275 18.208 162.586 18.124 162.95 18.124C163.307 18.124 163.605 18.187 163.843 18.313C164.088 18.439 164.284 18.6035 164.431 18.8065C164.585 19.0025 164.693 19.23 164.756 19.489C164.826 19.748 164.861 20.007 164.861 20.266V23.5H163.129ZM169.252 21.2215H169.032C168.843 21.2215 168.65 21.232 168.454 21.253C168.265 21.267 168.094 21.2985 167.94 21.3475C167.793 21.3965 167.67 21.47 167.572 21.568C167.474 21.659 167.425 21.7815 167.425 21.9355C167.425 22.0335 167.446 22.1175 167.488 22.1875C167.537 22.2575 167.597 22.3135 167.667 22.3555C167.737 22.3975 167.817 22.429 167.908 22.45C167.999 22.464 168.087 22.471 168.171 22.471C168.521 22.471 168.787 22.3765 168.969 22.1875C169.158 21.9915 169.252 21.729 169.252 21.4V21.2215ZM166.092 18.985C166.4 18.691 166.757 18.4705 167.163 18.3235C167.576 18.1765 167.996 18.103 168.423 18.103C168.864 18.103 169.235 18.159 169.536 18.271C169.844 18.376 170.092 18.544 170.281 18.775C170.47 18.999 170.607 19.286 170.691 19.636C170.782 19.979 170.827 20.3885 170.827 20.8645V23.5H169.252V22.9435H169.221C169.088 23.1605 168.885 23.3285 168.612 23.4475C168.346 23.5665 168.055 23.626 167.74 23.626C167.53 23.626 167.313 23.598 167.089 23.542C166.865 23.486 166.659 23.395 166.47 23.269C166.288 23.143 166.137 22.975 166.018 22.765C165.899 22.555 165.84 22.296 165.84 21.988C165.84 21.61 165.941 21.3055 166.144 21.0745C166.354 20.8435 166.62 20.665 166.942 20.539C167.271 20.413 167.635 20.329 168.034 20.287C168.433 20.245 168.822 20.224 169.2 20.224V20.14C169.2 19.881 169.109 19.692 168.927 19.573C168.745 19.447 168.521 19.384 168.255 19.384C168.01 19.384 167.772 19.4365 167.541 19.5415C167.317 19.6465 167.124 19.7725 166.963 19.9195L166.092 18.985ZM175.546 23.5V20.644C175.546 20.497 175.532 20.357 175.504 20.224C175.483 20.091 175.444 19.9755 175.388 19.8775C175.332 19.7725 175.252 19.692 175.147 19.636C175.049 19.573 174.923 19.5415 174.769 19.5415C174.615 19.5415 174.478 19.573 174.359 19.636C174.247 19.692 174.153 19.7725 174.076 19.8775C173.999 19.9825 173.939 20.105 173.897 20.245C173.862 20.378 173.845 20.518 173.845 20.665V23.5H172.112V18.271H173.782V18.9955H173.803C173.866 18.8835 173.946 18.775 174.044 18.67C174.149 18.558 174.268 18.4635 174.401 18.3865C174.541 18.3095 174.692 18.2465 174.853 18.1975C175.014 18.1485 175.185 18.124 175.367 18.124C175.717 18.124 176.015 18.187 176.26 18.313C176.505 18.439 176.701 18.6035 176.848 18.8065C177.002 19.0025 177.11 19.23 177.173 19.489C177.243 19.748 177.278 20.007 177.278 20.266V23.5H175.546ZM184.127 23.0065C184.127 23.5175 184.053 23.962 183.906 24.34C183.759 24.718 183.553 25.0295 183.287 25.2745C183.021 25.5265 182.695 25.712 182.31 25.831C181.932 25.957 181.512 26.02 181.05 26.02C180.588 26.02 180.112 25.95 179.622 25.81C179.139 25.67 178.719 25.467 178.362 25.201L179.223 23.9725C179.475 24.1965 179.752 24.361 180.053 24.466C180.361 24.578 180.662 24.634 180.956 24.634C181.46 24.634 181.831 24.501 182.069 24.235C182.314 23.969 182.436 23.6155 182.436 23.1745V22.8595H182.405C182.244 23.0695 182.027 23.2375 181.754 23.3635C181.481 23.4895 181.169 23.5525 180.819 23.5525C180.42 23.5525 180.067 23.4825 179.759 23.3425C179.451 23.1955 179.188 22.9995 178.971 22.7545C178.761 22.5095 178.6 22.226 178.488 21.904C178.376 21.575 178.32 21.2285 178.32 20.8645C178.32 20.5005 178.376 20.154 178.488 19.825C178.6 19.496 178.761 19.2055 178.971 18.9535C179.188 18.7015 179.451 18.502 179.759 18.355C180.067 18.201 180.417 18.124 180.809 18.124C181.138 18.124 181.453 18.1905 181.754 18.3235C182.055 18.4565 182.296 18.663 182.478 18.943H182.499V18.271H184.127V23.0065ZM182.489 20.854C182.489 20.679 182.457 20.511 182.394 20.35C182.338 20.189 182.254 20.049 182.142 19.93C182.03 19.804 181.897 19.706 181.743 19.636C181.589 19.566 181.414 19.531 181.218 19.531C181.022 19.531 180.847 19.566 180.693 19.636C180.546 19.706 180.42 19.8005 180.315 19.9195C180.21 20.0385 180.13 20.1785 180.074 20.3395C180.018 20.5005 179.99 20.672 179.99 20.854C179.99 21.029 180.018 21.197 180.074 21.358C180.13 21.519 180.21 21.6625 180.315 21.7885C180.42 21.9075 180.546 22.0055 180.693 22.0825C180.847 22.1525 181.022 22.1875 181.218 22.1875C181.414 22.1875 181.589 22.1525 181.743 22.0825C181.904 22.0055 182.037 21.9075 182.142 21.7885C182.254 21.6695 182.338 21.5295 182.394 21.3685C182.457 21.2075 182.489 21.036 182.489 20.854ZM189.095 20.287C189.095 20.014 189.008 19.7795 188.833 19.5835C188.665 19.3875 188.409 19.2895 188.066 19.2895C187.898 19.2895 187.744 19.3175 187.604 19.3735C187.464 19.4225 187.342 19.4925 187.237 19.5835C187.132 19.6745 187.048 19.783 186.985 19.909C186.922 20.028 186.887 20.154 186.88 20.287H189.095ZM190.681 20.9485C190.681 21.0185 190.681 21.0885 190.681 21.1585C190.681 21.2285 190.677 21.295 190.67 21.358H186.88C186.894 21.505 186.936 21.638 187.006 21.757C187.083 21.876 187.177 21.981 187.289 22.072C187.408 22.156 187.538 22.2225 187.678 22.2715C187.825 22.3205 187.975 22.345 188.129 22.345C188.402 22.345 188.633 22.296 188.822 22.198C189.011 22.093 189.165 21.96 189.284 21.799L190.481 22.555C190.236 22.912 189.911 23.1885 189.505 23.3845C189.106 23.5735 188.64 23.668 188.108 23.668C187.716 23.668 187.345 23.6085 186.995 23.4895C186.645 23.3635 186.337 23.185 186.071 22.954C185.812 22.716 185.606 22.4255 185.452 22.0825C185.305 21.7395 185.231 21.3475 185.231 20.9065C185.231 20.4795 185.305 20.0945 185.452 19.7515C185.599 19.4015 185.798 19.1075 186.05 18.8695C186.302 18.6245 186.6 18.4355 186.943 18.3025C187.286 18.1695 187.657 18.103 188.056 18.103C188.441 18.103 188.794 18.1695 189.116 18.3025C189.438 18.4285 189.715 18.614 189.946 18.859C190.177 19.104 190.355 19.4015 190.481 19.7515C190.614 20.1015 190.681 20.5005 190.681 20.9485ZM191.77 23.5V15.562H193.513V23.5H191.77ZM200.42 20.8645C200.42 21.2915 200.343 21.68 200.189 22.03C200.035 22.373 199.825 22.667 199.559 22.912C199.293 23.15 198.985 23.3355 198.635 23.4685C198.285 23.6015 197.91 23.668 197.511 23.668C197.119 23.668 196.745 23.6015 196.388 23.4685C196.038 23.3355 195.73 23.15 195.464 22.912C195.205 22.667 194.998 22.373 194.844 22.03C194.69 21.68 194.613 21.2915 194.613 20.8645C194.613 20.4375 194.69 20.0525 194.844 19.7095C194.998 19.3665 195.205 19.076 195.464 18.838C195.73 18.6 196.038 18.418 196.388 18.292C196.745 18.166 197.119 18.103 197.511 18.103C197.91 18.103 198.285 18.166 198.635 18.292C198.985 18.418 199.293 18.6 199.559 18.838C199.825 19.076 200.035 19.3665 200.189 19.7095C200.343 20.0525 200.42 20.4375 200.42 20.8645ZM198.761 20.8645C198.761 20.6965 198.733 20.532 198.677 20.371C198.621 20.21 198.54 20.07 198.435 19.951C198.33 19.825 198.201 19.7235 198.047 19.6465C197.893 19.5695 197.714 19.531 197.511 19.531C197.308 19.531 197.13 19.5695 196.976 19.6465C196.822 19.7235 196.692 19.825 196.587 19.951C196.489 20.07 196.412 20.21 196.356 20.371C196.307 20.532 196.283 20.6965 196.283 20.8645C196.283 21.0325 196.307 21.197 196.356 21.358C196.412 21.519 196.493 21.666 196.598 21.799C196.703 21.925 196.832 22.0265 196.986 22.1035C197.14 22.1805 197.319 22.219 197.522 22.219C197.725 22.219 197.903 22.1805 198.057 22.1035C198.211 22.0265 198.341 21.925 198.446 21.799C198.551 21.666 198.628 21.519 198.677 21.358C198.733 21.197 198.761 21.0325 198.761 20.8645ZM207.054 23.0065C207.054 23.5175 206.981 23.962 206.834 24.34C206.687 24.718 206.48 25.0295 206.214 25.2745C205.948 25.5265 205.623 25.712 205.238 25.831C204.86 25.957 204.44 26.02 203.978 26.02C203.516 26.02 203.04 25.95 202.55 25.81C202.067 25.67 201.647 25.467 201.29 25.201L202.151 23.9725C202.403 24.1965 202.679 24.361 202.98 24.466C203.288 24.578 203.589 24.634 203.883 24.634C204.387 24.634 204.758 24.501 204.996 24.235C205.241 23.969 205.364 23.6155 205.364 23.1745V22.8595H205.332C205.171 23.0695 204.954 23.2375 204.681 23.3635C204.408 23.4895 204.097 23.5525 203.747 23.5525C203.348 23.5525 202.994 23.4825 202.686 23.3425C202.378 23.1955 202.116 22.9995 201.899 22.7545C201.689 22.5095 201.528 22.226 201.416 21.904C201.304 21.575 201.248 21.2285 201.248 20.8645C201.248 20.5005 201.304 20.154 201.416 19.825C201.528 19.496 201.689 19.2055 201.899 18.9535C202.116 18.7015 202.378 18.502 202.686 18.355C202.994 18.201 203.344 18.124 203.736 18.124C204.065 18.124 204.38 18.1905 204.681 18.3235C204.982 18.4565 205.224 18.663 205.406 18.943H205.427V18.271H207.054V23.0065ZM205.416 20.854C205.416 20.679 205.385 20.511 205.322 20.35C205.266 20.189 205.182 20.049 205.07 19.93C204.958 19.804 204.825 19.706 204.671 19.636C204.517 19.566 204.342 19.531 204.146 19.531C203.95 19.531 203.775 19.566 203.621 19.636C203.474 19.706 203.348 19.8005 203.243 19.9195C203.138 20.0385 203.057 20.1785 203.001 20.3395C202.945 20.5005 202.917 20.672 202.917 20.854C202.917 21.029 202.945 21.197 203.001 21.358C203.057 21.519 203.138 21.6625 203.243 21.7885C203.348 21.9075 203.474 22.0055 203.621 22.0825C203.775 22.1525 203.95 22.1875 204.146 22.1875C204.342 22.1875 204.517 22.1525 204.671 22.0825C204.832 22.0055 204.965 21.9075 205.07 21.7885C205.182 21.6695 205.266 21.5295 205.322 21.3685C205.385 21.2075 205.416 21.036 205.416 20.854ZM214.291 16.8325C214.228 16.8115 214.154 16.794 214.07 16.78C213.986 16.766 213.902 16.759 213.818 16.759C213.657 16.759 213.528 16.787 213.43 16.843C213.332 16.899 213.255 16.976 213.199 17.074C213.143 17.165 213.104 17.27 213.083 17.389C213.062 17.508 213.052 17.627 213.052 17.746V18.271H214.217V19.5625H213.052V23.5H211.33V19.5625H210.374V18.271H211.33V17.767C211.33 17.445 211.365 17.1405 211.435 16.8535C211.505 16.5595 211.624 16.304 211.792 16.087C211.967 15.863 212.198 15.688 212.485 15.562C212.779 15.429 213.143 15.3625 213.577 15.3625C213.724 15.3625 213.867 15.373 214.007 15.394C214.154 15.408 214.287 15.4325 214.406 15.4675L214.291 16.8325ZM218.263 19.678C218.186 19.657 218.109 19.643 218.032 19.636C217.962 19.629 217.892 19.6255 217.822 19.6255C217.591 19.6255 217.395 19.6675 217.234 19.7515C217.08 19.8355 216.954 19.937 216.856 20.056C216.765 20.175 216.698 20.3045 216.656 20.4445C216.614 20.5845 216.593 20.707 216.593 20.812V23.5H214.871V18.271H216.53V19.027H216.551C216.684 18.761 216.873 18.544 217.118 18.376C217.363 18.208 217.647 18.124 217.969 18.124C218.039 18.124 218.105 18.1275 218.168 18.1345C218.238 18.1415 218.294 18.152 218.336 18.166L218.263 19.678ZM224.394 20.8645C224.394 21.2915 224.317 21.68 224.163 22.03C224.009 22.373 223.799 22.667 223.533 22.912C223.267 23.15 222.959 23.3355 222.609 23.4685C222.259 23.6015 221.884 23.668 221.485 23.668C221.093 23.668 220.719 23.6015 220.362 23.4685C220.012 23.3355 219.704 23.15 219.438 22.912C219.179 22.667 218.972 22.373 218.818 22.03C218.664 21.68 218.587 21.2915 218.587 20.8645C218.587 20.4375 218.664 20.0525 218.818 19.7095C218.972 19.3665 219.179 19.076 219.438 18.838C219.704 18.6 220.012 18.418 220.362 18.292C220.719 18.166 221.093 18.103 221.485 18.103C221.884 18.103 222.259 18.166 222.609 18.292C222.959 18.418 223.267 18.6 223.533 18.838C223.799 19.076 224.009 19.3665 224.163 19.7095C224.317 20.0525 224.394 20.4375 224.394 20.8645ZM222.735 20.8645C222.735 20.6965 222.707 20.532 222.651 20.371C222.595 20.21 222.514 20.07 222.409 19.951C222.304 19.825 222.175 19.7235 222.021 19.6465C221.867 19.5695 221.688 19.531 221.485 19.531C221.282 19.531 221.104 19.5695 220.95 19.6465C220.796 19.7235 220.666 19.825 220.561 19.951C220.463 20.07 220.386 20.21 220.33 20.371C220.281 20.532 220.257 20.6965 220.257 20.8645C220.257 21.0325 220.281 21.197 220.33 21.358C220.386 21.519 220.467 21.666 220.572 21.799C220.677 21.925 220.806 22.0265 220.96 22.1035C221.114 22.1805 221.293 22.219 221.496 22.219C221.699 22.219 221.877 22.1805 222.031 22.1035C222.185 22.0265 222.315 21.925 222.42 21.799C222.525 21.666 222.602 21.519 222.651 21.358C222.707 21.197 222.735 21.0325 222.735 20.8645ZM232.162 23.5V20.644C232.162 20.497 232.151 20.357 232.13 20.224C232.109 20.084 232.071 19.965 232.015 19.867C231.959 19.769 231.882 19.692 231.784 19.636C231.693 19.573 231.57 19.5415 231.416 19.5415C231.269 19.5415 231.14 19.573 231.028 19.636C230.923 19.699 230.832 19.783 230.755 19.888C230.685 19.993 230.632 20.1155 230.597 20.2555C230.562 20.3885 230.545 20.5285 230.545 20.6755V23.5H228.823V20.518C228.823 20.217 228.763 19.979 228.644 19.804C228.525 19.629 228.336 19.5415 228.077 19.5415C227.804 19.5415 227.591 19.65 227.437 19.867C227.29 20.084 227.216 20.35 227.216 20.665V23.5H225.484V18.271H227.153V18.9955H227.174C227.237 18.8835 227.314 18.775 227.405 18.67C227.503 18.565 227.619 18.474 227.752 18.397C227.885 18.313 228.032 18.2465 228.193 18.1975C228.361 18.1485 228.543 18.124 228.739 18.124C229.117 18.124 229.435 18.201 229.694 18.355C229.96 18.509 230.167 18.7295 230.314 19.0165C230.489 18.7435 230.713 18.5265 230.986 18.3655C231.259 18.2045 231.591 18.124 231.983 18.124C232.34 18.124 232.638 18.1905 232.876 18.3235C233.121 18.4495 233.317 18.6175 233.464 18.8275C233.611 19.0305 233.716 19.2615 233.779 19.5205C233.849 19.7725 233.884 20.021 233.884 20.266V23.5H232.162ZM239.678 17.599V19.132H242.555V20.6125H239.678V23.5H237.904V16.066H242.797V17.599H239.678ZM246.443 21.2215H246.223C246.034 21.2215 245.841 21.232 245.645 21.253C245.456 21.267 245.285 21.2985 245.131 21.3475C244.984 21.3965 244.861 21.47 244.763 21.568C244.665 21.659 244.616 21.7815 244.616 21.9355C244.616 22.0335 244.637 22.1175 244.679 22.1875C244.728 22.2575 244.788 22.3135 244.858 22.3555C244.928 22.3975 245.008 22.429 245.099 22.45C245.19 22.464 245.278 22.471 245.362 22.471C245.712 22.471 245.978 22.3765 246.16 22.1875C246.349 21.9915 246.443 21.729 246.443 21.4V21.2215ZM243.283 18.985C243.591 18.691 243.948 18.4705 244.354 18.3235C244.767 18.1765 245.187 18.103 245.614 18.103C246.055 18.103 246.426 18.159 246.727 18.271C247.035 18.376 247.283 18.544 247.472 18.775C247.661 18.999 247.798 19.286 247.882 19.636C247.973 19.979 248.018 20.3885 248.018 20.8645V23.5H246.443V22.9435H246.412C246.279 23.1605 246.076 23.3285 245.803 23.4475C245.537 23.5665 245.246 23.626 244.931 23.626C244.721 23.626 244.504 23.598 244.28 23.542C244.056 23.486 243.85 23.395 243.661 23.269C243.479 23.143 243.328 22.975 243.209 22.765C243.09 22.555 243.031 22.296 243.031 21.988C243.031 21.61 243.132 21.3055 243.335 21.0745C243.545 20.8435 243.811 20.665 244.133 20.539C244.462 20.413 244.826 20.329 245.225 20.287C245.624 20.245 246.013 20.224 246.391 20.224V20.14C246.391 19.881 246.3 19.692 246.118 19.573C245.936 19.447 245.712 19.384 245.446 19.384C245.201 19.384 244.963 19.4365 244.732 19.5415C244.508 19.6465 244.315 19.7725 244.154 19.9195L243.283 18.985ZM252.38 19.8145C252.24 19.6815 252.076 19.5695 251.887 19.4785C251.698 19.3875 251.498 19.342 251.288 19.342C251.127 19.342 250.977 19.3735 250.837 19.4365C250.704 19.4995 250.637 19.608 250.637 19.762C250.637 19.909 250.711 20.014 250.858 20.077C251.012 20.14 251.257 20.21 251.593 20.287C251.789 20.329 251.985 20.3885 252.181 20.4655C252.384 20.5425 252.566 20.644 252.727 20.77C252.888 20.896 253.017 21.05 253.115 21.232C253.213 21.414 253.262 21.631 253.262 21.883C253.262 22.212 253.196 22.492 253.063 22.723C252.93 22.947 252.755 23.129 252.538 23.269C252.328 23.409 252.09 23.5105 251.824 23.5735C251.558 23.6365 251.292 23.668 251.026 23.668C250.599 23.668 250.179 23.6015 249.766 23.4685C249.36 23.3285 249.02 23.1255 248.747 22.8595L249.713 21.841C249.867 22.009 250.056 22.149 250.28 22.261C250.504 22.373 250.742 22.429 250.994 22.429C251.134 22.429 251.271 22.3975 251.404 22.3345C251.544 22.2645 251.614 22.1455 251.614 21.9775C251.614 21.8165 251.53 21.6975 251.362 21.6205C251.194 21.5435 250.931 21.463 250.574 21.379C250.392 21.337 250.21 21.281 250.028 21.211C249.846 21.141 249.682 21.0465 249.535 20.9275C249.395 20.8085 249.279 20.6615 249.188 20.4865C249.097 20.3115 249.052 20.1015 249.052 19.8565C249.052 19.5415 249.118 19.2755 249.251 19.0585C249.384 18.8345 249.556 18.6525 249.766 18.5125C249.976 18.3725 250.207 18.271 250.459 18.208C250.718 18.138 250.973 18.103 251.225 18.103C251.617 18.103 251.999 18.166 252.37 18.292C252.748 18.411 253.066 18.593 253.325 18.838L252.38 19.8145ZM256.125 19.5625V21.5575C256.125 21.8025 256.171 21.988 256.262 22.114C256.36 22.233 256.531 22.2925 256.776 22.2925C256.86 22.2925 256.948 22.2855 257.039 22.2715C257.137 22.2575 257.217 22.2365 257.28 22.2085L257.301 23.4685C257.182 23.5105 257.032 23.5455 256.85 23.5735C256.668 23.6085 256.486 23.626 256.304 23.626C255.954 23.626 255.66 23.584 255.422 23.5C255.184 23.409 254.991 23.283 254.844 23.122C254.704 22.954 254.603 22.758 254.54 22.534C254.477 22.303 254.445 22.0475 254.445 21.7675V19.5625H253.605V18.271H254.435V16.8955H256.125V18.271H257.354V19.5625H256.125ZM263.298 23.5L262.72 22.0405H259.843L259.297 23.5H257.344L260.463 16.066H262.206L265.293 23.5H263.298ZM261.303 18.0505L260.358 20.602H262.227L261.303 18.0505ZM271.546 18.355C271.546 18.789 271.465 19.1565 271.304 19.4575C271.143 19.7515 270.926 19.9895 270.653 20.1715C270.38 20.3535 270.065 20.4865 269.708 20.5705C269.351 20.6545 268.98 20.6965 268.595 20.6965H267.703V23.5H265.907V16.066H268.637C269.043 16.066 269.421 16.108 269.771 16.192C270.128 16.269 270.436 16.3985 270.695 16.5805C270.961 16.7555 271.168 16.99 271.315 17.284C271.469 17.571 271.546 17.928 271.546 18.355ZM269.75 18.3655C269.75 18.1905 269.715 18.047 269.645 17.935C269.575 17.823 269.481 17.7355 269.362 17.6725C269.243 17.6095 269.106 17.5675 268.952 17.5465C268.805 17.5255 268.651 17.515 268.49 17.515H267.703V19.2685H268.459C268.627 19.2685 268.788 19.2545 268.942 19.2265C269.096 19.1985 269.232 19.1495 269.351 19.0795C269.477 19.0095 269.575 18.9185 269.645 18.8065C269.715 18.6875 269.75 18.5405 269.75 18.3655ZM272.623 23.5V16.066H274.429V23.5H272.623Z" fill="#F9FAFB"/>
+</g>
+<defs>
+<filter id="filter0_f_12187_586" x="-30" y="-30" width="360" height="100" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+<feGaussianBlur stdDeviation="15" result="effect1_foregroundBlur_12187_586"/>
+</filter>
+<radialGradient id="paint0_radial_12187_586" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(140 15.8) rotate(-173.561) scale(140.889 24.7295)">
+<stop stop-color="#4A144B"/>
+<stop offset="1" stop-color="#025FD7" stop-opacity="0"/>
+</radialGradient>
+<radialGradient id="paint1_radial_12187_586" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(14.7115 6.35417) rotate(63.815) scale(41.7282 73.8399)">
+<stop stop-color="#4C50BB"/>
+<stop offset="1" stop-color="#025FD7" stop-opacity="0"/>
+</radialGradient>
+<radialGradient id="paint2_radial_12187_586" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(230.625 29.8) rotate(-129.994) scale(38.8978 240.228)">
+<stop stop-color="#FF8585"/>
+<stop offset="1" stop-color="#025FD7" stop-opacity="0"/>
+</radialGradient>
+<linearGradient id="paint3_linear_12187_586" x1="4.6577" y1="-0.383822" x2="15.3281" y2="79.6444" gradientUnits="userSpaceOnUse">
+<stop stop-color="#19AEFF"/>
+<stop offset="0.21875" stop-color="white"/>
+<stop offset="0.416667" stop-color="#015CD5"/>
+<stop offset="0.625" stop-color="#2E303E"/>
+<stop offset="0.864583" stop-color="#19AEFF"/>
+</linearGradient>
+<linearGradient id="paint4_linear_12187_586" x1="31.487" y1="16.397" x2="36.6985" y2="16.397" gradientUnits="userSpaceOnUse">
+<stop stop-color="#19AEFF"/>
+<stop offset="1" stop-color="#015CD5"/>
+</linearGradient>
+<clipPath id="clip0_12187_586">
+<rect width="300" height="40" fill="white"/>
+</clipPath>
+</defs>
+</svg>
diff --git a/docs/en/docs/img/sponsors/bump-sh.svg b/docs/en/docs/img/sponsors/bump-sh.svg
new file mode 100644
index 000000000..053e54b1d
--- /dev/null
+++ b/docs/en/docs/img/sponsors/bump-sh.svg
@@ -0,0 +1,56 @@
+<svg width="240" height="100" viewBox="0 0 240 100" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_12161_3932)">
+<rect width="240" height="100" fill="#2E303E"/>
+<g opacity="0.3" filter="url(#filter0_f_12161_3932)">
+<rect width="240" height="100" fill="url(#paint0_radial_12161_3932)"/>
+<rect width="240" height="100" fill="url(#paint1_radial_12161_3932)"/>
+<rect width="240" height="100" fill="url(#paint2_radial_12161_3932)"/>
+</g>
+<rect x="0.1" y="0.1" width="239.8" height="99.8" rx="15.9" stroke="url(#paint3_linear_12161_3932)" stroke-opacity="0.2" stroke-width="0.2"/>
+<path d="M24.54 54.14C24.54 54.7187 24.4327 55.2087 24.218 55.61C24.0033 56.002 23.714 56.3193 23.35 56.562C22.986 56.8047 22.566 56.982 22.09 57.094C21.614 57.206 21.1193 57.262 20.606 57.262H19.416V61H17.022V51.088H20.662C21.2033 51.088 21.7073 51.144 22.174 51.256C22.65 51.3587 23.0607 51.5313 23.406 51.774C23.7607 52.0073 24.036 52.32 24.232 52.712C24.4373 53.0947 24.54 53.5707 24.54 54.14ZM22.146 54.154C22.146 53.9207 22.0993 53.7293 22.006 53.58C21.9127 53.4307 21.7867 53.314 21.628 53.23C21.4693 53.146 21.2873 53.09 21.082 53.062C20.886 53.034 20.6807 53.02 20.466 53.02H19.416V55.358H20.424C20.648 55.358 20.8627 55.3393 21.068 55.302C21.2733 55.2647 21.4553 55.1993 21.614 55.106C21.782 55.0127 21.9127 54.8913 22.006 54.742C22.0993 54.5833 22.146 54.3873 22.146 54.154ZM29.8415 61V60.034H29.8135C29.7295 60.1927 29.6175 60.342 29.4775 60.482C29.3468 60.622 29.1882 60.7433 29.0015 60.846C28.8242 60.9487 28.6235 61.0327 28.3995 61.098C28.1848 61.1633 27.9562 61.196 27.7135 61.196C27.2468 61.196 26.8502 61.112 26.5235 60.944C26.2062 60.776 25.9448 60.5613 25.7395 60.3C25.5435 60.0293 25.3988 59.726 25.3055 59.39C25.2215 59.0447 25.1795 58.6947 25.1795 58.34V54.028H27.4895V57.808C27.4895 58.004 27.5035 58.1907 27.5315 58.368C27.5595 58.5453 27.6108 58.704 27.6855 58.844C27.7695 58.984 27.8768 59.096 28.0075 59.18C28.1382 59.2547 28.3108 59.292 28.5255 59.292C28.9268 59.292 29.2302 59.1427 29.4355 58.844C29.6502 58.5453 29.7575 58.1953 29.7575 57.794V54.028H32.0535V61H29.8415ZM41.6191 57.486C41.6191 57.9713 41.5445 58.438 41.3951 58.886C41.2458 59.334 41.0265 59.7307 40.7371 60.076C40.4571 60.412 40.1118 60.6827 39.7011 60.888C39.2905 61.0933 38.8238 61.196 38.3011 61.196C37.8345 61.196 37.3911 61.1027 36.9711 60.916C36.5605 60.72 36.2431 60.4447 36.0191 60.09H35.9911V61H33.8771V50.416H36.1731V54.77H36.2011C36.3971 54.5367 36.6725 54.322 37.0271 54.126C37.3818 53.93 37.8158 53.832 38.3291 53.832C38.8331 53.832 39.2858 53.93 39.6871 54.126C40.0978 54.322 40.4431 54.588 40.7231 54.924C41.0125 55.26 41.2318 55.652 41.3811 56.1C41.5398 56.5387 41.6191 57.0007 41.6191 57.486ZM39.4071 57.486C39.4071 57.262 39.3698 57.0427 39.2951 56.828C39.2298 56.6133 39.1271 56.4267 38.9871 56.268C38.8471 56.1 38.6745 55.9647 38.4691 55.862C38.2638 55.7593 38.0258 55.708 37.7551 55.708C37.4938 55.708 37.2605 55.7593 37.0551 55.862C36.8498 55.9647 36.6725 56.1 36.5231 56.268C36.3831 56.436 36.2711 56.6273 36.1871 56.842C36.1125 57.0567 36.0751 57.276 36.0751 57.5C36.0751 57.724 36.1125 57.9433 36.1871 58.158C36.2711 58.3727 36.3831 58.564 36.5231 58.732C36.6725 58.9 36.8498 59.0353 37.0551 59.138C37.2605 59.2407 37.4938 59.292 37.7551 59.292C38.0258 59.292 38.2638 59.2407 38.4691 59.138C38.6745 59.0353 38.8471 58.9 38.9871 58.732C39.1271 58.564 39.2298 58.3727 39.2951 58.158C39.3698 57.934 39.4071 57.71 39.4071 57.486ZM43.1056 61V50.416H45.4296V61H43.1056ZM49.7396 51.802C49.7396 51.9793 49.7022 52.1473 49.6276 52.306C49.5622 52.4553 49.4689 52.586 49.3476 52.698C49.2356 52.81 49.0956 52.8987 48.9276 52.964C48.7689 53.0293 48.6009 53.062 48.4236 53.062C48.0502 53.062 47.7376 52.9407 47.4856 52.698C47.2336 52.446 47.1076 52.1473 47.1076 51.802C47.1076 51.634 47.1402 51.4753 47.2056 51.326C47.2709 51.1673 47.3642 51.032 47.4856 50.92C47.6069 50.808 47.7469 50.7193 47.9056 50.654C48.0642 50.5793 48.2369 50.542 48.4236 50.542C48.6009 50.542 48.7689 50.5747 48.9276 50.64C49.0956 50.7053 49.2356 50.794 49.3476 50.906C49.4689 51.018 49.5622 51.1533 49.6276 51.312C49.7022 51.4613 49.7396 51.6247 49.7396 51.802ZM47.2756 61V54.028H49.5716V61H47.2756ZM55.4921 56.086C55.3055 55.9087 55.0861 55.7593 54.8341 55.638C54.5821 55.5167 54.3161 55.456 54.0361 55.456C53.8215 55.456 53.6208 55.498 53.4341 55.582C53.2568 55.666 53.1681 55.8107 53.1681 56.016C53.1681 56.212 53.2661 56.352 53.4621 56.436C53.6675 56.52 53.9941 56.6133 54.4421 56.716C54.7035 56.772 54.9648 56.8513 55.2261 56.954C55.4968 57.0567 55.7395 57.192 55.9541 57.36C56.1688 57.528 56.3415 57.7333 56.4721 57.976C56.6028 58.2187 56.6681 58.508 56.6681 58.844C56.6681 59.2827 56.5795 59.656 56.4021 59.964C56.2248 60.2627 55.9915 60.5053 55.7021 60.692C55.4221 60.8787 55.1048 61.014 54.7501 61.098C54.3955 61.182 54.0408 61.224 53.6861 61.224C53.1168 61.224 52.5568 61.1353 52.0061 60.958C51.4648 60.7713 51.0121 60.5007 50.6481 60.146L51.9361 58.788C52.1415 59.012 52.3935 59.1987 52.6921 59.348C52.9908 59.4973 53.3081 59.572 53.6441 59.572C53.8308 59.572 54.0128 59.53 54.1901 59.446C54.3768 59.3527 54.4701 59.194 54.4701 58.97C54.4701 58.7553 54.3581 58.5967 54.1341 58.494C53.9101 58.3913 53.5601 58.284 53.0841 58.172C52.8415 58.116 52.5988 58.0413 52.3561 57.948C52.1135 57.8547 51.8941 57.7287 51.6981 57.57C51.5115 57.4113 51.3575 57.2153 51.2361 56.982C51.1148 56.7487 51.0541 56.4687 51.0541 56.142C51.0541 55.722 51.1428 55.3673 51.3201 55.078C51.4975 54.7793 51.7261 54.5367 52.0061 54.35C52.2861 54.1633 52.5941 54.028 52.9301 53.944C53.2755 53.8507 53.6161 53.804 53.9521 53.804C54.4748 53.804 54.9835 53.888 55.4781 54.056C55.9821 54.2147 56.4068 54.4573 56.7521 54.784L55.4921 56.086ZM62.5857 61V57.22C62.5857 57.024 62.5717 56.8373 62.5437 56.66C62.5157 56.4827 62.4597 56.3287 62.3757 56.198C62.301 56.058 62.1983 55.9507 62.0677 55.876C61.937 55.792 61.769 55.75 61.5637 55.75C61.1623 55.75 60.8543 55.8947 60.6397 56.184C60.425 56.464 60.3177 56.814 60.3177 57.234V61H58.0217V50.416H60.3177V54.91H60.3457C60.5043 54.63 60.7563 54.3827 61.1017 54.168C61.447 53.944 61.8623 53.832 62.3477 53.832C62.8237 53.832 63.2203 53.916 63.5377 54.084C63.8643 54.252 64.1257 54.4713 64.3217 54.742C64.527 55.0033 64.6717 55.3067 64.7557 55.652C64.849 55.9973 64.8957 56.3427 64.8957 56.688V61H62.5857ZM76.7342 61L75.9642 59.054H72.1282L71.4002 61H68.7962L72.9542 51.088H75.2782L79.3942 61H76.7342ZM74.0742 53.734L72.8142 57.136H75.3062L74.0742 53.734ZM87.7314 54.14C87.7314 54.7187 87.6241 55.2087 87.4094 55.61C87.1947 56.002 86.9054 56.3193 86.5414 56.562C86.1774 56.8047 85.7574 56.982 85.2814 57.094C84.8054 57.206 84.3107 57.262 83.7974 57.262H82.6074V61H80.2134V51.088H83.8534C84.3947 51.088 84.8987 51.144 85.3654 51.256C85.8414 51.3587 86.2521 51.5313 86.5974 51.774C86.9521 52.0073 87.2274 52.32 87.4234 52.712C87.6287 53.0947 87.7314 53.5707 87.7314 54.14ZM85.3374 54.154C85.3374 53.9207 85.2907 53.7293 85.1974 53.58C85.1041 53.4307 84.9781 53.314 84.8194 53.23C84.6607 53.146 84.4787 53.09 84.2734 53.062C84.0774 53.034 83.8721 53.02 83.6574 53.02H82.6074V55.358H83.6154C83.8394 55.358 84.0541 55.3393 84.2594 55.302C84.4647 55.2647 84.6467 55.1993 84.8054 55.106C84.9734 55.0127 85.1041 54.8913 85.1974 54.742C85.2907 54.5833 85.3374 54.3873 85.3374 54.154ZM89.1685 61V51.088H91.5765V61H89.1685ZM102.278 61V60.09H102.25C102.026 60.4447 101.704 60.72 101.284 60.916C100.873 61.1027 100.434 61.196 99.9675 61.196C99.4448 61.196 98.9782 61.0933 98.5675 60.888C98.1568 60.6827 97.8068 60.412 97.5175 60.076C97.2375 59.7307 97.0228 59.334 96.8735 58.886C96.7242 58.438 96.6495 57.9713 96.6495 57.486C96.6495 57.0007 96.7242 56.5387 96.8735 56.1C97.0322 55.652 97.2515 55.26 97.5315 54.924C97.8208 54.588 98.1662 54.322 98.5675 54.126C98.9782 53.93 99.4355 53.832 99.9395 53.832C100.453 53.832 100.887 53.93 101.242 54.126C101.596 54.322 101.872 54.5367 102.068 54.77H102.096V50.416H104.392V61H102.278ZM102.194 57.5C102.194 57.276 102.152 57.0567 102.068 56.842C101.993 56.6273 101.881 56.436 101.732 56.268C101.592 56.1 101.419 55.9647 101.214 55.862C101.008 55.7593 100.775 55.708 100.514 55.708C100.243 55.708 100.005 55.7593 99.7995 55.862C99.5942 55.9647 99.4215 56.1 99.2815 56.268C99.1415 56.4267 99.0342 56.6133 98.9595 56.828C98.8942 57.0427 98.8615 57.262 98.8615 57.486C98.8615 57.71 98.8942 57.934 98.9595 58.158C99.0342 58.3727 99.1415 58.564 99.2815 58.732C99.4215 58.9 99.5942 59.0353 99.7995 59.138C100.005 59.2407 100.243 59.292 100.514 59.292C100.775 59.292 101.008 59.2407 101.214 59.138C101.419 59.0353 101.592 58.9 101.732 58.732C101.881 58.564 101.993 58.3727 102.068 58.158C102.152 57.9433 102.194 57.724 102.194 57.5ZM113.606 57.486C113.606 58.0553 113.504 58.5733 113.298 59.04C113.093 59.4973 112.813 59.8893 112.458 60.216C112.104 60.5333 111.693 60.7807 111.226 60.958C110.76 61.1353 110.26 61.224 109.728 61.224C109.206 61.224 108.706 61.1353 108.23 60.958C107.764 60.7807 107.353 60.5333 106.998 60.216C106.653 59.8893 106.378 59.4973 106.172 59.04C105.967 58.5733 105.864 58.0553 105.864 57.486C105.864 56.9167 105.967 56.4033 106.172 55.946C106.378 55.4887 106.653 55.1013 106.998 54.784C107.353 54.4667 107.764 54.224 108.23 54.056C108.706 53.888 109.206 53.804 109.728 53.804C110.26 53.804 110.76 53.888 111.226 54.056C111.693 54.224 112.104 54.4667 112.458 54.784C112.813 55.1013 113.093 55.4887 113.298 55.946C113.504 56.4033 113.606 56.9167 113.606 57.486ZM111.394 57.486C111.394 57.262 111.357 57.0427 111.282 56.828C111.208 56.6133 111.1 56.4267 110.96 56.268C110.82 56.1 110.648 55.9647 110.442 55.862C110.237 55.7593 109.999 55.708 109.728 55.708C109.458 55.708 109.22 55.7593 109.014 55.862C108.809 55.9647 108.636 56.1 108.496 56.268C108.366 56.4267 108.263 56.6133 108.188 56.828C108.123 57.0427 108.09 57.262 108.09 57.486C108.09 57.71 108.123 57.9293 108.188 58.144C108.263 58.3587 108.37 58.5547 108.51 58.732C108.65 58.9 108.823 59.0353 109.028 59.138C109.234 59.2407 109.472 59.292 109.742 59.292C110.013 59.292 110.251 59.2407 110.456 59.138C110.662 59.0353 110.834 58.9 110.974 58.732C111.114 58.5547 111.217 58.3587 111.282 58.144C111.357 57.9293 111.394 57.71 111.394 57.486ZM119.862 56.282C119.731 56.114 119.554 55.9787 119.33 55.876C119.106 55.7733 118.877 55.722 118.644 55.722C118.401 55.722 118.182 55.7733 117.986 55.876C117.79 55.9693 117.622 56.1 117.482 56.268C117.342 56.4267 117.23 56.6133 117.146 56.828C117.071 57.0427 117.034 57.2713 117.034 57.514C117.034 57.7567 117.071 57.9853 117.146 58.2C117.221 58.4147 117.328 58.606 117.468 58.774C117.617 58.9327 117.79 59.0587 117.986 59.152C118.191 59.2453 118.42 59.292 118.672 59.292C118.905 59.292 119.134 59.25 119.358 59.166C119.591 59.0727 119.778 58.942 119.918 58.774L121.192 60.328C120.903 60.608 120.529 60.8273 120.072 60.986C119.615 61.1447 119.129 61.224 118.616 61.224C118.065 61.224 117.552 61.14 117.076 60.972C116.6 60.804 116.185 60.5613 115.83 60.244C115.485 59.9173 115.209 59.5253 115.004 59.068C114.808 58.6107 114.71 58.0927 114.71 57.514C114.71 56.9447 114.808 56.4313 115.004 55.974C115.209 55.5167 115.485 55.1293 115.83 54.812C116.185 54.4853 116.6 54.238 117.076 54.07C117.552 53.8927 118.061 53.804 118.602 53.804C118.854 53.804 119.101 53.8273 119.344 53.874C119.596 53.9207 119.834 53.986 120.058 54.07C120.291 54.1447 120.501 54.2427 120.688 54.364C120.884 54.476 121.052 54.602 121.192 54.742L119.862 56.282ZM126.203 56.086C126.016 55.9087 125.797 55.7593 125.545 55.638C125.293 55.5167 125.027 55.456 124.747 55.456C124.532 55.456 124.332 55.498 124.145 55.582C123.968 55.666 123.879 55.8107 123.879 56.016C123.879 56.212 123.977 56.352 124.173 56.436C124.378 56.52 124.705 56.6133 125.153 56.716C125.414 56.772 125.676 56.8513 125.937 56.954C126.208 57.0567 126.45 57.192 126.665 57.36C126.88 57.528 127.052 57.7333 127.183 57.976C127.314 58.2187 127.379 58.508 127.379 58.844C127.379 59.2827 127.29 59.656 127.113 59.964C126.936 60.2627 126.702 60.5053 126.413 60.692C126.133 60.8787 125.816 61.014 125.461 61.098C125.106 61.182 124.752 61.224 124.397 61.224C123.828 61.224 123.268 61.1353 122.717 60.958C122.176 60.7713 121.723 60.5007 121.359 60.146L122.647 58.788C122.852 59.012 123.104 59.1987 123.403 59.348C123.702 59.4973 124.019 59.572 124.355 59.572C124.542 59.572 124.724 59.53 124.901 59.446C125.088 59.3527 125.181 59.194 125.181 58.97C125.181 58.7553 125.069 58.5967 124.845 58.494C124.621 58.3913 124.271 58.284 123.795 58.172C123.552 58.116 123.31 58.0413 123.067 57.948C122.824 57.8547 122.605 57.7287 122.409 57.57C122.222 57.4113 122.068 57.2153 121.947 56.982C121.826 56.7487 121.765 56.4687 121.765 56.142C121.765 55.722 121.854 55.3673 122.031 55.078C122.208 54.7793 122.437 54.5367 122.717 54.35C122.997 54.1633 123.305 54.028 123.641 53.944C123.986 53.8507 124.327 53.804 124.663 53.804C125.186 53.804 125.694 53.888 126.189 54.056C126.693 54.2147 127.118 54.4573 127.463 54.784L126.203 56.086ZM136.321 57.962H136.027C135.775 57.962 135.518 57.976 135.257 58.004C135.005 58.0227 134.776 58.0647 134.571 58.13C134.375 58.1953 134.211 58.2933 134.081 58.424C133.95 58.5453 133.885 58.7087 133.885 58.914C133.885 59.0447 133.913 59.1567 133.969 59.25C134.034 59.3433 134.113 59.418 134.207 59.474C134.3 59.53 134.407 59.572 134.529 59.6C134.65 59.6187 134.767 59.628 134.879 59.628C135.345 59.628 135.7 59.502 135.943 59.25C136.195 58.9887 136.321 58.6387 136.321 58.2V57.962ZM132.107 54.98C132.517 54.588 132.993 54.294 133.535 54.098C134.085 53.902 134.645 53.804 135.215 53.804C135.803 53.804 136.297 53.8787 136.699 54.028C137.109 54.168 137.441 54.392 137.693 54.7C137.945 54.9987 138.127 55.3813 138.239 55.848C138.36 56.3053 138.421 56.8513 138.421 57.486V61H136.321V60.258H136.279C136.101 60.5473 135.831 60.7713 135.467 60.93C135.112 61.0887 134.725 61.168 134.305 61.168C134.025 61.168 133.735 61.1307 133.437 61.056C133.138 60.9813 132.863 60.86 132.611 60.692C132.368 60.524 132.167 60.3 132.009 60.02C131.85 59.74 131.771 59.3947 131.771 58.984C131.771 58.48 131.906 58.074 132.177 57.766C132.457 57.458 132.811 57.22 133.241 57.052C133.679 56.884 134.165 56.772 134.697 56.716C135.229 56.66 135.747 56.632 136.251 56.632V56.52C136.251 56.1747 136.129 55.9227 135.887 55.764C135.644 55.596 135.345 55.512 134.991 55.512C134.664 55.512 134.347 55.582 134.039 55.722C133.74 55.862 133.483 56.03 133.269 56.226L132.107 54.98ZM144.712 61V57.192C144.712 56.996 144.694 56.8093 144.656 56.632C144.628 56.4547 144.577 56.3007 144.502 56.17C144.428 56.03 144.32 55.9227 144.18 55.848C144.05 55.764 143.882 55.722 143.676 55.722C143.471 55.722 143.289 55.764 143.13 55.848C142.981 55.9227 142.855 56.03 142.752 56.17C142.65 56.31 142.57 56.4733 142.514 56.66C142.468 56.8373 142.444 57.024 142.444 57.22V61H140.134V54.028H142.36V54.994H142.388C142.472 54.8447 142.58 54.7 142.71 54.56C142.85 54.4107 143.009 54.2847 143.186 54.182C143.373 54.0793 143.574 53.9953 143.788 53.93C144.003 53.8647 144.232 53.832 144.474 53.832C144.941 53.832 145.338 53.916 145.664 54.084C145.991 54.252 146.252 54.4713 146.448 54.742C146.654 55.0033 146.798 55.3067 146.882 55.652C146.976 55.9973 147.022 56.3427 147.022 56.688V61H144.712ZM154.039 61V60.09H154.011C153.787 60.4447 153.465 60.72 153.045 60.916C152.635 61.1027 152.196 61.196 151.729 61.196C151.207 61.196 150.74 61.0933 150.329 60.888C149.919 60.6827 149.569 60.412 149.279 60.076C148.999 59.7307 148.785 59.334 148.635 58.886C148.486 58.438 148.411 57.9713 148.411 57.486C148.411 57.0007 148.486 56.5387 148.635 56.1C148.794 55.652 149.013 55.26 149.293 54.924C149.583 54.588 149.928 54.322 150.329 54.126C150.74 53.93 151.197 53.832 151.701 53.832C152.215 53.832 152.649 53.93 153.003 54.126C153.358 54.322 153.633 54.5367 153.829 54.77H153.857V50.416H156.153V61H154.039ZM153.955 57.5C153.955 57.276 153.913 57.0567 153.829 56.842C153.755 56.6273 153.643 56.436 153.493 56.268C153.353 56.1 153.181 55.9647 152.975 55.862C152.77 55.7593 152.537 55.708 152.275 55.708C152.005 55.708 151.767 55.7593 151.561 55.862C151.356 55.9647 151.183 56.1 151.043 56.268C150.903 56.4267 150.796 56.6133 150.721 56.828C150.656 57.0427 150.623 57.262 150.623 57.486C150.623 57.71 150.656 57.934 150.721 58.158C150.796 58.3727 150.903 58.564 151.043 58.732C151.183 58.9 151.356 59.0353 151.561 59.138C151.767 59.2407 152.005 59.292 152.275 59.292C152.537 59.292 152.77 59.2407 152.975 59.138C153.181 59.0353 153.353 58.9 153.493 58.732C153.643 58.564 153.755 58.3727 153.829 58.158C153.913 57.9433 153.955 57.724 153.955 57.5ZM21.698 78.282C21.5673 78.114 21.39 77.9787 21.166 77.876C20.942 77.7733 20.7133 77.722 20.48 77.722C20.2373 77.722 20.018 77.7733 19.822 77.876C19.626 77.9693 19.458 78.1 19.318 78.268C19.178 78.4267 19.066 78.6133 18.982 78.828C18.9073 79.0427 18.87 79.2713 18.87 79.514C18.87 79.7567 18.9073 79.9853 18.982 80.2C19.0567 80.4147 19.164 80.606 19.304 80.774C19.4533 80.9327 19.626 81.0587 19.822 81.152C20.0273 81.2453 20.256 81.292 20.508 81.292C20.7413 81.292 20.97 81.25 21.194 81.166C21.4273 81.0727 21.614 80.942 21.754 80.774L23.028 82.328C22.7387 82.608 22.3653 82.8273 21.908 82.986C21.4507 83.1447 20.9653 83.224 20.452 83.224C19.9013 83.224 19.388 83.14 18.912 82.972C18.436 82.804 18.0207 82.5613 17.666 82.244C17.3207 81.9173 17.0453 81.5253 16.84 81.068C16.644 80.6107 16.546 80.0927 16.546 79.514C16.546 78.9447 16.644 78.4313 16.84 77.974C17.0453 77.5167 17.3207 77.1293 17.666 76.812C18.0207 76.4853 18.436 76.238 18.912 76.07C19.388 75.8927 19.8967 75.804 20.438 75.804C20.69 75.804 20.9373 75.8273 21.18 75.874C21.432 75.9207 21.67 75.986 21.894 76.07C22.1273 76.1447 22.3373 76.2427 22.524 76.364C22.72 76.476 22.888 76.602 23.028 76.742L21.698 78.282ZM28.529 83V79.22C28.529 79.024 28.515 78.8373 28.487 78.66C28.459 78.4827 28.403 78.3287 28.319 78.198C28.2443 78.058 28.1417 77.9507 28.011 77.876C27.8803 77.792 27.7123 77.75 27.507 77.75C27.1057 77.75 26.7977 77.8947 26.583 78.184C26.3683 78.464 26.261 78.814 26.261 79.234V83H23.965V72.416H26.261V76.91H26.289C26.4477 76.63 26.6997 76.3827 27.045 76.168C27.3903 75.944 27.8057 75.832 28.291 75.832C28.767 75.832 29.1637 75.916 29.481 76.084C29.8077 76.252 30.069 76.4713 30.265 76.742C30.4703 77.0033 30.615 77.3067 30.699 77.652C30.7923 77.9973 30.839 78.3427 30.839 78.688V83H28.529ZM36.6936 79.962H36.3996C36.1476 79.962 35.891 79.976 35.6296 80.004C35.3776 80.0227 35.149 80.0647 34.9436 80.13C34.7476 80.1953 34.5843 80.2933 34.4536 80.424C34.323 80.5453 34.2576 80.7087 34.2576 80.914C34.2576 81.0447 34.2856 81.1567 34.3416 81.25C34.407 81.3433 34.4863 81.418 34.5796 81.474C34.673 81.53 34.7803 81.572 34.9016 81.6C35.023 81.6187 35.1396 81.628 35.2516 81.628C35.7183 81.628 36.073 81.502 36.3156 81.25C36.5676 80.9887 36.6936 80.6387 36.6936 80.2V79.962ZM32.4796 76.98C32.8903 76.588 33.3663 76.294 33.9076 76.098C34.4583 75.902 35.0183 75.804 35.5876 75.804C36.1756 75.804 36.6703 75.8787 37.0716 76.028C37.4823 76.168 37.8136 76.392 38.0656 76.7C38.3176 76.9987 38.4996 77.3813 38.6116 77.848C38.733 78.3053 38.7936 78.8513 38.7936 79.486V83H36.6936V82.258H36.6516C36.4743 82.5473 36.2036 82.7713 35.8396 82.93C35.485 83.0887 35.0976 83.168 34.6776 83.168C34.3976 83.168 34.1083 83.1307 33.8096 83.056C33.511 82.9813 33.2356 82.86 32.9836 82.692C32.741 82.524 32.5403 82.3 32.3816 82.02C32.223 81.74 32.1436 81.3947 32.1436 80.984C32.1436 80.48 32.279 80.074 32.5496 79.766C32.8296 79.458 33.1843 79.22 33.6136 79.052C34.0523 78.884 34.5376 78.772 35.0696 78.716C35.6016 78.66 36.1196 78.632 36.6236 78.632V78.52C36.6236 78.1747 36.5023 77.9227 36.2596 77.764C36.017 77.596 35.7183 77.512 35.3636 77.512C35.037 77.512 34.7196 77.582 34.4116 77.722C34.113 77.862 33.8563 78.03 33.6416 78.226L32.4796 76.98ZM45.0853 83V79.192C45.0853 78.996 45.0667 78.8093 45.0293 78.632C45.0013 78.4547 44.95 78.3007 44.8753 78.17C44.8007 78.03 44.6933 77.9227 44.5533 77.848C44.4227 77.764 44.2547 77.722 44.0493 77.722C43.844 77.722 43.662 77.764 43.5033 77.848C43.354 77.9227 43.228 78.03 43.1253 78.17C43.0227 78.31 42.9433 78.4733 42.8873 78.66C42.8407 78.8373 42.8173 79.024 42.8173 79.22V83H40.5073V76.028H42.7333V76.994H42.7613C42.8453 76.8447 42.9527 76.7 43.0833 76.56C43.2233 76.4107 43.382 76.2847 43.5593 76.182C43.746 76.0793 43.9467 75.9953 44.1613 75.93C44.376 75.8647 44.6047 75.832 44.8473 75.832C45.314 75.832 45.7107 75.916 46.0373 76.084C46.364 76.252 46.6253 76.4713 46.8213 76.742C47.0267 77.0033 47.1713 77.3067 47.2553 77.652C47.3487 77.9973 47.3953 78.3427 47.3953 78.688V83H45.0853ZM56.5263 82.342C56.5263 83.0233 56.4283 83.616 56.2323 84.12C56.0363 84.624 55.7609 85.0393 55.4063 85.366C55.0516 85.702 54.6176 85.9493 54.1043 86.108C53.6003 86.276 53.0403 86.36 52.4243 86.36C51.8083 86.36 51.1736 86.2667 50.5203 86.08C49.8763 85.8933 49.3163 85.6227 48.8403 85.268L49.9883 83.63C50.3243 83.9287 50.6929 84.148 51.0943 84.288C51.5049 84.4373 51.9063 84.512 52.2983 84.512C52.9703 84.512 53.4649 84.3347 53.7823 83.98C54.1089 83.6253 54.2723 83.154 54.2723 82.566V82.146H54.2303C54.0156 82.426 53.7263 82.65 53.3623 82.818C52.9983 82.986 52.5829 83.07 52.1163 83.07C51.5843 83.07 51.1129 82.9767 50.7023 82.79C50.2916 82.594 49.9416 82.3327 49.6523 82.006C49.3723 81.6793 49.1576 81.3013 49.0083 80.872C48.8589 80.4333 48.7843 79.9713 48.7843 79.486C48.7843 79.0007 48.8589 78.5387 49.0083 78.1C49.1576 77.6613 49.3723 77.274 49.6523 76.938C49.9416 76.602 50.2916 76.336 50.7023 76.14C51.1129 75.9347 51.5796 75.832 52.1023 75.832C52.5409 75.832 52.9609 75.9207 53.3623 76.098C53.7636 76.2753 54.0856 76.5507 54.3283 76.924H54.3563V76.028H56.5263V82.342ZM54.3423 79.472C54.3423 79.2387 54.3003 79.0147 54.2163 78.8C54.1416 78.5853 54.0296 78.3987 53.8803 78.24C53.7309 78.072 53.5536 77.9413 53.3483 77.848C53.1429 77.7547 52.9096 77.708 52.6483 77.708C52.3869 77.708 52.1536 77.7547 51.9483 77.848C51.7523 77.9413 51.5843 78.0673 51.4443 78.226C51.3043 78.3847 51.1969 78.5713 51.1223 78.786C51.0476 79.0007 51.0103 79.2293 51.0103 79.472C51.0103 79.7053 51.0476 79.9293 51.1223 80.144C51.1969 80.3587 51.3043 80.55 51.4443 80.718C51.5843 80.8767 51.7523 81.0073 51.9483 81.11C52.1536 81.2033 52.3869 81.25 52.6483 81.25C52.9096 81.25 53.1429 81.2033 53.3483 81.11C53.5629 81.0073 53.7403 80.8767 53.8803 80.718C54.0296 80.5593 54.1416 80.3727 54.2163 80.158C54.3003 79.9433 54.3423 79.7147 54.3423 79.472ZM63.1511 78.716C63.1511 78.352 63.0345 78.0393 62.8011 77.778C62.5771 77.5167 62.2365 77.386 61.7791 77.386C61.5551 77.386 61.3498 77.4233 61.1631 77.498C60.9765 77.5633 60.8131 77.6567 60.6731 77.778C60.5331 77.8993 60.4211 78.044 60.3371 78.212C60.2531 78.3707 60.2065 78.5387 60.1971 78.716H63.1511ZM65.2651 79.598C65.2651 79.6913 65.2651 79.7847 65.2651 79.878C65.2651 79.9713 65.2605 80.06 65.2511 80.144H60.1971C60.2158 80.34 60.2718 80.5173 60.3651 80.676C60.4678 80.8347 60.5938 80.9747 60.7431 81.096C60.9018 81.208 61.0745 81.2967 61.2611 81.362C61.4571 81.4273 61.6578 81.46 61.8631 81.46C62.2271 81.46 62.5351 81.3947 62.7871 81.264C63.0391 81.124 63.2445 80.9467 63.4031 80.732L64.9991 81.74C64.6725 82.216 64.2385 82.5847 63.6971 82.846C63.1651 83.098 62.5445 83.224 61.8351 83.224C61.3125 83.224 60.8178 83.1447 60.3511 82.986C59.8845 82.818 59.4738 82.58 59.1191 82.272C58.7738 81.9547 58.4985 81.5673 58.2931 81.11C58.0971 80.6527 57.9991 80.13 57.9991 79.542C57.9991 78.9727 58.0971 78.4593 58.2931 78.002C58.4891 77.5353 58.7551 77.1433 59.0911 76.826C59.4271 76.4993 59.8238 76.2473 60.2811 76.07C60.7385 75.8927 61.2331 75.804 61.7651 75.804C62.2785 75.804 62.7498 75.8927 63.1791 76.07C63.6085 76.238 63.9771 76.4853 64.2851 76.812C64.5931 77.1387 64.8311 77.5353 64.9991 78.002C65.1765 78.4687 65.2651 79.0007 65.2651 79.598ZM66.717 83V72.416H69.041V83H66.717ZM78.2509 79.486C78.2509 80.0553 78.1482 80.5733 77.9429 81.04C77.7376 81.4973 77.4576 81.8893 77.1029 82.216C76.7482 82.5333 76.3376 82.7807 75.8709 82.958C75.4042 83.1353 74.9049 83.224 74.3729 83.224C73.8502 83.224 73.3509 83.1353 72.8749 82.958C72.4082 82.7807 71.9976 82.5333 71.6429 82.216C71.2976 81.8893 71.0222 81.4973 70.8169 81.04C70.6116 80.5733 70.5089 80.0553 70.5089 79.486C70.5089 78.9167 70.6116 78.4033 70.8169 77.946C71.0222 77.4887 71.2976 77.1013 71.6429 76.784C71.9976 76.4667 72.4082 76.224 72.8749 76.056C73.3509 75.888 73.8502 75.804 74.3729 75.804C74.9049 75.804 75.4042 75.888 75.8709 76.056C76.3376 76.224 76.7482 76.4667 77.1029 76.784C77.4576 77.1013 77.7376 77.4887 77.9429 77.946C78.1482 78.4033 78.2509 78.9167 78.2509 79.486ZM76.0389 79.486C76.0389 79.262 76.0016 79.0427 75.9269 78.828C75.8522 78.6133 75.7449 78.4267 75.6049 78.268C75.4649 78.1 75.2922 77.9647 75.0869 77.862C74.8816 77.7593 74.6436 77.708 74.3729 77.708C74.1022 77.708 73.8642 77.7593 73.6589 77.862C73.4536 77.9647 73.2809 78.1 73.1409 78.268C73.0102 78.4267 72.9076 78.6133 72.8329 78.828C72.7676 79.0427 72.7349 79.262 72.7349 79.486C72.7349 79.71 72.7676 79.9293 72.8329 80.144C72.9076 80.3587 73.0149 80.5547 73.1549 80.732C73.2949 80.9 73.4676 81.0353 73.6729 81.138C73.8782 81.2407 74.1162 81.292 74.3869 81.292C74.6576 81.292 74.8956 81.2407 75.1009 81.138C75.3062 81.0353 75.4789 80.9 75.6189 80.732C75.7589 80.5547 75.8616 80.3587 75.9269 80.144C76.0016 79.9293 76.0389 79.71 76.0389 79.486ZM87.0966 82.342C87.0966 83.0233 86.9986 83.616 86.8026 84.12C86.6066 84.624 86.3313 85.0393 85.9766 85.366C85.6219 85.702 85.1879 85.9493 84.6746 86.108C84.1706 86.276 83.6106 86.36 82.9946 86.36C82.3786 86.36 81.7439 86.2667 81.0906 86.08C80.4466 85.8933 79.8866 85.6227 79.4106 85.268L80.5586 83.63C80.8946 83.9287 81.2633 84.148 81.6646 84.288C82.0753 84.4373 82.4766 84.512 82.8686 84.512C83.5406 84.512 84.0353 84.3347 84.3526 83.98C84.6793 83.6253 84.8426 83.154 84.8426 82.566V82.146H84.8006C84.5859 82.426 84.2966 82.65 83.9326 82.818C83.5686 82.986 83.1533 83.07 82.6866 83.07C82.1546 83.07 81.6833 82.9767 81.2726 82.79C80.8619 82.594 80.5119 82.3327 80.2226 82.006C79.9426 81.6793 79.7279 81.3013 79.5786 80.872C79.4293 80.4333 79.3546 79.9713 79.3546 79.486C79.3546 79.0007 79.4293 78.5387 79.5786 78.1C79.7279 77.6613 79.9426 77.274 80.2226 76.938C80.5119 76.602 80.8619 76.336 81.2726 76.14C81.6833 75.9347 82.1499 75.832 82.6726 75.832C83.1113 75.832 83.5313 75.9207 83.9326 76.098C84.3339 76.2753 84.6559 76.5507 84.8986 76.924H84.9266V76.028H87.0966V82.342ZM84.9126 79.472C84.9126 79.2387 84.8706 79.0147 84.7866 78.8C84.7119 78.5853 84.5999 78.3987 84.4506 78.24C84.3013 78.072 84.1239 77.9413 83.9186 77.848C83.7133 77.7547 83.4799 77.708 83.2186 77.708C82.9573 77.708 82.7239 77.7547 82.5186 77.848C82.3226 77.9413 82.1546 78.0673 82.0146 78.226C81.8746 78.3847 81.7673 78.5713 81.6926 78.786C81.6179 79.0007 81.5806 79.2293 81.5806 79.472C81.5806 79.7053 81.6179 79.9293 81.6926 80.144C81.7673 80.3587 81.8746 80.55 82.0146 80.718C82.1546 80.8767 82.3226 81.0073 82.5186 81.11C82.7239 81.2033 82.9573 81.25 83.2186 81.25C83.4799 81.25 83.7133 81.2033 83.9186 81.11C84.1333 81.0073 84.3106 80.8767 84.4506 80.718C84.5999 80.5593 84.7119 80.3727 84.7866 80.158C84.8706 79.9433 84.9126 79.7147 84.9126 79.472ZM96.7454 74.11C96.6614 74.082 96.5634 74.0587 96.4514 74.04C96.3394 74.0213 96.2274 74.012 96.1154 74.012C95.9008 74.012 95.7281 74.0493 95.5974 74.124C95.4668 74.1987 95.3641 74.3013 95.2894 74.432C95.2148 74.5533 95.1634 74.6933 95.1354 74.852C95.1074 75.0107 95.0934 75.1693 95.0934 75.328V76.028H96.6474V77.75H95.0934V83H92.7974V77.75H91.5234V76.028H92.7974V75.356C92.7974 74.9267 92.8441 74.5207 92.9374 74.138C93.0308 73.746 93.1894 73.4053 93.4134 73.116C93.6468 72.8173 93.9548 72.584 94.3374 72.416C94.7294 72.2387 95.2148 72.15 95.7934 72.15C95.9894 72.15 96.1808 72.164 96.3674 72.192C96.5634 72.2107 96.7408 72.2433 96.8994 72.29L96.7454 74.11ZM102.041 77.904C101.938 77.876 101.836 77.8573 101.733 77.848C101.64 77.8387 101.546 77.834 101.453 77.834C101.145 77.834 100.884 77.89 100.669 78.002C100.464 78.114 100.296 78.2493 100.165 78.408C100.044 78.5667 99.955 78.7393 99.899 78.926C99.843 79.1127 99.815 79.276 99.815 79.416V83H97.519V76.028H99.731V77.036H99.759C99.9364 76.6813 100.188 76.392 100.515 76.168C100.842 75.944 101.22 75.832 101.649 75.832C101.742 75.832 101.831 75.8367 101.915 75.846C102.008 75.8553 102.083 75.8693 102.139 75.888L102.041 77.904ZM110.216 79.486C110.216 80.0553 110.113 80.5733 109.908 81.04C109.702 81.4973 109.422 81.8893 109.068 82.216C108.713 82.5333 108.302 82.7807 107.836 82.958C107.369 83.1353 106.87 83.224 106.338 83.224C105.815 83.224 105.316 83.1353 104.84 82.958C104.373 82.7807 103.962 82.5333 103.608 82.216C103.262 81.8893 102.987 81.4973 102.782 81.04C102.576 80.5733 102.474 80.0553 102.474 79.486C102.474 78.9167 102.576 78.4033 102.782 77.946C102.987 77.4887 103.262 77.1013 103.608 76.784C103.962 76.4667 104.373 76.224 104.84 76.056C105.316 75.888 105.815 75.804 106.338 75.804C106.87 75.804 107.369 75.888 107.836 76.056C108.302 76.224 108.713 76.4667 109.068 76.784C109.422 77.1013 109.702 77.4887 109.908 77.946C110.113 78.4033 110.216 78.9167 110.216 79.486ZM108.004 79.486C108.004 79.262 107.966 79.0427 107.892 78.828C107.817 78.6133 107.71 78.4267 107.57 78.268C107.43 78.1 107.257 77.9647 107.052 77.862C106.846 77.7593 106.608 77.708 106.338 77.708C106.067 77.708 105.829 77.7593 105.624 77.862C105.418 77.9647 105.246 78.1 105.106 78.268C104.975 78.4267 104.872 78.6133 104.798 78.828C104.732 79.0427 104.7 79.262 104.7 79.486C104.7 79.71 104.732 79.9293 104.798 80.144C104.872 80.3587 104.98 80.5547 105.12 80.732C105.26 80.9 105.432 81.0353 105.638 81.138C105.843 81.2407 106.081 81.292 106.352 81.292C106.622 81.292 106.86 81.2407 107.066 81.138C107.271 81.0353 107.444 80.9 107.584 80.732C107.724 80.5547 107.826 80.3587 107.892 80.144C107.966 79.9293 108.004 79.71 108.004 79.486ZM120.573 83V79.192C120.573 78.996 120.559 78.8093 120.531 78.632C120.503 78.4453 120.452 78.2867 120.377 78.156C120.303 78.0253 120.2 77.9227 120.069 77.848C119.948 77.764 119.785 77.722 119.579 77.722C119.383 77.722 119.211 77.764 119.061 77.848C118.921 77.932 118.8 78.044 118.697 78.184C118.604 78.324 118.534 78.4873 118.487 78.674C118.441 78.8513 118.417 79.038 118.417 79.234V83H116.121V79.024C116.121 78.6227 116.042 78.3053 115.883 78.072C115.725 77.8387 115.473 77.722 115.127 77.722C114.763 77.722 114.479 77.8667 114.273 78.156C114.077 78.4453 113.979 78.8 113.979 79.22V83H111.669V76.028H113.895V76.994H113.923C114.007 76.8447 114.11 76.7 114.231 76.56C114.362 76.42 114.516 76.2987 114.693 76.196C114.871 76.084 115.067 75.9953 115.281 75.93C115.505 75.8647 115.748 75.832 116.009 75.832C116.513 75.832 116.938 75.9347 117.283 76.14C117.638 76.3453 117.913 76.6393 118.109 77.022C118.343 76.658 118.641 76.3687 119.005 76.154C119.369 75.9393 119.813 75.832 120.335 75.832C120.811 75.832 121.208 75.9207 121.525 76.098C121.852 76.266 122.113 76.49 122.309 76.77C122.505 77.0407 122.645 77.3487 122.729 77.694C122.823 78.03 122.869 78.3613 122.869 78.688V83H120.573ZM130.595 75.132V77.176H134.431V79.15H130.595V83H128.229V73.088H134.753V75.132H130.595ZM139.616 79.962H139.322C139.07 79.962 138.813 79.976 138.552 80.004C138.3 80.0227 138.071 80.0647 137.866 80.13C137.67 80.1953 137.506 80.2933 137.376 80.424C137.245 80.5453 137.18 80.7087 137.18 80.914C137.18 81.0447 137.208 81.1567 137.264 81.25C137.329 81.3433 137.408 81.418 137.502 81.474C137.595 81.53 137.702 81.572 137.824 81.6C137.945 81.6187 138.062 81.628 138.174 81.628C138.64 81.628 138.995 81.502 139.238 81.25C139.49 80.9887 139.616 80.6387 139.616 80.2V79.962ZM135.402 76.98C135.812 76.588 136.288 76.294 136.83 76.098C137.38 75.902 137.94 75.804 138.51 75.804C139.098 75.804 139.592 75.8787 139.994 76.028C140.404 76.168 140.736 76.392 140.988 76.7C141.24 76.9987 141.422 77.3813 141.534 77.848C141.655 78.3053 141.716 78.8513 141.716 79.486V83H139.616V82.258H139.574C139.396 82.5473 139.126 82.7713 138.762 82.93C138.407 83.0887 138.02 83.168 137.6 83.168C137.32 83.168 137.03 83.1307 136.732 83.056C136.433 82.9813 136.158 82.86 135.906 82.692C135.663 82.524 135.462 82.3 135.304 82.02C135.145 81.74 135.066 81.3947 135.066 80.984C135.066 80.48 135.201 80.074 135.472 79.766C135.752 79.458 136.106 79.22 136.536 79.052C136.974 78.884 137.46 78.772 137.992 78.716C138.524 78.66 139.042 78.632 139.546 78.632V78.52C139.546 78.1747 139.424 77.9227 139.182 77.764C138.939 77.596 138.64 77.512 138.286 77.512C137.959 77.512 137.642 77.582 137.334 77.722C137.035 77.862 136.778 78.03 136.564 78.226L135.402 76.98ZM147.531 78.086C147.345 77.9087 147.125 77.7593 146.873 77.638C146.621 77.5167 146.355 77.456 146.075 77.456C145.861 77.456 145.66 77.498 145.473 77.582C145.296 77.666 145.207 77.8107 145.207 78.016C145.207 78.212 145.305 78.352 145.501 78.436C145.707 78.52 146.033 78.6133 146.481 78.716C146.743 78.772 147.004 78.8513 147.265 78.954C147.536 79.0567 147.779 79.192 147.993 79.36C148.208 79.528 148.381 79.7333 148.511 79.976C148.642 80.2187 148.707 80.508 148.707 80.844C148.707 81.2827 148.619 81.656 148.441 81.964C148.264 82.2627 148.031 82.5053 147.741 82.692C147.461 82.8787 147.144 83.014 146.789 83.098C146.435 83.182 146.08 83.224 145.725 83.224C145.156 83.224 144.596 83.1353 144.045 82.958C143.504 82.7713 143.051 82.5007 142.687 82.146L143.975 80.788C144.181 81.012 144.433 81.1987 144.731 81.348C145.03 81.4973 145.347 81.572 145.683 81.572C145.87 81.572 146.052 81.53 146.229 81.446C146.416 81.3527 146.509 81.194 146.509 80.97C146.509 80.7553 146.397 80.5967 146.173 80.494C145.949 80.3913 145.599 80.284 145.123 80.172C144.881 80.116 144.638 80.0413 144.395 79.948C144.153 79.8547 143.933 79.7287 143.737 79.57C143.551 79.4113 143.397 79.2153 143.275 78.982C143.154 78.7487 143.093 78.4687 143.093 78.142C143.093 77.722 143.182 77.3673 143.359 77.078C143.537 76.7793 143.765 76.5367 144.045 76.35C144.325 76.1633 144.633 76.028 144.969 75.944C145.315 75.8507 145.655 75.804 145.991 75.804C146.514 75.804 147.023 75.888 147.517 76.056C148.021 76.2147 148.446 76.4573 148.791 76.784L147.531 78.086ZM152.525 77.75V80.41C152.525 80.7367 152.585 80.984 152.707 81.152C152.837 81.3107 153.066 81.39 153.393 81.39C153.505 81.39 153.621 81.3807 153.743 81.362C153.873 81.3433 153.981 81.3153 154.065 81.278L154.093 82.958C153.934 83.014 153.733 83.0607 153.491 83.098C153.248 83.1447 153.005 83.168 152.763 83.168C152.296 83.168 151.904 83.112 151.587 83C151.269 82.8787 151.013 82.7107 150.817 82.496C150.63 82.272 150.495 82.0107 150.411 81.712C150.327 81.404 150.285 81.0633 150.285 80.69V77.75H149.165V76.028H150.271V74.194H152.525V76.028H154.163V77.75H152.525ZM162.088 83L161.318 81.054H157.482L156.754 83H154.15L158.308 73.088H160.632L164.748 83H162.088ZM159.428 75.734L158.168 79.136H160.66L159.428 75.734ZM173.085 76.14C173.085 76.7187 172.978 77.2087 172.763 77.61C172.548 78.002 172.259 78.3193 171.895 78.562C171.531 78.8047 171.111 78.982 170.635 79.094C170.159 79.206 169.664 79.262 169.151 79.262H167.961V83H165.567V73.088H169.207C169.748 73.088 170.252 73.144 170.719 73.256C171.195 73.3587 171.606 73.5313 171.951 73.774C172.306 74.0073 172.581 74.32 172.777 74.712C172.982 75.0947 173.085 75.5707 173.085 76.14ZM170.691 76.154C170.691 75.9207 170.644 75.7293 170.551 75.58C170.458 75.4307 170.332 75.314 170.173 75.23C170.014 75.146 169.832 75.09 169.627 75.062C169.431 75.034 169.226 75.02 169.011 75.02H167.961V77.358H168.969C169.193 77.358 169.408 77.3393 169.613 77.302C169.818 77.2647 170 77.1993 170.159 77.106C170.327 77.0127 170.458 76.8913 170.551 76.742C170.644 76.5833 170.691 76.3873 170.691 76.154ZM174.522 83V73.088H176.93V83H174.522Z" fill="#F9FAFB"/>
+<path d="M26.3653 23.9009C27.7965 23.9009 28.9567 25.052 28.9567 26.4719C28.9567 27.8918 27.7965 29.0429 26.3653 29.0429L16 29.0429L16 23.9009L26.3653 23.9009Z" fill="white"/>
+<path d="M19.4551 17.0449C20.8863 17.0449 22.0464 18.196 22.0464 19.6159C22.0464 21.0358 20.8863 22.1869 19.4551 22.1869L16 22.1869L16 17.0449L19.4551 17.0449Z" fill="white"/>
+<path d="M42.3033 22.8708C42.997 22.7504 44.0029 21.9588 44.0029 20.4962C44.0029 18.5689 42.6674 17.2955 40.5688 17.2955L34.8453 17.2955L34.8453 28.8247L40.5861 28.8247C43.1704 28.8247 44.3325 27.4997 44.3325 25.6241C44.3325 23.9893 43.2571 23.0601 42.3033 22.9397L42.3033 22.8708ZM37.2041 19.2916L40.3086 19.2916C41.0718 19.2916 41.7135 19.8251 41.7135 20.6338C41.7135 21.5286 41.0891 22.1137 40.1526 22.1137L37.2041 22.1137L37.2041 19.2916ZM37.2041 26.8286L37.2041 23.9721L40.4127 23.9721C41.2972 23.9721 41.9216 24.5228 41.9216 25.4004C41.9216 26.2607 41.3839 26.8286 40.326 26.8286L37.2041 26.8286Z" fill="white"/>
+<path d="M54.0172 20.238L51.7279 20.238L51.7279 24.0409C51.7279 26.1403 50.8779 27.0007 49.5773 27.0007C48.5192 27.0007 47.8255 26.1919 47.8255 24.9874L47.8255 20.238L45.5361 20.238L45.5361 25.4692C45.5361 27.6029 46.9236 29.0828 49.0049 29.0828C50.1494 29.0828 51.0515 28.7214 51.7279 28.0503L51.7279 28.8247L54.0172 28.8247L54.0172 20.238Z" fill="white"/>
+<path d="M66.9767 19.98C65.5892 19.98 64.5311 20.5134 63.82 21.391C63.1956 20.479 62.1378 19.98 60.9757 19.98C59.8485 19.98 58.9987 20.3414 58.3916 20.9436L58.3916 20.2381L56.1021 20.2381L56.1021 28.8248L58.3916 28.8248L58.3916 24.6949C58.3916 22.8881 59.1547 22.0621 60.3686 22.0621C61.3227 22.0621 62.0684 22.7676 62.0684 23.9206L62.0684 28.8248L64.3578 28.8248L64.3578 24.6949C64.3578 22.8881 65.1555 22.0621 66.3697 22.0621C67.3235 22.0621 68.0693 22.7676 68.0693 23.9206L68.0693 28.8248L70.3415 28.8248L70.3415 23.4559C70.3415 21.3566 68.7804 19.98 66.9767 19.98Z" fill="white"/>
+<path d="M77.3695 19.98C76.1901 19.98 75.2363 20.3241 74.5078 20.9264L74.5078 20.2381L72.2183 20.2381L72.2183 31.7501L74.5078 31.7501L74.5078 28.1537C75.2363 28.7387 76.1901 29.0829 77.3695 29.0829C79.5722 29.0829 81.6188 27.2416 81.6188 24.54C81.6188 21.8384 79.5722 19.98 77.3695 19.98ZM76.9705 27.104C75.739 27.104 74.5078 26.1231 74.5078 24.54C74.5078 22.9569 75.739 21.9589 76.9705 21.9589C78.358 21.9589 79.3988 22.9569 79.3988 24.54C79.3988 26.1231 78.358 27.104 76.9705 27.104Z" fill="white"/>
+<path d="M92.2518 22.97C92.0673 22.7285 91.8136 22.5214 91.4908 22.3489C91.1679 22.1649 90.8163 22.0729 90.4357 22.0729C90.1014 22.0729 89.7958 22.1419 89.5191 22.2799C89.2423 22.4179 89.104 22.6479 89.104 22.97C89.104 23.292 89.2539 23.5221 89.5537 23.6601C89.865 23.7866 90.3147 23.9189 90.9027 24.0569C91.2141 24.1259 91.5254 24.2179 91.8367 24.3329C92.1596 24.448 92.4478 24.6032 92.7015 24.7988C92.9667 24.9828 93.18 25.2186 93.3414 25.5061C93.5029 25.7821 93.5836 26.1214 93.5836 26.524C93.5836 27.0301 93.4856 27.4614 93.2895 27.8179C93.1051 28.163 92.8514 28.4448 92.5285 28.6633C92.2172 28.8818 91.8482 29.0371 91.4216 29.1291C91.0065 29.2326 90.5741 29.2844 90.1244 29.2844C89.4787 29.2844 88.8503 29.1694 88.2392 28.9393C87.6281 28.6978 87.1207 28.3585 86.7172 27.9215L88.0835 26.6448C88.3141 26.9438 88.6139 27.1911 88.9829 27.3866C89.3519 27.5822 89.7612 27.6799 90.2109 27.6799C90.3608 27.6799 90.5107 27.6627 90.6606 27.6282C90.822 27.5937 90.9661 27.5419 91.093 27.4729C91.2314 27.3924 91.3409 27.2889 91.4216 27.1623C91.5023 27.0358 91.5427 26.8806 91.5427 26.6965C91.5427 26.3515 91.3812 26.1042 91.0584 25.9547C90.7471 25.8051 90.2743 25.6556 89.6401 25.5061C89.3288 25.4371 89.0233 25.3508 88.7235 25.2473C88.4352 25.1323 88.1758 24.9885 87.9452 24.816C87.7146 24.632 87.5301 24.4077 87.3917 24.1432C87.2533 23.8786 87.1841 23.5508 87.1841 23.1598C87.1841 22.6997 87.2764 22.3029 87.4609 21.9693C87.6569 21.6358 87.9106 21.3655 88.2219 21.1585C88.5332 20.94 88.8849 20.7789 89.2769 20.6754C89.669 20.5719 90.0725 20.5201 90.4876 20.5201C91.0872 20.5201 91.6695 20.6237 92.2345 20.8307C92.811 21.0377 93.2665 21.354 93.6009 21.7796L92.2518 22.97Z" fill="white"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M92.2266 23.2259L92.1122 23.0761C91.9457 22.8581 91.713 22.6663 91.4079 22.5032L91.4058 22.5021L91.4037 22.5009C91.108 22.3324 90.7864 22.2479 90.4357 22.2479C90.1263 22.2479 89.8479 22.3116 89.5975 22.4365C89.4844 22.4929 89.4077 22.5637 89.3581 22.646C89.3083 22.7289 89.2794 22.8344 89.2794 22.9701C89.2794 23.1032 89.31 23.2068 89.3634 23.2888C89.4165 23.3702 89.4996 23.4419 89.6236 23.4996C89.9221 23.6205 90.3598 23.7498 90.9418 23.8864C91.2605 23.9571 91.5788 24.0512 91.8966 24.1685C92.2338 24.2888 92.5371 24.4516 92.8052 24.6577C93.0907 24.8566 93.3204 25.1111 93.4937 25.4194C93.6738 25.728 93.759 26.0991 93.759 26.5241C93.759 27.0521 93.6567 27.5136 93.4438 27.9013C93.2462 28.2704 92.9739 28.5731 92.6282 28.8074C92.296 29.0403 91.9059 29.2034 91.4614 29.2996C91.0325 29.4064 90.5867 29.4595 90.1244 29.4595C89.4573 29.4595 88.8079 29.3405 88.1772 29.1032L88.1759 29.1026L88.1745 29.1021C87.5414 28.8519 87.0113 28.4984 86.5881 28.0401L86.4702 27.9124L88.1047 26.3853L88.2225 26.5381C88.4363 26.8154 88.716 27.0471 89.0652 27.2322C89.4069 27.4132 89.7876 27.505 90.2109 27.505C90.3471 27.505 90.4838 27.4893 90.6211 27.4577L90.6224 27.4574L90.6238 27.4571C90.77 27.4259 90.8971 27.3798 91.0067 27.3205C91.1215 27.2533 91.2092 27.1693 91.2735 27.0685C91.3327 26.9758 91.3672 26.8549 91.3672 26.6966C91.3672 26.5521 91.3337 26.4385 91.2745 26.3478C91.2151 26.2568 91.1222 26.1772 90.9845 26.1135L90.9833 26.113L90.9822 26.1124C90.6885 25.9713 90.2309 25.8254 89.6009 25.6768C89.2835 25.6063 88.9718 25.5184 88.666 25.4128L88.6621 25.4114L88.6583 25.4099C88.3568 25.2896 88.0837 25.1385 87.8399 24.9561L87.8377 24.9544L87.8355 24.9527C87.5856 24.7533 87.3856 24.51 87.2361 24.2242C87.0813 23.9281 87.0087 23.5706 87.0087 23.1598C87.0087 22.6763 87.1057 22.2492 87.3072 21.8849L87.3083 21.8829L87.3095 21.8809C87.5181 21.526 87.7893 21.2363 88.1227 21.0142C88.4516 20.7836 88.8219 20.6146 89.232 20.5063C89.639 20.3988 90.0577 20.3452 90.4876 20.3452C91.1077 20.3452 91.7103 20.4523 92.2944 20.6663C92.8976 20.883 93.3817 21.2171 93.7389 21.6717L93.8409 21.8015L92.2266 23.2259ZM88.2218 21.1586C87.9105 21.3656 87.6569 21.6359 87.4608 21.9694C87.2763 22.303 87.1841 22.6998 87.1841 23.1598C87.1841 23.5509 87.2533 23.8787 87.3917 24.1432C87.53 24.4078 87.7145 24.6321 87.9451 24.8161C88.1757 24.9886 88.4352 25.1324 88.7234 25.2474C89.0232 25.3509 89.3288 25.4372 89.6401 25.5062C90.2743 25.6557 90.747 25.8052 91.0583 25.9547C91.3812 26.1043 91.5426 26.3515 91.5426 26.6966C91.5426 26.8806 91.5023 27.0359 91.4216 27.1624C91.3408 27.2889 91.2313 27.3924 91.0929 27.473C90.9661 27.542 90.822 27.5937 90.6605 27.6282C90.5106 27.6627 90.3608 27.68 90.2109 27.68C89.7612 27.68 89.3518 27.5822 88.9829 27.3867C88.671 27.2214 88.4085 27.0192 88.1955 26.78C88.1565 26.7362 88.1192 26.6911 88.0835 26.6448L86.7171 27.9215C86.7313 27.9369 86.7456 27.9521 86.76 27.9672C86.7859 27.9943 86.8122 28.0211 86.839 28.0474C87.2213 28.4243 87.688 28.7216 88.2391 28.9394C88.8503 29.1695 89.4787 29.2845 90.1244 29.2845C90.5741 29.2845 91.0065 29.2327 91.4216 29.1292C91.8482 29.0372 92.2172 28.8819 92.5285 28.6634C92.8513 28.4449 93.105 28.1631 93.2895 27.818C93.4855 27.4615 93.5835 27.0301 93.5835 26.5241C93.5835 26.1215 93.5028 25.7822 93.3414 25.5062C93.18 25.2186 92.9666 24.9829 92.7014 24.7988C92.4478 24.6033 92.1595 24.448 91.8367 24.333C91.5253 24.218 91.214 24.126 90.9027 24.057C90.3146 23.919 89.8649 23.7867 89.5536 23.6602C89.2538 23.5221 89.1039 23.2921 89.1039 22.9701C89.1039 22.648 89.2423 22.418 89.519 22.28C89.7958 22.1419 90.1013 22.0729 90.4357 22.0729C90.8162 22.0729 91.1679 22.165 91.4907 22.349C91.7522 22.4887 91.9682 22.651 92.1389 22.836C92.1791 22.8794 92.2167 22.9241 92.2517 22.9701L93.6008 21.7796C93.2664 21.3541 92.811 21.0378 92.2345 20.8308C91.6695 20.6237 91.0872 20.5202 90.4876 20.5202C90.0725 20.5202 89.6689 20.572 89.2769 20.6755C88.8848 20.779 88.5332 20.94 88.2218 21.1586Z" fill="white"/>
+<path d="M28.9566 19.6159C28.9566 21.0358 27.7964 22.1869 26.3653 22.1869C24.9341 22.1869 23.7739 21.0358 23.7739 19.6159C23.7739 18.196 24.9341 17.0449 26.3653 17.0449C27.7964 17.0449 28.9566 18.196 28.9566 19.6159Z" fill="url(#paint4_linear_12161_3932)"/>
+<path d="M82.4836 27.8352C82.4836 27.4671 82.6162 27.1508 82.8814 26.8863C83.1582 26.6218 83.4868 26.4895 83.8673 26.4895C84.2363 26.4895 84.5591 26.616 84.8359 26.8691C85.1126 27.1221 85.251 27.4326 85.251 27.8007C85.251 28.1687 85.1126 28.485 84.8359 28.7496C84.5707 29.0141 84.2478 29.1464 83.8673 29.1464C83.6828 29.1464 83.5041 29.1119 83.3311 29.0429C83.1697 28.9739 83.0256 28.8818 82.8987 28.7668C82.7719 28.6518 82.6681 28.5138 82.5874 28.3528C82.5182 28.1917 82.4836 28.0192 82.4836 27.8352Z" fill="white"/>
+<path d="M95.5586 29.0429L97.8483 29.0429L97.8483 24.913C97.8483 23.1062 98.6461 22.2803 99.8602 22.2803C100.814 22.2803 101.56 22.9858 101.56 24.1387L101.56 29.0429L103.832 29.0429L103.832 23.6741C103.832 21.5747 102.271 20.1981 100.467 20.1981C99.3924 20.1981 98.5153 20.5182 97.844 21.0705L97.844 16L95.5586 16L95.5586 29.0429Z" fill="white"/>
+</g>
+<defs>
+<filter id="filter0_f_12161_3932" x="-30" y="-30" width="300" height="160" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+<feGaussianBlur stdDeviation="15" result="effect1_foregroundBlur_12161_3932"/>
+</filter>
+<radialGradient id="paint0_radial_12161_3932" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(112 39.5) rotate(-160.573) scale(118.761 58.6742)">
+<stop stop-color="#4A144B"/>
+<stop offset="1" stop-color="#025FD7" stop-opacity="0"/>
+</radialGradient>
+<radialGradient id="paint1_radial_12161_3932" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(11.7692 15.8854) rotate(81.0575) scale(94.7665 65.0274)">
+<stop stop-color="#4C50BB"/>
+<stop offset="1" stop-color="#025FD7" stop-opacity="0"/>
+</radialGradient>
+<radialGradient id="paint2_radial_12161_3932" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(184.5 74.5) rotate(-105.027) scale(77.1379 242.277)">
+<stop stop-color="#FF8585"/>
+<stop offset="1" stop-color="#025FD7" stop-opacity="0"/>
+</radialGradient>
+<linearGradient id="paint3_linear_12161_3932" x1="3.72616" y1="-0.959555" x2="76.0199" y2="172.545" gradientUnits="userSpaceOnUse">
+<stop stop-color="#19AEFF"/>
+<stop offset="0.21875" stop-color="white"/>
+<stop offset="0.416667" stop-color="#015CD5"/>
+<stop offset="0.625" stop-color="#2E303E"/>
+<stop offset="0.864583" stop-color="#19AEFF"/>
+</linearGradient>
+<linearGradient id="paint4_linear_12161_3932" x1="23.7893" y1="19.5513" x2="29.066" y2="19.5513" gradientUnits="userSpaceOnUse">
+<stop stop-color="#19AEFF"/>
+<stop offset="1" stop-color="#015CD5"/>
+</linearGradient>
+<clipPath id="clip0_12161_3932">
+<rect width="240" height="100" fill="white"/>
+</clipPath>
+</defs>
+</svg>
diff --git a/docs/en/overrides/main.html b/docs/en/overrides/main.html
index d867d2ee5..4c7f19fd4 100644
--- a/docs/en/overrides/main.html
+++ b/docs/en/overrides/main.html
@@ -49,7 +49,7 @@
     <div class="item">
       <a title="Automate FastAPI documentation generation with Bump.sh" style="display: block; position: relative;" href="https://bump.sh/fastapi?utm_source=fastapi&utm_medium=referral&utm_campaign=sponsor" target="_blank">
         <span class="sponsor-badge">sponsor</span>
-        <img class="sponsor-image" src="/img/sponsors/bump-sh-banner.png" />
+        <img class="sponsor-image" src="/img/sponsors/bump-sh-banner.svg" />
       </a>
     </div>
   </div>

From c1adce4fe93a0035e69988f7e051cfab97d8acef Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 4 Oct 2023 22:52:00 +0000
Subject: [PATCH 212/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 87476fd1e..3c7ecad43 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* 🔧 Update sponsors, Bump.sh images. PR [#10381](https://github.com/tiangolo/fastapi/pull/10381) by [@tiangolo](https://github.com/tiangolo).
 * 👥 Update FastAPI People. PR [#10363](https://github.com/tiangolo/fastapi/pull/10363) by [@tiangolo](https://github.com/tiangolo).
 ## 0.103.2
 

From 2ba7586ff3f4dca379043489141c6d07cb2451bc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 17 Oct 2023 09:59:11 +0400
Subject: [PATCH 213/317] =?UTF-8?q?=E2=AC=86=EF=B8=8F=20Drop=20support=20f?=
 =?UTF-8?q?or=20Python=203.7,=20require=20Python=203.8=20or=20above=20(#10?=
 =?UTF-8?q?442)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 📝 Update docs, require Python 3.8+, drop 3.7

* 🔧 Update pyproject.toml, drop support for Python 3.7, require Python 3.8+

* 👷 Update CI GitHub Actions, drop support for Python 3.7, require 3.8+

* 📝 Update docs' references to Python 3.6 and 3.7, use Python 3.8
---
 .github/workflows/publish.yml                 |  2 +-
 .github/workflows/test.yml                    |  2 +-
 README.md                                     |  6 +-
 docs/de/docs/features.md                      |  2 +-
 .../docs/advanced/additional-status-codes.md  |  4 +-
 .../en/docs/advanced/advanced-dependencies.md | 16 ++---
 docs/en/docs/advanced/generate-clients.md     |  6 +-
 .../docs/advanced/security/http-basic-auth.md | 12 ++--
 .../docs/advanced/security/oauth2-scopes.md   | 32 ++++-----
 docs/en/docs/advanced/settings.md             | 12 ++--
 docs/en/docs/advanced/testing-dependencies.md |  4 +-
 docs/en/docs/advanced/websockets.md           |  6 +-
 .../docs/how-to/separate-openapi-schemas.md   |  8 +--
 docs/en/docs/index.md                         |  6 +-
 docs/en/docs/python-types.md                  | 24 +++----
 docs/en/docs/tutorial/background-tasks.md     |  4 +-
 docs/en/docs/tutorial/bigger-applications.md  |  4 +-
 docs/en/docs/tutorial/body-fields.md          |  8 +--
 docs/en/docs/tutorial/body-multiple-params.md | 18 ++---
 docs/en/docs/tutorial/body-nested-models.md   | 20 +++---
 docs/en/docs/tutorial/body-updates.md         |  8 +--
 docs/en/docs/tutorial/body.md                 | 12 ++--
 docs/en/docs/tutorial/cookie-params.md        |  8 +--
 .../dependencies/classes-as-dependencies.md   | 52 +++++++-------
 ...pendencies-in-path-operation-decorators.md | 16 ++---
 .../dependencies/dependencies-with-yield.md   |  8 +--
 .../dependencies/global-dependencies.md       |  4 +-
 docs/en/docs/tutorial/dependencies/index.md   | 14 ++--
 .../tutorial/dependencies/sub-dependencies.md | 16 ++---
 docs/en/docs/tutorial/encoder.md              |  2 +-
 docs/en/docs/tutorial/extra-data-types.md     |  8 +--
 docs/en/docs/tutorial/extra-models.md         | 10 +--
 docs/en/docs/tutorial/header-params.md        | 16 ++---
 .../tutorial/path-operation-configuration.md  | 10 +--
 .../path-params-numeric-validations.md        | 26 +++----
 .../tutorial/query-params-str-validations.md  | 72 +++++++++----------
 docs/en/docs/tutorial/query-params.md         |  8 +--
 docs/en/docs/tutorial/request-files.md        | 28 ++++----
 .../docs/tutorial/request-forms-and-files.md  |  8 +--
 docs/en/docs/tutorial/request-forms.md        |  8 +--
 docs/en/docs/tutorial/response-model.md       | 28 ++++----
 docs/en/docs/tutorial/schema-extra-example.md | 18 ++---
 docs/en/docs/tutorial/security/first-steps.md | 12 ++--
 .../tutorial/security/get-current-user.md     | 24 +++----
 docs/en/docs/tutorial/security/oauth2-jwt.md  | 16 ++---
 .../docs/tutorial/security/simple-oauth2.md   | 20 +++---
 docs/en/docs/tutorial/sql-databases.md        | 20 +++---
 docs/en/docs/tutorial/testing.md              |  4 +-
 docs/es/docs/features.md                      |  2 +-
 docs/es/docs/index.md                         |  6 +-
 docs/fr/docs/features.md                      |  2 +-
 docs/fr/docs/index.md                         |  6 +-
 docs/ja/docs/features.md                      |  2 +-
 docs/ja/docs/index.md                         |  2 +-
 docs/ko/docs/index.md                         |  2 +-
 docs/pl/docs/features.md                      |  2 +-
 docs/pl/docs/index.md                         |  4 +-
 docs/pt/docs/features.md                      |  2 +-
 docs/pt/docs/index.md                         |  6 +-
 docs/pt/docs/tutorial/body-multiple-params.md | 10 +--
 docs/pt/docs/tutorial/encoder.md              |  2 +-
 docs/pt/docs/tutorial/extra-models.md         | 10 +--
 docs/pt/docs/tutorial/header-params.md        |  8 +--
 .../tutorial/path-operation-configuration.md  | 10 +--
 .../path-params-numeric-validations.md        |  4 +-
 docs/pt/docs/tutorial/query-params.md         |  8 +--
 docs/ru/docs/features.md                      |  2 +-
 docs/ru/docs/index.md                         |  6 +-
 docs/ru/docs/tutorial/background-tasks.md     |  2 +-
 docs/ru/docs/tutorial/body-fields.md          |  4 +-
 docs/ru/docs/tutorial/body-multiple-params.md | 18 ++---
 docs/ru/docs/tutorial/body-nested-models.md   | 20 +++---
 docs/ru/docs/tutorial/cookie-params.md        |  4 +-
 .../dependencies/global-dependencies.md       |  4 +-
 docs/ru/docs/tutorial/extra-data-types.md     |  4 +-
 docs/ru/docs/tutorial/extra-models.md         | 10 +--
 docs/ru/docs/tutorial/header-params.md        | 16 ++---
 .../tutorial/path-operation-configuration.md  | 10 +--
 .../path-params-numeric-validations.md        | 26 +++----
 .../tutorial/query-params-str-validations.md  | 72 +++++++++----------
 docs/ru/docs/tutorial/query-params.md         |  8 +--
 docs/ru/docs/tutorial/request-forms.md        |  8 +--
 docs/ru/docs/tutorial/response-model.md       | 28 ++++----
 docs/ru/docs/tutorial/schema-extra-example.md | 12 ++--
 docs/ru/docs/tutorial/testing.md              |  4 +-
 docs/tr/docs/features.md                      |  2 +-
 docs/tr/docs/index.md                         |  6 +-
 docs/uk/docs/python-types.md                  | 22 +++---
 docs/uk/docs/tutorial/body.md                 | 12 ++--
 docs/uk/docs/tutorial/cookie-params.md        |  8 +--
 docs/uk/docs/tutorial/encoder.md              |  2 +-
 docs/uk/docs/tutorial/extra-data-types.md     |  8 +--
 docs/vi/docs/features.md                      |  2 +-
 docs/vi/docs/index.md                         |  6 +-
 docs/vi/docs/python-types.md                  | 18 ++---
 docs/yo/docs/index.md                         |  6 +-
 docs/zh/docs/advanced/generate-clients.md     |  6 +-
 docs/zh/docs/advanced/settings.md             | 12 ++--
 docs/zh/docs/advanced/websockets.md           |  6 +-
 docs/zh/docs/index.md                         |  6 +-
 docs/zh/docs/tutorial/background-tasks.md     |  4 +-
 docs/zh/docs/tutorial/body-fields.md          |  8 +--
 docs/zh/docs/tutorial/body-multiple-params.md | 18 ++---
 docs/zh/docs/tutorial/body-nested-models.md   | 20 +++---
 docs/zh/docs/tutorial/body.md                 | 12 ++--
 docs/zh/docs/tutorial/cookie-params.md        |  8 +--
 .../dependencies/classes-as-dependencies.md   |  4 +-
 docs/zh/docs/tutorial/encoder.md              |  2 +-
 docs/zh/docs/tutorial/extra-data-types.md     |  8 +--
 docs/zh/docs/tutorial/extra-models.md         | 10 +--
 docs/zh/docs/tutorial/header-params.md        | 16 ++---
 .../path-params-numeric-validations.md        | 10 +--
 .../tutorial/query-params-str-validations.md  |  2 +-
 docs/zh/docs/tutorial/request-files.md        |  6 +-
 docs/zh/docs/tutorial/response-model.md       |  8 +--
 docs/zh/docs/tutorial/schema-extra-example.md |  8 +--
 docs/zh/docs/tutorial/security/first-steps.md |  4 +-
 docs/zh/docs/tutorial/sql-databases.md        | 20 +++---
 docs/zh/docs/tutorial/testing.md              |  4 +-
 pyproject.toml                                |  3 +-
 120 files changed, 657 insertions(+), 658 deletions(-)

diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index b84c5bf17..5ab0603b9 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -17,7 +17,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v4
         with:
-          python-version: "3.7"
+          python-version: "3.10"
           # Issue ref: https://github.com/actions/setup-python/issues/436
           # cache: "pip"
           cache-dependency-path: pyproject.toml
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 4ebc64a14..769b52021 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -42,7 +42,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.7", "3.8", "3.9", "3.10", "3.11"]
+        python-version: ["3.8", "3.9", "3.10", "3.11"]
         pydantic-version: ["pydantic-v1", "pydantic-v2"]
       fail-fast: false
     steps:
diff --git a/README.md b/README.md
index 3f125e60e..aeb29b587 100644
--- a/README.md
+++ b/README.md
@@ -27,7 +27,7 @@
 
 ---
 
-FastAPI is a modern, fast (high-performance), web framework for building APIs with Python 3.7+ based on standard Python type hints.
+FastAPI is a modern, fast (high-performance), web framework for building APIs with Python 3.8+ based on standard Python type hints.
 
 The key features are:
 
@@ -120,7 +120,7 @@ If you are building a <abbr title="Command Line Interface">CLI</abbr> app to be
 
 ## Requirements
 
-Python 3.7+
+Python 3.8+
 
 FastAPI stands on the shoulders of giants:
 
@@ -336,7 +336,7 @@ You do that with standard modern Python types.
 
 You don't have to learn a new syntax, the methods or classes of a specific library, etc.
 
-Just standard **Python 3.7+**.
+Just standard **Python 3.8+**.
 
 For example, for an `int`:
 
diff --git a/docs/de/docs/features.md b/docs/de/docs/features.md
index f281afd1e..64fa8092d 100644
--- a/docs/de/docs/features.md
+++ b/docs/de/docs/features.md
@@ -25,7 +25,7 @@ Mit einer interaktiven API-Dokumentation und explorativen webbasierten Benutzers
 
 ### Nur modernes Python
 
-Alles basiert auf **Python 3.6 Typ**-Deklarationen (dank Pydantic). Es muss keine neue Syntax gelernt werden, nur standardisiertes modernes Python.
+Alles basiert auf **Python 3.8 Typ**-Deklarationen (dank Pydantic). Es muss keine neue Syntax gelernt werden, nur standardisiertes modernes Python.
 
 
 
diff --git a/docs/en/docs/advanced/additional-status-codes.md b/docs/en/docs/advanced/additional-status-codes.md
index 416444d3b..0ce275343 100644
--- a/docs/en/docs/advanced/additional-status-codes.md
+++ b/docs/en/docs/advanced/additional-status-codes.md
@@ -26,7 +26,7 @@ To achieve that, import `JSONResponse`, and return your content there directly,
     {!> ../../../docs_src/additional_status_codes/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4  26"
     {!> ../../../docs_src/additional_status_codes/tutorial001_an.py!}
@@ -41,7 +41,7 @@ To achieve that, import `JSONResponse`, and return your content there directly,
     {!> ../../../docs_src/additional_status_codes/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/advanced/advanced-dependencies.md b/docs/en/docs/advanced/advanced-dependencies.md
index 402c5d755..0cffab56d 100644
--- a/docs/en/docs/advanced/advanced-dependencies.md
+++ b/docs/en/docs/advanced/advanced-dependencies.md
@@ -24,13 +24,13 @@ To do that, we declare a method `__call__`:
     {!> ../../../docs_src/dependencies/tutorial011_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/dependencies/tutorial011_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -51,13 +51,13 @@ And now, we can use `__init__` to declare the parameters of the instance that we
     {!> ../../../docs_src/dependencies/tutorial011_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/dependencies/tutorial011_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -78,13 +78,13 @@ We could create an instance of this class with:
     {!> ../../../docs_src/dependencies/tutorial011_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17"
     {!> ../../../docs_src/dependencies/tutorial011_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -113,13 +113,13 @@ checker(q="somequery")
     {!> ../../../docs_src/dependencies/tutorial011_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="21"
     {!> ../../../docs_src/dependencies/tutorial011_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/advanced/generate-clients.md b/docs/en/docs/advanced/generate-clients.md
index f439ed93a..07a8f039f 100644
--- a/docs/en/docs/advanced/generate-clients.md
+++ b/docs/en/docs/advanced/generate-clients.md
@@ -35,7 +35,7 @@ Let's start with a simple FastAPI application:
     {!> ../../../docs_src/generate_clients/tutorial001_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9-11  14-15  18  19  23"
     {!> ../../../docs_src/generate_clients/tutorial001.py!}
@@ -147,7 +147,7 @@ For example, you could have a section for **items** and another section for **us
     {!> ../../../docs_src/generate_clients/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="23  28  36"
     {!> ../../../docs_src/generate_clients/tutorial002.py!}
@@ -204,7 +204,7 @@ You can then pass that custom function to **FastAPI** as the `generate_unique_id
     {!> ../../../docs_src/generate_clients/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8-9  12"
     {!> ../../../docs_src/generate_clients/tutorial003.py!}
diff --git a/docs/en/docs/advanced/security/http-basic-auth.md b/docs/en/docs/advanced/security/http-basic-auth.md
index 8177a4b28..6f9002f60 100644
--- a/docs/en/docs/advanced/security/http-basic-auth.md
+++ b/docs/en/docs/advanced/security/http-basic-auth.md
@@ -26,13 +26,13 @@ Then, when you type that username and password, the browser sends them in the he
     {!> ../../../docs_src/security/tutorial006_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="2  7  11"
     {!> ../../../docs_src/security/tutorial006_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -65,13 +65,13 @@ Then we can use `secrets.compare_digest()` to ensure that `credentials.username`
     {!> ../../../docs_src/security/tutorial007_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  12-24"
     {!> ../../../docs_src/security/tutorial007_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -148,13 +148,13 @@ After detecting that the credentials are incorrect, return an `HTTPException` wi
     {!> ../../../docs_src/security/tutorial007_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="26-30"
     {!> ../../../docs_src/security/tutorial007_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/advanced/security/oauth2-scopes.md b/docs/en/docs/advanced/security/oauth2-scopes.md
index 41cd61683..304a46090 100644
--- a/docs/en/docs/advanced/security/oauth2-scopes.md
+++ b/docs/en/docs/advanced/security/oauth2-scopes.md
@@ -68,7 +68,7 @@ First, let's quickly see the parts that change from the examples in the main **T
     {!> ../../../docs_src/security/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="2  4  8  12  47  65  106  108-116  122-125  129-135  140  156"
     {!> ../../../docs_src/security/tutorial005_an.py!}
@@ -92,7 +92,7 @@ First, let's quickly see the parts that change from the examples in the main **T
     {!> ../../../docs_src/security/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -121,7 +121,7 @@ The `scopes` parameter receives a `dict` with each scope as a key and the descri
     {!> ../../../docs_src/security/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="63-66"
     {!> ../../../docs_src/security/tutorial005_an.py!}
@@ -146,7 +146,7 @@ The `scopes` parameter receives a `dict` with each scope as a key and the descri
     {!> ../../../docs_src/security/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -188,7 +188,7 @@ And we return the scopes as part of the JWT token.
     {!> ../../../docs_src/security/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="156"
     {!> ../../../docs_src/security/tutorial005_an.py!}
@@ -212,7 +212,7 @@ And we return the scopes as part of the JWT token.
     {!> ../../../docs_src/security/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -254,7 +254,7 @@ In this case, it requires the scope `me` (it could require more than one scope).
     {!> ../../../docs_src/security/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4  140  171"
     {!> ../../../docs_src/security/tutorial005_an.py!}
@@ -278,7 +278,7 @@ In this case, it requires the scope `me` (it could require more than one scope).
     {!> ../../../docs_src/security/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -320,7 +320,7 @@ This `SecurityScopes` class is similar to `Request` (`Request` was used to get t
     {!> ../../../docs_src/security/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8  106"
     {!> ../../../docs_src/security/tutorial005_an.py!}
@@ -344,7 +344,7 @@ This `SecurityScopes` class is similar to `Request` (`Request` was used to get t
     {!> ../../../docs_src/security/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -377,7 +377,7 @@ In this exception, we include the scopes required (if any) as a string separated
     {!> ../../../docs_src/security/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="106  108-116"
     {!> ../../../docs_src/security/tutorial005_an.py!}
@@ -401,7 +401,7 @@ In this exception, we include the scopes required (if any) as a string separated
     {!> ../../../docs_src/security/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -436,7 +436,7 @@ We also verify that we have a user with that username, and if not, we raise that
     {!> ../../../docs_src/security/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="47  117-128"
     {!> ../../../docs_src/security/tutorial005_an.py!}
@@ -460,7 +460,7 @@ We also verify that we have a user with that username, and if not, we raise that
     {!> ../../../docs_src/security/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -487,7 +487,7 @@ For this, we use `security_scopes.scopes`, that contains a `list` with all these
     {!> ../../../docs_src/security/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="129-135"
     {!> ../../../docs_src/security/tutorial005_an.py!}
@@ -511,7 +511,7 @@ For this, we use `security_scopes.scopes`, that contains a `list` with all these
     {!> ../../../docs_src/security/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/advanced/settings.md b/docs/en/docs/advanced/settings.md
index 8f6c7da93..d39130777 100644
--- a/docs/en/docs/advanced/settings.md
+++ b/docs/en/docs/advanced/settings.md
@@ -260,13 +260,13 @@ Now we create a dependency that returns a new `config.Settings()`.
     {!> ../../../docs_src/settings/app02_an_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="6  12-13"
     {!> ../../../docs_src/settings/app02_an/main.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -288,13 +288,13 @@ And then we can require it from the *path operation function* as a dependency an
     {!> ../../../docs_src/settings/app02_an_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17  19-21"
     {!> ../../../docs_src/settings/app02_an/main.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -396,13 +396,13 @@ But as we are using the `@lru_cache()` decorator on top, the `Settings` object w
     {!> ../../../docs_src/settings/app03_an_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  11"
     {!> ../../../docs_src/settings/app03_an/main.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/advanced/testing-dependencies.md b/docs/en/docs/advanced/testing-dependencies.md
index ee48a735d..57dd87f56 100644
--- a/docs/en/docs/advanced/testing-dependencies.md
+++ b/docs/en/docs/advanced/testing-dependencies.md
@@ -40,7 +40,7 @@ And then **FastAPI** will call that override instead of the original dependency.
     {!> ../../../docs_src/dependency_testing/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="29-30  33"
     {!> ../../../docs_src/dependency_testing/tutorial001_an.py!}
@@ -55,7 +55,7 @@ And then **FastAPI** will call that override instead of the original dependency.
     {!> ../../../docs_src/dependency_testing/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/advanced/websockets.md b/docs/en/docs/advanced/websockets.md
index 94cf191d2..49b8fba89 100644
--- a/docs/en/docs/advanced/websockets.md
+++ b/docs/en/docs/advanced/websockets.md
@@ -124,7 +124,7 @@ They work the same way as for other FastAPI endpoints/*path operations*:
     {!> ../../../docs_src/websockets/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="69-70  83"
     {!> ../../../docs_src/websockets/tutorial002_an.py!}
@@ -139,7 +139,7 @@ They work the same way as for other FastAPI endpoints/*path operations*:
     {!> ../../../docs_src/websockets/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -191,7 +191,7 @@ When a WebSocket connection is closed, the `await websocket.receive_text()` will
     {!> ../../../docs_src/websockets/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="81-83"
     {!> ../../../docs_src/websockets/tutorial003.py!}
diff --git a/docs/en/docs/how-to/separate-openapi-schemas.md b/docs/en/docs/how-to/separate-openapi-schemas.md
index d38be3c59..10be1071a 100644
--- a/docs/en/docs/how-to/separate-openapi-schemas.md
+++ b/docs/en/docs/how-to/separate-openapi-schemas.md
@@ -44,7 +44,7 @@ Let's say you have a Pydantic model with default values, like this one:
 
     </details>
 
-=== "Python 3.7+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/separate_openapi_schemas/tutorial001.py[ln:1-9]!}
@@ -99,7 +99,7 @@ If you use this model as an input like here:
 
     </details>
 
-=== "Python 3.7+"
+=== "Python 3.8+"
 
     ```Python hl_lines="16"
     {!> ../../../docs_src/separate_openapi_schemas/tutorial001.py[ln:1-17]!}
@@ -142,7 +142,7 @@ But if you use the same model as an output, like here:
     {!> ../../../docs_src/separate_openapi_schemas/tutorial001_py39.py!}
     ```
 
-=== "Python 3.7+"
+=== "Python 3.8+"
 
     ```Python hl_lines="21"
     {!> ../../../docs_src/separate_openapi_schemas/tutorial001.py!}
@@ -214,7 +214,7 @@ In that case, you can disable this feature in **FastAPI**, with the parameter `s
     {!> ../../../docs_src/separate_openapi_schemas/tutorial002_py39.py!}
     ```
 
-=== "Python 3.7+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12"
     {!> ../../../docs_src/separate_openapi_schemas/tutorial002.py!}
diff --git a/docs/en/docs/index.md b/docs/en/docs/index.md
index ebd74bc8f..cd3f3e000 100644
--- a/docs/en/docs/index.md
+++ b/docs/en/docs/index.md
@@ -27,7 +27,7 @@
 
 ---
 
-FastAPI is a modern, fast (high-performance), web framework for building APIs with Python 3.7+ based on standard Python type hints.
+FastAPI is a modern, fast (high-performance), web framework for building APIs with Python 3.8+ based on standard Python type hints.
 
 The key features are:
 
@@ -115,7 +115,7 @@ If you are building a <abbr title="Command Line Interface">CLI</abbr> app to be
 
 ## Requirements
 
-Python 3.7+
+Python 3.8+
 
 FastAPI stands on the shoulders of giants:
 
@@ -331,7 +331,7 @@ You do that with standard modern Python types.
 
 You don't have to learn a new syntax, the methods or classes of a specific library, etc.
 
-Just standard **Python 3.7+**.
+Just standard **Python 3.8+**.
 
 For example, for an `int`:
 
diff --git a/docs/en/docs/python-types.md b/docs/en/docs/python-types.md
index 693613a36..cdd22ea4a 100644
--- a/docs/en/docs/python-types.md
+++ b/docs/en/docs/python-types.md
@@ -182,7 +182,7 @@ For example, let's define a variable to be a `list` of `str`.
     {!> ../../../docs_src/python_types/tutorial006_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     From `typing`, import `List` (with a capital `L`):
 
@@ -230,7 +230,7 @@ You would do the same to declare `tuple`s and `set`s:
     {!> ../../../docs_src/python_types/tutorial007_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  4"
     {!> ../../../docs_src/python_types/tutorial007.py!}
@@ -255,7 +255,7 @@ The second type parameter is for the values of the `dict`:
     {!> ../../../docs_src/python_types/tutorial008_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  4"
     {!> ../../../docs_src/python_types/tutorial008.py!}
@@ -281,7 +281,7 @@ In Python 3.10 there's also a **new syntax** where you can put the possible type
     {!> ../../../docs_src/python_types/tutorial008b_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  4"
     {!> ../../../docs_src/python_types/tutorial008b.py!}
@@ -311,13 +311,13 @@ This also means that in Python 3.10, you can use `Something | None`:
     {!> ../../../docs_src/python_types/tutorial009_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  4"
     {!> ../../../docs_src/python_types/tutorial009.py!}
     ```
 
-=== "Python 3.6+ alternative"
+=== "Python 3.8+ alternative"
 
     ```Python hl_lines="1  4"
     {!> ../../../docs_src/python_types/tutorial009b.py!}
@@ -375,10 +375,10 @@ These types that take type parameters in square brackets are called **Generic ty
     * `set`
     * `dict`
 
-    And the same as with Python 3.6, from the `typing` module:
+    And the same as with Python 3.8, from the `typing` module:
 
     * `Union`
-    * `Optional` (the same as with Python 3.6)
+    * `Optional` (the same as with Python 3.8)
     * ...and others.
 
     In Python 3.10, as an alternative to using the generics `Union` and `Optional`, you can use the <abbr title='also called "bitwise or operator", but that meaning is not relevant here'>vertical bar (`|`)</abbr> to declare unions of types, that's a lot better and simpler.
@@ -392,13 +392,13 @@ These types that take type parameters in square brackets are called **Generic ty
     * `set`
     * `dict`
 
-    And the same as with Python 3.6, from the `typing` module:
+    And the same as with Python 3.8, from the `typing` module:
 
     * `Union`
     * `Optional`
     * ...and others.
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     * `List`
     * `Tuple`
@@ -458,7 +458,7 @@ An example from the official Pydantic docs:
     {!> ../../../docs_src/python_types/tutorial011_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     {!> ../../../docs_src/python_types/tutorial011.py!}
@@ -486,7 +486,7 @@ Python also has a feature that allows putting **additional metadata** in these t
     {!> ../../../docs_src/python_types/tutorial013_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     In versions below Python 3.9, you import `Annotated` from `typing_extensions`.
 
diff --git a/docs/en/docs/tutorial/background-tasks.md b/docs/en/docs/tutorial/background-tasks.md
index 178297192..bc8e2af6a 100644
--- a/docs/en/docs/tutorial/background-tasks.md
+++ b/docs/en/docs/tutorial/background-tasks.md
@@ -69,7 +69,7 @@ Using `BackgroundTasks` also works with the dependency injection system, you can
     {!> ../../../docs_src/background_tasks/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="14  16  23  26"
     {!> ../../../docs_src/background_tasks/tutorial002_an.py!}
@@ -84,7 +84,7 @@ Using `BackgroundTasks` also works with the dependency injection system, you can
     {!> ../../../docs_src/background_tasks/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/bigger-applications.md b/docs/en/docs/tutorial/bigger-applications.md
index 26d26475f..1cf7e50e0 100644
--- a/docs/en/docs/tutorial/bigger-applications.md
+++ b/docs/en/docs/tutorial/bigger-applications.md
@@ -118,13 +118,13 @@ We will now use a simple dependency to read a custom `X-Token` header:
     {!> ../../../docs_src/bigger_applications/app_an_py39/dependencies.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  5-7"
     {!> ../../../docs_src/bigger_applications/app_an/dependencies.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/body-fields.md b/docs/en/docs/tutorial/body-fields.md
index 8966032ff..55e67fdd6 100644
--- a/docs/en/docs/tutorial/body-fields.md
+++ b/docs/en/docs/tutorial/body-fields.md
@@ -18,7 +18,7 @@ First, you have to import it:
     {!> ../../../docs_src/body_fields/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4"
     {!> ../../../docs_src/body_fields/tutorial001_an.py!}
@@ -33,7 +33,7 @@ First, you have to import it:
     {!> ../../../docs_src/body_fields/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -61,7 +61,7 @@ You can then use `Field` with model attributes:
     {!> ../../../docs_src/body_fields/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12-15"
     {!> ../../../docs_src/body_fields/tutorial001_an.py!}
@@ -76,7 +76,7 @@ You can then use `Field` with model attributes:
     {!> ../../../docs_src/body_fields/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/body-multiple-params.md b/docs/en/docs/tutorial/body-multiple-params.md
index b214092c9..ebef8eeaa 100644
--- a/docs/en/docs/tutorial/body-multiple-params.md
+++ b/docs/en/docs/tutorial/body-multiple-params.md
@@ -20,7 +20,7 @@ And you can also declare body parameters as optional, by setting the default to
     {!> ../../../docs_src/body_multiple_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="19-21"
     {!> ../../../docs_src/body_multiple_params/tutorial001_an.py!}
@@ -35,7 +35,7 @@ And you can also declare body parameters as optional, by setting the default to
     {!> ../../../docs_src/body_multiple_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -68,7 +68,7 @@ But you can also declare multiple body parameters, e.g. `item` and `user`:
     {!> ../../../docs_src/body_multiple_params/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="22"
     {!> ../../../docs_src/body_multiple_params/tutorial002.py!}
@@ -123,7 +123,7 @@ But you can instruct **FastAPI** to treat it as another body key using `Body`:
     {!> ../../../docs_src/body_multiple_params/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24"
     {!> ../../../docs_src/body_multiple_params/tutorial003_an.py!}
@@ -138,7 +138,7 @@ But you can instruct **FastAPI** to treat it as another body key using `Body`:
     {!> ../../../docs_src/body_multiple_params/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -197,7 +197,7 @@ For example:
     {!> ../../../docs_src/body_multiple_params/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="28"
     {!> ../../../docs_src/body_multiple_params/tutorial004_an.py!}
@@ -212,7 +212,7 @@ For example:
     {!> ../../../docs_src/body_multiple_params/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -250,7 +250,7 @@ as in:
     {!> ../../../docs_src/body_multiple_params/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/body_multiple_params/tutorial005_an.py!}
@@ -265,7 +265,7 @@ as in:
     {!> ../../../docs_src/body_multiple_params/tutorial005_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/body-nested-models.md b/docs/en/docs/tutorial/body-nested-models.md
index ffa0c0d0e..3a1052397 100644
--- a/docs/en/docs/tutorial/body-nested-models.md
+++ b/docs/en/docs/tutorial/body-nested-models.md
@@ -12,7 +12,7 @@ You can define an attribute to be a subtype. For example, a Python `list`:
     {!> ../../../docs_src/body_nested_models/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="14"
     {!> ../../../docs_src/body_nested_models/tutorial001.py!}
@@ -73,7 +73,7 @@ So, in our example, we can make `tags` be specifically a "list of strings":
     {!> ../../../docs_src/body_nested_models/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="14"
     {!> ../../../docs_src/body_nested_models/tutorial002.py!}
@@ -99,7 +99,7 @@ Then we can declare `tags` as a set of strings:
     {!> ../../../docs_src/body_nested_models/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  14"
     {!> ../../../docs_src/body_nested_models/tutorial003.py!}
@@ -137,7 +137,7 @@ For example, we can define an `Image` model:
     {!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9-11"
     {!> ../../../docs_src/body_nested_models/tutorial004.py!}
@@ -159,7 +159,7 @@ And then we can use it as the type of an attribute:
     {!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20"
     {!> ../../../docs_src/body_nested_models/tutorial004.py!}
@@ -208,7 +208,7 @@ For example, as in the `Image` model we have a `url` field, we can declare it to
     {!> ../../../docs_src/body_nested_models/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4  10"
     {!> ../../../docs_src/body_nested_models/tutorial005.py!}
@@ -232,7 +232,7 @@ You can also use Pydantic models as subtypes of `list`, `set`, etc:
     {!> ../../../docs_src/body_nested_models/tutorial006_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20"
     {!> ../../../docs_src/body_nested_models/tutorial006.py!}
@@ -283,7 +283,7 @@ You can define arbitrarily deeply nested models:
     {!> ../../../docs_src/body_nested_models/tutorial007_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  14  20  23  27"
     {!> ../../../docs_src/body_nested_models/tutorial007.py!}
@@ -314,7 +314,7 @@ as in:
     {!> ../../../docs_src/body_nested_models/tutorial008_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15"
     {!> ../../../docs_src/body_nested_models/tutorial008.py!}
@@ -354,7 +354,7 @@ In this case, you would accept any `dict` as long as it has `int` keys with `flo
     {!> ../../../docs_src/body_nested_models/tutorial009_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/body_nested_models/tutorial009.py!}
diff --git a/docs/en/docs/tutorial/body-updates.md b/docs/en/docs/tutorial/body-updates.md
index a32948db1..3341f2d5d 100644
--- a/docs/en/docs/tutorial/body-updates.md
+++ b/docs/en/docs/tutorial/body-updates.md
@@ -18,7 +18,7 @@ You can use the `jsonable_encoder` to convert the input data to data that can be
     {!> ../../../docs_src/body_updates/tutorial001_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="30-35"
     {!> ../../../docs_src/body_updates/tutorial001.py!}
@@ -79,7 +79,7 @@ Then you can use this to generate a `dict` with only the data that was set (sent
     {!> ../../../docs_src/body_updates/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="34"
     {!> ../../../docs_src/body_updates/tutorial002.py!}
@@ -103,7 +103,7 @@ Like `stored_item_model.copy(update=update_data)`:
     {!> ../../../docs_src/body_updates/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="35"
     {!> ../../../docs_src/body_updates/tutorial002.py!}
@@ -136,7 +136,7 @@ In summary, to apply partial updates you would:
     {!> ../../../docs_src/body_updates/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="30-37"
     {!> ../../../docs_src/body_updates/tutorial002.py!}
diff --git a/docs/en/docs/tutorial/body.md b/docs/en/docs/tutorial/body.md
index 172b91fdf..67ba48f1e 100644
--- a/docs/en/docs/tutorial/body.md
+++ b/docs/en/docs/tutorial/body.md
@@ -25,7 +25,7 @@ First, you need to import `BaseModel` from `pydantic`:
     {!> ../../../docs_src/body/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4"
     {!> ../../../docs_src/body/tutorial001.py!}
@@ -43,7 +43,7 @@ Use standard Python types for all the attributes:
     {!> ../../../docs_src/body/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="7-11"
     {!> ../../../docs_src/body/tutorial001.py!}
@@ -81,7 +81,7 @@ To add it to your *path operation*, declare it the same way you declared path an
     {!> ../../../docs_src/body/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/body/tutorial001.py!}
@@ -155,7 +155,7 @@ Inside of the function, you can access all the attributes of the model object di
     {!> ../../../docs_src/body/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="21"
     {!> ../../../docs_src/body/tutorial002.py!}
@@ -173,7 +173,7 @@ You can declare path parameters and request body at the same time.
     {!> ../../../docs_src/body/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17-18"
     {!> ../../../docs_src/body/tutorial003.py!}
@@ -191,7 +191,7 @@ You can also declare **body**, **path** and **query** parameters, all at the sam
     {!> ../../../docs_src/body/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/body/tutorial004.py!}
diff --git a/docs/en/docs/tutorial/cookie-params.md b/docs/en/docs/tutorial/cookie-params.md
index 111e93458..3436a7df3 100644
--- a/docs/en/docs/tutorial/cookie-params.md
+++ b/docs/en/docs/tutorial/cookie-params.md
@@ -18,7 +18,7 @@ First import `Cookie`:
     {!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3"
     {!> ../../../docs_src/cookie_params/tutorial001_an.py!}
@@ -33,7 +33,7 @@ First import `Cookie`:
     {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -60,7 +60,7 @@ The first value is the default value, you can pass all the extra validation or a
     {!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/cookie_params/tutorial001_an.py!}
@@ -75,7 +75,7 @@ The first value is the default value, you can pass all the extra validation or a
     {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/dependencies/classes-as-dependencies.md b/docs/en/docs/tutorial/dependencies/classes-as-dependencies.md
index 498d935fe..842f2adf6 100644
--- a/docs/en/docs/tutorial/dependencies/classes-as-dependencies.md
+++ b/docs/en/docs/tutorial/dependencies/classes-as-dependencies.md
@@ -18,7 +18,7 @@ In the previous example, we were returning a `dict` from our dependency ("depend
     {!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12"
     {!> ../../../docs_src/dependencies/tutorial001_an.py!}
@@ -33,7 +33,7 @@ In the previous example, we were returning a `dict` from our dependency ("depend
     {!> ../../../docs_src/dependencies/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -115,7 +115,7 @@ Then, we can change the dependency "dependable" `common_parameters` from above t
     {!> ../../../docs_src/dependencies/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12-16"
     {!> ../../../docs_src/dependencies/tutorial002_an.py!}
@@ -130,7 +130,7 @@ Then, we can change the dependency "dependable" `common_parameters` from above t
     {!> ../../../docs_src/dependencies/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -153,7 +153,7 @@ Pay attention to the `__init__` method used to create the instance of the class:
     {!> ../../../docs_src/dependencies/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="13"
     {!> ../../../docs_src/dependencies/tutorial002_an.py!}
@@ -168,7 +168,7 @@ Pay attention to the `__init__` method used to create the instance of the class:
     {!> ../../../docs_src/dependencies/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -191,7 +191,7 @@ Pay attention to the `__init__` method used to create the instance of the class:
     {!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/dependencies/tutorial001_an.py!}
@@ -206,7 +206,7 @@ Pay attention to the `__init__` method used to create the instance of the class:
     {!> ../../../docs_src/dependencies/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -241,7 +241,7 @@ Now you can declare your dependency using this class.
     {!> ../../../docs_src/dependencies/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20"
     {!> ../../../docs_src/dependencies/tutorial002_an.py!}
@@ -256,7 +256,7 @@ Now you can declare your dependency using this class.
     {!> ../../../docs_src/dependencies/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -271,7 +271,7 @@ Now you can declare your dependency using this class.
 
 Notice how we write `CommonQueryParams` twice in the above code:
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -280,7 +280,7 @@ Notice how we write `CommonQueryParams` twice in the above code:
     commons: CommonQueryParams = Depends(CommonQueryParams)
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]
@@ -300,13 +300,13 @@ From it is that FastAPI will extract the declared parameters and that is what Fa
 
 In this case, the first `CommonQueryParams`, in:
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     commons: Annotated[CommonQueryParams, ...
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -319,13 +319,13 @@ In this case, the first `CommonQueryParams`, in:
 
 You could actually write just:
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     commons: Annotated[Any, Depends(CommonQueryParams)]
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -348,7 +348,7 @@ You could actually write just:
     {!> ../../../docs_src/dependencies/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20"
     {!> ../../../docs_src/dependencies/tutorial003_an.py!}
@@ -363,7 +363,7 @@ You could actually write just:
     {!> ../../../docs_src/dependencies/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -380,7 +380,7 @@ But declaring the type is encouraged as that way your editor will know what will
 
 But you see that we are having some code repetition here, writing `CommonQueryParams` twice:
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -389,7 +389,7 @@ But you see that we are having some code repetition here, writing `CommonQueryPa
     commons: CommonQueryParams = Depends(CommonQueryParams)
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]
@@ -401,13 +401,13 @@ For those specific cases, you can do the following:
 
 Instead of writing:
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)]
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -418,13 +418,13 @@ Instead of writing:
 
 ...you write:
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     commons: Annotated[CommonQueryParams, Depends()]
     ```
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -449,7 +449,7 @@ The same example would then look like:
     {!> ../../../docs_src/dependencies/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20"
     {!> ../../../docs_src/dependencies/tutorial004_an.py!}
@@ -464,7 +464,7 @@ The same example would then look like:
     {!> ../../../docs_src/dependencies/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md b/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
index ccef5aef4..eaab51d1b 100644
--- a/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
+++ b/docs/en/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
@@ -20,13 +20,13 @@ It should be a `list` of `Depends()`:
     {!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/dependencies/tutorial006_an.py!}
     ```
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -63,13 +63,13 @@ They can declare request requirements (like headers) or other sub-dependencies:
     {!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="7  12"
     {!> ../../../docs_src/dependencies/tutorial006_an.py!}
     ```
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -88,13 +88,13 @@ These dependencies can `raise` exceptions, the same as normal dependencies:
     {!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  14"
     {!> ../../../docs_src/dependencies/tutorial006_an.py!}
     ```
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -115,13 +115,13 @@ So, you can re-use a normal dependency (that returns a value) you already use so
     {!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10  15"
     {!> ../../../docs_src/dependencies/tutorial006_an.py!}
     ```
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md b/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
index 8a5422ac8..fe18f1f1d 100644
--- a/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
+++ b/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
@@ -72,13 +72,13 @@ For example, `dependency_c` can have a dependency on `dependency_b`, and `depend
     {!> ../../../docs_src/dependencies/tutorial008_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="5  13  21"
     {!> ../../../docs_src/dependencies/tutorial008_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -99,13 +99,13 @@ And, in turn, `dependency_b` needs the value from `dependency_a` (here named `de
     {!> ../../../docs_src/dependencies/tutorial008_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17-18  25-26"
     {!> ../../../docs_src/dependencies/tutorial008_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/dependencies/global-dependencies.md b/docs/en/docs/tutorial/dependencies/global-dependencies.md
index 0989b31d4..0dcf73176 100644
--- a/docs/en/docs/tutorial/dependencies/global-dependencies.md
+++ b/docs/en/docs/tutorial/dependencies/global-dependencies.md
@@ -12,13 +12,13 @@ In that case, they will be applied to all the *path operations* in the applicati
     {!> ../../../docs_src/dependencies/tutorial012_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="16"
     {!> ../../../docs_src/dependencies/tutorial012_an.py!}
     ```
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/dependencies/index.md b/docs/en/docs/tutorial/dependencies/index.md
index f6f4bced0..bc98cb26e 100644
--- a/docs/en/docs/tutorial/dependencies/index.md
+++ b/docs/en/docs/tutorial/dependencies/index.md
@@ -43,7 +43,7 @@ It is just a function that can take all the same parameters that a *path operati
     {!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9-12"
     {!> ../../../docs_src/dependencies/tutorial001_an.py!}
@@ -58,7 +58,7 @@ It is just a function that can take all the same parameters that a *path operati
     {!> ../../../docs_src/dependencies/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -106,7 +106,7 @@ And then it just returns a `dict` containing those values.
     {!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3"
     {!> ../../../docs_src/dependencies/tutorial001_an.py!}
@@ -121,7 +121,7 @@ And then it just returns a `dict` containing those values.
     {!> ../../../docs_src/dependencies/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -146,7 +146,7 @@ The same way you use `Body`, `Query`, etc. with your *path operation function* p
     {!> ../../../docs_src/dependencies/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="16  21"
     {!> ../../../docs_src/dependencies/tutorial001_an.py!}
@@ -161,7 +161,7 @@ The same way you use `Body`, `Query`, etc. with your *path operation function* p
     {!> ../../../docs_src/dependencies/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -231,7 +231,7 @@ But because we are using `Annotated`, we can store that `Annotated` value in a v
     {!> ../../../docs_src/dependencies/tutorial001_02_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15  19  24"
     {!> ../../../docs_src/dependencies/tutorial001_02_an.py!}
diff --git a/docs/en/docs/tutorial/dependencies/sub-dependencies.md b/docs/en/docs/tutorial/dependencies/sub-dependencies.md
index b50de1a46..1cb469a80 100644
--- a/docs/en/docs/tutorial/dependencies/sub-dependencies.md
+++ b/docs/en/docs/tutorial/dependencies/sub-dependencies.md
@@ -22,7 +22,7 @@ You could create a first dependency ("dependable") like:
     {!> ../../../docs_src/dependencies/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9-10"
     {!> ../../../docs_src/dependencies/tutorial005_an.py!}
@@ -37,7 +37,7 @@ You could create a first dependency ("dependable") like:
     {!> ../../../docs_src/dependencies/tutorial005_py310.py!}
     ```
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -66,7 +66,7 @@ Then you can create another dependency function (a "dependable") that at the sam
     {!> ../../../docs_src/dependencies/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="14"
     {!> ../../../docs_src/dependencies/tutorial005_an.py!}
@@ -81,7 +81,7 @@ Then you can create another dependency function (a "dependable") that at the sam
     {!> ../../../docs_src/dependencies/tutorial005_py310.py!}
     ```
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -113,7 +113,7 @@ Then we can use the dependency with:
     {!> ../../../docs_src/dependencies/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24"
     {!> ../../../docs_src/dependencies/tutorial005_an.py!}
@@ -128,7 +128,7 @@ Then we can use the dependency with:
     {!> ../../../docs_src/dependencies/tutorial005_py310.py!}
     ```
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -161,14 +161,14 @@ And it will save the returned value in a <abbr title="A utility/system to store
 
 In an advanced scenario where you know you need the dependency to be called at every step (possibly multiple times) in the same request instead of using the "cached" value, you can set the parameter `use_cache=False` when using `Depends`:
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1"
     async def needy_dependency(fresh_value: Annotated[str, Depends(get_value, use_cache=False)]):
         return {"fresh_value": fresh_value}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/encoder.md b/docs/en/docs/tutorial/encoder.md
index 735aa2209..845cc25fc 100644
--- a/docs/en/docs/tutorial/encoder.md
+++ b/docs/en/docs/tutorial/encoder.md
@@ -26,7 +26,7 @@ It receives an object, like a Pydantic model, and returns a JSON compatible vers
     {!> ../../../docs_src/encoder/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="5  22"
     {!> ../../../docs_src/encoder/tutorial001.py!}
diff --git a/docs/en/docs/tutorial/extra-data-types.md b/docs/en/docs/tutorial/extra-data-types.md
index b34ccd26f..fd7a99af3 100644
--- a/docs/en/docs/tutorial/extra-data-types.md
+++ b/docs/en/docs/tutorial/extra-data-types.md
@@ -67,7 +67,7 @@ Here's an example *path operation* with parameters using some of the above types
     {!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  3  13-17"
     {!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
@@ -82,7 +82,7 @@ Here's an example *path operation* with parameters using some of the above types
     {!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -105,7 +105,7 @@ Note that the parameters inside the function have their natural data type, and y
     {!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="19-20"
     {!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
@@ -120,7 +120,7 @@ Note that the parameters inside the function have their natural data type, and y
     {!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/extra-models.md b/docs/en/docs/tutorial/extra-models.md
index e91e879e4..590d095bd 100644
--- a/docs/en/docs/tutorial/extra-models.md
+++ b/docs/en/docs/tutorial/extra-models.md
@@ -23,7 +23,7 @@ Here's a general idea of how the models could look like with their password fiel
     {!> ../../../docs_src/extra_models/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  11  16  22  24  29-30  33-35  40-41"
     {!> ../../../docs_src/extra_models/tutorial001.py!}
@@ -164,7 +164,7 @@ That way, we can declare just the differences between the models (with plaintext
     {!> ../../../docs_src/extra_models/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  15-16  19-20  23-24"
     {!> ../../../docs_src/extra_models/tutorial002.py!}
@@ -187,7 +187,7 @@ To do that, use the standard Python type hint <a href="https://docs.python.org/3
     {!> ../../../docs_src/extra_models/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  14-15  18-20  33"
     {!> ../../../docs_src/extra_models/tutorial003.py!}
@@ -219,7 +219,7 @@ For that, use the standard Python `typing.List` (or just `list` in Python 3.9 an
     {!> ../../../docs_src/extra_models/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  20"
     {!> ../../../docs_src/extra_models/tutorial004.py!}
@@ -239,7 +239,7 @@ In this case, you can use `typing.Dict` (or just `dict` in Python 3.9 and above)
     {!> ../../../docs_src/extra_models/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  8"
     {!> ../../../docs_src/extra_models/tutorial005.py!}
diff --git a/docs/en/docs/tutorial/header-params.md b/docs/en/docs/tutorial/header-params.md
index 9e928cdc6..bbba90998 100644
--- a/docs/en/docs/tutorial/header-params.md
+++ b/docs/en/docs/tutorial/header-params.md
@@ -18,7 +18,7 @@ First import `Header`:
     {!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3"
     {!> ../../../docs_src/header_params/tutorial001_an.py!}
@@ -33,7 +33,7 @@ First import `Header`:
     {!> ../../../docs_src/header_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -60,7 +60,7 @@ The first value is the default value, you can pass all the extra validation or a
     {!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/header_params/tutorial001_an.py!}
@@ -75,7 +75,7 @@ The first value is the default value, you can pass all the extra validation or a
     {!> ../../../docs_src/header_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -120,7 +120,7 @@ If for some reason you need to disable automatic conversion of underscores to hy
     {!> ../../../docs_src/header_params/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12"
     {!> ../../../docs_src/header_params/tutorial002_an.py!}
@@ -135,7 +135,7 @@ If for some reason you need to disable automatic conversion of underscores to hy
     {!> ../../../docs_src/header_params/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -169,7 +169,7 @@ For example, to declare a header of `X-Token` that can appear more than once, yo
     {!> ../../../docs_src/header_params/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/header_params/tutorial003_an.py!}
@@ -193,7 +193,7 @@ For example, to declare a header of `X-Token` that can appear more than once, yo
     {!> ../../../docs_src/header_params/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/path-operation-configuration.md b/docs/en/docs/tutorial/path-operation-configuration.md
index 7d4d4bcca..babf85acb 100644
--- a/docs/en/docs/tutorial/path-operation-configuration.md
+++ b/docs/en/docs/tutorial/path-operation-configuration.md
@@ -25,7 +25,7 @@ But if you don't remember what each number code is for, you can use the shortcut
     {!> ../../../docs_src/path_operation_configuration/tutorial001_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3  17"
     {!> ../../../docs_src/path_operation_configuration/tutorial001.py!}
@@ -54,7 +54,7 @@ You can add tags to your *path operation*, pass the parameter `tags` with a `lis
     {!> ../../../docs_src/path_operation_configuration/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17  22  27"
     {!> ../../../docs_src/path_operation_configuration/tutorial002.py!}
@@ -92,7 +92,7 @@ You can add a `summary` and `description`:
     {!> ../../../docs_src/path_operation_configuration/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20-21"
     {!> ../../../docs_src/path_operation_configuration/tutorial003.py!}
@@ -116,7 +116,7 @@ You can write <a href="https://en.wikipedia.org/wiki/Markdown" class="external-l
     {!> ../../../docs_src/path_operation_configuration/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="19-27"
     {!> ../../../docs_src/path_operation_configuration/tutorial004.py!}
@@ -142,7 +142,7 @@ You can specify the response description with the parameter `response_descriptio
     {!> ../../../docs_src/path_operation_configuration/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="21"
     {!> ../../../docs_src/path_operation_configuration/tutorial005.py!}
diff --git a/docs/en/docs/tutorial/path-params-numeric-validations.md b/docs/en/docs/tutorial/path-params-numeric-validations.md
index 9255875d6..57ad20b13 100644
--- a/docs/en/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/en/docs/tutorial/path-params-numeric-validations.md
@@ -18,7 +18,7 @@ First, import `Path` from `fastapi`, and import `Annotated`:
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3-4"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
@@ -33,7 +33,7 @@ First, import `Path` from `fastapi`, and import `Annotated`:
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -67,7 +67,7 @@ For example, to declare a `title` metadata value for the path parameter `item_id
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
@@ -82,7 +82,7 @@ For example, to declare a `title` metadata value for the path parameter `item_id
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -117,7 +117,7 @@ It doesn't matter for **FastAPI**. It will detect the parameters by their names,
 
 So, you can declare your function as:
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -134,7 +134,7 @@ But have in mind that if you use `Annotated`, you won't have this problem, it wo
     {!> ../../../docs_src/path_params_numeric_validations/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial002_an.py!}
@@ -174,7 +174,7 @@ Have in mind that if you use `Annotated`, as you are not using function paramete
     {!> ../../../docs_src/path_params_numeric_validations/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial003_an.py!}
@@ -192,13 +192,13 @@ Here, with `ge=1`, `item_id` will need to be an integer number "`g`reater than o
     {!> ../../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial004_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -220,13 +220,13 @@ The same applies for:
     {!> ../../../docs_src/path_params_numeric_validations/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial005_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -251,13 +251,13 @@ And the same for <abbr title="less than"><code>lt</code></abbr>.
     {!> ../../../docs_src/path_params_numeric_validations/tutorial006_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial006_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/query-params-str-validations.md b/docs/en/docs/tutorial/query-params-str-validations.md
index 5d1c08add..0b2cf02a8 100644
--- a/docs/en/docs/tutorial/query-params-str-validations.md
+++ b/docs/en/docs/tutorial/query-params-str-validations.md
@@ -10,7 +10,7 @@ Let's take this application as example:
     {!> ../../../docs_src/query_params_str_validations/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params_str_validations/tutorial001.py!}
@@ -42,7 +42,7 @@ To achieve that, first import:
     {!> ../../../docs_src/query_params_str_validations/tutorial002_an_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     In versions of Python below Python 3.9 you import `Annotated` from `typing_extensions`.
 
@@ -73,7 +73,7 @@ We had this type annotation:
     q: str | None = None
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     q: Union[str, None] = None
@@ -87,7 +87,7 @@ What we will do is wrap that with `Annotated`, so it becomes:
     q: Annotated[str | None] = None
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     q: Annotated[Union[str, None]] = None
@@ -107,7 +107,7 @@ Now that we have this `Annotated` where we can put more metadata, add `Query` to
     {!> ../../../docs_src/query_params_str_validations/tutorial002_an_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params_str_validations/tutorial002_an.py!}
@@ -138,7 +138,7 @@ This is how you would use `Query()` as the default value of your function parame
     {!> ../../../docs_src/query_params_str_validations/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params_str_validations/tutorial002.py!}
@@ -251,7 +251,7 @@ You can also add a parameter `min_length`:
     {!> ../../../docs_src/query_params_str_validations/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/query_params_str_validations/tutorial003_an.py!}
@@ -266,7 +266,7 @@ You can also add a parameter `min_length`:
     {!> ../../../docs_src/query_params_str_validations/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -291,7 +291,7 @@ You can define a <abbr title="A regular expression, regex or regexp is a sequenc
     {!> ../../../docs_src/query_params_str_validations/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12"
     {!> ../../../docs_src/query_params_str_validations/tutorial004_an.py!}
@@ -306,7 +306,7 @@ You can define a <abbr title="A regular expression, regex or regexp is a sequenc
     {!> ../../../docs_src/query_params_str_validations/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -351,13 +351,13 @@ Let's say that you want to declare the `q` query parameter to have a `min_length
     {!> ../../../docs_src/query_params_str_validations/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/query_params_str_validations/tutorial005_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -405,13 +405,13 @@ So, when you need to declare a value as required while using `Query`, you can si
     {!> ../../../docs_src/query_params_str_validations/tutorial006_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/query_params_str_validations/tutorial006_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -435,13 +435,13 @@ There's an alternative way to explicitly declare that a value is required. You c
     {!> ../../../docs_src/query_params_str_validations/tutorial006b_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/query_params_str_validations/tutorial006b_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -475,7 +475,7 @@ To do that, you can declare that `None` is a valid type but still use `...` as t
     {!> ../../../docs_src/query_params_str_validations/tutorial006c_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params_str_validations/tutorial006c_an.py!}
@@ -490,7 +490,7 @@ To do that, you can declare that `None` is a valid type but still use `...` as t
     {!> ../../../docs_src/query_params_str_validations/tutorial006c_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -512,13 +512,13 @@ If you feel uncomfortable using `...`, you can also import and use `Required` fr
     {!> ../../../docs_src/query_params_str_validations/tutorial006d_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="2  9"
     {!> ../../../docs_src/query_params_str_validations/tutorial006d_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -548,7 +548,7 @@ For example, to declare a query parameter `q` that can appear multiple times in
     {!> ../../../docs_src/query_params_str_validations/tutorial011_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params_str_validations/tutorial011_an.py!}
@@ -572,7 +572,7 @@ For example, to declare a query parameter `q` that can appear multiple times in
     {!> ../../../docs_src/query_params_str_validations/tutorial011_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -617,7 +617,7 @@ And you can also define a default `list` of values if none are provided:
     {!> ../../../docs_src/query_params_str_validations/tutorial012_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params_str_validations/tutorial012_an.py!}
@@ -632,7 +632,7 @@ And you can also define a default `list` of values if none are provided:
     {!> ../../../docs_src/query_params_str_validations/tutorial012_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -668,13 +668,13 @@ You can also use `list` directly instead of `List[str]` (or `list[str]` in Pytho
     {!> ../../../docs_src/query_params_str_validations/tutorial013_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/query_params_str_validations/tutorial013_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -713,7 +713,7 @@ You can add a `title`:
     {!> ../../../docs_src/query_params_str_validations/tutorial007_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/query_params_str_validations/tutorial007_an.py!}
@@ -728,7 +728,7 @@ You can add a `title`:
     {!> ../../../docs_src/query_params_str_validations/tutorial007_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -751,7 +751,7 @@ And a `description`:
     {!> ../../../docs_src/query_params_str_validations/tutorial008_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15"
     {!> ../../../docs_src/query_params_str_validations/tutorial008_an.py!}
@@ -766,7 +766,7 @@ And a `description`:
     {!> ../../../docs_src/query_params_str_validations/tutorial008_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -805,7 +805,7 @@ Then you can declare an `alias`, and that alias is what will be used to find the
     {!> ../../../docs_src/query_params_str_validations/tutorial009_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params_str_validations/tutorial009_an.py!}
@@ -820,7 +820,7 @@ Then you can declare an `alias`, and that alias is what will be used to find the
     {!> ../../../docs_src/query_params_str_validations/tutorial009_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -849,7 +849,7 @@ Then pass the parameter `deprecated=True` to `Query`:
     {!> ../../../docs_src/query_params_str_validations/tutorial010_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20"
     {!> ../../../docs_src/query_params_str_validations/tutorial010_an.py!}
@@ -864,7 +864,7 @@ Then pass the parameter `deprecated=True` to `Query`:
     {!> ../../../docs_src/query_params_str_validations/tutorial010_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -893,7 +893,7 @@ To exclude a query parameter from the generated OpenAPI schema (and thus, from t
     {!> ../../../docs_src/query_params_str_validations/tutorial014_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/query_params_str_validations/tutorial014_an.py!}
@@ -908,7 +908,7 @@ To exclude a query parameter from the generated OpenAPI schema (and thus, from t
     {!> ../../../docs_src/query_params_str_validations/tutorial014_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/query-params.md b/docs/en/docs/tutorial/query-params.md
index 0b74b10f8..988ff4bf1 100644
--- a/docs/en/docs/tutorial/query-params.md
+++ b/docs/en/docs/tutorial/query-params.md
@@ -69,7 +69,7 @@ The same way, you can declare optional query parameters, by setting their defaul
     {!> ../../../docs_src/query_params/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params/tutorial002.py!}
@@ -90,7 +90,7 @@ You can also declare `bool` types, and they will be converted:
     {!> ../../../docs_src/query_params/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params/tutorial003.py!}
@@ -143,7 +143,7 @@ They will be detected by name:
     {!> ../../../docs_src/query_params/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8  10"
     {!> ../../../docs_src/query_params/tutorial004.py!}
@@ -209,7 +209,7 @@ And of course, you can define some parameters as required, some as having a defa
     {!> ../../../docs_src/query_params/tutorial006_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params/tutorial006.py!}
diff --git a/docs/en/docs/tutorial/request-files.md b/docs/en/docs/tutorial/request-files.md
index 1fe1e7a33..c85a68ed6 100644
--- a/docs/en/docs/tutorial/request-files.md
+++ b/docs/en/docs/tutorial/request-files.md
@@ -19,13 +19,13 @@ Import `File` and `UploadFile` from `fastapi`:
     {!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1"
     {!> ../../../docs_src/request_files/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -44,13 +44,13 @@ Create file parameters the same way you would for `Body` or `Form`:
     {!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/request_files/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -85,13 +85,13 @@ Define a file parameter with a type of `UploadFile`:
     {!> ../../../docs_src/request_files/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="13"
     {!> ../../../docs_src/request_files/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -181,7 +181,7 @@ You can make a file optional by using standard type annotations and setting a de
     {!> ../../../docs_src/request_files/tutorial001_02_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10  18"
     {!> ../../../docs_src/request_files/tutorial001_02_an.py!}
@@ -196,7 +196,7 @@ You can make a file optional by using standard type annotations and setting a de
     {!> ../../../docs_src/request_files/tutorial001_02_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -215,13 +215,13 @@ You can also use `File()` with `UploadFile`, for example, to set additional meta
     {!> ../../../docs_src/request_files/tutorial001_03_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8  14"
     {!> ../../../docs_src/request_files/tutorial001_03_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -244,7 +244,7 @@ To use that, declare a list of `bytes` or `UploadFile`:
     {!> ../../../docs_src/request_files/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11  16"
     {!> ../../../docs_src/request_files/tutorial002_an.py!}
@@ -259,7 +259,7 @@ To use that, declare a list of `bytes` or `UploadFile`:
     {!> ../../../docs_src/request_files/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -285,7 +285,7 @@ And the same way as before, you can use `File()` to set additional parameters, e
     {!> ../../../docs_src/request_files/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12  19-21"
     {!> ../../../docs_src/request_files/tutorial003_an.py!}
@@ -300,7 +300,7 @@ And the same way as before, you can use `File()` to set additional parameters, e
     {!> ../../../docs_src/request_files/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/request-forms-and-files.md b/docs/en/docs/tutorial/request-forms-and-files.md
index 1818946c4..a58291dc8 100644
--- a/docs/en/docs/tutorial/request-forms-and-files.md
+++ b/docs/en/docs/tutorial/request-forms-and-files.md
@@ -15,13 +15,13 @@ You can define files and form fields at the same time using `File` and `Form`.
     {!> ../../../docs_src/request_forms_and_files/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1"
     {!> ../../../docs_src/request_forms_and_files/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -40,13 +40,13 @@ Create file and form parameters the same way you would for `Body` or `Query`:
     {!> ../../../docs_src/request_forms_and_files/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9-11"
     {!> ../../../docs_src/request_forms_and_files/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/request-forms.md b/docs/en/docs/tutorial/request-forms.md
index 5d441a614..0e8ac5f4f 100644
--- a/docs/en/docs/tutorial/request-forms.md
+++ b/docs/en/docs/tutorial/request-forms.md
@@ -17,13 +17,13 @@ Import `Form` from `fastapi`:
     {!> ../../../docs_src/request_forms/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1"
     {!> ../../../docs_src/request_forms/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -42,13 +42,13 @@ Create form parameters the same way you would for `Body` or `Query`:
     {!> ../../../docs_src/request_forms/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/request_forms/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/response-model.md b/docs/en/docs/tutorial/response-model.md
index 2181cfb5a..d6d3d61cb 100644
--- a/docs/en/docs/tutorial/response-model.md
+++ b/docs/en/docs/tutorial/response-model.md
@@ -16,7 +16,7 @@ You can use **type annotations** the same way you would for input data in functi
     {!> ../../../docs_src/response_model/tutorial001_01_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18  23"
     {!> ../../../docs_src/response_model/tutorial001_01.py!}
@@ -65,7 +65,7 @@ You can use the `response_model` parameter in any of the *path operations*:
     {!> ../../../docs_src/response_model/tutorial001_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17  22  24-27"
     {!> ../../../docs_src/response_model/tutorial001.py!}
@@ -101,7 +101,7 @@ Here we are declaring a `UserIn` model, it will contain a plaintext password:
     {!> ../../../docs_src/response_model/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  11"
     {!> ../../../docs_src/response_model/tutorial002.py!}
@@ -121,7 +121,7 @@ And we are using this model to declare our input and the same model to declare o
     {!> ../../../docs_src/response_model/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/response_model/tutorial002.py!}
@@ -146,7 +146,7 @@ We can instead create an input model with the plaintext password and an output m
     {!> ../../../docs_src/response_model/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  11  16"
     {!> ../../../docs_src/response_model/tutorial003.py!}
@@ -160,7 +160,7 @@ Here, even though our *path operation function* is returning the same input user
     {!> ../../../docs_src/response_model/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24"
     {!> ../../../docs_src/response_model/tutorial003.py!}
@@ -174,7 +174,7 @@ Here, even though our *path operation function* is returning the same input user
     {!> ../../../docs_src/response_model/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="22"
     {!> ../../../docs_src/response_model/tutorial003.py!}
@@ -208,7 +208,7 @@ And in those cases, we can use classes and inheritance to take advantage of func
     {!> ../../../docs_src/response_model/tutorial003_01_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9-13  15-16  20"
     {!> ../../../docs_src/response_model/tutorial003_01.py!}
@@ -284,7 +284,7 @@ The same would happen if you had something like a <abbr title='A union between m
     {!> ../../../docs_src/response_model/tutorial003_04_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/response_model/tutorial003_04.py!}
@@ -306,7 +306,7 @@ In this case, you can disable the response model generation by setting `response
     {!> ../../../docs_src/response_model/tutorial003_05_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/response_model/tutorial003_05.py!}
@@ -330,7 +330,7 @@ Your response model could have default values, like:
     {!> ../../../docs_src/response_model/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11  13-14"
     {!> ../../../docs_src/response_model/tutorial004.py!}
@@ -360,7 +360,7 @@ You can set the *path operation decorator* parameter `response_model_exclude_uns
     {!> ../../../docs_src/response_model/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24"
     {!> ../../../docs_src/response_model/tutorial004.py!}
@@ -447,7 +447,7 @@ This can be used as a quick shortcut if you have only one Pydantic model and wan
     {!> ../../../docs_src/response_model/tutorial005_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="31  37"
     {!> ../../../docs_src/response_model/tutorial005.py!}
@@ -468,7 +468,7 @@ If you forget to use a `set` and use a `list` or `tuple` instead, FastAPI will s
     {!> ../../../docs_src/response_model/tutorial006_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="31  37"
     {!> ../../../docs_src/response_model/tutorial006.py!}
diff --git a/docs/en/docs/tutorial/schema-extra-example.md b/docs/en/docs/tutorial/schema-extra-example.md
index 9eeb3f1f2..9bb9ba4e3 100644
--- a/docs/en/docs/tutorial/schema-extra-example.md
+++ b/docs/en/docs/tutorial/schema-extra-example.md
@@ -20,13 +20,13 @@ You can declare `examples` for a Pydantic model that will be added to the genera
     {!> ../../../docs_src/schema_extra_example/tutorial001_py310_pv1.py!}
     ```
 
-=== "Python 3.6+ Pydantic v2"
+=== "Python 3.8+ Pydantic v2"
 
     ```Python hl_lines="15-26"
     {!> ../../../docs_src/schema_extra_example/tutorial001.py!}
     ```
 
-=== "Python 3.6+ Pydantic v1"
+=== "Python 3.8+ Pydantic v1"
 
     ```Python hl_lines="15-25"
     {!> ../../../docs_src/schema_extra_example/tutorial001_pv1.py!}
@@ -68,7 +68,7 @@ When using `Field()` with Pydantic models, you can also declare additional `exam
     {!> ../../../docs_src/schema_extra_example/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4  10-13"
     {!> ../../../docs_src/schema_extra_example/tutorial002.py!}
@@ -104,7 +104,7 @@ Here we pass `examples` containing one example of the data expected in `Body()`:
     {!> ../../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="23-30"
     {!> ../../../docs_src/schema_extra_example/tutorial003_an.py!}
@@ -119,7 +119,7 @@ Here we pass `examples` containing one example of the data expected in `Body()`:
     {!> ../../../docs_src/schema_extra_example/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -150,7 +150,7 @@ You can of course also pass multiple `examples`:
     {!> ../../../docs_src/schema_extra_example/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24-39"
     {!> ../../../docs_src/schema_extra_example/tutorial004_an.py!}
@@ -165,7 +165,7 @@ You can of course also pass multiple `examples`:
     {!> ../../../docs_src/schema_extra_example/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -225,7 +225,7 @@ You can use it like this:
     {!> ../../../docs_src/schema_extra_example/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24-50"
     {!> ../../../docs_src/schema_extra_example/tutorial005_an.py!}
@@ -240,7 +240,7 @@ You can use it like this:
     {!> ../../../docs_src/schema_extra_example/tutorial005_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/security/first-steps.md b/docs/en/docs/tutorial/security/first-steps.md
index 5765cf2d6..2f39f1ec2 100644
--- a/docs/en/docs/tutorial/security/first-steps.md
+++ b/docs/en/docs/tutorial/security/first-steps.md
@@ -26,13 +26,13 @@ Copy the example in a file `main.py`:
     {!> ../../../docs_src/security/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     {!> ../../../docs_src/security/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -140,13 +140,13 @@ When we create an instance of the `OAuth2PasswordBearer` class we pass in the `t
     {!> ../../../docs_src/security/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python  hl_lines="7"
     {!> ../../../docs_src/security/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -191,13 +191,13 @@ Now you can pass that `oauth2_scheme` in a dependency with `Depends`.
     {!> ../../../docs_src/security/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python  hl_lines="11"
     {!> ../../../docs_src/security/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/security/get-current-user.md b/docs/en/docs/tutorial/security/get-current-user.md
index 1a8c5d9a8..e99a800c6 100644
--- a/docs/en/docs/tutorial/security/get-current-user.md
+++ b/docs/en/docs/tutorial/security/get-current-user.md
@@ -8,13 +8,13 @@ In the previous chapter the security system (which is based on the dependency in
     {!> ../../../docs_src/security/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/security/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -45,7 +45,7 @@ The same way we use Pydantic to declare bodies, we can use it anywhere else:
     {!> ../../../docs_src/security/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="5  13-17"
     {!> ../../../docs_src/security/tutorial002_an.py!}
@@ -60,7 +60,7 @@ The same way we use Pydantic to declare bodies, we can use it anywhere else:
     {!> ../../../docs_src/security/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -91,7 +91,7 @@ The same as we were doing before in the *path operation* directly, our new depen
     {!> ../../../docs_src/security/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="26"
     {!> ../../../docs_src/security/tutorial002_an.py!}
@@ -106,7 +106,7 @@ The same as we were doing before in the *path operation* directly, our new depen
     {!> ../../../docs_src/security/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -131,7 +131,7 @@ The same as we were doing before in the *path operation* directly, our new depen
     {!> ../../../docs_src/security/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20-23  27-28"
     {!> ../../../docs_src/security/tutorial002_an.py!}
@@ -146,7 +146,7 @@ The same as we were doing before in the *path operation* directly, our new depen
     {!> ../../../docs_src/security/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -171,7 +171,7 @@ So now we can use the same `Depends` with our `get_current_user` in the *path op
     {!> ../../../docs_src/security/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="32"
     {!> ../../../docs_src/security/tutorial002_an.py!}
@@ -186,7 +186,7 @@ So now we can use the same `Depends` with our `get_current_user` in the *path op
     {!> ../../../docs_src/security/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -253,7 +253,7 @@ And all these thousands of *path operations* can be as small as 3 lines:
     {!> ../../../docs_src/security/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="31-33"
     {!> ../../../docs_src/security/tutorial002_an.py!}
@@ -268,7 +268,7 @@ And all these thousands of *path operations* can be as small as 3 lines:
     {!> ../../../docs_src/security/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/security/oauth2-jwt.md b/docs/en/docs/tutorial/security/oauth2-jwt.md
index deb722b96..0a347fed3 100644
--- a/docs/en/docs/tutorial/security/oauth2-jwt.md
+++ b/docs/en/docs/tutorial/security/oauth2-jwt.md
@@ -121,7 +121,7 @@ And another one to authenticate and return a user.
     {!> ../../../docs_src/security/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="7  49  56-57  60-61  70-76"
     {!> ../../../docs_src/security/tutorial004_an.py!}
@@ -136,7 +136,7 @@ And another one to authenticate and return a user.
     {!> ../../../docs_src/security/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -188,7 +188,7 @@ Create a utility function to generate a new access token.
     {!> ../../../docs_src/security/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="6  13-15  29-31 79-87"
     {!> ../../../docs_src/security/tutorial004_an.py!}
@@ -203,7 +203,7 @@ Create a utility function to generate a new access token.
     {!> ../../../docs_src/security/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -232,7 +232,7 @@ If the token is invalid, return an HTTP error right away.
     {!> ../../../docs_src/security/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="90-107"
     {!> ../../../docs_src/security/tutorial004_an.py!}
@@ -247,7 +247,7 @@ If the token is invalid, return an HTTP error right away.
     {!> ../../../docs_src/security/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -274,7 +274,7 @@ Create a real JWT access token and return it
     {!> ../../../docs_src/security/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="118-133"
     {!> ../../../docs_src/security/tutorial004_an.py!}
@@ -289,7 +289,7 @@ Create a real JWT access token and return it
     {!> ../../../docs_src/security/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/security/simple-oauth2.md b/docs/en/docs/tutorial/security/simple-oauth2.md
index abcf6b667..88edc9eab 100644
--- a/docs/en/docs/tutorial/security/simple-oauth2.md
+++ b/docs/en/docs/tutorial/security/simple-oauth2.md
@@ -61,7 +61,7 @@ First, import `OAuth2PasswordRequestForm`, and use it as a dependency with `Depe
     {!> ../../../docs_src/security/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4  79"
     {!> ../../../docs_src/security/tutorial003_an.py!}
@@ -76,7 +76,7 @@ First, import `OAuth2PasswordRequestForm`, and use it as a dependency with `Depe
     {!> ../../../docs_src/security/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -134,7 +134,7 @@ For the error, we use the exception `HTTPException`:
     {!> ../../../docs_src/security/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3  80-82"
     {!> ../../../docs_src/security/tutorial003_an.py!}
@@ -149,7 +149,7 @@ For the error, we use the exception `HTTPException`:
     {!> ../../../docs_src/security/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -194,7 +194,7 @@ So, the thief won't be able to try to use those same passwords in another system
     {!> ../../../docs_src/security/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="83-86"
     {!> ../../../docs_src/security/tutorial003_an.py!}
@@ -209,7 +209,7 @@ So, the thief won't be able to try to use those same passwords in another system
     {!> ../../../docs_src/security/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -264,7 +264,7 @@ For this simple example, we are going to just be completely insecure and return
     {!> ../../../docs_src/security/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="88"
     {!> ../../../docs_src/security/tutorial003_an.py!}
@@ -279,7 +279,7 @@ For this simple example, we are going to just be completely insecure and return
     {!> ../../../docs_src/security/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
@@ -321,7 +321,7 @@ So, in our endpoint, we will only get a user if the user exists, was correctly a
     {!> ../../../docs_src/security/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="59-67  70-75  95"
     {!> ../../../docs_src/security/tutorial003_an.py!}
@@ -336,7 +336,7 @@ So, in our endpoint, we will only get a user if the user exists, was correctly a
     {!> ../../../docs_src/security/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/en/docs/tutorial/sql-databases.md b/docs/en/docs/tutorial/sql-databases.md
index 6e0e5dc06..010244bbf 100644
--- a/docs/en/docs/tutorial/sql-databases.md
+++ b/docs/en/docs/tutorial/sql-databases.md
@@ -281,7 +281,7 @@ But for security, the `password` won't be in other Pydantic *models*, for exampl
     {!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3  6-8  11-12  23-24  27-28"
     {!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
@@ -325,7 +325,7 @@ Not only the IDs of those items, but all the data that we defined in the Pydanti
     {!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15-17  31-34"
     {!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
@@ -354,7 +354,7 @@ In the `Config` class, set the attribute `orm_mode = True`.
     {!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15  19-20  31  36-37"
     {!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
@@ -494,7 +494,7 @@ In a very simplistic way create the database tables:
     {!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/sql_databases/sql_app/main.py!}
@@ -528,7 +528,7 @@ Our dependency will create a new SQLAlchemy `SessionLocal` that will be used in
     {!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15-20"
     {!> ../../../docs_src/sql_databases/sql_app/main.py!}
@@ -553,7 +553,7 @@ This will then give us better editor support inside the *path operation function
     {!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24  32  38  47  53"
     {!> ../../../docs_src/sql_databases/sql_app/main.py!}
@@ -574,7 +574,7 @@ Now, finally, here's the standard **FastAPI** *path operations* code.
     {!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="23-28  31-34  37-42  45-49  52-55"
     {!> ../../../docs_src/sql_databases/sql_app/main.py!}
@@ -673,7 +673,7 @@ For example, in a background task worker with <a href="https://docs.celeryq.dev"
     {!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     {!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
@@ -693,7 +693,7 @@ For example, in a background task worker with <a href="https://docs.celeryq.dev"
     {!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     {!> ../../../docs_src/sql_databases/sql_app/main.py!}
@@ -752,7 +752,7 @@ The middleware we'll add (just a function) will create a new SQLAlchemy `Session
     {!> ../../../docs_src/sql_databases/sql_app_py39/alt_main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="14-22"
     {!> ../../../docs_src/sql_databases/sql_app/alt_main.py!}
diff --git a/docs/en/docs/tutorial/testing.md b/docs/en/docs/tutorial/testing.md
index ec133a4d0..3f8dd69a1 100644
--- a/docs/en/docs/tutorial/testing.md
+++ b/docs/en/docs/tutorial/testing.md
@@ -122,7 +122,7 @@ Both *path operations* require an `X-Token` header.
     {!> ../../../docs_src/app_testing/app_b_an_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     {!> ../../../docs_src/app_testing/app_b_an/main.py!}
@@ -137,7 +137,7 @@ Both *path operations* require an `X-Token` header.
     {!> ../../../docs_src/app_testing/app_b_py310/main.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/es/docs/features.md b/docs/es/docs/features.md
index 5d6b6509a..d05c4f73e 100644
--- a/docs/es/docs/features.md
+++ b/docs/es/docs/features.md
@@ -25,7 +25,7 @@ Documentación interactiva de la API e interfaces web de exploración. Hay múlt
 
 ### Simplemente Python moderno
 
-Todo está basado en las declaraciones de tipo de **Python 3.6** estándar (gracias a Pydantic). No necesitas aprender una sintáxis nueva, solo Python moderno.
+Todo está basado en las declaraciones de tipo de **Python 3.8** estándar (gracias a Pydantic). No necesitas aprender una sintáxis nueva, solo Python moderno.
 
 Si necesitas un repaso de 2 minutos de cómo usar los tipos de Python (así no uses FastAPI) prueba el tutorial corto: [Python Types](python-types.md){.internal-link target=_blank}.
 
diff --git a/docs/es/docs/index.md b/docs/es/docs/index.md
index 5b75880c0..30a575577 100644
--- a/docs/es/docs/index.md
+++ b/docs/es/docs/index.md
@@ -23,7 +23,7 @@
 **Código Fuente**: <a href="https://github.com/tiangolo/fastapi" target="_blank">https://github.com/tiangolo/fastapi</a>
 
 ---
-FastAPI es un web framework moderno y rápido (de alto rendimiento) para construir APIs con Python 3.6+ basado en las anotaciones de tipos estándar de Python.
+FastAPI es un web framework moderno y rápido (de alto rendimiento) para construir APIs con Python 3.8+ basado en las anotaciones de tipos estándar de Python.
 
 Sus características principales son:
 
@@ -106,7 +106,7 @@ Si estás construyendo un app de <abbr title="Interfaz de línea de comandos en
 
 ## Requisitos
 
-Python 3.7+
+Python 3.8+
 
 FastAPI está sobre los hombros de gigantes:
 
@@ -319,7 +319,7 @@ Lo haces con tipos modernos estándar de Python.
 
 No tienes que aprender una sintáxis nueva, los métodos o clases de una library específica, etc.
 
-Solo **Python 3.6+** estándar.
+Solo **Python 3.8+** estándar.
 
 Por ejemplo, para un `int`:
 
diff --git a/docs/fr/docs/features.md b/docs/fr/docs/features.md
index f5faa46b6..0c1f6269a 100644
--- a/docs/fr/docs/features.md
+++ b/docs/fr/docs/features.md
@@ -25,7 +25,7 @@ Documentation d'API interactive et interface web d'exploration. Comme le framewo
 
 ### Faite en python moderne
 
-Tout est basé sur la déclaration de type standard de **Python 3.6** (grâce à Pydantic). Pas de nouvelles syntaxes à apprendre. Juste du Python standard et moderne.
+Tout est basé sur la déclaration de type standard de **Python 3.8** (grâce à Pydantic). Pas de nouvelles syntaxes à apprendre. Juste du Python standard et moderne.
 
 Si vous souhaitez un rappel de 2 minutes sur l'utilisation des types en Python (même si vous ne comptez pas utiliser FastAPI), jetez un oeil au tutoriel suivant: [Python Types](python-types.md){.internal-link target=_blank}.
 
diff --git a/docs/fr/docs/index.md b/docs/fr/docs/index.md
index 4ac9864ec..f732fc74c 100644
--- a/docs/fr/docs/index.md
+++ b/docs/fr/docs/index.md
@@ -27,7 +27,7 @@
 
 ---
 
-FastAPI est un framework web moderne et rapide (haute performance) pour la création d'API avec Python 3.7+, basé sur les annotations de type standard de Python.
+FastAPI est un framework web moderne et rapide (haute performance) pour la création d'API avec Python 3.8+, basé sur les annotations de type standard de Python.
 
 Les principales fonctionnalités sont :
 
@@ -115,7 +115,7 @@ Si vous souhaitez construire une application <abbr title="Command Line Interface
 
 ## Prérequis
 
-Python 3.7+
+Python 3.8+
 
 FastAPI repose sur les épaules de géants :
 
@@ -331,7 +331,7 @@ Vous faites cela avec les types Python standard modernes.
 
 Vous n'avez pas à apprendre une nouvelle syntaxe, les méthodes ou les classes d'une bibliothèque spécifique, etc.
 
-Juste du **Python 3.7+** standard.
+Juste du **Python 3.8+** standard.
 
 Par exemple, pour un `int`:
 
diff --git a/docs/ja/docs/features.md b/docs/ja/docs/features.md
index a40b48cf0..853364f11 100644
--- a/docs/ja/docs/features.md
+++ b/docs/ja/docs/features.md
@@ -24,7 +24,7 @@
 
 ### 現代的なPython
 
-FastAPIの機能はすべて、標準のPython 3.6型宣言に基づいています（Pydanticの功績）。新しい構文はありません。ただの現代的な標準のPythonです。
+FastAPIの機能はすべて、標準のPython 3.8型宣言に基づいています（Pydanticの功績）。新しい構文はありません。ただの現代的な標準のPythonです。
 
 （FastAPIを使用しない場合でも）Pythonの型の使用方法について簡単な復習が必要な場合は、短いチュートリアル（[Python Types](python-types.md){.internal-link target=_blank}）を参照してください。
 
diff --git a/docs/ja/docs/index.md b/docs/ja/docs/index.md
index a9c381a23..f340fdb87 100644
--- a/docs/ja/docs/index.md
+++ b/docs/ja/docs/index.md
@@ -107,7 +107,7 @@ FastAPI は、Pythonの標準である型ヒントに基づいてPython 3.6 以
 
 ## 必要条件
 
-Python 3.7+
+Python 3.8+
 
 FastAPI は巨人の肩の上に立っています。
 
diff --git a/docs/ko/docs/index.md b/docs/ko/docs/index.md
index a6991a9b8..7ce938106 100644
--- a/docs/ko/docs/index.md
+++ b/docs/ko/docs/index.md
@@ -107,7 +107,7 @@ FastAPI는 현대적이고, 빠르며(고성능), 파이썬 표준 타입 힌트
 
 ## 요구사항
 
-Python 3.7+
+Python 3.8+
 
 FastAPI는 거인들의 어깨 위에 서 있습니다:
 
diff --git a/docs/pl/docs/features.md b/docs/pl/docs/features.md
index 49d362dd9..ed10af9bc 100644
--- a/docs/pl/docs/features.md
+++ b/docs/pl/docs/features.md
@@ -25,7 +25,7 @@ Interaktywna dokumentacja i webowe interfejsy do eksploracji API. Z racji tego,
 
 ### Nowoczesny Python
 
-Wszystko opiera się na standardowych deklaracjach typu **Python 3.6** (dzięki Pydantic). Brak nowej składni do uczenia. Po prostu standardowy, współczesny Python.
+Wszystko opiera się na standardowych deklaracjach typu **Python 3.8** (dzięki Pydantic). Brak nowej składni do uczenia. Po prostu standardowy, współczesny Python.
 
 Jeśli potrzebujesz szybkiego przypomnienia jak używać deklaracji typów w Pythonie (nawet jeśli nie używasz FastAPI), sprawdź krótki samouczek: [Python Types](python-types.md){.internal-link target=_blank}.
 
diff --git a/docs/pl/docs/index.md b/docs/pl/docs/index.md
index bade7a88c..43a20383c 100644
--- a/docs/pl/docs/index.md
+++ b/docs/pl/docs/index.md
@@ -106,7 +106,7 @@ Jeżeli tworzysz aplikacje <abbr title="aplikacja z interfejsem konsolowym">CLI<
 
 ## Wymagania
 
-Python 3.7+
+Python 3.8+
 
 FastAPI oparty jest na:
 
@@ -321,7 +321,7 @@ Robisz to tak samo jak ze standardowymi typami w Pythonie.
 
 Nie musisz sie uczyć żadnej nowej składni, metod lub klas ze specyficznych bibliotek itp.
 
-Po prostu standardowy **Python 3.6+**.
+Po prostu standardowy **Python 3.8+**.
 
 Na przykład, dla danych typu `int`:
 
diff --git a/docs/pt/docs/features.md b/docs/pt/docs/features.md
index bd0db8e76..822992c5b 100644
--- a/docs/pt/docs/features.md
+++ b/docs/pt/docs/features.md
@@ -25,7 +25,7 @@ Documentação interativa da API e navegação _web_ da interface de usuário. C
 
 ### Apenas Python moderno
 
-Tudo é baseado no padrão das declarações de **tipos do Python 3.6** (graças ao Pydantic). Nenhuma sintaxe nova para aprender. Apenas o padrão moderno do Python.
+Tudo é baseado no padrão das declarações de **tipos do Python 3.8** (graças ao Pydantic). Nenhuma sintaxe nova para aprender. Apenas o padrão moderno do Python.
 
 Se você precisa refrescar a memória rapidamente sobre como usar tipos do Python (mesmo que você não use o FastAPI), confira esse rápido tutorial: [Tipos do Python](python-types.md){.internal-link target=_blank}.
 
diff --git a/docs/pt/docs/index.md b/docs/pt/docs/index.md
index 591e7f3d4..d1e64b3b9 100644
--- a/docs/pt/docs/index.md
+++ b/docs/pt/docs/index.md
@@ -24,7 +24,7 @@
 
 ---
 
-FastAPI é um moderno e rápido (alta performance) _framework web_ para construção de APIs com Python 3.6 ou superior, baseado nos _type hints_ padrões do Python.
+FastAPI é um moderno e rápido (alta performance) _framework web_ para construção de APIs com Python 3.8 ou superior, baseado nos _type hints_ padrões do Python.
 
 Os recursos chave são:
 
@@ -100,7 +100,7 @@ Se você estiver construindo uma aplicação <abbr title="Command Line Interface
 
 ## Requisitos
 
-Python 3.7+
+Python 3.8+
 
 FastAPI está nos ombros de gigantes:
 
@@ -316,7 +316,7 @@ Você faz com tipos padrão do Python moderno.
 
 Você não terá que aprender uma nova sintaxe, métodos ou classes de uma biblioteca específica etc.
 
-Apenas **Python 3.6+** padrão.
+Apenas **Python 3.8+** padrão.
 
 Por exemplo, para um `int`:
 
diff --git a/docs/pt/docs/tutorial/body-multiple-params.md b/docs/pt/docs/tutorial/body-multiple-params.md
index 22f5856a6..0eaa9664c 100644
--- a/docs/pt/docs/tutorial/body-multiple-params.md
+++ b/docs/pt/docs/tutorial/body-multiple-params.md
@@ -14,7 +14,7 @@ E você também pode declarar parâmetros de corpo como opcionais, definindo o v
     {!> ../../../docs_src/body_multiple_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="19-21"
     {!> ../../../docs_src/body_multiple_params/tutorial001.py!}
@@ -44,7 +44,7 @@ Mas você pode também declarar múltiplos parâmetros de corpo, por exemplo, `i
     {!> ../../../docs_src/body_multiple_params/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="22"
     {!> ../../../docs_src/body_multiple_params/tutorial002.py!}
@@ -87,7 +87,7 @@ Se você declará-lo como é, porque é um valor singular, o **FastAPI** assumir
 
 Mas você pode instruir o **FastAPI** para tratá-lo como outra chave do corpo usando `Body`:
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="22"
     {!> ../../../docs_src/body_multiple_params/tutorial003.py!}
@@ -143,7 +143,7 @@ Por exemplo:
     {!> ../../../docs_src/body_multiple_params/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="27"
     {!> ../../../docs_src/body_multiple_params/tutorial004.py!}
@@ -172,7 +172,7 @@ como em:
     {!> ../../../docs_src/body_multiple_params/tutorial005_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17"
     {!> ../../../docs_src/body_multiple_params/tutorial005.py!}
diff --git a/docs/pt/docs/tutorial/encoder.md b/docs/pt/docs/tutorial/encoder.md
index bb4483fdc..b9bfbf63b 100644
--- a/docs/pt/docs/tutorial/encoder.md
+++ b/docs/pt/docs/tutorial/encoder.md
@@ -26,7 +26,7 @@ A função recebe um objeto, como um modelo Pydantic e retorna uma versão compa
     {!> ../../../docs_src/encoder/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="5  22"
     {!> ../../../docs_src/encoder/tutorial001.py!}
diff --git a/docs/pt/docs/tutorial/extra-models.md b/docs/pt/docs/tutorial/extra-models.md
index dd5407eb2..1343a3ae4 100644
--- a/docs/pt/docs/tutorial/extra-models.md
+++ b/docs/pt/docs/tutorial/extra-models.md
@@ -17,7 +17,7 @@ Isso é especialmente o caso para modelos de usuários, porque:
 
 Aqui está uma ideia geral de como os modelos poderiam parecer com seus campos de senha e os lugares onde são usados:
 
-=== "Python 3.6 and above"
+=== "Python 3.8 and above"
 
     ```Python hl_lines="9  11  16  22  24  29-30  33-35  40-41"
     {!> ../../../docs_src/extra_models/tutorial001.py!}
@@ -158,7 +158,7 @@ Toda conversão de dados, validação, documentação, etc. ainda funcionará no
 
 Dessa forma, podemos declarar apenas as diferenças entre os modelos (com `password` em texto claro, com `hashed_password` e sem senha):
 
-=== "Python 3.6 and above"
+=== "Python 3.8 and above"
 
     ```Python hl_lines="9  15-16  19-20  23-24"
     {!> ../../../docs_src/extra_models/tutorial002.py!}
@@ -181,7 +181,7 @@ Para fazer isso, use a dica de tipo padrão do Python <a href="https://docs.pyth
 !!! note
     Ao definir um <a href="https://pydantic-docs.helpmanual.io/usage/types/#unions" class="external-link" target="_blank">`Union`</a>, inclua o tipo mais específico primeiro, seguido pelo tipo menos específico. No exemplo abaixo, o tipo mais específico `PlaneItem` vem antes de `CarItem` em `Union[PlaneItem, CarItem]`.
 
-=== "Python 3.6 and above"
+=== "Python 3.8 and above"
 
     ```Python hl_lines="1  14-15  18-20  33"
     {!> ../../../docs_src/extra_models/tutorial003.py!}
@@ -213,7 +213,7 @@ Da mesma forma, você pode declarar respostas de listas de objetos.
 
 Para isso, use o padrão Python `typing.List` (ou simplesmente `list` no Python 3.9 e superior):
 
-=== "Python 3.6 and above"
+=== "Python 3.8 and above"
 
     ```Python hl_lines="1  20"
     {!> ../../../docs_src/extra_models/tutorial004.py!}
@@ -233,7 +233,7 @@ Isso é útil se você não souber os nomes de campo / atributo válidos (que se
 
 Neste caso, você pode usar `typing.Dict` (ou simplesmente dict no Python 3.9 e superior):
 
-=== "Python 3.6 and above"
+=== "Python 3.8 and above"
 
     ```Python hl_lines="1  8"
     {!> ../../../docs_src/extra_models/tutorial005.py!}
diff --git a/docs/pt/docs/tutorial/header-params.md b/docs/pt/docs/tutorial/header-params.md
index bc8843327..4bdfb7e9c 100644
--- a/docs/pt/docs/tutorial/header-params.md
+++ b/docs/pt/docs/tutorial/header-params.md
@@ -12,7 +12,7 @@ Primeiro importe `Header`:
     {!> ../../../docs_src/header_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3"
     {!> ../../../docs_src/header_params/tutorial001.py!}
@@ -30,7 +30,7 @@ O primeiro valor é o valor padrão, você pode passar todas as validações adi
     {!> ../../../docs_src/header_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/header_params/tutorial001.py!}
@@ -66,7 +66,7 @@ Se por algum motivo você precisar desabilitar a conversão automática de subli
     {!> ../../../docs_src/header_params/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/header_params/tutorial002.py!}
@@ -97,7 +97,7 @@ Por exemplo, para declarar um cabeçalho de `X-Token` que pode aparecer mais de
     {!> ../../../docs_src/header_params/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/header_params/tutorial003.py!}
diff --git a/docs/pt/docs/tutorial/path-operation-configuration.md b/docs/pt/docs/tutorial/path-operation-configuration.md
index e0a23f665..13a87240f 100644
--- a/docs/pt/docs/tutorial/path-operation-configuration.md
+++ b/docs/pt/docs/tutorial/path-operation-configuration.md
@@ -13,7 +13,7 @@ Você pode passar diretamente o código `int`, como `404`.
 
 Mas se você não se lembrar o que cada código numérico significa, pode usar as constantes de atalho em `status`:
 
-=== "Python 3.6 and above"
+=== "Python 3.8 and above"
 
     ```Python hl_lines="3  17"
     {!> ../../../docs_src/path_operation_configuration/tutorial001.py!}
@@ -42,7 +42,7 @@ Esse código de status será usado na resposta e será adicionado ao esquema Ope
 
 Você pode adicionar tags para sua *operação de rota*, passe o parâmetro `tags` com uma `list` de `str` (comumente apenas um `str`):
 
-=== "Python 3.6 and above"
+=== "Python 3.8 and above"
 
     ```Python hl_lines="17  22  27"
     {!> ../../../docs_src/path_operation_configuration/tutorial002.py!}
@@ -80,7 +80,7 @@ Nestes casos, pode fazer sentido armazenar as tags em um `Enum`.
 
 Você pode adicionar um `summary` e uma `description`:
 
-=== "Python 3.6 and above"
+=== "Python 3.8 and above"
 
     ```Python hl_lines="20-21"
     {!> ../../../docs_src/path_operation_configuration/tutorial003.py!}
@@ -104,7 +104,7 @@ Como as descrições tendem a ser longas e cobrir várias linhas, você pode dec
 
 Você pode escrever <a href="https://en.wikipedia.org/wiki/Markdown" class="external-link" target="_blank">Markdown</a> na docstring, ele será interpretado e exibido corretamente (levando em conta a indentação da docstring).
 
-=== "Python 3.6 and above"
+=== "Python 3.8 and above"
 
     ```Python hl_lines="19-27"
     {!> ../../../docs_src/path_operation_configuration/tutorial004.py!}
@@ -131,7 +131,7 @@ Ela será usada nas documentações interativas:
 
 Você pode especificar a descrição da resposta com o parâmetro `response_description`:
 
-=== "Python 3.6 and above"
+=== "Python 3.8 and above"
 
     ```Python hl_lines="21"
     {!> ../../../docs_src/path_operation_configuration/tutorial005.py!}
diff --git a/docs/pt/docs/tutorial/path-params-numeric-validations.md b/docs/pt/docs/tutorial/path-params-numeric-validations.md
index ec9b74b30..eb0d31dc3 100644
--- a/docs/pt/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/pt/docs/tutorial/path-params-numeric-validations.md
@@ -12,7 +12,7 @@ Primeiro, importe `Path` de `fastapi`:
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
@@ -30,7 +30,7 @@ Por exemplo para declarar um valor de metadado `title` para o parâmetro de rota
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001.py!}
diff --git a/docs/pt/docs/tutorial/query-params.md b/docs/pt/docs/tutorial/query-params.md
index 3ada4fd21..08bb99dbc 100644
--- a/docs/pt/docs/tutorial/query-params.md
+++ b/docs/pt/docs/tutorial/query-params.md
@@ -69,7 +69,7 @@ Da mesma forma, você pode declarar parâmetros de consulta opcionais, definindo
     {!> ../../../docs_src/query_params/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params/tutorial002.py!}
@@ -91,7 +91,7 @@ Você também pode declarar tipos `bool`, e eles serão convertidos:
     {!> ../../../docs_src/query_params/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params/tutorial003.py!}
@@ -143,7 +143,7 @@ Eles serão detectados pelo nome:
     {!> ../../../docs_src/query_params/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8  10"
     {!> ../../../docs_src/query_params/tutorial004.py!}
@@ -209,7 +209,7 @@ E claro, você pode definir alguns parâmetros como obrigatórios, alguns possui
     {!> ../../../docs_src/query_params/tutorial006_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params/tutorial006.py!}
diff --git a/docs/ru/docs/features.md b/docs/ru/docs/features.md
index e18f7bc87..97841cc83 100644
--- a/docs/ru/docs/features.md
+++ b/docs/ru/docs/features.md
@@ -27,7 +27,7 @@
 
 ### Только современный Python
 
-Все эти возможности основаны на стандартных **аннотациях типов Python 3.6** (благодаря Pydantic). Не нужно изучать новый синтаксис. Только лишь стандартный современный Python.
+Все эти возможности основаны на стандартных **аннотациях типов Python 3.8** (благодаря Pydantic). Не нужно изучать новый синтаксис. Только лишь стандартный современный Python.
 
 Если вам нужно освежить знания, как использовать аннотации типов в Python (даже если вы не используете FastAPI), выделите 2 минуты и просмотрите краткое руководство: [Введение в аннотации типов Python¶
 ](python-types.md){.internal-link target=_blank}.
diff --git a/docs/ru/docs/index.md b/docs/ru/docs/index.md
index 30c32e046..97a3947bd 100644
--- a/docs/ru/docs/index.md
+++ b/docs/ru/docs/index.md
@@ -27,7 +27,7 @@
 
 ---
 
-FastAPI — это современный, быстрый (высокопроизводительный) веб-фреймворк для создания API используя Python 3.6+, в основе которого лежит стандартная аннотация типов Python.
+FastAPI — это современный, быстрый (высокопроизводительный) веб-фреймворк для создания API используя Python 3.8+, в основе которого лежит стандартная аннотация типов Python.
 
 Ключевые особенности:
 
@@ -109,7 +109,7 @@ FastAPI — это современный, быстрый (высокопрои
 
 ## Зависимости
 
-Python 3.7+
+Python 3.8+
 
 FastAPI стоит на плечах гигантов:
 
@@ -325,7 +325,7 @@ def update_item(item_id: int, item: Item):
 
 Вам не нужно изучать новый синтаксис, методы или классы конкретной библиотеки и т. д.
 
-Только стандартный **Python 3.6+**.
+Только стандартный **Python 3.8+**.
 
 Например, для `int`:
 
diff --git a/docs/ru/docs/tutorial/background-tasks.md b/docs/ru/docs/tutorial/background-tasks.md
index 81efda786..7a3cf6d83 100644
--- a/docs/ru/docs/tutorial/background-tasks.md
+++ b/docs/ru/docs/tutorial/background-tasks.md
@@ -63,7 +63,7 @@
     {!> ../../../docs_src/background_tasks/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="13  15  22  25"
     {!> ../../../docs_src/background_tasks/tutorial002.py!}
diff --git a/docs/ru/docs/tutorial/body-fields.md b/docs/ru/docs/tutorial/body-fields.md
index 2dc6c1e26..02a598004 100644
--- a/docs/ru/docs/tutorial/body-fields.md
+++ b/docs/ru/docs/tutorial/body-fields.md
@@ -12,7 +12,7 @@
     {!> ../../../docs_src/body_fields/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4"
     {!> ../../../docs_src/body_fields/tutorial001.py!}
@@ -31,7 +31,7 @@
     {!> ../../../docs_src/body_fields/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11-14"
     {!> ../../../docs_src/body_fields/tutorial001.py!}
diff --git a/docs/ru/docs/tutorial/body-multiple-params.md b/docs/ru/docs/tutorial/body-multiple-params.md
index a20457092..e52ef6f6f 100644
--- a/docs/ru/docs/tutorial/body-multiple-params.md
+++ b/docs/ru/docs/tutorial/body-multiple-params.md
@@ -20,7 +20,7 @@
     {!> ../../../docs_src/body_multiple_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="19-21"
     {!> ../../../docs_src/body_multiple_params/tutorial001_an.py!}
@@ -35,7 +35,7 @@
     {!> ../../../docs_src/body_multiple_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! Заметка
         Рекомендуется использовать версию с `Annotated`, если это возможно.
@@ -68,7 +68,7 @@
     {!> ../../../docs_src/body_multiple_params/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="22"
     {!> ../../../docs_src/body_multiple_params/tutorial002.py!}
@@ -123,7 +123,7 @@
     {!> ../../../docs_src/body_multiple_params/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24"
     {!> ../../../docs_src/body_multiple_params/tutorial003_an.py!}
@@ -138,7 +138,7 @@
     {!> ../../../docs_src/body_multiple_params/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! Заметка
         Рекомендуется использовать `Annotated` версию, если это возможно.
@@ -197,7 +197,7 @@ q: str | None = None
     {!> ../../../docs_src/body_multiple_params/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="28"
     {!> ../../../docs_src/body_multiple_params/tutorial004_an.py!}
@@ -212,7 +212,7 @@ q: str | None = None
     {!> ../../../docs_src/body_multiple_params/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! Заметка
         Рекомендуется использовать `Annotated` версию, если это возможно.
@@ -250,7 +250,7 @@ item: Item = Body(embed=True)
     {!> ../../../docs_src/body_multiple_params/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/body_multiple_params/tutorial005_an.py!}
@@ -265,7 +265,7 @@ item: Item = Body(embed=True)
     {!> ../../../docs_src/body_multiple_params/tutorial005_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! Заметка
         Рекомендуется использовать `Annotated` версию, если это возможно.
diff --git a/docs/ru/docs/tutorial/body-nested-models.md b/docs/ru/docs/tutorial/body-nested-models.md
index 6435e316f..a6d123d30 100644
--- a/docs/ru/docs/tutorial/body-nested-models.md
+++ b/docs/ru/docs/tutorial/body-nested-models.md
@@ -12,7 +12,7 @@
     {!> ../../../docs_src/body_nested_models/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="14"
     {!> ../../../docs_src/body_nested_models/tutorial001.py!}
@@ -73,7 +73,7 @@ my_list: List[str]
     {!> ../../../docs_src/body_nested_models/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="14"
     {!> ../../../docs_src/body_nested_models/tutorial002.py!}
@@ -99,7 +99,7 @@ my_list: List[str]
     {!> ../../../docs_src/body_nested_models/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  14"
     {!> ../../../docs_src/body_nested_models/tutorial003.py!}
@@ -137,7 +137,7 @@ my_list: List[str]
     {!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9-11"
     {!> ../../../docs_src/body_nested_models/tutorial004.py!}
@@ -159,7 +159,7 @@ my_list: List[str]
     {!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20"
     {!> ../../../docs_src/body_nested_models/tutorial004.py!}
@@ -208,7 +208,7 @@ my_list: List[str]
     {!> ../../../docs_src/body_nested_models/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4  10"
     {!> ../../../docs_src/body_nested_models/tutorial005.py!}
@@ -232,7 +232,7 @@ my_list: List[str]
     {!> ../../../docs_src/body_nested_models/tutorial006_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20"
     {!> ../../../docs_src/body_nested_models/tutorial006.py!}
@@ -283,7 +283,7 @@ my_list: List[str]
     {!> ../../../docs_src/body_nested_models/tutorial007_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  14  20  23  27"
     {!> ../../../docs_src/body_nested_models/tutorial007.py!}
@@ -314,7 +314,7 @@ images: list[Image]
     {!> ../../../docs_src/body_nested_models/tutorial008_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15"
     {!> ../../../docs_src/body_nested_models/tutorial008.py!}
@@ -354,7 +354,7 @@ images: list[Image]
     {!> ../../../docs_src/body_nested_models/tutorial009_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/body_nested_models/tutorial009.py!}
diff --git a/docs/ru/docs/tutorial/cookie-params.md b/docs/ru/docs/tutorial/cookie-params.md
index a6f2caa26..5f99458b6 100644
--- a/docs/ru/docs/tutorial/cookie-params.md
+++ b/docs/ru/docs/tutorial/cookie-params.md
@@ -12,7 +12,7 @@
     {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3"
     {!> ../../../docs_src/cookie_params/tutorial001.py!}
@@ -30,7 +30,7 @@
     {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/cookie_params/tutorial001.py!}
diff --git a/docs/ru/docs/tutorial/dependencies/global-dependencies.md b/docs/ru/docs/tutorial/dependencies/global-dependencies.md
index 870d42cf5..eb1b4d7c1 100644
--- a/docs/ru/docs/tutorial/dependencies/global-dependencies.md
+++ b/docs/ru/docs/tutorial/dependencies/global-dependencies.md
@@ -12,13 +12,13 @@
     {!> ../../../docs_src/dependencies/tutorial012_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="16"
     {!> ../../../docs_src/dependencies/tutorial012_an.py!}
     ```
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать 'Annotated' версию, если это возможно.
diff --git a/docs/ru/docs/tutorial/extra-data-types.md b/docs/ru/docs/tutorial/extra-data-types.md
index efcbcb38a..0f613a6b2 100644
--- a/docs/ru/docs/tutorial/extra-data-types.md
+++ b/docs/ru/docs/tutorial/extra-data-types.md
@@ -55,7 +55,7 @@
 
 Вот пример *операции пути* с параметрами, который демонстрирует некоторые из вышеперечисленных типов.
 
-=== "Python 3.6 и выше"
+=== "Python 3.8 и выше"
 
     ```Python hl_lines="1  3  12-16"
     {!> ../../../docs_src/extra_data_types/tutorial001.py!}
@@ -69,7 +69,7 @@
 
 Обратите внимание, что параметры внутри функции имеют свой естественный тип данных, и вы, например, можете выполнять обычные манипуляции с датами, такие как:
 
-=== "Python 3.6 и выше"
+=== "Python 3.8 и выше"
 
     ```Python hl_lines="18-19"
     {!> ../../../docs_src/extra_data_types/tutorial001.py!}
diff --git a/docs/ru/docs/tutorial/extra-models.md b/docs/ru/docs/tutorial/extra-models.md
index a346f7432..30176b4e3 100644
--- a/docs/ru/docs/tutorial/extra-models.md
+++ b/docs/ru/docs/tutorial/extra-models.md
@@ -23,7 +23,7 @@
     {!> ../../../docs_src/extra_models/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  11  16  22  24  29-30  33-35  40-41"
     {!> ../../../docs_src/extra_models/tutorial001.py!}
@@ -164,7 +164,7 @@ UserInDB(
     {!> ../../../docs_src/extra_models/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  15-16  19-20  23-24"
     {!> ../../../docs_src/extra_models/tutorial002.py!}
@@ -187,7 +187,7 @@ UserInDB(
     {!> ../../../docs_src/extra_models/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  14-15  18-20  33"
     {!> ../../../docs_src/extra_models/tutorial003.py!}
@@ -219,7 +219,7 @@ some_variable: PlaneItem | CarItem
     {!> ../../../docs_src/extra_models/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  20"
     {!> ../../../docs_src/extra_models/tutorial004.py!}
@@ -239,7 +239,7 @@ some_variable: PlaneItem | CarItem
     {!> ../../../docs_src/extra_models/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  8"
     {!> ../../../docs_src/extra_models/tutorial005.py!}
diff --git a/docs/ru/docs/tutorial/header-params.md b/docs/ru/docs/tutorial/header-params.md
index 0ff8ea489..1be4ac707 100644
--- a/docs/ru/docs/tutorial/header-params.md
+++ b/docs/ru/docs/tutorial/header-params.md
@@ -18,7 +18,7 @@
     {!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3"
     {!> ../../../docs_src/header_params/tutorial001_an.py!}
@@ -33,7 +33,7 @@
     {!> ../../../docs_src/header_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -60,7 +60,7 @@
     {!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/header_params/tutorial001_an.py!}
@@ -75,7 +75,7 @@
     {!> ../../../docs_src/header_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -120,7 +120,7 @@
     {!> ../../../docs_src/header_params/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12"
     {!> ../../../docs_src/header_params/tutorial002_an.py!}
@@ -135,7 +135,7 @@
     {!> ../../../docs_src/header_params/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Предпочтительнее использовать версию с аннотацией, если это возможно.
@@ -169,7 +169,7 @@
     {!> ../../../docs_src/header_params/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/header_params/tutorial003_an.py!}
@@ -193,7 +193,7 @@
     {!> ../../../docs_src/header_params/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Предпочтительнее использовать версию с аннотацией, если это возможно.
diff --git a/docs/ru/docs/tutorial/path-operation-configuration.md b/docs/ru/docs/tutorial/path-operation-configuration.md
index 013903add..db99409f4 100644
--- a/docs/ru/docs/tutorial/path-operation-configuration.md
+++ b/docs/ru/docs/tutorial/path-operation-configuration.md
@@ -25,7 +25,7 @@
     {!> ../../../docs_src/path_operation_configuration/tutorial001_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3  17"
     {!> ../../../docs_src/path_operation_configuration/tutorial001.py!}
@@ -54,7 +54,7 @@
     {!> ../../../docs_src/path_operation_configuration/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17  22  27"
     {!> ../../../docs_src/path_operation_configuration/tutorial002.py!}
@@ -92,7 +92,7 @@
     {!> ../../../docs_src/path_operation_configuration/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20-21"
     {!> ../../../docs_src/path_operation_configuration/tutorial003.py!}
@@ -116,7 +116,7 @@
     {!> ../../../docs_src/path_operation_configuration/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="19-27"
     {!> ../../../docs_src/path_operation_configuration/tutorial004.py!}
@@ -142,7 +142,7 @@
     {!> ../../../docs_src/path_operation_configuration/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="21"
     {!> ../../../docs_src/path_operation_configuration/tutorial005.py!}
diff --git a/docs/ru/docs/tutorial/path-params-numeric-validations.md b/docs/ru/docs/tutorial/path-params-numeric-validations.md
index 0d034ef34..bd2c29d0a 100644
--- a/docs/ru/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/ru/docs/tutorial/path-params-numeric-validations.md
@@ -18,7 +18,7 @@
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3-4"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
@@ -33,7 +33,7 @@
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -67,7 +67,7 @@
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
@@ -82,7 +82,7 @@
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -117,7 +117,7 @@
 
 Поэтому вы можете определить функцию так:
 
-=== "Python 3.6 без Annotated"
+=== "Python 3.8 без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -134,7 +134,7 @@
     {!> ../../../docs_src/path_params_numeric_validations/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial002_an.py!}
@@ -174,7 +174,7 @@ Python не будет ничего делать с `*`, но он будет з
     {!> ../../../docs_src/path_params_numeric_validations/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial003_an.py!}
@@ -192,13 +192,13 @@ Python не будет ничего делать с `*`, но он будет з
     {!> ../../../docs_src/path_params_numeric_validations/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial004_an.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -220,13 +220,13 @@ Python не будет ничего делать с `*`, но он будет з
     {!> ../../../docs_src/path_params_numeric_validations/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial005_an.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -251,13 +251,13 @@ Python не будет ничего делать с `*`, но он будет з
     {!> ../../../docs_src/path_params_numeric_validations/tutorial006_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial006_an.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
diff --git a/docs/ru/docs/tutorial/query-params-str-validations.md b/docs/ru/docs/tutorial/query-params-str-validations.md
index 68042db63..15be5dbf6 100644
--- a/docs/ru/docs/tutorial/query-params-str-validations.md
+++ b/docs/ru/docs/tutorial/query-params-str-validations.md
@@ -10,7 +10,7 @@
     {!> ../../../docs_src/query_params_str_validations/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params_str_validations/tutorial001.py!}
@@ -42,7 +42,7 @@ Query-параметр `q` имеет тип `Union[str, None]` (или `str | N
     {!> ../../../docs_src/query_params_str_validations/tutorial002_an_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     В версиях Python ниже Python 3.9 `Annotation` импортируется из `typing_extensions`.
 
@@ -66,7 +66,7 @@ Query-параметр `q` имеет тип `Union[str, None]` (или `str | N
     q: str | None = None
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     q: Union[str, None] = None
@@ -80,7 +80,7 @@ Query-параметр `q` имеет тип `Union[str, None]` (или `str | N
     q: Annotated[str | None] = None
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     q: Annotated[Union[str, None]] = None
@@ -100,7 +100,7 @@ Query-параметр `q` имеет тип `Union[str, None]` (или `str | N
     {!> ../../../docs_src/query_params_str_validations/tutorial002_an_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params_str_validations/tutorial002_an.py!}
@@ -131,7 +131,7 @@ Query-параметр `q` имеет тип `Union[str, None]` (или `str | N
     {!> ../../../docs_src/query_params_str_validations/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params_str_validations/tutorial002.py!}
@@ -244,7 +244,7 @@ q: str = Query(default="rick")
     {!> ../../../docs_src/query_params_str_validations/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/query_params_str_validations/tutorial003_an.py!}
@@ -259,7 +259,7 @@ q: str = Query(default="rick")
     {!> ../../../docs_src/query_params_str_validations/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -284,7 +284,7 @@ q: str = Query(default="rick")
     {!> ../../../docs_src/query_params_str_validations/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12"
     {!> ../../../docs_src/query_params_str_validations/tutorial004_an.py!}
@@ -299,7 +299,7 @@ q: str = Query(default="rick")
     {!> ../../../docs_src/query_params_str_validations/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -330,13 +330,13 @@ q: str = Query(default="rick")
     {!> ../../../docs_src/query_params_str_validations/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/query_params_str_validations/tutorial005_an.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -384,13 +384,13 @@ q: Union[str, None] = None
     {!> ../../../docs_src/query_params_str_validations/tutorial006_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/query_params_str_validations/tutorial006_an.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -414,13 +414,13 @@ q: Union[str, None] = None
     {!> ../../../docs_src/query_params_str_validations/tutorial006b_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/query_params_str_validations/tutorial006b_an.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -454,7 +454,7 @@ q: Union[str, None] = None
     {!> ../../../docs_src/query_params_str_validations/tutorial006c_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params_str_validations/tutorial006c_an.py!}
@@ -469,7 +469,7 @@ q: Union[str, None] = None
     {!> ../../../docs_src/query_params_str_validations/tutorial006c_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -491,13 +491,13 @@ q: Union[str, None] = None
     {!> ../../../docs_src/query_params_str_validations/tutorial006d_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="2  9"
     {!> ../../../docs_src/query_params_str_validations/tutorial006d_an.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -527,7 +527,7 @@ q: Union[str, None] = None
     {!> ../../../docs_src/query_params_str_validations/tutorial011_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params_str_validations/tutorial011_an.py!}
@@ -551,7 +551,7 @@ q: Union[str, None] = None
     {!> ../../../docs_src/query_params_str_validations/tutorial011_py39.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -596,7 +596,7 @@ http://localhost:8000/items/?q=foo&q=bar
     {!> ../../../docs_src/query_params_str_validations/tutorial012_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params_str_validations/tutorial012_an.py!}
@@ -611,7 +611,7 @@ http://localhost:8000/items/?q=foo&q=bar
     {!> ../../../docs_src/query_params_str_validations/tutorial012_py39.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -647,13 +647,13 @@ http://localhost:8000/items/
     {!> ../../../docs_src/query_params_str_validations/tutorial013_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/query_params_str_validations/tutorial013_an.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -692,7 +692,7 @@ http://localhost:8000/items/
     {!> ../../../docs_src/query_params_str_validations/tutorial007_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/query_params_str_validations/tutorial007_an.py!}
@@ -707,7 +707,7 @@ http://localhost:8000/items/
     {!> ../../../docs_src/query_params_str_validations/tutorial007_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -730,7 +730,7 @@ http://localhost:8000/items/
     {!> ../../../docs_src/query_params_str_validations/tutorial008_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15"
     {!> ../../../docs_src/query_params_str_validations/tutorial008_an.py!}
@@ -745,7 +745,7 @@ http://localhost:8000/items/
     {!> ../../../docs_src/query_params_str_validations/tutorial008_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -784,7 +784,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
     {!> ../../../docs_src/query_params_str_validations/tutorial009_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params_str_validations/tutorial009_an.py!}
@@ -799,7 +799,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
     {!> ../../../docs_src/query_params_str_validations/tutorial009_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -828,7 +828,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
     {!> ../../../docs_src/query_params_str_validations/tutorial010_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20"
     {!> ../../../docs_src/query_params_str_validations/tutorial010_an.py!}
@@ -843,7 +843,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
     {!> ../../../docs_src/query_params_str_validations/tutorial010_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
@@ -872,7 +872,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
     {!> ../../../docs_src/query_params_str_validations/tutorial014_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/query_params_str_validations/tutorial014_an.py!}
@@ -887,7 +887,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
     {!> ../../../docs_src/query_params_str_validations/tutorial014_py310.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
diff --git a/docs/ru/docs/tutorial/query-params.md b/docs/ru/docs/tutorial/query-params.md
index 68333ec56..6e885cb65 100644
--- a/docs/ru/docs/tutorial/query-params.md
+++ b/docs/ru/docs/tutorial/query-params.md
@@ -69,7 +69,7 @@ http://127.0.0.1:8000/items/?skip=20
     {!> ../../../docs_src/query_params/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params/tutorial002.py!}
@@ -90,7 +90,7 @@ http://127.0.0.1:8000/items/?skip=20
     {!> ../../../docs_src/query_params/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params/tutorial003.py!}
@@ -143,7 +143,7 @@ http://127.0.0.1:8000/items/foo?short=yes
     {!> ../../../docs_src/query_params/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8  10"
     {!> ../../../docs_src/query_params/tutorial004.py!}
@@ -209,7 +209,7 @@ http://127.0.0.1:8000/items/foo-item?needy=sooooneedy
     {!> ../../../docs_src/query_params/tutorial006_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/query_params/tutorial006.py!}
diff --git a/docs/ru/docs/tutorial/request-forms.md b/docs/ru/docs/tutorial/request-forms.md
index a20cf78e0..0fc9e4eda 100644
--- a/docs/ru/docs/tutorial/request-forms.md
+++ b/docs/ru/docs/tutorial/request-forms.md
@@ -17,13 +17,13 @@
     {!> ../../../docs_src/request_forms/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1"
     {!> ../../../docs_src/request_forms/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать 'Annotated' версию, если это возможно.
@@ -42,13 +42,13 @@
     {!> ../../../docs_src/request_forms/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8"
     {!> ../../../docs_src/request_forms/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ без Annotated"
+=== "Python 3.8+ без Annotated"
 
     !!! tip "Подсказка"
         Рекомендуется использовать 'Annotated' версию, если это возможно.
diff --git a/docs/ru/docs/tutorial/response-model.md b/docs/ru/docs/tutorial/response-model.md
index c5e111790..38b45e2a5 100644
--- a/docs/ru/docs/tutorial/response-model.md
+++ b/docs/ru/docs/tutorial/response-model.md
@@ -16,7 +16,7 @@ FastAPI позволяет использовать **аннотации тип
     {!> ../../../docs_src/response_model/tutorial001_01_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18  23"
     {!> ../../../docs_src/response_model/tutorial001_01.py!}
@@ -65,7 +65,7 @@ FastAPI будет использовать этот возвращаемый т
     {!> ../../../docs_src/response_model/tutorial001_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17  22  24-27"
     {!> ../../../docs_src/response_model/tutorial001.py!}
@@ -101,7 +101,7 @@ FastAPI будет использовать значение `response_model` д
     {!> ../../../docs_src/response_model/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  11"
     {!> ../../../docs_src/response_model/tutorial002.py!}
@@ -120,7 +120,7 @@ FastAPI будет использовать значение `response_model` д
     {!> ../../../docs_src/response_model/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/response_model/tutorial002.py!}
@@ -145,7 +145,7 @@ FastAPI будет использовать значение `response_model` д
     {!> ../../../docs_src/response_model/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  11  16"
     {!> ../../../docs_src/response_model/tutorial003.py!}
@@ -159,7 +159,7 @@ FastAPI будет использовать значение `response_model` д
     {!> ../../../docs_src/response_model/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24"
     {!> ../../../docs_src/response_model/tutorial003.py!}
@@ -173,7 +173,7 @@ FastAPI будет использовать значение `response_model` д
     {!> ../../../docs_src/response_model/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="22"
     {!> ../../../docs_src/response_model/tutorial003.py!}
@@ -207,7 +207,7 @@ FastAPI будет использовать значение `response_model` д
     {!> ../../../docs_src/response_model/tutorial003_01_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9-13  15-16  20"
     {!> ../../../docs_src/response_model/tutorial003_01.py!}
@@ -283,7 +283,7 @@ FastAPI совместно с Pydantic выполнит некоторую ма
     {!> ../../../docs_src/response_model/tutorial003_04_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/response_model/tutorial003_04.py!}
@@ -305,7 +305,7 @@ FastAPI совместно с Pydantic выполнит некоторую ма
     {!> ../../../docs_src/response_model/tutorial003_05_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/response_model/tutorial003_05.py!}
@@ -329,7 +329,7 @@ FastAPI совместно с Pydantic выполнит некоторую ма
     {!> ../../../docs_src/response_model/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11  13-14"
     {!> ../../../docs_src/response_model/tutorial004.py!}
@@ -359,7 +359,7 @@ FastAPI совместно с Pydantic выполнит некоторую ма
     {!> ../../../docs_src/response_model/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24"
     {!> ../../../docs_src/response_model/tutorial004.py!}
@@ -446,7 +446,7 @@ FastAPI достаточно умен (на самом деле, это засл
     {!> ../../../docs_src/response_model/tutorial005_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="31  37"
     {!> ../../../docs_src/response_model/tutorial005.py!}
@@ -467,7 +467,7 @@ FastAPI достаточно умен (на самом деле, это засл
     {!> ../../../docs_src/response_model/tutorial006_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="31  37"
     {!> ../../../docs_src/response_model/tutorial006.py!}
diff --git a/docs/ru/docs/tutorial/schema-extra-example.md b/docs/ru/docs/tutorial/schema-extra-example.md
index a0363b9ba..a13ab5935 100644
--- a/docs/ru/docs/tutorial/schema-extra-example.md
+++ b/docs/ru/docs/tutorial/schema-extra-example.md
@@ -14,7 +14,7 @@
     {!> ../../../docs_src/schema_extra_example/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15-23"
     {!> ../../../docs_src/schema_extra_example/tutorial001.py!}
@@ -39,7 +39,7 @@
     {!> ../../../docs_src/schema_extra_example/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4  10-13"
     {!> ../../../docs_src/schema_extra_example/tutorial002.py!}
@@ -78,7 +78,7 @@
     {!> ../../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="23-28"
     {!> ../../../docs_src/schema_extra_example/tutorial003_an.py!}
@@ -93,7 +93,7 @@
     {!> ../../../docs_src/schema_extra_example/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip Заметка
         Рекомендуется использовать версию с `Annotated`, если это возможно.
@@ -133,7 +133,7 @@
     {!> ../../../docs_src/schema_extra_example/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24-50"
     {!> ../../../docs_src/schema_extra_example/tutorial004_an.py!}
@@ -148,7 +148,7 @@
     {!> ../../../docs_src/schema_extra_example/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip Заметка
         Рекомендуется использовать версию с `Annotated`, если это возможно.
diff --git a/docs/ru/docs/tutorial/testing.md b/docs/ru/docs/tutorial/testing.md
index 3f9005112..ca47a6f51 100644
--- a/docs/ru/docs/tutorial/testing.md
+++ b/docs/ru/docs/tutorial/testing.md
@@ -122,7 +122,7 @@
     {!> ../../../docs_src/app_testing/app_b_an_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     {!> ../../../docs_src/app_testing/app_b_an/main.py!}
@@ -137,7 +137,7 @@
     {!> ../../../docs_src/app_testing/app_b_py310/main.py!}
     ```
 
-=== "Python 3.6+  без Annotated"
+=== "Python 3.8+  без Annotated"
 
     !!! tip "Подсказка"
         По возможности используйте версию с `Annotated`.
diff --git a/docs/tr/docs/features.md b/docs/tr/docs/features.md
index f8220fb58..8b143ffe7 100644
--- a/docs/tr/docs/features.md
+++ b/docs/tr/docs/features.md
@@ -27,7 +27,7 @@ OpenAPI standartlarına dayalı olan bir framework olarak, geliştiricilerin bir
 
 ### Sadece modern Python
 
-Tamamiyle standartlar **Python 3.6**'nın type hintlerine dayanıyor (Pydantic'in sayesinde). Yeni bir syntax öğrenmene gerek yok. Sadece modern Python.
+Tamamiyle standartlar **Python 3.8**'nın type hintlerine dayanıyor (Pydantic'in sayesinde). Yeni bir syntax öğrenmene gerek yok. Sadece modern Python.
 
 
 Eğer Python type hintlerini bilmiyorsan veya bir hatırlatmaya ihtiyacın var ise(FastAPI kullanmasan bile) şu iki dakikalık küçük bilgilendirici içeriğe bir göz at: [Python Types](python-types.md){.internal-link target=_blank}.
diff --git a/docs/tr/docs/index.md b/docs/tr/docs/index.md
index e74efbc2f..e61f5b82c 100644
--- a/docs/tr/docs/index.md
+++ b/docs/tr/docs/index.md
@@ -24,7 +24,7 @@
 
 ---
 
-FastAPI, Python 3.6+'nın standart type hintlerine dayanan modern ve hızlı (yüksek performanslı) API'lar oluşturmak için kullanılabilecek web framework'ü.
+FastAPI, Python 3.8+'nın standart type hintlerine dayanan modern ve hızlı (yüksek performanslı) API'lar oluşturmak için kullanılabilecek web framework'ü.
 
 Ana özellikleri:
 
@@ -115,7 +115,7 @@ Eğer API yerine <abbr title="Command Line Interface">komut satırı uygulaması
 
 ## Gereksinimler
 
-Python 3.7+
+Python 3.8+
 
 FastAPI iki devin omuzları üstünde duruyor:
 
@@ -331,7 +331,7 @@ Type-hinting işlemini Python dilindeki standart veri tipleri ile yapabilirsin
 
 Yeni bir syntax'e alışmana gerek yok, metodlar ve classlar zaten spesifik kütüphanelere ait.
 
-Sadece standart **Python 3.6+**.
+Sadece standart **Python 3.8+**.
 
 Örnek olarak, `int` tanımlamak için:
 
diff --git a/docs/uk/docs/python-types.md b/docs/uk/docs/python-types.md
index f792e83a8..6c8e29016 100644
--- a/docs/uk/docs/python-types.md
+++ b/docs/uk/docs/python-types.md
@@ -164,7 +164,7 @@ John Doe
 
 Наприклад, давайте визначимо змінну, яка буде `list` із `str`.
 
-=== "Python 3.6 і вище"
+=== "Python 3.8 і вище"
 
     З модуля `typing`, імпортуємо `List` (з великої літери `L`):
 
@@ -218,7 +218,7 @@ John Doe
 
 Ви повинні зробити те ж саме, щоб оголосити `tuple` і `set`:
 
-=== "Python 3.6 і вище"
+=== "Python 3.8 і вище"
 
     ```Python hl_lines="1  4"
     {!> ../../../docs_src/python_types/tutorial007.py!}
@@ -243,7 +243,7 @@ John Doe
 
 Другий параметр типу для значення у `dict`:
 
-=== "Python 3.6 і вище"
+=== "Python 3.8 і вище"
 
     ```Python hl_lines="1  4"
     {!> ../../../docs_src/python_types/tutorial008.py!}
@@ -269,7 +269,7 @@ John Doe
 
 У Python 3.10 також є **альтернативний синтаксис**, у якому ви можете розділити можливі типи за допомогою <abbr title='також називають «побітовим "або" оператором», але це значення тут не актуальне'>вертикальної смуги (`|`)</abbr>.
 
-=== "Python 3.6 і вище"
+=== "Python 3.8 і вище"
 
     ```Python hl_lines="1  4"
     {!> ../../../docs_src/python_types/tutorial008b.py!}
@@ -299,13 +299,13 @@ John Doe
 
 Це також означає, що в Python 3.10 ви можете використовувати `Something | None`:
 
-=== "Python 3.6 і вище"
+=== "Python 3.8 і вище"
 
     ```Python hl_lines="1  4"
     {!> ../../../docs_src/python_types/tutorial009.py!}
     ```
 
-=== "Python 3.6 і вище - альтернатива"
+=== "Python 3.8 і вище - альтернатива"
 
     ```Python hl_lines="1  4"
     {!> ../../../docs_src/python_types/tutorial009b.py!}
@@ -321,7 +321,7 @@ John Doe
 
 Ці типи, які приймають параметри типу у квадратних дужках, називаються **Generic types** or **Generics**, наприклад:
 
-=== "Python 3.6 і вище"
+=== "Python 3.8 і вище"
 
     * `List`
     * `Tuple`
@@ -340,7 +340,7 @@ John Doe
     * `set`
     * `dict`
 
-    І те саме, що й у Python 3.6, із модуля `typing`:
+    І те саме, що й у Python 3.8, із модуля `typing`:
 
     * `Union`
     * `Optional`
@@ -355,10 +355,10 @@ John Doe
     * `set`
     * `dict`
 
-    І те саме, що й у Python 3.6, із модуля `typing`:
+    І те саме, що й у Python 3.8, із модуля `typing`:
 
     * `Union`
-    * `Optional` (так само як у Python 3.6)
+    * `Optional` (так само як у Python 3.8)
     * ...та інші.
 
     У Python 3.10, як альтернатива використанню `Union` та `Optional`, ви можете використовувати <abbr title='також називають «побітовим "або" оператором», але це значення тут не актуальне'>вертикальну смугу (`|`)</abbr> щоб оголосити об'єднання типів.
@@ -397,7 +397,7 @@ John Doe
 
 Приклад з документації Pydantic:
 
-=== "Python 3.6 і вище"
+=== "Python 3.8 і вище"
 
     ```Python
     {!> ../../../docs_src/python_types/tutorial011.py!}
diff --git a/docs/uk/docs/tutorial/body.md b/docs/uk/docs/tutorial/body.md
index e78c5de0e..9759e7f45 100644
--- a/docs/uk/docs/tutorial/body.md
+++ b/docs/uk/docs/tutorial/body.md
@@ -19,7 +19,7 @@
 
 Спочатку вам потрібно імпортувати `BaseModel` з `pydantic`:
 
-=== "Python 3.6 і вище"
+=== "Python 3.8 і вище"
 
     ```Python hl_lines="4"
     {!> ../../../docs_src/body/tutorial001.py!}
@@ -37,7 +37,7 @@
 
 Використовуйте стандартні типи Python для всіх атрибутів:
 
-=== "Python 3.6 і вище"
+=== "Python 3.8 і вище"
 
     ```Python hl_lines="7-11"
     {!> ../../../docs_src/body/tutorial001.py!}
@@ -75,7 +75,7 @@
 
 Щоб додати модель даних до вашої *операції шляху*, оголосіть її так само, як ви оголосили параметри шляху та запиту:
 
-=== "Python 3.6 і вище"
+=== "Python 3.8 і вище"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/body/tutorial001.py!}
@@ -149,7 +149,7 @@
 
 Усередині функції ви можете отримати прямий доступ до всіх атрибутів об’єкта моделі:
 
-=== "Python 3.6 і вище"
+=== "Python 3.8 і вище"
 
     ```Python hl_lines="21"
     {!> ../../../docs_src/body/tutorial002.py!}
@@ -167,7 +167,7 @@
 
 **FastAPI** розпізнає, що параметри функції, які відповідають параметрам шляху, мають бути **взяті з шляху**, а параметри функції, які оголошуються як моделі Pydantic, **взяті з тіла запиту**.
 
-=== "Python 3.6 і вище"
+=== "Python 3.8 і вище"
 
     ```Python hl_lines="17-18"
     {!> ../../../docs_src/body/tutorial003.py!}
@@ -185,7 +185,7 @@
 
 **FastAPI** розпізнає кожен з них і візьме дані з потрібного місця.
 
-=== "Python 3.6 і вище"
+=== "Python 3.8 і вище"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/body/tutorial004.py!}
diff --git a/docs/uk/docs/tutorial/cookie-params.md b/docs/uk/docs/tutorial/cookie-params.md
index 2b0e8993c..199b93839 100644
--- a/docs/uk/docs/tutorial/cookie-params.md
+++ b/docs/uk/docs/tutorial/cookie-params.md
@@ -18,7 +18,7 @@
     {!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3"
     {!> ../../../docs_src/cookie_params/tutorial001_an.py!}
@@ -33,7 +33,7 @@
     {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Бажано використовувати `Annotated` версію, якщо це можливо.
@@ -60,7 +60,7 @@
     {!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/cookie_params/tutorial001_an.py!}
@@ -75,7 +75,7 @@
     {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Бажано використовувати `Annotated` версію, якщо це можливо.
diff --git a/docs/uk/docs/tutorial/encoder.md b/docs/uk/docs/tutorial/encoder.md
index d660447b4..b6583341f 100644
--- a/docs/uk/docs/tutorial/encoder.md
+++ b/docs/uk/docs/tutorial/encoder.md
@@ -26,7 +26,7 @@
     {!> ../../../docs_src/encoder/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="5  22"
     {!> ../../../docs_src/encoder/tutorial001.py!}
diff --git a/docs/uk/docs/tutorial/extra-data-types.md b/docs/uk/docs/tutorial/extra-data-types.md
index ba75ee627..ec5ec0d18 100644
--- a/docs/uk/docs/tutorial/extra-data-types.md
+++ b/docs/uk/docs/tutorial/extra-data-types.md
@@ -67,7 +67,7 @@
     {!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  3  13-17"
     {!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
@@ -82,7 +82,7 @@
     {!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Бажано використовувати `Annotated` версію, якщо це можливо.
@@ -105,7 +105,7 @@
     {!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="19-20"
     {!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
@@ -120,7 +120,7 @@
     {!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Бажано використовувати `Annotated` версію, якщо це можливо.
diff --git a/docs/vi/docs/features.md b/docs/vi/docs/features.md
index 0599530e8..306aeb359 100644
--- a/docs/vi/docs/features.md
+++ b/docs/vi/docs/features.md
@@ -26,7 +26,7 @@ Tài liệu tương tác API và web giao diện người dùng. Là một frame
 
 ### Chỉ cần phiên bản Python hiện đại
 
-Tất cả được dựa trên khai báo kiểu dữ liệu chuẩn của **Python 3.6** (cảm ơn Pydantic). Bạn không cần học cú pháp mới, chỉ cần biết chuẩn Python hiện đại.
+Tất cả được dựa trên khai báo kiểu dữ liệu chuẩn của **Python 3.8** (cảm ơn Pydantic). Bạn không cần học cú pháp mới, chỉ cần biết chuẩn Python hiện đại.
 
 Nếu bạn cần 2 phút để làm mới lại cách sử dụng các kiểu dữ liệu mới của Python (thậm chí nếu bạn không sử dụng FastAPI), xem hướng dẫn ngắn: [Kiểu dữ liệu Python](python-types.md){.internal-link target=_blank}.
 
diff --git a/docs/vi/docs/index.md b/docs/vi/docs/index.md
index 0e773a011..3f416dbec 100644
--- a/docs/vi/docs/index.md
+++ b/docs/vi/docs/index.md
@@ -27,7 +27,7 @@
 
 ---
 
-FastAPI là một web framework hiện đại, hiệu năng cao để xây dựng web APIs với Python 3.7+ dựa trên tiêu chuẩn Python type hints.
+FastAPI là một web framework hiện đại, hiệu năng cao để xây dựng web APIs với Python 3.8+ dựa trên tiêu chuẩn Python type hints.
 
 Những tính năng như:
 
@@ -116,7 +116,7 @@ Nếu bạn đang xây dựng một <abbr title="Giao diện dòng lệnh">CLI</
 
 ## Yêu cầu
 
-Python 3.7+
+Python 3.8+
 
 FastAPI đứng trên vai những người khổng lồ:
 
@@ -332,7 +332,7 @@ Bạn định nghĩa bằng cách sử dụng các kiểu dữ liệu chuẩn c
 
 Bạn không phải học một cú pháp mới, các phương thức và class của một thư viện cụ thể nào.
 
-Chỉ cần sử dụng các chuẩn của **Python 3.7+**.
+Chỉ cần sử dụng các chuẩn của **Python 3.8+**.
 
 Ví dụ, với một tham số kiểu `int`:
 
diff --git a/docs/vi/docs/python-types.md b/docs/vi/docs/python-types.md
index 7f4f51131..4999caac3 100644
--- a/docs/vi/docs/python-types.md
+++ b/docs/vi/docs/python-types.md
@@ -182,7 +182,7 @@ Ví dụ, hãy định nghĩa một biến là `list` các `str`.
     {!> ../../../docs_src/python_types/tutorial006_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     Từ `typing`, import `List` (với chữ cái `L` viết hoa):
 
@@ -230,7 +230,7 @@ Bạn sẽ làm điều tương tự để khai báo các `tuple` và  các `set
     {!> ../../../docs_src/python_types/tutorial007_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  4"
     {!> ../../../docs_src/python_types/tutorial007.py!}
@@ -255,7 +255,7 @@ Tham số kiểu dữ liệu thứ hai dành cho giá trị của `dict`.
     {!> ../../../docs_src/python_types/tutorial008_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  4"
     {!> ../../../docs_src/python_types/tutorial008.py!}
@@ -284,7 +284,7 @@ Trong Python 3.10 cũng có một **cú pháp mới** mà bạn có thể đặt
     {!> ../../../docs_src/python_types/tutorial008b_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  4"
     {!> ../../../docs_src/python_types/tutorial008b.py!}
@@ -314,13 +314,13 @@ Sử dụng `Optional[str]` thay cho `str` sẽ cho phép trình soạn thảo g
     {!> ../../../docs_src/python_types/tutorial009_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  4"
     {!> ../../../docs_src/python_types/tutorial009.py!}
     ```
 
-=== "Python 3.6+ alternative"
+=== "Python 3.8+ alternative"
 
     ```Python hl_lines="1  4"
     {!> ../../../docs_src/python_types/tutorial009b.py!}
@@ -404,7 +404,7 @@ Những kiểu dữ liệu này lấy tham số kiểu dữ liệu trong dấu n
     * `Optional`
     * ...and others.
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     * `List`
     * `Tuple`
@@ -464,7 +464,7 @@ Một ví dụ từ tài liệu chính thức của Pydantic:
     {!> ../../../docs_src/python_types/tutorial011_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     {!> ../../../docs_src/python_types/tutorial011.py!}
@@ -493,7 +493,7 @@ Python cũng có một tính năng cho phép đặt **metadata bổ sung** trong
     {!> ../../../docs_src/python_types/tutorial013_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     Ở phiên bản dưới Python 3.9, bạn import `Annotated` từ `typing_extensions`.
 
diff --git a/docs/yo/docs/index.md b/docs/yo/docs/index.md
index ca75a6b13..101e13b6b 100644
--- a/docs/yo/docs/index.md
+++ b/docs/yo/docs/index.md
@@ -27,7 +27,7 @@
 
 ---
 
-FastAPI jẹ́ ìgbàlódé, tí ó yára (iṣẹ-giga), ìlànà wẹ́ẹ́bù fún kikọ àwọn API pẹ̀lú Python 3.7+ èyí tí ó da lori àwọn ìtọ́kasí àmì irúfẹ́ Python.
+FastAPI jẹ́ ìgbàlódé, tí ó yára (iṣẹ-giga), ìlànà wẹ́ẹ́bù fún kikọ àwọn API pẹ̀lú Python 3.8+ èyí tí ó da lori àwọn ìtọ́kasí àmì irúfẹ́ Python.
 
 Àwọn ẹya pàtàkì ni:
 
@@ -115,7 +115,7 @@ Ti o ba n kọ ohun èlò <abbr title="Command Line Interface">CLI</abbr> láti
 
 ## Èròjà
 
-Python 3.7+
+Python 3.8+
 
 FastAPI dúró lórí àwọn èjìká tí àwọn òmíràn:
 
@@ -331,7 +331,7 @@ O ṣe ìyẹn pẹ̀lú irúfẹ́ àmì ìtọ́kasí ìgbàlódé Python.
 
 O ò nílò láti kọ́ síńtáàsì tuntun, ìlànà tàbí ọ̀wọ́ kíláàsì kan pàtó, abbl (i.e. àti bẹbẹ lọ).
 
-Ìtọ́kasí **Python 3.7+**
+Ìtọ́kasí **Python 3.8+**
 
 Fún àpẹẹrẹ, fún `int`:
 
diff --git a/docs/zh/docs/advanced/generate-clients.md b/docs/zh/docs/advanced/generate-clients.md
index f3a58c062..e222e479c 100644
--- a/docs/zh/docs/advanced/generate-clients.md
+++ b/docs/zh/docs/advanced/generate-clients.md
@@ -22,7 +22,7 @@
     {!> ../../../docs_src/generate_clients/tutorial001_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9-11  14-15  18  19  23"
     {!> ../../../docs_src/generate_clients/tutorial001.py!}
@@ -134,7 +134,7 @@ frontend-app@1.0.0 generate-client /home/user/code/frontend-app
     {!> ../../../docs_src/generate_clients/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="23  28  36"
     {!> ../../../docs_src/generate_clients/tutorial002.py!}
@@ -191,7 +191,7 @@ FastAPI为每个*路径操作*使用一个**唯一ID**，它用于**操作ID**
     {!> ../../../docs_src/generate_clients/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="8-9  12"
     {!> ../../../docs_src/generate_clients/tutorial003.py!}
diff --git a/docs/zh/docs/advanced/settings.md b/docs/zh/docs/advanced/settings.md
index 597e99a77..7f718acef 100644
--- a/docs/zh/docs/advanced/settings.md
+++ b/docs/zh/docs/advanced/settings.md
@@ -223,13 +223,13 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp"uvicorn main:app
     {!> ../../../docs_src/settings/app02_an_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="6  12-13"
     {!> ../../../docs_src/settings/app02_an/main.py!}
     ```
 
-=== "Python 3.6+ 非注解版本"
+=== "Python 3.8+ 非注解版本"
 
     !!! tip
         如果可能，请尽量使用 `Annotated` 版本。
@@ -251,13 +251,13 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp"uvicorn main:app
     {!> ../../../docs_src/settings/app02_an_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17  19-21"
     {!> ../../../docs_src/settings/app02_an/main.py!}
     ```
 
-=== "Python 3.6+ 非注解版本"
+=== "Python 3.8+ 非注解版本"
 
     !!! tip
         如果可能，请尽量使用 `Annotated` 版本。
@@ -345,13 +345,13 @@ def get_settings():
     {!> ../../../docs_src/settings/app03_an_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  11"
     {!> ../../../docs_src/settings/app03_an/main.py!}
     ```
 
-=== "Python 3.6+ 非注解版本"
+=== "Python 3.8+ 非注解版本"
 
     !!! tip
         如果可能，请尽量使用 `Annotated` 版本。
diff --git a/docs/zh/docs/advanced/websockets.md b/docs/zh/docs/advanced/websockets.md
index a723487fd..a5cbdd965 100644
--- a/docs/zh/docs/advanced/websockets.md
+++ b/docs/zh/docs/advanced/websockets.md
@@ -118,7 +118,7 @@ $ uvicorn main:app --reload
     {!> ../../../docs_src/websockets/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="69-70  83"
     {!> ../../../docs_src/websockets/tutorial002_an.py!}
@@ -133,7 +133,7 @@ $ uvicorn main:app --reload
     {!> ../../../docs_src/websockets/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ 非带注解版本"
+=== "Python 3.8+ 非带注解版本"
 
     !!! tip
         如果可能，请尽量使用 `Annotated` 版本。
@@ -181,7 +181,7 @@ $ uvicorn main:app --reload
     {!> ../../../docs_src/websockets/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="81-83"
     {!> ../../../docs_src/websockets/tutorial003.py!}
diff --git a/docs/zh/docs/index.md b/docs/zh/docs/index.md
index 1de2a8d36..d776e5813 100644
--- a/docs/zh/docs/index.md
+++ b/docs/zh/docs/index.md
@@ -24,7 +24,7 @@
 
 ---
 
-FastAPI 是一个用于构建 API 的现代、快速（高性能）的 web 框架，使用 Python 3.6+ 并基于标准的 Python 类型提示。
+FastAPI 是一个用于构建 API 的现代、快速（高性能）的 web 框架，使用 Python 3.8+ 并基于标准的 Python 类型提示。
 
 关键特性:
 
@@ -107,7 +107,7 @@ FastAPI 是一个用于构建 API 的现代、快速（高性能）的 web 框
 
 ## 依赖
 
-Python 3.6 及更高版本
+Python 3.8 及更高版本
 
 FastAPI 站在以下巨人的肩膀之上：
 
@@ -323,7 +323,7 @@ def update_item(item_id: int, item: Item):
 
 你不需要去学习新的语法、了解特定库的方法或类，等等。
 
-只需要使用标准的 **Python 3.6 及更高版本**。
+只需要使用标准的 **Python 3.8 及更高版本**。
 
 举个例子，比如声明 `int` 类型：
 
diff --git a/docs/zh/docs/tutorial/background-tasks.md b/docs/zh/docs/tutorial/background-tasks.md
index c8568298b..94b75d4fd 100644
--- a/docs/zh/docs/tutorial/background-tasks.md
+++ b/docs/zh/docs/tutorial/background-tasks.md
@@ -69,7 +69,7 @@
     {!> ../../../docs_src/background_tasks/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="14  16  23  26"
     {!> ../../../docs_src/background_tasks/tutorial002_an.py!}
@@ -84,7 +84,7 @@
     {!> ../../../docs_src/background_tasks/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ 没Annotated"
+=== "Python 3.8+ 没Annotated"
 
     !!! tip
          尽可能选择使用 `Annotated` 的版本。
diff --git a/docs/zh/docs/tutorial/body-fields.md b/docs/zh/docs/tutorial/body-fields.md
index c153784dc..fb6c6d9b6 100644
--- a/docs/zh/docs/tutorial/body-fields.md
+++ b/docs/zh/docs/tutorial/body-fields.md
@@ -18,7 +18,7 @@
     {!> ../../../docs_src/body_fields/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4"
     {!> ../../../docs_src/body_fields/tutorial001_an.py!}
@@ -33,7 +33,7 @@
     {!> ../../../docs_src/body_fields/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         尽可能选择使用 `Annotated` 的版本。
@@ -61,7 +61,7 @@
     {!> ../../../docs_src/body_fields/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12-15"
     {!> ../../../docs_src/body_fields/tutorial001_an.py!}
@@ -76,7 +76,7 @@
     {!> ../../../docs_src/body_fields/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/docs/zh/docs/tutorial/body-multiple-params.md b/docs/zh/docs/tutorial/body-multiple-params.md
index ee2cba6df..c93ef2f5c 100644
--- a/docs/zh/docs/tutorial/body-multiple-params.md
+++ b/docs/zh/docs/tutorial/body-multiple-params.md
@@ -20,7 +20,7 @@
     {!> ../../../docs_src/body_multiple_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="19-21"
     {!> ../../../docs_src/body_multiple_params/tutorial001_an.py!}
@@ -35,7 +35,7 @@
     {!> ../../../docs_src/body_multiple_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         尽可能选择使用 `Annotated` 的版本。
@@ -68,7 +68,7 @@
     {!> ../../../docs_src/body_multiple_params/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="22"
     {!> ../../../docs_src/body_multiple_params/tutorial002.py!}
@@ -124,7 +124,7 @@
     {!> ../../../docs_src/body_multiple_params/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24"
     {!> ../../../docs_src/body_multiple_params/tutorial003_an.py!}
@@ -139,7 +139,7 @@
     {!> ../../../docs_src/body_multiple_params/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         尽可能选择使用 `Annotated` 的版本。
@@ -193,7 +193,7 @@ q: str = None
     {!> ../../../docs_src/body_multiple_params/tutorial004_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="28"
     {!> ../../../docs_src/body_multiple_params/tutorial004_an.py!}
@@ -208,7 +208,7 @@ q: str = None
     {!> ../../../docs_src/body_multiple_params/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         尽可能选择使用 `Annotated` 的版本。
@@ -247,7 +247,7 @@ item: Item = Body(embed=True)
     {!> ../../../docs_src/body_multiple_params/tutorial005_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/body_multiple_params/tutorial005_an.py!}
@@ -262,7 +262,7 @@ item: Item = Body(embed=True)
     {!> ../../../docs_src/body_multiple_params/tutorial005_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         尽可能选择使用 `Annotated` 的版本。
diff --git a/docs/zh/docs/tutorial/body-nested-models.md b/docs/zh/docs/tutorial/body-nested-models.md
index 7704d2624..c65308bef 100644
--- a/docs/zh/docs/tutorial/body-nested-models.md
+++ b/docs/zh/docs/tutorial/body-nested-models.md
@@ -12,7 +12,7 @@
     {!> ../../../docs_src/body_nested_models/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="14"
     {!> ../../../docs_src/body_nested_models/tutorial001.py!}
@@ -63,7 +63,7 @@ my_list: List[str]
     {!> ../../../docs_src/body_nested_models/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="14"
     {!> ../../../docs_src/body_nested_models/tutorial002.py!}
@@ -89,7 +89,7 @@ Python 具有一种特殊的数据类型来保存一组唯一的元素，即 `se
     {!> ../../../docs_src/body_nested_models/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  14"
     {!> ../../../docs_src/body_nested_models/tutorial003.py!}
@@ -127,7 +127,7 @@ Pydantic 模型的每个属性都具有类型。
     {!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9-11"
     {!> ../../../docs_src/body_nested_models/tutorial004.py!}
@@ -149,7 +149,7 @@ Pydantic 模型的每个属性都具有类型。
     {!> ../../../docs_src/body_nested_models/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20"
     {!> ../../../docs_src/body_nested_models/tutorial004.py!}
@@ -198,7 +198,7 @@ Pydantic 模型的每个属性都具有类型。
     {!> ../../../docs_src/body_nested_models/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4  10"
     {!> ../../../docs_src/body_nested_models/tutorial005.py!}
@@ -222,7 +222,7 @@ Pydantic 模型的每个属性都具有类型。
     {!> ../../../docs_src/body_nested_models/tutorial006_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="20"
     {!> ../../../docs_src/body_nested_models/tutorial006.py!}
@@ -273,7 +273,7 @@ Pydantic 模型的每个属性都具有类型。
     {!> ../../../docs_src/body_nested_models/tutorial007_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  14  20  23  27"
     {!> ../../../docs_src/body_nested_models/tutorial007.py!}
@@ -298,7 +298,7 @@ images: List[Image]
     {!> ../../../docs_src/body_nested_models/tutorial008_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15"
     {!> ../../../docs_src/body_nested_models/tutorial008.py!}
@@ -338,7 +338,7 @@ images: List[Image]
     {!> ../../../docs_src/body_nested_models/tutorial009_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/body_nested_models/tutorial009.py!}
diff --git a/docs/zh/docs/tutorial/body.md b/docs/zh/docs/tutorial/body.md
index d00c96dc3..5cf53c0c2 100644
--- a/docs/zh/docs/tutorial/body.md
+++ b/docs/zh/docs/tutorial/body.md
@@ -23,7 +23,7 @@
     {!> ../../../docs_src/body/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4"
     {!> ../../../docs_src/body/tutorial001.py!}
@@ -41,7 +41,7 @@
     {!> ../../../docs_src/body/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="7-11"
     {!> ../../../docs_src/body/tutorial001.py!}
@@ -79,7 +79,7 @@
     {!> ../../../docs_src/body/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/body/tutorial001.py!}
@@ -142,7 +142,7 @@ Pydantic 本身甚至也进行了一些更改以支持此功能。
     {!> ../../../docs_src/body/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="21"
     {!> ../../../docs_src/body/tutorial002.py!}
@@ -160,7 +160,7 @@ Pydantic 本身甚至也进行了一些更改以支持此功能。
     {!> ../../../docs_src/body/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17-18"
     {!> ../../../docs_src/body/tutorial003.py!}
@@ -178,7 +178,7 @@ Pydantic 本身甚至也进行了一些更改以支持此功能。
     {!> ../../../docs_src/body/tutorial004_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/body/tutorial004.py!}
diff --git a/docs/zh/docs/tutorial/cookie-params.md b/docs/zh/docs/tutorial/cookie-params.md
index 470fd8e82..f115f9677 100644
--- a/docs/zh/docs/tutorial/cookie-params.md
+++ b/docs/zh/docs/tutorial/cookie-params.md
@@ -18,7 +18,7 @@
     {!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3"
     {!> ../../../docs_src/cookie_params/tutorial001_an.py!}
@@ -33,7 +33,7 @@
     {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         尽可能选择使用 `Annotated` 的版本。
@@ -61,7 +61,7 @@
     {!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/cookie_params/tutorial001_an.py!}
@@ -76,7 +76,7 @@
     {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         尽可能选择使用 `Annotated` 的版本。
diff --git a/docs/zh/docs/tutorial/dependencies/classes-as-dependencies.md b/docs/zh/docs/tutorial/dependencies/classes-as-dependencies.md
index f404820df..1866da298 100644
--- a/docs/zh/docs/tutorial/dependencies/classes-as-dependencies.md
+++ b/docs/zh/docs/tutorial/dependencies/classes-as-dependencies.md
@@ -12,7 +12,7 @@
     {!> ../../../docs_src/dependencies/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/dependencies/tutorial001.py!}
@@ -85,7 +85,7 @@ fluffy = Cat(name="Mr Fluffy")
     {!> ../../../docs_src/dependencies/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11-15"
     {!> ../../../docs_src/dependencies/tutorial002.py!}
diff --git a/docs/zh/docs/tutorial/encoder.md b/docs/zh/docs/tutorial/encoder.md
index 76ed846ce..859ebc2e8 100644
--- a/docs/zh/docs/tutorial/encoder.md
+++ b/docs/zh/docs/tutorial/encoder.md
@@ -26,7 +26,7 @@
     {!> ../../../docs_src/encoder/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="5  22"
     {!> ../../../docs_src/encoder/tutorial001.py!}
diff --git a/docs/zh/docs/tutorial/extra-data-types.md b/docs/zh/docs/tutorial/extra-data-types.md
index 76d606903..a74efa61b 100644
--- a/docs/zh/docs/tutorial/extra-data-types.md
+++ b/docs/zh/docs/tutorial/extra-data-types.md
@@ -67,7 +67,7 @@
     {!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  3  13-17"
     {!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
@@ -82,7 +82,7 @@
     {!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         尽可能选择使用 `Annotated` 的版本。
@@ -105,7 +105,7 @@
     {!> ../../../docs_src/extra_data_types/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="19-20"
     {!> ../../../docs_src/extra_data_types/tutorial001_an.py!}
@@ -120,7 +120,7 @@
     {!> ../../../docs_src/extra_data_types/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         尽可能选择使用 `Annotated` 的版本。
diff --git a/docs/zh/docs/tutorial/extra-models.md b/docs/zh/docs/tutorial/extra-models.md
index 32f8f9df1..06427a73d 100644
--- a/docs/zh/docs/tutorial/extra-models.md
+++ b/docs/zh/docs/tutorial/extra-models.md
@@ -23,7 +23,7 @@
     {!> ../../../docs_src/extra_models/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  11  16  22  24  29-30  33-35  40-41"
     {!> ../../../docs_src/extra_models/tutorial001.py!}
@@ -164,7 +164,7 @@ UserInDB(
     {!> ../../../docs_src/extra_models/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  15-16  19-20  23-24"
     {!> ../../../docs_src/extra_models/tutorial002.py!}
@@ -188,7 +188,7 @@ UserInDB(
     {!> ../../../docs_src/extra_models/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  14-15  18-20  33"
     {!> ../../../docs_src/extra_models/tutorial003.py!}
@@ -206,7 +206,7 @@ UserInDB(
     {!> ../../../docs_src/extra_models/tutorial004_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  20"
     {!> ../../../docs_src/extra_models/tutorial004.py!}
@@ -226,7 +226,7 @@ UserInDB(
     {!> ../../../docs_src/extra_models/tutorial005_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="1  8"
     {!> ../../../docs_src/extra_models/tutorial005.py!}
diff --git a/docs/zh/docs/tutorial/header-params.md b/docs/zh/docs/tutorial/header-params.md
index 22ff6dc27..2701167b3 100644
--- a/docs/zh/docs/tutorial/header-params.md
+++ b/docs/zh/docs/tutorial/header-params.md
@@ -18,7 +18,7 @@
     {!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3"
     {!> ../../../docs_src/header_params/tutorial001_an.py!}
@@ -33,7 +33,7 @@
     {!> ../../../docs_src/header_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         尽可能选择使用 `Annotated` 的版本。
@@ -60,7 +60,7 @@
     {!> ../../../docs_src/header_params/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/header_params/tutorial001_an.py!}
@@ -75,7 +75,7 @@
     {!> ../../../docs_src/header_params/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         尽可能选择使用 `Annotated` 的版本。
@@ -120,7 +120,7 @@
     {!> ../../../docs_src/header_params/tutorial002_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="12"
     {!> ../../../docs_src/header_params/tutorial002_an.py!}
@@ -135,7 +135,7 @@
     {!> ../../../docs_src/header_params/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         尽可能选择使用 `Annotated` 的版本。
@@ -170,7 +170,7 @@
     {!> ../../../docs_src/header_params/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10"
     {!> ../../../docs_src/header_params/tutorial003_an.py!}
@@ -194,7 +194,7 @@
     {!> ../../../docs_src/header_params/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         尽可能选择使用 `Annotated` 的版本。
diff --git a/docs/zh/docs/tutorial/path-params-numeric-validations.md b/docs/zh/docs/tutorial/path-params-numeric-validations.md
index 78fa922b4..9b41ad7cf 100644
--- a/docs/zh/docs/tutorial/path-params-numeric-validations.md
+++ b/docs/zh/docs/tutorial/path-params-numeric-validations.md
@@ -18,7 +18,7 @@
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3-4"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
@@ -33,7 +33,7 @@
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         尽可能选择使用 `Annotated` 的版本。
@@ -60,7 +60,7 @@
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="11"
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_an.py!}
@@ -75,7 +75,7 @@
     {!> ../../../docs_src/path_params_numeric_validations/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         尽可能选择使用 `Annotated` 的版本。
@@ -107,7 +107,7 @@
 
 因此，你可以将函数声明为：
 
-=== "Python 3.6 non-Annotated"
+=== "Python 3.8 non-Annotated"
 
     !!! tip
         尽可能选择使用 `Annotated` 的版本。
diff --git a/docs/zh/docs/tutorial/query-params-str-validations.md b/docs/zh/docs/tutorial/query-params-str-validations.md
index 7244aeade..39253eb0d 100644
--- a/docs/zh/docs/tutorial/query-params-str-validations.md
+++ b/docs/zh/docs/tutorial/query-params-str-validations.md
@@ -10,7 +10,7 @@
     {!> ../../../docs_src/query_params_str_validations/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/query_params_str_validations/tutorial001.py!}
diff --git a/docs/zh/docs/tutorial/request-files.md b/docs/zh/docs/tutorial/request-files.md
index 03474907e..2c48f33ca 100644
--- a/docs/zh/docs/tutorial/request-files.md
+++ b/docs/zh/docs/tutorial/request-files.md
@@ -130,7 +130,7 @@ contents = myfile.file.read()
     {!> ../../../docs_src/request_files/tutorial001_02_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  17"
     {!> ../../../docs_src/request_files/tutorial001_02.py!}
@@ -158,7 +158,7 @@ FastAPI 支持同时上传多个文件。
     {!> ../../../docs_src/request_files/tutorial002_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="10  15"
     {!> ../../../docs_src/request_files/tutorial002.py!}
@@ -183,7 +183,7 @@ FastAPI 支持同时上传多个文件。
     {!> ../../../docs_src/request_files/tutorial003_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="18"
     {!> ../../../docs_src/request_files/tutorial003.py!}
diff --git a/docs/zh/docs/tutorial/response-model.md b/docs/zh/docs/tutorial/response-model.md
index f529cb0d8..e731b6989 100644
--- a/docs/zh/docs/tutorial/response-model.md
+++ b/docs/zh/docs/tutorial/response-model.md
@@ -20,7 +20,7 @@
     {!> ../../../docs_src/response_model/tutorial001_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="17  22  24-27"
     {!> ../../../docs_src/response_model/tutorial001.py!}
@@ -78,7 +78,7 @@ FastAPI 将使用此 `response_model` 来：
     {!> ../../../docs_src/response_model/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9  11  16"
     {!> ../../../docs_src/response_model/tutorial003.py!}
@@ -92,7 +92,7 @@ FastAPI 将使用此 `response_model` 来：
     {!> ../../../docs_src/response_model/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24"
     {!> ../../../docs_src/response_model/tutorial003.py!}
@@ -106,7 +106,7 @@ FastAPI 将使用此 `response_model` 来：
     {!> ../../../docs_src/response_model/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="22"
     {!> ../../../docs_src/response_model/tutorial003.py!}
diff --git a/docs/zh/docs/tutorial/schema-extra-example.md b/docs/zh/docs/tutorial/schema-extra-example.md
index 816e8f68e..ebc04da8b 100644
--- a/docs/zh/docs/tutorial/schema-extra-example.md
+++ b/docs/zh/docs/tutorial/schema-extra-example.md
@@ -16,7 +16,7 @@
     {!> ../../../docs_src/schema_extra_example/tutorial001_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15-23"
     {!> ../../../docs_src/schema_extra_example/tutorial001.py!}
@@ -34,7 +34,7 @@
     {!> ../../../docs_src/schema_extra_example/tutorial002_py310.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="4  10-13"
     {!> ../../../docs_src/schema_extra_example/tutorial002.py!}
@@ -61,7 +61,7 @@
     {!> ../../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="23-28"
     {!> ../../../docs_src/schema_extra_example/tutorial003_an.py!}
@@ -76,7 +76,7 @@
     {!> ../../../docs_src/schema_extra_example/tutorial003_py310.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         尽可能选择使用 `Annotated` 的版本。
diff --git a/docs/zh/docs/tutorial/security/first-steps.md b/docs/zh/docs/tutorial/security/first-steps.md
index 7b1052e12..dda956417 100644
--- a/docs/zh/docs/tutorial/security/first-steps.md
+++ b/docs/zh/docs/tutorial/security/first-steps.md
@@ -26,13 +26,13 @@
     {!> ../../../docs_src/security/tutorial001_an_py39.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     {!> ../../../docs_src/security/tutorial001_an.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         尽可能选择使用 `Annotated` 的版本。
diff --git a/docs/zh/docs/tutorial/sql-databases.md b/docs/zh/docs/tutorial/sql-databases.md
index 482588f94..8b09dc677 100644
--- a/docs/zh/docs/tutorial/sql-databases.md
+++ b/docs/zh/docs/tutorial/sql-databases.md
@@ -258,7 +258,7 @@ connect_args={"check_same_thread": False}
     {!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="3  6-8  11-12  23-24  27-28"
     {!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
@@ -302,7 +302,7 @@ name: str
     {!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15-17  31-34"
     {!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
@@ -331,7 +331,7 @@ name: str
     {!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15  19-20  31  36-37"
     {!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
@@ -471,7 +471,7 @@ current_user.items
     {!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="9"
     {!> ../../../docs_src/sql_databases/sql_app/main.py!}
@@ -505,7 +505,7 @@ current_user.items
     {!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="15-20"
     {!> ../../../docs_src/sql_databases/sql_app/main.py!}
@@ -530,7 +530,7 @@ current_user.items
     {!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="24  32  38  47  53"
     {!> ../../../docs_src/sql_databases/sql_app/main.py!}
@@ -551,7 +551,7 @@ current_user.items
     {!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="23-28  31-34  37-42  45-49  52-55"
     {!> ../../../docs_src/sql_databases/sql_app/main.py!}
@@ -650,7 +650,7 @@ def read_user(user_id: int, db: Session = Depends(get_db)):
     {!> ../../../docs_src/sql_databases/sql_app_py39/schemas.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     {!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
@@ -670,7 +670,7 @@ def read_user(user_id: int, db: Session = Depends(get_db)):
     {!> ../../../docs_src/sql_databases/sql_app_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     {!> ../../../docs_src/sql_databases/sql_app/main.py!}
@@ -729,7 +729,7 @@ $ uvicorn sql_app.main:app --reload
     {!> ../../../docs_src/sql_databases/sql_app_py39/alt_main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python hl_lines="14-22"
     {!> ../../../docs_src/sql_databases/sql_app/alt_main.py!}
diff --git a/docs/zh/docs/tutorial/testing.md b/docs/zh/docs/tutorial/testing.md
index 41f01f8d8..77fff7596 100644
--- a/docs/zh/docs/tutorial/testing.md
+++ b/docs/zh/docs/tutorial/testing.md
@@ -122,7 +122,7 @@
     {!> ../../../docs_src/app_testing/app_b_an_py39/main.py!}
     ```
 
-=== "Python 3.6+"
+=== "Python 3.8+"
 
     ```Python
     {!> ../../../docs_src/app_testing/app_b_an/main.py!}
@@ -137,7 +137,7 @@
     {!> ../../../docs_src/app_testing/app_b_py310/main.py!}
     ```
 
-=== "Python 3.6+ non-Annotated"
+=== "Python 3.8+ non-Annotated"
 
     !!! tip
         Prefer to use the `Annotated` version if possible.
diff --git a/pyproject.toml b/pyproject.toml
index 2870b31a5..b49f472d5 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 name = "fastapi"
 description = "FastAPI framework, high performance, easy to learn, fast to code, ready for production"
 readme = "README.md"
-requires-python = ">=3.7"
+requires-python = ">=3.8"
 license = "MIT"
 authors = [
     { name = "Sebastián Ramírez", email = "tiangolo@gmail.com" },
@@ -32,7 +32,6 @@ classifiers = [
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.7",
     "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",

From 4ef8c3286dca34ef5821eadd6e692044169beb80 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 17 Oct 2023 05:59:55 +0000
Subject: [PATCH 214/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 3c7ecad43..b7fe5a640 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ⬆️ Drop support for Python 3.7, require Python 3.8 or above. PR [#10442](https://github.com/tiangolo/fastapi/pull/10442) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, Bump.sh images. PR [#10381](https://github.com/tiangolo/fastapi/pull/10381) by [@tiangolo](https://github.com/tiangolo).
 * 👥 Update FastAPI People. PR [#10363](https://github.com/tiangolo/fastapi/pull/10363) by [@tiangolo](https://github.com/tiangolo).
 ## 0.103.2

From 6b0c77e554ff6462696159899b9fe710a5d6a8fc Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 17 Oct 2023 11:18:40 +0400
Subject: [PATCH 215/317] =?UTF-8?q?=E2=AC=86=20Bump=20pypa/gh-action-pypi-?=
 =?UTF-8?q?publish=20from=201.8.6=20to=201.8.10=20(#10061)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Bumps [pypa/gh-action-pypi-publish](https://github.com/pypa/gh-action-pypi-publish) from 1.8.6 to 1.8.10.
- [Release notes](https://github.com/pypa/gh-action-pypi-publish/releases)
- [Commits](https://github.com/pypa/gh-action-pypi-publish/compare/v1.8.6...v1.8.10)

---
updated-dependencies:
- dependency-name: pypa/gh-action-pypi-publish
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/publish.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 5ab0603b9..faa46d751 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -32,7 +32,7 @@ jobs:
       - name: Build distribution
         run: python -m build
       - name: Publish
-        uses: pypa/gh-action-pypi-publish@v1.8.6
+        uses: pypa/gh-action-pypi-publish@v1.8.10
         with:
           password: ${{ secrets.PYPI_API_TOKEN }}
       - name: Dump GitHub context

From e5fd92a7aba2ce9e3eebce1d683f10858cbbfb34 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 17 Oct 2023 07:19:26 +0000
Subject: [PATCH 216/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b7fe5a640..f4d546900 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ⬆ Bump pypa/gh-action-pypi-publish from 1.8.6 to 1.8.10. PR [#10061](https://github.com/tiangolo/fastapi/pull/10061) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆️ Drop support for Python 3.7, require Python 3.8 or above. PR [#10442](https://github.com/tiangolo/fastapi/pull/10442) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, Bump.sh images. PR [#10381](https://github.com/tiangolo/fastapi/pull/10381) by [@tiangolo](https://github.com/tiangolo).
 * 👥 Update FastAPI People. PR [#10363](https://github.com/tiangolo/fastapi/pull/10363) by [@tiangolo](https://github.com/tiangolo).

From d03373f3e803e637017fe4807cbefd08d218f8e0 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 17 Oct 2023 11:19:41 +0400
Subject: [PATCH 217/317] =?UTF-8?q?=E2=AC=86=20Bump=20actions/checkout=20f?=
 =?UTF-8?q?rom=203=20to=204=20(#10208)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Bumps [actions/checkout](https://github.com/actions/checkout) from 3 to 4.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v3...v4)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/build-docs.yml          | 6 +++---
 .github/workflows/deploy-docs.yml         | 2 +-
 .github/workflows/latest-changes.yml      | 2 +-
 .github/workflows/notify-translations.yml | 2 +-
 .github/workflows/people.yml              | 2 +-
 .github/workflows/publish.yml             | 2 +-
 .github/workflows/test.yml                | 6 +++---
 7 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/.github/workflows/build-docs.yml b/.github/workflows/build-docs.yml
index dedf23fb9..a1ce0860a 100644
--- a/.github/workflows/build-docs.yml
+++ b/.github/workflows/build-docs.yml
@@ -17,7 +17,7 @@ jobs:
     outputs:
       docs: ${{ steps.filter.outputs.docs }}
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     # For pull requests it's not necessary to checkout the code but for master it is
     - uses: dorny/paths-filter@v2
       id: filter
@@ -35,7 +35,7 @@ jobs:
     outputs:
       langs: ${{ steps.show-langs.outputs.langs }}
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Set up Python
         uses: actions/setup-python@v4
         with:
@@ -71,7 +71,7 @@ jobs:
         env:
           GITHUB_CONTEXT: ${{ toJson(github) }}
         run: echo "$GITHUB_CONTEXT"
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Set up Python
         uses: actions/setup-python@v4
         with:
diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
index dcd6d7107..8af8ba827 100644
--- a/.github/workflows/deploy-docs.yml
+++ b/.github/workflows/deploy-docs.yml
@@ -14,7 +14,7 @@ jobs:
         env:
           GITHUB_CONTEXT: ${{ toJson(github) }}
         run: echo "$GITHUB_CONTEXT"
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Clean site
         run: |
           rm -rf ./site
diff --git a/.github/workflows/latest-changes.yml b/.github/workflows/latest-changes.yml
index e38870f46..ffec5ee5e 100644
--- a/.github/workflows/latest-changes.yml
+++ b/.github/workflows/latest-changes.yml
@@ -24,7 +24,7 @@ jobs:
         env:
           GITHUB_CONTEXT: ${{ toJson(github) }}
         run: echo "$GITHUB_CONTEXT"
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           # To allow latest-changes to commit to the main branch
           token: ${{ secrets.FASTAPI_LATEST_CHANGES }}
diff --git a/.github/workflows/notify-translations.yml b/.github/workflows/notify-translations.yml
index 44ee83ec0..c0904ce48 100644
--- a/.github/workflows/notify-translations.yml
+++ b/.github/workflows/notify-translations.yml
@@ -23,7 +23,7 @@ jobs:
         env:
           GITHUB_CONTEXT: ${{ toJson(github) }}
         run: echo "$GITHUB_CONTEXT"
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       # Allow debugging with tmate
       - name: Setup tmate session
         uses: mxschmitt/action-tmate@v3
diff --git a/.github/workflows/people.yml b/.github/workflows/people.yml
index 4480a1427..b0868771d 100644
--- a/.github/workflows/people.yml
+++ b/.github/workflows/people.yml
@@ -19,7 +19,7 @@ jobs:
         env:
           GITHUB_CONTEXT: ${{ toJson(github) }}
         run: echo "$GITHUB_CONTEXT"
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       # Ref: https://github.com/actions/runner/issues/2033
       - name: Fix git safe.directory in container
         run: mkdir -p /home/runner/work/_temp/_github_home && printf "[safe]\n\tdirectory = /github/workspace" > /home/runner/work/_temp/_github_home/.gitconfig
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index faa46d751..8cbd01b92 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -13,7 +13,7 @@ jobs:
         env:
           GITHUB_CONTEXT: ${{ toJson(github) }}
         run: echo "$GITHUB_CONTEXT"
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Set up Python
         uses: actions/setup-python@v4
         with:
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 769b52021..7eccaa0ac 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -17,7 +17,7 @@ jobs:
         env:
           GITHUB_CONTEXT: ${{ toJson(github) }}
         run: echo "$GITHUB_CONTEXT"
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Set up Python
         uses: actions/setup-python@v4
         with:
@@ -50,7 +50,7 @@ jobs:
         env:
           GITHUB_CONTEXT: ${{ toJson(github) }}
         run: echo "$GITHUB_CONTEXT"
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Set up Python
         uses: actions/setup-python@v4
         with:
@@ -92,7 +92,7 @@ jobs:
         env:
           GITHUB_CONTEXT: ${{ toJson(github) }}
         run: echo "$GITHUB_CONTEXT"
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - uses: actions/setup-python@v4
         with:
           python-version: '3.8'

From 89e741765250b907b846192069e05f91d50bcaaa Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 17 Oct 2023 11:20:09 +0400
Subject: [PATCH 218/317] =?UTF-8?q?=E2=AC=86=20Bump=20dawidd6/action-downl?=
 =?UTF-8?q?oad-artifact=20from=202.27.0=20to=202.28.0=20(#10268)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Bumps [dawidd6/action-download-artifact](https://github.com/dawidd6/action-download-artifact) from 2.27.0 to 2.28.0.
- [Release notes](https://github.com/dawidd6/action-download-artifact/releases)
- [Commits](https://github.com/dawidd6/action-download-artifact/compare/v2.27.0...v2.28.0)

---
updated-dependencies:
- dependency-name: dawidd6/action-download-artifact
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/deploy-docs.yml | 2 +-
 .github/workflows/smokeshow.yml   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
index 8af8ba827..155ebd0a8 100644
--- a/.github/workflows/deploy-docs.yml
+++ b/.github/workflows/deploy-docs.yml
@@ -21,7 +21,7 @@ jobs:
           mkdir ./site
       - name: Download Artifact Docs
         id: download
-        uses: dawidd6/action-download-artifact@v2.27.0
+        uses: dawidd6/action-download-artifact@v2.28.0
         with:
           if_no_artifact_found: ignore
           github_token: ${{ secrets.FASTAPI_PREVIEW_DOCS_DOWNLOAD_ARTIFACTS }}
diff --git a/.github/workflows/smokeshow.yml b/.github/workflows/smokeshow.yml
index 4e689d95c..38b44c413 100644
--- a/.github/workflows/smokeshow.yml
+++ b/.github/workflows/smokeshow.yml
@@ -24,7 +24,7 @@ jobs:
 
       - run: pip install smokeshow
 
-      - uses: dawidd6/action-download-artifact@v2.27.0
+      - uses: dawidd6/action-download-artifact@v2.28.0
         with:
           github_token: ${{ secrets.FASTAPI_SMOKESHOW_DOWNLOAD_ARTIFACTS }}
           workflow: test.yml

From 912e4bb90603860fd5d7dd759c3db02dbfd1addc Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 17 Oct 2023 07:20:20 +0000
Subject: [PATCH 219/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f4d546900..7be1eda35 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ⬆ Bump actions/checkout from 3 to 4. PR [#10208](https://github.com/tiangolo/fastapi/pull/10208) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ Bump pypa/gh-action-pypi-publish from 1.8.6 to 1.8.10. PR [#10061](https://github.com/tiangolo/fastapi/pull/10061) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆️ Drop support for Python 3.7, require Python 3.8 or above. PR [#10442](https://github.com/tiangolo/fastapi/pull/10442) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, Bump.sh images. PR [#10381](https://github.com/tiangolo/fastapi/pull/10381) by [@tiangolo](https://github.com/tiangolo).

From 3fa44aabe37362d4640403d9571897ea7dd5cf9b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 17 Oct 2023 07:20:59 +0000
Subject: [PATCH 220/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 7be1eda35..4222c4400 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -2,6 +2,7 @@
 
 ## Latest Changes
 
+* ⬆ Bump dawidd6/action-download-artifact from 2.27.0 to 2.28.0. PR [#10268](https://github.com/tiangolo/fastapi/pull/10268) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ Bump actions/checkout from 3 to 4. PR [#10208](https://github.com/tiangolo/fastapi/pull/10208) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ Bump pypa/gh-action-pypi-publish from 1.8.6 to 1.8.10. PR [#10061](https://github.com/tiangolo/fastapi/pull/10061) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆️ Drop support for Python 3.7, require Python 3.8 or above. PR [#10442](https://github.com/tiangolo/fastapi/pull/10442) by [@tiangolo](https://github.com/tiangolo).

From 05ca41cfd1c56157cf5bd2b3c1958263bdd71611 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 18 Oct 2023 16:36:40 +0400
Subject: [PATCH 221/317] =?UTF-8?q?=E2=9C=A8=20Add=20reference=20(code=20A?=
 =?UTF-8?q?PI)=20docs=20with=20PEP=20727,=20add=20subclass=20with=20custom?=
 =?UTF-8?q?=20docstrings=20for=20`BackgroundTasks`,=20refactor=20docs=20st?=
 =?UTF-8?q?ructure=20(#10392)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* ➕ Add mkdocstrings and griffe-typingdoc to dependencies

* 🔧 Add mkdocstrings configs to MkDocs

* 📝 Add first WIP reference page

* ⬆️ Upgrade typing-extensions to the minimum version including Doc()

* 📝 Add docs to FastAPI parameters

* 📝 Add docstrings for OpenAPI docs utils

* 📝 Add docstrings for security utils

* 📝 Add docstrings for UploadFile

* 📝 Update docstrings in FastAPI class

* 📝 Add docstrings for path operation methods

* 📝 Add docstring for jsonable_encoder

* 📝 Add docstrings for exceptions

* 📝 Add docstsrings for parameter functions

* 📝 Add docstrings for responses

* 📝 Add docstrings for APIRouter

* ♻️ Sub-class BackgroundTasks to document it with docstrings

* 📝 Update usage of background tasks in dependencies

* ✅ Update tests with new deprecation warnings

* 📝 Add new reference docs

* 🔧 Update MkDocs with new reference docs

* ✅ Update pytest fixture, deprecation is raised only once

* 🎨 Update format for types in exceptions.py

* ♻️ Update annotations in BackgroundTask, `Annotated` can't take ParamSpec's P.args or P.kwargs

* ✏️ Fix typos caught by @pawamoy

* 🔧 Update and fix MkDocstrings configs from @pawamoy tips

* 📝 Update reference docs

* ✏️ Fix typos found by @pawamoy

* ➕ Add HTTPX as a dependency for docs, for the TestClient

* 🔧 Update MkDocs config, rename websockets reference

* 🔇 Add type-ignores for Doc as the stubs haven't been released for mypy

* 🔥 Remove duplicated deprecated notice

* 🔇 Remove typing error for unreleased stub in openapi/docs.py

* ✅ Add tests for UploadFile for coverage

* ⬆️ Upgrade griffe-typingdoc==0.2.2

* 📝 Refactor docs structure

* 🔨 Update README generation with new index frontmatter and style

* 🔨 Update generation of languages, remove from top menu, keep in lang menu

* 📝 Add OpenAPI Pydantic models

* 🔨 Update docs script to not translate Reference and Release Notes

* 🔧 Add reference for OpenAPI models

* 🔧 Update MkDocs config for mkdocstrings insiders

* 👷 Install mkdocstring insiders in CI for docs

* 🐛 Fix MkDocstrings insiders install URL

* ➕ Move dependencies shared by docs and tests to its own requirements file

* 👷 Update cache keys for test and docs dependencies

* 📝 Remove no longer needed __init__ placeholder docstrings

* 📝 Move docstring for APIRouter to the class level (not __init__ level)

* 🔥 Remove no longer needed dummy placeholder __init__ docstring
---
 .github/workflows/build-docs.yml              |   14 +-
 .github/workflows/test.yml                    |    4 +-
 docs/en/docs/about/index.md                   |    3 +
 docs/en/docs/fastapi-people.md                |    5 +
 docs/en/docs/features.md                      |    5 +
 docs/en/docs/help/index.md                    |    3 +
 docs/en/docs/index.md                         |    9 +
 docs/en/docs/learn/index.md                   |    5 +
 docs/en/docs/reference/apirouter.md           |   25 +
 docs/en/docs/reference/background.md          |   13 +
 docs/en/docs/reference/dependencies.md        |   32 +
 docs/en/docs/reference/encoders.md            |    3 +
 docs/en/docs/reference/exceptions.md          |   22 +
 docs/en/docs/reference/fastapi.md             |   32 +
 docs/en/docs/reference/httpconnection.md      |   13 +
 docs/en/docs/reference/index.md               |    7 +
 docs/en/docs/reference/middleware.md          |   46 +
 docs/en/docs/reference/openapi/docs.md        |   11 +
 docs/en/docs/reference/openapi/index.md       |    5 +
 docs/en/docs/reference/openapi/models.md      |    5 +
 docs/en/docs/reference/parameters.md          |   36 +
 docs/en/docs/reference/request.md             |   18 +
 docs/en/docs/reference/response.md            |   15 +
 docs/en/docs/reference/responses.md           |  166 +
 docs/en/docs/reference/security/index.md      |   76 +
 docs/en/docs/reference/staticfiles.md         |   14 +
 docs/en/docs/reference/status.md              |   39 +
 docs/en/docs/reference/templating.md          |   14 +
 docs/en/docs/reference/testclient.md          |   14 +
 docs/en/docs/reference/uploadfile.md          |   23 +
 docs/en/docs/reference/websockets.md          |   70 +
 docs/en/docs/release-notes.md                 |    5 +
 docs/en/docs/resources/index.md               |    3 +
 docs/en/mkdocs.yml                            |  297 +-
 fastapi/applications.py                       | 4269 +++++++++++++++--
 fastapi/background.py                         |   60 +-
 fastapi/datastructures.py                     |  123 +-
 fastapi/dependencies/utils.py                 |   18 +-
 fastapi/encoders.py                           |  110 +-
 fastapi/exceptions.py                         |  131 +-
 fastapi/openapi/docs.py                       |  169 +-
 fastapi/param_functions.py                    | 2179 ++++++++-
 fastapi/responses.py                          |   14 +
 fastapi/routing.py                            | 3483 +++++++++++++-
 fastapi/security/api_key.py                   |  227 +-
 fastapi/security/http.py                      |  285 +-
 fastapi/security/oauth2.py                    |  549 ++-
 fastapi/security/open_id_connect_url.py       |   58 +-
 pyproject.toml                                |    2 +-
 requirements-docs-tests.txt                   |    3 +
 requirements-docs.txt                         |    3 +
 requirements-tests.txt                        |    3 +-
 scripts/docs.py                               |    7 +-
 scripts/mkdocs_hooks.py                       |    8 +
 tests/test_datastructures.py                  |   18 +
 tests/test_router_events.py                   |    3 +
 .../test_tutorial001.py                       |   15 +-
 .../test_events/test_tutorial001.py           |   13 +-
 .../test_events/test_tutorial002.py           |   13 +-
 .../test_testing/test_tutorial003.py          |    4 +-
 60 files changed, 11811 insertions(+), 1008 deletions(-)
 create mode 100644 docs/en/docs/about/index.md
 create mode 100644 docs/en/docs/help/index.md
 create mode 100644 docs/en/docs/learn/index.md
 create mode 100644 docs/en/docs/reference/apirouter.md
 create mode 100644 docs/en/docs/reference/background.md
 create mode 100644 docs/en/docs/reference/dependencies.md
 create mode 100644 docs/en/docs/reference/encoders.md
 create mode 100644 docs/en/docs/reference/exceptions.md
 create mode 100644 docs/en/docs/reference/fastapi.md
 create mode 100644 docs/en/docs/reference/httpconnection.md
 create mode 100644 docs/en/docs/reference/index.md
 create mode 100644 docs/en/docs/reference/middleware.md
 create mode 100644 docs/en/docs/reference/openapi/docs.md
 create mode 100644 docs/en/docs/reference/openapi/index.md
 create mode 100644 docs/en/docs/reference/openapi/models.md
 create mode 100644 docs/en/docs/reference/parameters.md
 create mode 100644 docs/en/docs/reference/request.md
 create mode 100644 docs/en/docs/reference/response.md
 create mode 100644 docs/en/docs/reference/responses.md
 create mode 100644 docs/en/docs/reference/security/index.md
 create mode 100644 docs/en/docs/reference/staticfiles.md
 create mode 100644 docs/en/docs/reference/status.md
 create mode 100644 docs/en/docs/reference/templating.md
 create mode 100644 docs/en/docs/reference/testclient.md
 create mode 100644 docs/en/docs/reference/uploadfile.md
 create mode 100644 docs/en/docs/reference/websockets.md
 create mode 100644 docs/en/docs/resources/index.md
 create mode 100644 requirements-docs-tests.txt

diff --git a/.github/workflows/build-docs.yml b/.github/workflows/build-docs.yml
index a1ce0860a..4100781c5 100644
--- a/.github/workflows/build-docs.yml
+++ b/.github/workflows/build-docs.yml
@@ -44,14 +44,17 @@ jobs:
         id: cache
         with:
           path: ${{ env.pythonLocation }}
-          key: ${{ runner.os }}-python-docs-${{ env.pythonLocation }}-${{ hashFiles('pyproject.toml', 'requirements-docs.txt') }}-v06
+          key: ${{ runner.os }}-python-docs-${{ env.pythonLocation }}-${{ hashFiles('pyproject.toml', 'requirements-docs.txt', 'requirements-docs-tests.txt') }}-v06
       - name: Install docs extras
         if: steps.cache.outputs.cache-hit != 'true'
         run: pip install -r requirements-docs.txt
       # Install MkDocs Material Insiders here just to put it in the cache for the rest of the steps
       - name: Install Material for MkDocs Insiders
         if: ( github.event_name != 'pull_request' || github.event.pull_request.head.repo.fork == false ) && steps.cache.outputs.cache-hit != 'true'
-        run: pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/squidfunk/mkdocs-material-insiders.git
+        run: |
+          pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/squidfunk/mkdocs-material-insiders.git
+          pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/pawamoy-insiders/griffe-typing-deprecated.git
+          pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/pawamoy-insiders/mkdocstrings-python.git
       - name: Export Language Codes
         id: show-langs
         run: |
@@ -80,13 +83,16 @@ jobs:
         id: cache
         with:
           path: ${{ env.pythonLocation }}
-          key: ${{ runner.os }}-python-docs-${{ env.pythonLocation }}-${{ hashFiles('pyproject.toml', 'requirements-docs.txt') }}-v06
+          key: ${{ runner.os }}-python-docs-${{ env.pythonLocation }}-${{ hashFiles('pyproject.toml', 'requirements-docs.txt', 'requirements-docs-tests.txt') }}-v06
       - name: Install docs extras
         if: steps.cache.outputs.cache-hit != 'true'
         run: pip install -r requirements-docs.txt
       - name: Install Material for MkDocs Insiders
         if: ( github.event_name != 'pull_request' || github.event.pull_request.head.repo.fork == false ) && steps.cache.outputs.cache-hit != 'true'
-        run: pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/squidfunk/mkdocs-material-insiders.git
+        run: |
+          pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/squidfunk/mkdocs-material-insiders.git
+          pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/pawamoy-insiders/griffe-typing-deprecated.git
+          pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/pawamoy-insiders/mkdocstrings-python.git
       - name: Update Languages
         run: python ./scripts/docs.py update-languages
       - uses: actions/cache@v3
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 7eccaa0ac..59754525d 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -29,7 +29,7 @@ jobs:
         id: cache
         with:
           path: ${{ env.pythonLocation }}
-          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-pydantic-v2-${{ hashFiles('pyproject.toml', 'requirements-tests.txt') }}-test-v06
+          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-pydantic-v2-${{ hashFiles('pyproject.toml', 'requirements-tests.txt', 'requirements-docs-tests.txt') }}-test-v06
       - name: Install Dependencies
         if: steps.cache.outputs.cache-hit != 'true'
         run: pip install -r requirements-tests.txt
@@ -62,7 +62,7 @@ jobs:
         id: cache
         with:
           path: ${{ env.pythonLocation }}
-          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-${{ matrix.pydantic-version }}-${{ hashFiles('pyproject.toml', 'requirements-tests.txt') }}-test-v06
+          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-${{ matrix.pydantic-version }}-${{ hashFiles('pyproject.toml', 'requirements-tests.txt', 'requirements-docs-tests.txt') }}-test-v06
       - name: Install Dependencies
         if: steps.cache.outputs.cache-hit != 'true'
         run: pip install -r requirements-tests.txt
diff --git a/docs/en/docs/about/index.md b/docs/en/docs/about/index.md
new file mode 100644
index 000000000..27b78696b
--- /dev/null
+++ b/docs/en/docs/about/index.md
@@ -0,0 +1,3 @@
+# About
+
+About FastAPI, its design, inspiration and more. 🤓
diff --git a/docs/en/docs/fastapi-people.md b/docs/en/docs/fastapi-people.md
index 20caaa1ee..7e26358d8 100644
--- a/docs/en/docs/fastapi-people.md
+++ b/docs/en/docs/fastapi-people.md
@@ -1,3 +1,8 @@
+---
+hide:
+  - navigation
+---
+
 # FastAPI People
 
 FastAPI has an amazing community that welcomes people from all backgrounds.
diff --git a/docs/en/docs/features.md b/docs/en/docs/features.md
index 98f37b534..6f13b03bb 100644
--- a/docs/en/docs/features.md
+++ b/docs/en/docs/features.md
@@ -1,3 +1,8 @@
+---
+hide:
+  - navigation
+---
+
 # Features
 
 ## FastAPI features
diff --git a/docs/en/docs/help/index.md b/docs/en/docs/help/index.md
new file mode 100644
index 000000000..5ee7df2fe
--- /dev/null
+++ b/docs/en/docs/help/index.md
@@ -0,0 +1,3 @@
+# Help
+
+Help and get help, contribute, get involved. 🤝
diff --git a/docs/en/docs/index.md b/docs/en/docs/index.md
index cd3f3e000..3660e74e3 100644
--- a/docs/en/docs/index.md
+++ b/docs/en/docs/index.md
@@ -1,3 +1,12 @@
+---
+hide:
+  - navigation
+---
+
+<style>
+.md-content .md-typeset h1 { display: none; }
+</style>
+
 <p align="center">
   <a href="https://fastapi.tiangolo.com"><img src="https://fastapi.tiangolo.com/img/logo-margin/logo-teal.png" alt="FastAPI"></a>
 </p>
diff --git a/docs/en/docs/learn/index.md b/docs/en/docs/learn/index.md
new file mode 100644
index 000000000..d056fb320
--- /dev/null
+++ b/docs/en/docs/learn/index.md
@@ -0,0 +1,5 @@
+# Learn
+
+Here are the introductory sections and the tutorials to learn **FastAPI**.
+
+You could consider this a **book**, a **course**, the **official** and recommended way to learn FastAPI. 😎
diff --git a/docs/en/docs/reference/apirouter.md b/docs/en/docs/reference/apirouter.md
new file mode 100644
index 000000000..b779ad291
--- /dev/null
+++ b/docs/en/docs/reference/apirouter.md
@@ -0,0 +1,25 @@
+# `APIRouter` class
+
+Here's the reference information for the `APIRouter` class, with all its parameters,
+attributes and methods.
+
+You can import the `APIRouter` class directly from `fastapi`:
+
+```python
+from fastapi import APIRouter
+```
+
+::: fastapi.APIRouter
+    options:
+        members:
+            - websocket
+            - include_router
+            - get
+            - put
+            - post
+            - delete
+            - options
+            - head
+            - patch
+            - trace
+            - on_event
diff --git a/docs/en/docs/reference/background.md b/docs/en/docs/reference/background.md
new file mode 100644
index 000000000..e0c0be899
--- /dev/null
+++ b/docs/en/docs/reference/background.md
@@ -0,0 +1,13 @@
+# Background Tasks - `BackgroundTasks`
+
+You can declare a parameter in a *path operation function* or dependency function
+with the type `BackgroundTasks`, and then you can use it to schedule the execution
+of background tasks after the response is sent.
+
+You can import it directly from `fastapi`:
+
+```python
+from fastapi import BackgroundTasks
+```
+
+::: fastapi.BackgroundTasks
diff --git a/docs/en/docs/reference/dependencies.md b/docs/en/docs/reference/dependencies.md
new file mode 100644
index 000000000..95cd101e4
--- /dev/null
+++ b/docs/en/docs/reference/dependencies.md
@@ -0,0 +1,32 @@
+# Dependencies - `Depends()` and `Security()`
+
+## `Depends()`
+
+Dependencies are handled mainly with the special function `Depends()` that takes a
+callable.
+
+Here is the reference for it and its parameters.
+
+You can import it directly from `fastapi`:
+
+```python
+from fastapi import Depends
+```
+
+::: fastapi.Depends
+
+## `Security()`
+
+For many scenarios, you can handle security (authorization, authentication, etc.) with
+dependendencies, using `Depends()`.
+
+But when you want to also declare OAuth2 scopes, you can use `Security()` instead of
+`Depends()`.
+
+You can import `Security()` directly from `fastapi`:
+
+```python
+from fastapi import Security
+```
+
+::: fastapi.Security
diff --git a/docs/en/docs/reference/encoders.md b/docs/en/docs/reference/encoders.md
new file mode 100644
index 000000000..28df2e43a
--- /dev/null
+++ b/docs/en/docs/reference/encoders.md
@@ -0,0 +1,3 @@
+# Encoders - `jsonable_encoder`
+
+::: fastapi.encoders.jsonable_encoder
diff --git a/docs/en/docs/reference/exceptions.md b/docs/en/docs/reference/exceptions.md
new file mode 100644
index 000000000..adc9b91ce
--- /dev/null
+++ b/docs/en/docs/reference/exceptions.md
@@ -0,0 +1,22 @@
+# Exceptions - `HTTPException` and `WebSocketException`
+
+These are the exceptions that you can raise to show errors to the client.
+
+When you raise an exception, as would happen with normal Python, the rest of the
+excecution is aborted. This way you can raise these exceptions from anywhere in the
+code to abort a request and show the error to the client.
+
+You can use:
+
+* `HTTPException`
+* `WebSocketException`
+
+These exceptions can be imported directly from `fastapi`:
+
+```python
+from fastapi import HTTPException, WebSocketException
+```
+
+::: fastapi.HTTPException
+
+::: fastapi.WebSocketException
diff --git a/docs/en/docs/reference/fastapi.md b/docs/en/docs/reference/fastapi.md
new file mode 100644
index 000000000..8b87664cb
--- /dev/null
+++ b/docs/en/docs/reference/fastapi.md
@@ -0,0 +1,32 @@
+# `FastAPI` class
+
+Here's the reference information for the `FastAPI` class, with all its parameters,
+attributes and methods.
+
+You can import the `FastAPI` class directly from `fastapi`:
+
+```python
+from fastapi import FastAPI
+```
+
+::: fastapi.FastAPI
+    options:
+        members:
+            - openapi_version
+            - webhooks
+            - state
+            - dependency_overrides
+            - openapi
+            - websocket
+            - include_router
+            - get
+            - put
+            - post
+            - delete
+            - options
+            - head
+            - patch
+            - trace
+            - on_event
+            - middleware
+            - exception_handler
diff --git a/docs/en/docs/reference/httpconnection.md b/docs/en/docs/reference/httpconnection.md
new file mode 100644
index 000000000..43dfc46f9
--- /dev/null
+++ b/docs/en/docs/reference/httpconnection.md
@@ -0,0 +1,13 @@
+# `HTTPConnection` class
+
+When you want to define dependencies that should be compatible with both HTTP and
+WebSockets, you can define a parameter that takes an `HTTPConnection` instead of a
+`Request` or a `WebSocket`.
+
+You can import it from `fastapi.requests`:
+
+```python
+from fastapi.requests import HTTPConnection
+```
+
+::: fastapi.requests.HTTPConnection
diff --git a/docs/en/docs/reference/index.md b/docs/en/docs/reference/index.md
new file mode 100644
index 000000000..994b3c38c
--- /dev/null
+++ b/docs/en/docs/reference/index.md
@@ -0,0 +1,7 @@
+# Reference - Code API
+
+Here's the reference or code API, the classes, functions, parameters, attributes, and
+all the FastAPI parts you can use in you applications.
+
+If you want to **learn FastAPI** you are much better off reading the
+[FastAPI Tutorial](https://fastapi.tiangolo.com/tutorial/).
diff --git a/docs/en/docs/reference/middleware.md b/docs/en/docs/reference/middleware.md
new file mode 100644
index 000000000..89704d3c8
--- /dev/null
+++ b/docs/en/docs/reference/middleware.md
@@ -0,0 +1,46 @@
+# Middleware
+
+There are several middlewares available provided by Starlette directly.
+
+Read more about them in the
+[FastAPI docs for Middleware](https://fastapi.tiangolo.com/advanced/middleware/).
+
+::: fastapi.middleware.cors.CORSMiddleware
+
+It can be imported from `fastapi`:
+
+```python
+from fastapi.middleware.cors import CORSMiddleware
+```
+
+::: fastapi.middleware.gzip.GZipMiddleware
+
+It can be imported from `fastapi`:
+
+```python
+from fastapi.middleware.gzip import GZipMiddleware
+```
+
+::: fastapi.middleware.httpsredirect.HTTPSRedirectMiddleware
+
+It can be imported from `fastapi`:
+
+```python
+from fastapi.middleware.httpsredirect import HTTPSRedirectMiddleware
+```
+
+::: fastapi.middleware.trustedhost.TrustedHostMiddleware
+
+It can be imported from `fastapi`:
+
+```python
+from fastapi.middleware.trustedhost import TrustedHostMiddleware
+```
+
+::: fastapi.middleware.wsgi.WSGIMiddleware
+
+It can be imported from `fastapi`:
+
+```python
+from fastapi.middleware.wsgi import WSGIMiddleware
+```
diff --git a/docs/en/docs/reference/openapi/docs.md b/docs/en/docs/reference/openapi/docs.md
new file mode 100644
index 000000000..ab620833e
--- /dev/null
+++ b/docs/en/docs/reference/openapi/docs.md
@@ -0,0 +1,11 @@
+# OpenAPI `docs`
+
+Utilities to handle OpenAPI automatic UI documentation, including Swagger UI (by default at `/docs`) and ReDoc (by default at `/redoc`).
+
+::: fastapi.openapi.docs.get_swagger_ui_html
+
+::: fastapi.openapi.docs.get_redoc_html
+
+::: fastapi.openapi.docs.get_swagger_ui_oauth2_redirect_html
+
+::: fastapi.openapi.docs.swagger_ui_default_parameters
diff --git a/docs/en/docs/reference/openapi/index.md b/docs/en/docs/reference/openapi/index.md
new file mode 100644
index 000000000..e2b313f15
--- /dev/null
+++ b/docs/en/docs/reference/openapi/index.md
@@ -0,0 +1,5 @@
+# OpenAPI
+
+There are several utilities to handle OpenAPI.
+
+You normally don't need to use them unless you have a specific advanced use case that requires it.
diff --git a/docs/en/docs/reference/openapi/models.md b/docs/en/docs/reference/openapi/models.md
new file mode 100644
index 000000000..4a6b0770e
--- /dev/null
+++ b/docs/en/docs/reference/openapi/models.md
@@ -0,0 +1,5 @@
+# OpenAPI `models`
+
+OpenAPI Pydantic models used to generate and validate the generated OpenAPI.
+
+::: fastapi.openapi.models
diff --git a/docs/en/docs/reference/parameters.md b/docs/en/docs/reference/parameters.md
new file mode 100644
index 000000000..8f77f0161
--- /dev/null
+++ b/docs/en/docs/reference/parameters.md
@@ -0,0 +1,36 @@
+# Request Parameters
+
+Here's the reference information for the request parameters.
+
+These are the special functions that you can put in *path operation function*
+parameters or dependency functions with `Annotated` to get data from the request.
+
+It includes:
+
+* `Query()`
+* `Path()`
+* `Body()`
+* `Cookie()`
+* `Header()`
+* `Form()`
+* `File()`
+
+You can import them all directly from `fastapi`:
+
+```python
+from fastapi import Body, Cookie, File, Form, Header, Path, Query
+```
+
+::: fastapi.Query
+
+::: fastapi.Path
+
+::: fastapi.Body
+
+::: fastapi.Cookie
+
+::: fastapi.Header
+
+::: fastapi.Form
+
+::: fastapi.File
diff --git a/docs/en/docs/reference/request.md b/docs/en/docs/reference/request.md
new file mode 100644
index 000000000..91ec7d37b
--- /dev/null
+++ b/docs/en/docs/reference/request.md
@@ -0,0 +1,18 @@
+# `Request` class
+
+You can declare a parameter in a *path operation function* or dependency to be of type
+`Request` and then you can access the raw request object directly, without any
+validation, etc.
+
+You can import it directly from `fastapi`:
+
+```python
+from fastapi import Request
+```
+
+!!! tip
+    When you want to define dependencies that should be compatible with both HTTP and
+    WebSockets, you can define a parameter that takes an `HTTPConnection` instead of a
+    `Request` or a `WebSocket`.
+
+::: fastapi.Request
diff --git a/docs/en/docs/reference/response.md b/docs/en/docs/reference/response.md
new file mode 100644
index 000000000..916254583
--- /dev/null
+++ b/docs/en/docs/reference/response.md
@@ -0,0 +1,15 @@
+# `Response` class
+
+You can declare a parameter in a *path operation function* or dependency to be of type
+`Response` and then you can set data for the response like headers or cookies.
+
+You can also use it directly to create an instance of it and return it from your *path
+operations*.
+
+You can import it directly from `fastapi`:
+
+```python
+from fastapi import Response
+```
+
+::: fastapi.Response
diff --git a/docs/en/docs/reference/responses.md b/docs/en/docs/reference/responses.md
new file mode 100644
index 000000000..2cbbd8963
--- /dev/null
+++ b/docs/en/docs/reference/responses.md
@@ -0,0 +1,166 @@
+# Custom Response Classes - File, HTML, Redirect, Streaming, etc.
+
+There are several custom response classes you can use to create an instance and return
+them directly from your *path operations*.
+
+Read more about it in the
+[FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/).
+
+You can import them directly from `fastapi.responses`:
+
+```python
+from fastapi.responses import (
+    FileResponse,
+    HTMLResponse,
+    JSONResponse,
+    ORJSONResponse,
+    PlainTextResponse,
+    RedirectResponse,
+    Response,
+    StreamingResponse,
+    UJSONResponse,
+)
+```
+
+## FastAPI Responses
+
+There are a couple of custom FastAPI response classes, you can use them to optimize JSON performance.
+
+::: fastapi.responses.UJSONResponse
+    options:
+        members:
+            - charset
+            - status_code
+            - media_type
+            - body
+            - background
+            - raw_headers
+            - render
+            - init_headers
+            - headers
+            - set_cookie
+            - delete_cookie
+
+::: fastapi.responses.ORJSONResponse
+    options:
+        members:
+            - charset
+            - status_code
+            - media_type
+            - body
+            - background
+            - raw_headers
+            - render
+            - init_headers
+            - headers
+            - set_cookie
+            - delete_cookie
+
+## Starlette Responses
+
+::: fastapi.responses.FileResponse
+    options:
+        members:
+            - chunk_size
+            - charset
+            - status_code
+            - media_type
+            - body
+            - background
+            - raw_headers
+            - render
+            - init_headers
+            - headers
+            - set_cookie
+            - delete_cookie
+
+::: fastapi.responses.HTMLResponse
+    options:
+        members:
+            - charset
+            - status_code
+            - media_type
+            - body
+            - background
+            - raw_headers
+            - render
+            - init_headers
+            - headers
+            - set_cookie
+            - delete_cookie
+
+::: fastapi.responses.JSONResponse
+    options:
+        members:
+            - charset
+            - status_code
+            - media_type
+            - body
+            - background
+            - raw_headers
+            - render
+            - init_headers
+            - headers
+            - set_cookie
+            - delete_cookie
+
+::: fastapi.responses.PlainTextResponse
+    options:
+        members:
+            - charset
+            - status_code
+            - media_type
+            - body
+            - background
+            - raw_headers
+            - render
+            - init_headers
+            - headers
+            - set_cookie
+            - delete_cookie
+
+::: fastapi.responses.RedirectResponse
+    options:
+        members:
+            - charset
+            - status_code
+            - media_type
+            - body
+            - background
+            - raw_headers
+            - render
+            - init_headers
+            - headers
+            - set_cookie
+            - delete_cookie
+
+::: fastapi.responses.Response
+    options:
+        members:
+            - charset
+            - status_code
+            - media_type
+            - body
+            - background
+            - raw_headers
+            - render
+            - init_headers
+            - headers
+            - set_cookie
+            - delete_cookie
+
+::: fastapi.responses.StreamingResponse
+    options:
+        members:
+            - body_iterator
+            - charset
+            - status_code
+            - media_type
+            - body
+            - background
+            - raw_headers
+            - render
+            - init_headers
+            - headers
+            - set_cookie
+            - delete_cookie
diff --git a/docs/en/docs/reference/security/index.md b/docs/en/docs/reference/security/index.md
new file mode 100644
index 000000000..ff86e9e30
--- /dev/null
+++ b/docs/en/docs/reference/security/index.md
@@ -0,0 +1,76 @@
+# Security Tools
+
+When you need to declare dependencies with OAuth2 scopes you use `Security()`.
+
+But you still need to define what is the dependable, the callable that you pass as
+a parameter to `Depends()` or `Security()`.
+
+There are multiple tools that you can use to create those dependables, and they get
+integrated into OpenAPI so they are shown in the automatic docs UI, they can be used
+by automatically generated clients and SDKs, etc.
+
+You can import them from `fastapi.security`:
+
+```python
+from fastapi.security import (
+    APIKeyCookie,
+    APIKeyHeader,
+    APIKeyQuery,
+    HTTPAuthorizationCredentials,
+    HTTPBasic,
+    HTTPBasicCredentials,
+    HTTPBearer,
+    HTTPDigest,
+    OAuth2,
+    OAuth2AuthorizationCodeBearer,
+    OAuth2PasswordBearer,
+    OAuth2PasswordRequestForm,
+    OAuth2PasswordRequestFormStrict,
+    OpenIdConnect,
+    SecurityScopes,
+)
+```
+
+## API Key Security Schemes
+
+::: fastapi.security.APIKeyCookie
+
+::: fastapi.security.APIKeyHeader
+
+::: fastapi.security.APIKeyQuery
+
+## HTTP Authentication Schemes
+
+::: fastapi.security.HTTPBasic
+
+::: fastapi.security.HTTPBearer
+
+::: fastapi.security.HTTPDigest
+
+## HTTP Credentials
+
+::: fastapi.security.HTTPAuthorizationCredentials
+
+::: fastapi.security.HTTPBasicCredentials
+
+## OAuth2 Authentication
+
+::: fastapi.security.OAuth2
+
+::: fastapi.security.OAuth2AuthorizationCodeBearer
+
+::: fastapi.security.OAuth2PasswordBearer
+
+## OAuth2 Password Form
+
+::: fastapi.security.OAuth2PasswordRequestForm
+
+::: fastapi.security.OAuth2PasswordRequestFormStrict
+
+## OAuth2 Security Scopes in Dependencies
+
+::: fastapi.security.SecurityScopes
+
+## OpenID Connect
+
+::: fastapi.security.OpenIdConnect
diff --git a/docs/en/docs/reference/staticfiles.md b/docs/en/docs/reference/staticfiles.md
new file mode 100644
index 000000000..ce66f17b3
--- /dev/null
+++ b/docs/en/docs/reference/staticfiles.md
@@ -0,0 +1,14 @@
+# Static Files - `StaticFiles`
+
+You can use the `StaticFiles` class to serve static files, like JavaScript, CSS, images, etc.
+
+Read more about it in the
+[FastAPI docs for Static Files](https://fastapi.tiangolo.com/tutorial/static-files/).
+
+You can import it directly from `fastapi.staticfiles`:
+
+```python
+from fastapi.staticfiles import StaticFiles
+```
+
+::: fastapi.staticfiles.StaticFiles
diff --git a/docs/en/docs/reference/status.md b/docs/en/docs/reference/status.md
new file mode 100644
index 000000000..54fba9387
--- /dev/null
+++ b/docs/en/docs/reference/status.md
@@ -0,0 +1,39 @@
+# Status Codes
+
+You can import the `status` module from `fastapi`:
+
+```python
+from fastapi import status
+```
+
+`status` is provided directly by Starlette.
+
+It containes a group of named constants (variables) with integer status codes.
+
+For example:
+
+* 200: `status.HTTP_200_OK`
+* 403: `status.HTTP_403_FORBIDDEN`
+* etc.
+
+It can be convenient to quickly access HTTP (and WebSocket) status codes in your app,
+using autocompletion for the name without having to remember the integer status codes
+by memory.
+
+Read more about it in the
+[FastAPI docs about Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+
+## Example
+
+```python
+from fastapi import FastAPI, status
+
+app = FastAPI()
+
+
+@app.get("/items/", status_code=status.HTTP_418_IM_A_TEAPOT)
+def read_items():
+    return [{"name": "Plumbus"}, {"name": "Portal Gun"}]
+```
+
+::: fastapi.status
diff --git a/docs/en/docs/reference/templating.md b/docs/en/docs/reference/templating.md
new file mode 100644
index 000000000..c865badfc
--- /dev/null
+++ b/docs/en/docs/reference/templating.md
@@ -0,0 +1,14 @@
+# Templating - `Jinja2Templates`
+
+You can use the `Jinja2Templates` class to render Jinja templates.
+
+Read more about it in the
+[FastAPI docs for Templates](https://fastapi.tiangolo.com/advanced/templates/).
+
+You can import it directly from `fastapi.templating`:
+
+```python
+from fastapi.templating import Jinja2Templates
+```
+
+::: fastapi.templating.Jinja2Templates
diff --git a/docs/en/docs/reference/testclient.md b/docs/en/docs/reference/testclient.md
new file mode 100644
index 000000000..e391d964a
--- /dev/null
+++ b/docs/en/docs/reference/testclient.md
@@ -0,0 +1,14 @@
+# Test Client - `TestClient`
+
+You can use the `TestClient` class to test FastAPI applications without creating an actual HTTP and socket connection, just communicating directly with the FastAPI code.
+
+Read more about it in the
+[FastAPI docs for Testing](https://fastapi.tiangolo.com/tutorial/testing/).
+
+You can import it directly from `fastapi.testclient`:
+
+```python
+from fastapi.testclient import TestClient
+```
+
+::: fastapi.testclient.TestClient
diff --git a/docs/en/docs/reference/uploadfile.md b/docs/en/docs/reference/uploadfile.md
new file mode 100644
index 000000000..45c644b18
--- /dev/null
+++ b/docs/en/docs/reference/uploadfile.md
@@ -0,0 +1,23 @@
+# `UploadFile` class
+
+You can define *path operation function* parameters to be of the type `UploadFile`
+to receive files from the request.
+
+You can import it directly from `fastapi`:
+
+```python
+from fastapi import UploadFile
+```
+
+::: fastapi.UploadFile
+    options:
+        members:
+            - file
+            - filename
+            - size
+            - headers
+            - content_type
+            - read
+            - write
+            - seek
+            - close
diff --git a/docs/en/docs/reference/websockets.md b/docs/en/docs/reference/websockets.md
new file mode 100644
index 000000000..2a0469467
--- /dev/null
+++ b/docs/en/docs/reference/websockets.md
@@ -0,0 +1,70 @@
+# WebSockets
+
+When defining WebSockets, you normally declare a parameter of type `WebSocket` and
+with it you can read data from the client and send data to it.
+
+It is provided directly by Starlette, but you can import it from `fastapi`:
+
+```python
+from fastapi import WebSocket
+```
+
+!!! tip
+    When you want to define dependencies that should be compatible with both HTTP and
+    WebSockets, you can define a parameter that takes an `HTTPConnection` instead of a
+    `Request` or a `WebSocket`.
+
+::: fastapi.WebSocket
+    options:
+        members:
+            - scope
+            - app
+            - url
+            - base_url
+            - headers
+            - query_params
+            - path_params
+            - cookies
+            - client
+            - state
+            - url_for
+            - client_state
+            - application_state
+            - receive
+            - send
+            - accept
+            - receive_text
+            - receive_bytes
+            - receive_json
+            - iter_text
+            - iter_bytes
+            - iter_json
+            - send_text
+            - send_bytes
+            - send_json
+            - close
+
+When a client disconnects, a `WebSocketDisconnect` exception is raised, you can catch
+it.
+
+You can import it directly form `fastapi`:
+
+```python
+from fastapi import WebSocketDisconnect
+```
+
+::: fastapi.WebSocketDisconnect
+
+## WebSockets - additional classes
+
+Additional classes for handling WebSockets.
+
+Provided directly by Starlette, but you can import it from `fastapi`:
+
+```python
+from fastapi.websockets import WebSocketDisconnect, WebSocketState
+```
+
+::: fastapi.websockets.WebSocketDisconnect
+
+::: fastapi.websockets.WebSocketState
diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 4222c4400..62ffd4b35 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -1,3 +1,8 @@
+---
+hide:
+  - navigation
+---
+
 # Release Notes
 
 ## Latest Changes
diff --git a/docs/en/docs/resources/index.md b/docs/en/docs/resources/index.md
new file mode 100644
index 000000000..8c7cac43b
--- /dev/null
+++ b/docs/en/docs/resources/index.md
@@ -0,0 +1,3 @@
+# Resources
+
+Additional resources, external links, articles and more. ✈️
diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index ba1ac7924..a64eff269 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -30,6 +30,7 @@ theme:
   - content.code.annotate
   - content.code.copy
   - content.code.select
+  - navigation.tabs
   icon:
     repo: fontawesome/brands/github-alt
   logo: img/icon-white.svg
@@ -52,142 +53,174 @@ plugins:
       advanced/custom-request-and-route.md: how-to/custom-request-and-route.md
       advanced/conditional-openapi.md: how-to/conditional-openapi.md
       advanced/extending-openapi.md: how-to/extending-openapi.md
+  mkdocstrings:
+    handlers:
+      python:
+        options:
+          extensions:
+            - griffe_typingdoc
+          show_root_heading: true
+          show_if_no_docstring: true
+          preload_modules: [httpx, starlette]
+          inherited_members: true
+          members_order: source
+          separate_signature: true
+          unwrap_annotated: true
+          filters: ["!^_"]
+          merge_init_into_class: true
+          docstring_section_style: spacy
+          signature_crossrefs: true
+          show_symbol_type_heading: true
+          show_symbol_type_toc: true
 nav:
 - FastAPI: index.md
-- Languages:
-  - en: /
-  - de: /de/
-  - em: /em/
-  - es: /es/
-  - fa: /fa/
-  - fr: /fr/
-  - he: /he/
-  - id: /id/
-  - ja: /ja/
-  - ko: /ko/
-  - pl: /pl/
-  - pt: /pt/
-  - ru: /ru/
-  - tr: /tr/
-  - uk: /uk/
-  - ur: /ur/
-  - vi: /vi/
-  - yo: /yo/
-  - zh: /zh/
 - features.md
+- Learn:
+  - learn/index.md
+  - python-types.md
+  - async.md
+  - Tutorial - User Guide:
+    - tutorial/index.md
+    - tutorial/first-steps.md
+    - tutorial/path-params.md
+    - tutorial/query-params.md
+    - tutorial/body.md
+    - tutorial/query-params-str-validations.md
+    - tutorial/path-params-numeric-validations.md
+    - tutorial/body-multiple-params.md
+    - tutorial/body-fields.md
+    - tutorial/body-nested-models.md
+    - tutorial/schema-extra-example.md
+    - tutorial/extra-data-types.md
+    - tutorial/cookie-params.md
+    - tutorial/header-params.md
+    - tutorial/response-model.md
+    - tutorial/extra-models.md
+    - tutorial/response-status-code.md
+    - tutorial/request-forms.md
+    - tutorial/request-files.md
+    - tutorial/request-forms-and-files.md
+    - tutorial/handling-errors.md
+    - tutorial/path-operation-configuration.md
+    - tutorial/encoder.md
+    - tutorial/body-updates.md
+    - Dependencies:
+      - tutorial/dependencies/index.md
+      - tutorial/dependencies/classes-as-dependencies.md
+      - tutorial/dependencies/sub-dependencies.md
+      - tutorial/dependencies/dependencies-in-path-operation-decorators.md
+      - tutorial/dependencies/global-dependencies.md
+      - tutorial/dependencies/dependencies-with-yield.md
+    - Security:
+      - tutorial/security/index.md
+      - tutorial/security/first-steps.md
+      - tutorial/security/get-current-user.md
+      - tutorial/security/simple-oauth2.md
+      - tutorial/security/oauth2-jwt.md
+    - tutorial/middleware.md
+    - tutorial/cors.md
+    - tutorial/sql-databases.md
+    - tutorial/bigger-applications.md
+    - tutorial/background-tasks.md
+    - tutorial/metadata.md
+    - tutorial/static-files.md
+    - tutorial/testing.md
+    - tutorial/debugging.md
+  - Advanced User Guide:
+    - advanced/index.md
+    - advanced/path-operation-advanced-configuration.md
+    - advanced/additional-status-codes.md
+    - advanced/response-directly.md
+    - advanced/custom-response.md
+    - advanced/additional-responses.md
+    - advanced/response-cookies.md
+    - advanced/response-headers.md
+    - advanced/response-change-status-code.md
+    - advanced/advanced-dependencies.md
+    - Advanced Security:
+      - advanced/security/index.md
+      - advanced/security/oauth2-scopes.md
+      - advanced/security/http-basic-auth.md
+    - advanced/using-request-directly.md
+    - advanced/dataclasses.md
+    - advanced/middleware.md
+    - advanced/sub-applications.md
+    - advanced/behind-a-proxy.md
+    - advanced/templates.md
+    - advanced/websockets.md
+    - advanced/events.md
+    - advanced/testing-websockets.md
+    - advanced/testing-events.md
+    - advanced/testing-dependencies.md
+    - advanced/testing-database.md
+    - advanced/async-tests.md
+    - advanced/settings.md
+    - advanced/openapi-callbacks.md
+    - advanced/openapi-webhooks.md
+    - advanced/wsgi.md
+    - advanced/generate-clients.md
+  - Deployment:
+    - deployment/index.md
+    - deployment/versions.md
+    - deployment/https.md
+    - deployment/manually.md
+    - deployment/concepts.md
+    - deployment/cloud.md
+    - deployment/server-workers.md
+    - deployment/docker.md
+  - How To - Recipes:
+    - how-to/index.md
+    - how-to/general.md
+    - how-to/sql-databases-peewee.md
+    - how-to/async-sql-encode-databases.md
+    - how-to/nosql-databases-couchbase.md
+    - how-to/graphql.md
+    - how-to/custom-request-and-route.md
+    - how-to/conditional-openapi.md
+    - how-to/extending-openapi.md
+    - how-to/separate-openapi-schemas.md
+    - how-to/custom-docs-ui-assets.md
+    - how-to/configure-swagger-ui.md
+- Reference (Code API):
+  - reference/index.md
+  - reference/fastapi.md
+  - reference/parameters.md
+  - reference/status.md
+  - reference/uploadfile.md
+  - reference/exceptions.md
+  - reference/dependencies.md
+  - reference/apirouter.md
+  - reference/background.md
+  - reference/request.md
+  - reference/websockets.md
+  - reference/httpconnection.md
+  - reference/response.md
+  - reference/responses.md
+  - reference/middleware.md
+  - OpenAPI:
+    - reference/openapi/index.md
+    - reference/openapi/docs.md
+    - reference/openapi/models.md
+  - reference/security/index.md
+  - reference/encoders.md
+  - reference/staticfiles.md
+  - reference/templating.md
+  - reference/testclient.md
 - fastapi-people.md
-- python-types.md
-- Tutorial - User Guide:
-  - tutorial/index.md
-  - tutorial/first-steps.md
-  - tutorial/path-params.md
-  - tutorial/query-params.md
-  - tutorial/body.md
-  - tutorial/query-params-str-validations.md
-  - tutorial/path-params-numeric-validations.md
-  - tutorial/body-multiple-params.md
-  - tutorial/body-fields.md
-  - tutorial/body-nested-models.md
-  - tutorial/schema-extra-example.md
-  - tutorial/extra-data-types.md
-  - tutorial/cookie-params.md
-  - tutorial/header-params.md
-  - tutorial/response-model.md
-  - tutorial/extra-models.md
-  - tutorial/response-status-code.md
-  - tutorial/request-forms.md
-  - tutorial/request-files.md
-  - tutorial/request-forms-and-files.md
-  - tutorial/handling-errors.md
-  - tutorial/path-operation-configuration.md
-  - tutorial/encoder.md
-  - tutorial/body-updates.md
-  - Dependencies:
-    - tutorial/dependencies/index.md
-    - tutorial/dependencies/classes-as-dependencies.md
-    - tutorial/dependencies/sub-dependencies.md
-    - tutorial/dependencies/dependencies-in-path-operation-decorators.md
-    - tutorial/dependencies/global-dependencies.md
-    - tutorial/dependencies/dependencies-with-yield.md
-  - Security:
-    - tutorial/security/index.md
-    - tutorial/security/first-steps.md
-    - tutorial/security/get-current-user.md
-    - tutorial/security/simple-oauth2.md
-    - tutorial/security/oauth2-jwt.md
-  - tutorial/middleware.md
-  - tutorial/cors.md
-  - tutorial/sql-databases.md
-  - tutorial/bigger-applications.md
-  - tutorial/background-tasks.md
-  - tutorial/metadata.md
-  - tutorial/static-files.md
-  - tutorial/testing.md
-  - tutorial/debugging.md
-- Advanced User Guide:
-  - advanced/index.md
-  - advanced/path-operation-advanced-configuration.md
-  - advanced/additional-status-codes.md
-  - advanced/response-directly.md
-  - advanced/custom-response.md
-  - advanced/additional-responses.md
-  - advanced/response-cookies.md
-  - advanced/response-headers.md
-  - advanced/response-change-status-code.md
-  - advanced/advanced-dependencies.md
-  - Advanced Security:
-    - advanced/security/index.md
-    - advanced/security/oauth2-scopes.md
-    - advanced/security/http-basic-auth.md
-  - advanced/using-request-directly.md
-  - advanced/dataclasses.md
-  - advanced/middleware.md
-  - advanced/sub-applications.md
-  - advanced/behind-a-proxy.md
-  - advanced/templates.md
-  - advanced/websockets.md
-  - advanced/events.md
-  - advanced/testing-websockets.md
-  - advanced/testing-events.md
-  - advanced/testing-dependencies.md
-  - advanced/testing-database.md
-  - advanced/async-tests.md
-  - advanced/settings.md
-  - advanced/openapi-callbacks.md
-  - advanced/openapi-webhooks.md
-  - advanced/wsgi.md
-  - advanced/generate-clients.md
-- async.md
-- Deployment:
-  - deployment/index.md
-  - deployment/versions.md
-  - deployment/https.md
-  - deployment/manually.md
-  - deployment/concepts.md
-  - deployment/cloud.md
-  - deployment/server-workers.md
-  - deployment/docker.md
-- How To - Recipes:
-  - how-to/index.md
-  - how-to/general.md
-  - how-to/sql-databases-peewee.md
-  - how-to/async-sql-encode-databases.md
-  - how-to/nosql-databases-couchbase.md
-  - how-to/graphql.md
-  - how-to/custom-request-and-route.md
-  - how-to/conditional-openapi.md
-  - how-to/extending-openapi.md
-  - how-to/separate-openapi-schemas.md
-  - how-to/custom-docs-ui-assets.md
-  - how-to/configure-swagger-ui.md
-- project-generation.md
-- alternatives.md
-- history-design-future.md
-- external-links.md
-- benchmarks.md
-- help-fastapi.md
-- newsletter.md
-- contributing.md
+- Resources:
+  - resources/index.md
+  - project-generation.md
+  - external-links.md
+  - newsletter.md
+- About:
+  - about/index.md
+  - alternatives.md
+  - history-design-future.md
+  - benchmarks.md
+- Help:
+  - help/index.md
+  - help-fastapi.md
+  - contributing.md
 - release-notes.md
 markdown_extensions:
   toc:
diff --git a/fastapi/applications.py b/fastapi/applications.py
index 5cc568292..46b7ae81b 100644
--- a/fastapi/applications.py
+++ b/fastapi/applications.py
@@ -43,57 +43,792 @@ from starlette.requests import Request
 from starlette.responses import HTMLResponse, JSONResponse, Response
 from starlette.routing import BaseRoute
 from starlette.types import ASGIApp, Lifespan, Receive, Scope, Send
+from typing_extensions import Annotated, Doc, deprecated  # type: ignore [attr-defined]
 
 AppType = TypeVar("AppType", bound="FastAPI")
 
 
 class FastAPI(Starlette):
+    """
+    `FastAPI` app class, the main entrypoint to use FastAPI.
+
+    Read more in the
+    [FastAPI docs for First Steps](https://fastapi.tiangolo.com/tutorial/first-steps/).
+
+    ## Example
+
+    ```python
+    from fastapi import FastAPI
+
+    app = FastAPI()
+    ```
+    """
+
     def __init__(
         self: AppType,
         *,
-        debug: bool = False,
-        routes: Optional[List[BaseRoute]] = None,
-        title: str = "FastAPI",
-        summary: Optional[str] = None,
-        description: str = "",
-        version: str = "0.1.0",
-        openapi_url: Optional[str] = "/openapi.json",
-        openapi_tags: Optional[List[Dict[str, Any]]] = None,
-        servers: Optional[List[Dict[str, Union[str, Any]]]] = None,
-        dependencies: Optional[Sequence[Depends]] = None,
-        default_response_class: Type[Response] = Default(JSONResponse),
-        redirect_slashes: bool = True,
-        docs_url: Optional[str] = "/docs",
-        redoc_url: Optional[str] = "/redoc",
-        swagger_ui_oauth2_redirect_url: Optional[str] = "/docs/oauth2-redirect",
-        swagger_ui_init_oauth: Optional[Dict[str, Any]] = None,
-        middleware: Optional[Sequence[Middleware]] = None,
-        exception_handlers: Optional[
-            Dict[
-                Union[int, Type[Exception]],
-                Callable[[Request, Any], Coroutine[Any, Any, Response]],
-            ]
+        debug: Annotated[
+            bool,
+            Doc(
+                """
+                Boolean indicating if debug tracebacks should be returned on server
+                errors.
+
+                Read more in the
+                [Starlette docs for Applications](https://www.starlette.io/applications/#instantiating-the-application).
+                """
+            ),
+        ] = False,
+        routes: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                **Note**: you probably shouldn't use this parameter, it is inherited
+                from Starlette and supported for compatibility.
+
+                In FastAPI, you normally would use the *path operation* decorators,
+                like:
+
+                * `app.get()`
+                * `app.post()`
+                * etc.
+
+                ---
+
+                A list of routes to serve incoming HTTP and WebSocket requests.
+                """
+            ),
+            deprecated(
+                """
+                You normally wouldn't use this parameter with FastAPI, it is inherited
+                from Starlette and supported for compatibility.
+
+                In FastAPI, you normally would use the *path operation methods*,
+                like `app.get()`, `app.post()`, etc.
+                """
+            ),
         ] = None,
-        on_startup: Optional[Sequence[Callable[[], Any]]] = None,
-        on_shutdown: Optional[Sequence[Callable[[], Any]]] = None,
-        lifespan: Optional[Lifespan[AppType]] = None,
-        terms_of_service: Optional[str] = None,
-        contact: Optional[Dict[str, Union[str, Any]]] = None,
-        license_info: Optional[Dict[str, Union[str, Any]]] = None,
-        openapi_prefix: str = "",
-        root_path: str = "",
-        root_path_in_servers: bool = True,
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        webhooks: Optional[routing.APIRouter] = None,
-        deprecated: Optional[bool] = None,
-        include_in_schema: bool = True,
-        swagger_ui_parameters: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
-            generate_unique_id
-        ),
-        separate_input_output_schemas: bool = True,
-        **extra: Any,
+        title: Annotated[
+            str,
+            Doc(
+                """
+                The title of the API.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more in the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(title="ChimichangApp")
+                ```
+                """
+            ),
+        ] = "FastAPI",
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A short summary of the API.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more in the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(summary="Deadpond's favorite app. Nuff said.")
+                ```
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            str,
+            Doc(
+                '''
+                A description of the API. Supports Markdown (using
+                [CommonMark syntax](https://commonmark.org/)).
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more in the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(
+                    description="""
+                                ChimichangApp API helps you do awesome stuff. 🚀
+
+                                ## Items
+
+                                You can **read items**.
+
+                                ## Users
+
+                                You will be able to:
+
+                                * **Create users** (_not implemented_).
+                                * **Read users** (_not implemented_).
+
+                                """
+                )
+                ```
+                '''
+            ),
+        ] = "",
+        version: Annotated[
+            str,
+            Doc(
+                """
+                The version of the API.
+
+                **Note** This is the version of your application, not the version of
+                the OpenAPI specification nor the version of FastAPI being used.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more in the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(version="0.0.1")
+                ```
+                """
+            ),
+        ] = "0.1.0",
+        openapi_url: Annotated[
+            Optional[str],
+            Doc(
+                """
+                The URL where the OpenAPI schema will be served from.
+
+                If you set it to `None`, no OpenAPI schema will be served publicly, and
+                the default automatic endpoints `/docs` and `/redoc` will also be
+                disabled.
+
+                Read more in the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#openapi-url).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(openapi_url="/api/v1/openapi.json")
+                ```
+                """
+            ),
+        ] = "/openapi.json",
+        openapi_tags: Annotated[
+            Optional[List[Dict[str, Any]]],
+            Doc(
+                """
+                A list of tags used by OpenAPI, these are the same `tags` you can set
+                in the *path operations*, like:
+
+                * `@app.get("/users/", tags=["users"])`
+                * `@app.get("/items/", tags=["items"])`
+
+                The order of the tags can be used to specify the order shown in
+                tools like Swagger UI, used in the automatic path `/docs`.
+
+                It's not required to specify all the tags used.
+
+                The tags that are not declared MAY be organized randomly or based
+                on the tools' logic. Each tag name in the list MUST be unique.
+
+                The value of each item is a `dict` containing:
+
+                * `name`: The name of the tag.
+                * `description`: A short description of the tag.
+                    [CommonMark syntax](https://commonmark.org/) MAY be used for rich
+                    text representation.
+                * `externalDocs`: Additional external documentation for this tag. If
+                    provided, it would contain a `dict` with:
+                    * `description`: A short description of the target documentation.
+                        [CommonMark syntax](https://commonmark.org/) MAY be used for
+                        rich text representation.
+                    * `url`: The URL for the target documentation. Value MUST be in
+                        the form of a URL.
+
+                Read more in the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-tags).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                tags_metadata = [
+                    {
+                        "name": "users",
+                        "description": "Operations with users. The **login** logic is also here.",
+                    },
+                    {
+                        "name": "items",
+                        "description": "Manage items. So _fancy_ they have their own docs.",
+                        "externalDocs": {
+                            "description": "Items external docs",
+                            "url": "https://fastapi.tiangolo.com/",
+                        },
+                    },
+                ]
+
+                app = FastAPI(openapi_tags=tags_metadata)
+                ```
+                """
+            ),
+        ] = None,
+        servers: Annotated[
+            Optional[List[Dict[str, Union[str, Any]]]],
+            Doc(
+                """
+                A `list` of `dict`s with connectivity information to a target server.
+
+                You would use it, for example, if your application is served from
+                different domains and you want to use the same Swagger UI in the
+                browser to interact with each of them (instead of having multiple
+                browser tabs open). Or if you want to leave fixed the possible URLs.
+
+                If the servers `list` is not provided, or is an empty `list`, the
+                default value would be a a `dict` with a `url` value of `/`.
+
+                Each item in the `list` is a `dict` containing:
+
+                * `url`: A URL to the target host. This URL supports Server Variables
+                and MAY be relative, to indicate that the host location is relative
+                to the location where the OpenAPI document is being served. Variable
+                substitutions will be made when a variable is named in `{`brackets`}`.
+                * `description`: An optional string describing the host designated by
+                the URL. [CommonMark syntax](https://commonmark.org/) MAY be used for
+                rich text representation.
+                * `variables`: A `dict` between a variable name and its value. The value
+                    is used for substitution in the server's URL template.
+
+                Read more in the
+                [FastAPI docs for Behind a Proxy](https://fastapi.tiangolo.com/advanced/behind-a-proxy/#additional-servers).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(
+                    servers=[
+                        {"url": "https://stag.example.com", "description": "Staging environment"},
+                        {"url": "https://prod.example.com", "description": "Production environment"},
+                    ]
+                )
+                ```
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of global dependencies, they will be applied to each
+                *path operation*, including in sub-routers.
+
+                Read more about it in the
+                [FastAPI docs for Global Dependencies](https://fastapi.tiangolo.com/tutorial/dependencies/global-dependencies/).
+
+                **Example**
+
+                ```python
+                from fastapi import Depends, FastAPI
+
+                from .dependencies import func_dep_1, func_dep_2
+
+                app = FastAPI(dependencies=[Depends(func_dep_1), Depends(func_dep_2)])
+                ```
+                """
+            ),
+        ] = None,
+        default_response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                The default response class to be used.
+
+                Read more in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#default-response-class).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+                from fastapi.responses import ORJSONResponse
+
+                app = FastAPI(default_response_class=ORJSONResponse)
+                ```
+                """
+            ),
+        ] = Default(JSONResponse),
+        redirect_slashes: Annotated[
+            bool,
+            Doc(
+                """
+                Whether to detect and redirect slashes in URLs when the client doesn't
+                use the same format.
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(redirect_slashes=True)  # the default
+
+                @app.get("/items/")
+                async def read_items():
+                    return [{"item_id": "Foo"}]
+                ```
+
+                With this app, if a client goes to `/items` (without a trailing slash),
+                they will be automatically redirected with an HTTP status code of 307
+                to `/items/`.
+                """
+            ),
+        ] = True,
+        docs_url: Annotated[
+            Optional[str],
+            Doc(
+                """
+                The path to the automatic interactive API documentation.
+                It is handled in the browser by Swagger UI.
+
+                The default URL is `/docs`. You can disable it by setting it to `None`.
+
+                If `openapi_url` is set to `None`, this will be automatically disabled.
+
+                Read more in the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#docs-urls).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(docs_url="/documentation", redoc_url=None)
+                ```
+                """
+            ),
+        ] = "/docs",
+        redoc_url: Annotated[
+            Optional[str],
+            Doc(
+                """
+                The path to the alternative automatic interactive API documentation
+                provided by ReDoc.
+
+                The default URL is `/redoc`. You can disable it by setting it to `None`.
+
+                If `openapi_url` is set to `None`, this will be automatically disabled.
+
+                Read more in the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#docs-urls).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(docs_url="/documentation", redoc_url="redocumentation")
+                ```
+                """
+            ),
+        ] = "/redoc",
+        swagger_ui_oauth2_redirect_url: Annotated[
+            Optional[str],
+            Doc(
+                """
+                The OAuth2 redirect endpoint for the Swagger UI.
+
+                By default it is `/docs/oauth2-redirect`.
+
+                This is only used if you use OAuth2 (with the "Authorize" button)
+                with Swagger UI.
+                """
+            ),
+        ] = "/docs/oauth2-redirect",
+        swagger_ui_init_oauth: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                OAuth2 configuration for the Swagger UI, by default shown at `/docs`.
+
+                Read more about the available configuration options in the
+                [Swagger UI docs](https://swagger.io/docs/open-source-tools/swagger-ui/usage/oauth2/).
+                """
+            ),
+        ] = None,
+        middleware: Annotated[
+            Optional[Sequence[Middleware]],
+            Doc(
+                """
+                List of middleware to be added when creating the application.
+
+                In FastAPI you would normally do this with `app.add_middleware()`
+                instead.
+
+                Read more in the
+                [FastAPI docs for Middleware](https://fastapi.tiangolo.com/tutorial/middleware/).
+                """
+            ),
+        ] = None,
+        exception_handlers: Annotated[
+            Optional[
+                Dict[
+                    Union[int, Type[Exception]],
+                    Callable[[Request, Any], Coroutine[Any, Any, Response]],
+                ]
+            ],
+            Doc(
+                """
+                A dictionary with handlers for exceptions.
+
+                In FastAPI, you would normally use the decorator
+                `@app.exception_handler()`.
+
+                Read more in the
+                [FastAPI docs for Handling Errors](https://fastapi.tiangolo.com/tutorial/handling-errors/).
+                """
+            ),
+        ] = None,
+        on_startup: Annotated[
+            Optional[Sequence[Callable[[], Any]]],
+            Doc(
+                """
+                A list of startup event handler functions.
+
+                You should instead use the `lifespan` handlers.
+
+                Read more in the [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/).
+                """
+            ),
+        ] = None,
+        on_shutdown: Annotated[
+            Optional[Sequence[Callable[[], Any]]],
+            Doc(
+                """
+                A list of shutdown event handler functions.
+
+                You should instead use the `lifespan` handlers.
+
+                Read more in the
+                [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/).
+                """
+            ),
+        ] = None,
+        lifespan: Annotated[
+            Optional[Lifespan[AppType]],
+            Doc(
+                """
+                A `Lifespan` context manager handler. This replaces `startup` and
+                `shutdown` functions with a single context manager.
+
+                Read more in the
+                [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/).
+                """
+            ),
+        ] = None,
+        terms_of_service: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A URL to the Terms of Service for your API.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more at the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api).
+
+                **Example**
+
+                ```python
+                app = FastAPI(terms_of_service="http://example.com/terms/")
+                ```
+                """
+            ),
+        ] = None,
+        contact: Annotated[
+            Optional[Dict[str, Union[str, Any]]],
+            Doc(
+                """
+                A dictionary with the contact information for the exposed API.
+
+                It can contain several fields.
+
+                * `name`: (`str`) The name of the contact person/organization.
+                * `url`: (`str`) A URL pointing to the contact information. MUST be in
+                    the format of a URL.
+                * `email`: (`str`) The email address of the contact person/organization.
+                    MUST be in the format of an email address.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more at the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api).
+
+                **Example**
+
+                ```python
+                app = FastAPI(
+                    contact={
+                        "name": "Deadpoolio the Amazing",
+                        "url": "http://x-force.example.com/contact/",
+                        "email": "dp@x-force.example.com",
+                    }
+                )
+                ```
+                """
+            ),
+        ] = None,
+        license_info: Annotated[
+            Optional[Dict[str, Union[str, Any]]],
+            Doc(
+                """
+                A dictionary with the license information for the exposed API.
+
+                It can contain several fields.
+
+                * `name`: (`str`) **REQUIRED** (if a `license_info` is set). The
+                    license name used for the API.
+                * `identifier`: (`str`) An [SPDX](https://spdx.dev/) license expression
+                    for the API. The `identifier` field is mutually exclusive of the `url`
+                    field. Available since OpenAPI 3.1.0, FastAPI 0.99.0.
+                * `url`: (`str`) A URL to the license used for the API. This MUST be
+                    the format of a URL.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more at the
+                [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api).
+
+                **Example**
+
+                ```python
+                app = FastAPI(
+                    license_info={
+                        "name": "Apache 2.0",
+                        "url": "https://www.apache.org/licenses/LICENSE-2.0.html",
+                    }
+                )
+                ```
+                """
+            ),
+        ] = None,
+        openapi_prefix: Annotated[
+            str,
+            Doc(
+                """
+                A URL prefix for the OpenAPI URL.
+                """
+            ),
+            deprecated(
+                """
+                "openapi_prefix" has been deprecated in favor of "root_path", which
+                follows more closely the ASGI standard, is simpler, and more
+                automatic.
+                """
+            ),
+        ] = "",
+        root_path: Annotated[
+            str,
+            Doc(
+                """
+                A path prefix handled by a proxy that is not seen by the application
+                but is seen by external clients, which affects things like Swagger UI.
+
+                Read more about it at the
+                [FastAPI docs for Behind a Proxy](https://fastapi.tiangolo.com/advanced/behind-a-proxy/).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(root_path="/api/v1")
+                ```
+                """
+            ),
+        ] = "",
+        root_path_in_servers: Annotated[
+            bool,
+            Doc(
+                """
+                To disable automatically generating the URLs in the `servers` field
+                in the autogenerated OpenAPI using the `root_path`.
+
+                Read more about it in the
+                [FastAPI docs for Behind a Proxy](https://fastapi.tiangolo.com/advanced/behind-a-proxy/#disable-automatic-server-from-root_path).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI(root_path_in_servers=False)
+                ```
+                """
+            ),
+        ] = True,
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses to be shown in OpenAPI.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Additional Responses in OpenAPI](https://fastapi.tiangolo.com/advanced/additional-responses/).
+
+                And in the
+                [FastAPI docs for Bigger Applications](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies).
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                OpenAPI callbacks that should apply to all *path operations*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        webhooks: Annotated[
+            Optional[routing.APIRouter],
+            Doc(
+                """
+                Add OpenAPI webhooks. This is similar to `callbacks` but it doesn't
+                depend on specific *path operations*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                **Note**: This is available since OpenAPI 3.1.0, FastAPI 0.99.0.
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Webhooks](https://fastapi.tiangolo.com/advanced/openapi-webhooks/).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark all *path operations* as deprecated. You probably don't need it,
+                but it's available.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                To include (or not) all the *path operations* in the generated OpenAPI.
+                You probably don't need it, but it's available.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        swagger_ui_parameters: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Parameters to configure Swagger UI, the autogenerated interactive API
+                documentation (by default at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs about how to Configure Swagger UI](https://fastapi.tiangolo.com/how-to/configure-swagger-ui/).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[routing.APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
+        separate_input_output_schemas: Annotated[
+            bool,
+            Doc(
+                """
+                Whether to generate separate OpenAPI schemas for request body and
+                response body when the results would be more precise.
+
+                This is particularly useful when automatically generating clients.
+
+                For example, if you have a model like:
+
+                ```python
+                from pydantic import BaseModel
+
+                class Item(BaseModel):
+                    name: str
+                    tags: list[str] = []
+                ```
+
+                When `Item` is used for input, a request body, `tags` is not required,
+                the client doesn't have to provide it.
+
+                But when using `Item` for output, for a response body, `tags` is always
+                available because it has a default value, even if it's just an empty
+                list. So, the client should be able to always expect it.
+
+                In this case, there would be two different schemas, one for input and
+                another one for output.
+                """
+            ),
+        ] = True,
+        **extra: Annotated[
+            Any,
+            Doc(
+                """
+                Extra keyword arguments to be stored in the app, not used by FastAPI
+                anywhere.
+                """
+            ),
+        ],
     ) -> None:
         self.debug = debug
         self.title = title
@@ -114,7 +849,37 @@ class FastAPI(Starlette):
         self.servers = servers or []
         self.separate_input_output_schemas = separate_input_output_schemas
         self.extra = extra
-        self.openapi_version = "3.1.0"
+        self.openapi_version: Annotated[
+            str,
+            Doc(
+                """
+                The version string of OpenAPI.
+
+                FastAPI will generate OpenAPI version 3.1.0, and will output that as
+                the OpenAPI version. But some tools, even though they might be
+                compatible with OpenAPI 3.1.0, might not recognize it as a valid.
+
+                So you could override this value to trick those tools into using
+                the generated OpenAPI. Have in mind that this is a hack. But if you
+                avoid using features added in OpenAPI 3.1.0, it might work for your
+                use case.
+
+                This is not passed as a parameter to the `FastAPI` class to avoid
+                giving the false idea that FastAPI would generate a different OpenAPI
+                schema. It is only available as an attribute.
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                app = FastAPI()
+
+                app.openapi_version = "3.0.2"
+                ```
+                """
+            ),
+        ] = "3.1.0"
         self.openapi_schema: Optional[Dict[str, Any]] = None
         if self.openapi_url:
             assert self.title, "A title must be provided for OpenAPI, e.g.: 'My API'"
@@ -127,10 +892,55 @@ class FastAPI(Starlette):
                 "automatic. Check the docs at "
                 "https://fastapi.tiangolo.com/advanced/sub-applications/"
             )
-        self.webhooks = webhooks or routing.APIRouter()
+        self.webhooks: Annotated[
+            routing.APIRouter,
+            Doc(
+                """
+                The `app.webhooks` attribute is an `APIRouter` with the *path
+                operations* that will be used just for documentation of webhooks.
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Webhooks](https://fastapi.tiangolo.com/advanced/openapi-webhooks/).
+                """
+            ),
+        ] = (
+            webhooks or routing.APIRouter()
+        )
         self.root_path = root_path or openapi_prefix
-        self.state: State = State()
-        self.dependency_overrides: Dict[Callable[..., Any], Callable[..., Any]] = {}
+        self.state: Annotated[
+            State,
+            Doc(
+                """
+                A state object for the application. This is the same object for the
+                entire application, it doesn't change from request to request.
+
+                You normally woudln't use this in FastAPI, for most of the cases you
+                would instead use FastAPI dependencies.
+
+                This is simply inherited from Starlette.
+
+                Read more about it in the
+                [Starlette docs for Applications](https://www.starlette.io/applications/#storing-state-on-the-app-instance).
+                """
+            ),
+        ] = State()
+        self.dependency_overrides: Annotated[
+            Dict[Callable[..., Any], Callable[..., Any]],
+            Doc(
+                """
+                A dictionary with overrides for the dependencies.
+
+                Each key is the original dependency callable, and the value is the
+                actual dependency that should be called.
+
+                This is for testing, to replace expensive dependencies with testing
+                versions.
+
+                Read more about it in the
+                [FastAPI docs for Testing Dependencies with Overrides](https://fastapi.tiangolo.com/advanced/testing-dependencies/).
+                """
+            ),
+        ] = {}
         self.router: routing.APIRouter = routing.APIRouter(
             routes=routes,
             redirect_slashes=redirect_slashes,
@@ -215,6 +1025,19 @@ class FastAPI(Starlette):
         return app
 
     def openapi(self) -> Dict[str, Any]:
+        """
+        Generate the OpenAPI schema of the application. This is called by FastAPI
+        internally.
+
+        The first time it is called it stores the result in the attribute
+        `app.openapi_schema`, and next times it is called, it just returns that same
+        result. To avoid the cost of generating the schema every time.
+
+        If you need to modify the generated OpenAPI schema, you could modify it.
+
+        Read more in the
+        [FastAPI docs for OpenAPI](https://fastapi.tiangolo.com/how-to/extending-openapi/).
+        """
         if not self.openapi_schema:
             self.openapi_schema = get_openapi(
                 title=self.title,
@@ -427,11 +1250,58 @@ class FastAPI(Starlette):
 
     def websocket(
         self,
-        path: str,
-        name: Optional[str] = None,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                WebSocket path.
+                """
+            ),
+        ],
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A name for the WebSocket. Only used internally.
+                """
+            ),
+        ] = None,
         *,
-        dependencies: Optional[Sequence[Depends]] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be used for this
+                WebSocket.
+
+                Read more about it in the
+                [FastAPI docs for WebSockets](https://fastapi.tiangolo.com/advanced/websockets/).
+                """
+            ),
+        ] = None,
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Decorate a WebSocket function.
+
+        Read more about it in the
+        [FastAPI docs for WebSockets](https://fastapi.tiangolo.com/advanced/websockets/).
+
+        **Example**
+
+        ```python
+        from fastapi import FastAPI, WebSocket
+
+        app = FastAPI()
+
+        @app.websocket("/ws")
+        async def websocket_endpoint(websocket: WebSocket):
+            await websocket.accept()
+            while True:
+                data = await websocket.receive_text()
+                await websocket.send_text(f"Message text was: {data}")
+        ```
+        """
+
         def decorator(func: DecoratedCallable) -> DecoratedCallable:
             self.add_api_websocket_route(
                 path,
@@ -445,62 +1315,556 @@ class FastAPI(Starlette):
 
     def include_router(
         self,
-        router: routing.APIRouter,
+        router: Annotated[routing.APIRouter, Doc("The `APIRouter` to include.")],
         *,
-        prefix: str = "",
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[Depends]] = None,
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        include_in_schema: bool = True,
-        default_response_class: Type[Response] = Default(JSONResponse),
-        callbacks: Optional[List[BaseRoute]] = None,
-        generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
-            generate_unique_id
-        ),
-    ) -> None:
-        self.router.include_router(
-            router,
-            prefix=prefix,
-            tags=tags,
-            dependencies=dependencies,
-            responses=responses,
-            deprecated=deprecated,
-            include_in_schema=include_in_schema,
-            default_response_class=default_response_class,
-            callbacks=callbacks,
-            generate_unique_id_function=generate_unique_id_function,
-        )
+        prefix: Annotated[str, Doc("An optional path prefix for the router.")] = "",
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to all the *path operations* in this
+                router.
 
-    def get(
-        self,
-        path: str,
-        *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
-            generate_unique_id
-        ),
-    ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to all the
+                *path operations* in this router.
+
+                Read more about it in the
+                [FastAPI docs for Bigger Applications - Multiple Files](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies).
+
+                **Example**
+
+                ```python
+                from fastapi import Depends, FastAPI
+
+                from .dependencies import get_token_header
+                from .internal import admin
+
+                app = FastAPI()
+
+                app.include_router(
+                    admin.router,
+                    dependencies=[Depends(get_token_header)],
+                )
+                ```
+                """
+            ),
+        ] = None,
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses to be shown in OpenAPI.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Additional Responses in OpenAPI](https://fastapi.tiangolo.com/advanced/additional-responses/).
+
+                And in the
+                [FastAPI docs for Bigger Applications](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark all the *path operations* in this router as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                from .internal import old_api
+
+                app = FastAPI()
+
+                app.include_router(
+                    old_api.router,
+                    deprecated=True,
+                )
+                ```
+                """
+            ),
+        ] = None,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include (or not) all the *path operations* in this router in the
+                generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+
+                from .internal import old_api
+
+                app = FastAPI()
+
+                app.include_router(
+                    old_api.router,
+                    include_in_schema=False,
+                )
+                ```
+                """
+            ),
+        ] = True,
+        default_response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Default response class to be used for the *path operations* in this
+                router.
+
+                Read more in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#default-response-class).
+
+                **Example**
+
+                ```python
+                from fastapi import FastAPI
+                from fastapi.responses import ORJSONResponse
+
+                from .internal import old_api
+
+                app = FastAPI()
+
+                app.include_router(
+                    old_api.router,
+                    default_response_class=ORJSONResponse,
+                )
+                ```
+                """
+            ),
+        ] = Default(JSONResponse),
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[routing.APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
+    ) -> None:
+        """
+        Include an `APIRouter` in the same app.
+
+        Read more about it in the
+        [FastAPI docs for Bigger Applications](https://fastapi.tiangolo.com/tutorial/bigger-applications/).
+
+        ## Example
+
+        ```python
+        from fastapi import FastAPI
+
+        from .users import users_router
+
+        app = FastAPI()
+
+        app.include_router(users_router)
+        ```
+        """
+        self.router.include_router(
+            router,
+            prefix=prefix,
+            tags=tags,
+            dependencies=dependencies,
+            responses=responses,
+            deprecated=deprecated,
+            include_in_schema=include_in_schema,
+            default_response_class=default_response_class,
+            callbacks=callbacks,
+            generate_unique_id_function=generate_unique_id_function,
+        )
+
+    def get(
+        self,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
+        *,
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[routing.APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
+    ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP GET operation.
+
+        ## Example
+
+        ```python
+        from fastapi import FastAPI
+
+        app = FastAPI()
+
+        @app.get("/items/")
+        def read_items():
+            return [{"name": "Empanada"}, {"name": "Arepa"}]
+        ```
+        """
         return self.router.get(
             path,
             response_model=response_model,
@@ -529,33 +1893,356 @@ class FastAPI(Starlette):
 
     def put(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[routing.APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP PUT operation.
+
+        ## Example
+
+        ```python
+        from fastapi import FastAPI
+        from pydantic import BaseModel
+
+        class Item(BaseModel):
+            name: str
+            description: str | None = None
+
+        app = FastAPI()
+
+        @app.put("/items/{item_id}")
+        def replace_item(item_id: str, item: Item):
+            return {"message": "Item replaced", "id": item_id}
+        ```
+        """
         return self.router.put(
             path,
             response_model=response_model,
@@ -584,33 +2271,356 @@ class FastAPI(Starlette):
 
     def post(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[routing.APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP POST operation.
+
+        ## Example
+
+        ```python
+        from fastapi import FastAPI
+        from pydantic import BaseModel
+
+        class Item(BaseModel):
+            name: str
+            description: str | None = None
+
+        app = FastAPI()
+
+        @app.post("/items/")
+        def create_item(item: Item):
+            return {"message": "Item created"}
+        ```
+        """
         return self.router.post(
             path,
             response_model=response_model,
@@ -639,33 +2649,351 @@ class FastAPI(Starlette):
 
     def delete(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[routing.APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP DELETE operation.
+
+        ## Example
+
+        ```python
+        from fastapi import FastAPI
+
+        app = FastAPI()
+
+        @app.delete("/items/{item_id}")
+        def delete_item(item_id: str):
+            return {"message": "Item deleted"}
+        ```
+        """
         return self.router.delete(
             path,
             response_model=response_model,
@@ -694,33 +3022,351 @@ class FastAPI(Starlette):
 
     def options(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[routing.APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP OPTIONS operation.
+
+        ## Example
+
+        ```python
+        from fastapi import FastAPI
+
+        app = FastAPI()
+
+        @app.options("/items/")
+        def get_item_options():
+            return {"additions": ["Aji", "Guacamole"]}
+        ```
+        """
         return self.router.options(
             path,
             response_model=response_model,
@@ -747,35 +3393,353 @@ class FastAPI(Starlette):
             generate_unique_id_function=generate_unique_id_function,
         )
 
-    def head(
-        self,
-        path: str,
-        *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
-            generate_unique_id
-        ),
+    def head(
+        self,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
+        *,
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[routing.APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP HEAD operation.
+
+        ## Example
+
+        ```python
+        from fastapi import FastAPI, Response
+
+        app = FastAPI()
+
+        @app.head("/items/", status_code=204)
+        def get_items_headers(response: Response):
+            response.headers["X-Cat-Dog"] = "Alone in the world"
+        ```
+        """
         return self.router.head(
             path,
             response_model=response_model,
@@ -804,33 +3768,356 @@ class FastAPI(Starlette):
 
     def patch(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[routing.APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP PATCH operation.
+
+        ## Example
+
+        ```python
+        from fastapi import FastAPI
+        from pydantic import BaseModel
+
+        class Item(BaseModel):
+            name: str
+            description: str | None = None
+
+        app = FastAPI()
+
+        @app.patch("/items/")
+        def update_item(item: Item):
+            return {"message": "Item updated in place"}
+        ```
+        """
         return self.router.patch(
             path,
             response_model=response_model,
@@ -859,33 +4146,351 @@ class FastAPI(Starlette):
 
     def trace(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[routing.APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[routing.APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP TRACE operation.
+
+        ## Example
+
+        ```python
+        from fastapi import FastAPI
+
+        app = FastAPI()
+
+        @app.put("/items/{item_id}")
+        def trace_item(item_id: str):
+            return None
+        ```
+        """
         return self.router.trace(
             path,
             response_model=response_model,
@@ -921,14 +4526,72 @@ class FastAPI(Starlette):
 
         return decorator
 
+    @deprecated(
+        """
+        on_event is deprecated, use lifespan event handlers instead.
+
+        Read more about it in the
+        [FastAPI docs for Lifespan Events](https://fastapi.tiangolo.com/advanced/events/).
+        """
+    )
     def on_event(
-        self, event_type: str
+        self,
+        event_type: Annotated[
+            str,
+            Doc(
+                """
+                The type of event. `startup` or `shutdown`.
+                """
+            ),
+        ],
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add an event handler for the application.
+
+        `on_event` is deprecated, use `lifespan` event handlers instead.
+
+        Read more about it in the
+        [FastAPI docs for Lifespan Events](https://fastapi.tiangolo.com/advanced/events/#alternative-events-deprecated).
+        """
         return self.router.on_event(event_type)
 
     def middleware(
-        self, middleware_type: str
+        self,
+        middleware_type: Annotated[
+            str,
+            Doc(
+                """
+                The type of middleware. Currently only supports `http`.
+                """
+            ),
+        ],
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a middleware to the application.
+
+        Read more about it in the
+        [FastAPI docs for Middleware](https://fastapi.tiangolo.com/tutorial/middleware/).
+
+        ## Example
+
+        ```python
+        import time
+
+        from fastapi import FastAPI, Request
+
+        app = FastAPI()
+
+
+        @app.middleware("http")
+        async def add_process_time_header(request: Request, call_next):
+            start_time = time.time()
+            response = await call_next(request)
+            process_time = time.time() - start_time
+            response.headers["X-Process-Time"] = str(process_time)
+            return response
+        ```
+        """
+
         def decorator(func: DecoratedCallable) -> DecoratedCallable:
             self.add_middleware(BaseHTTPMiddleware, dispatch=func)
             return func
@@ -936,8 +4599,46 @@ class FastAPI(Starlette):
         return decorator
 
     def exception_handler(
-        self, exc_class_or_status_code: Union[int, Type[Exception]]
+        self,
+        exc_class_or_status_code: Annotated[
+            Union[int, Type[Exception]],
+            Doc(
+                """
+                The Exception class this would handle, or a status code.
+                """
+            ),
+        ],
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add an exception handler to the app.
+
+        Read more about it in the
+        [FastAPI docs for Handling Errors](https://fastapi.tiangolo.com/tutorial/handling-errors/).
+
+        ## Example
+
+        ```python
+        from fastapi import FastAPI, Request
+        from fastapi.responses import JSONResponse
+
+
+        class UnicornException(Exception):
+            def __init__(self, name: str):
+                self.name = name
+
+
+        app = FastAPI()
+
+
+        @app.exception_handler(UnicornException)
+        async def unicorn_exception_handler(request: Request, exc: UnicornException):
+            return JSONResponse(
+                status_code=418,
+                content={"message": f"Oops! {exc.name} did something. There goes a rainbow..."},
+            )
+        ```
+        """
+
         def decorator(func: DecoratedCallable) -> DecoratedCallable:
             self.add_exception_handler(exc_class_or_status_code, func)
             return func
diff --git a/fastapi/background.py b/fastapi/background.py
index dd3bbe249..35ab1b227 100644
--- a/fastapi/background.py
+++ b/fastapi/background.py
@@ -1 +1,59 @@
-from starlette.background import BackgroundTasks as BackgroundTasks  # noqa
+from typing import Any, Callable
+
+from starlette.background import BackgroundTasks as StarletteBackgroundTasks
+from typing_extensions import Annotated, Doc, ParamSpec  # type: ignore [attr-defined]
+
+P = ParamSpec("P")
+
+
+class BackgroundTasks(StarletteBackgroundTasks):
+    """
+    A collection of background tasks that will be called after a response has been
+    sent to the client.
+
+    Read more about it in the
+    [FastAPI docs for Background Tasks](https://fastapi.tiangolo.com/tutorial/background-tasks/).
+
+    ## Example
+
+    ```python
+    from fastapi import BackgroundTasks, FastAPI
+
+    app = FastAPI()
+
+
+    def write_notification(email: str, message=""):
+        with open("log.txt", mode="w") as email_file:
+            content = f"notification for {email}: {message}"
+            email_file.write(content)
+
+
+    @app.post("/send-notification/{email}")
+    async def send_notification(email: str, background_tasks: BackgroundTasks):
+        background_tasks.add_task(write_notification, email, message="some notification")
+        return {"message": "Notification sent in the background"}
+    ```
+    """
+
+    def add_task(
+        self,
+        func: Annotated[
+            Callable[P, Any],
+            Doc(
+                """
+                The function to call after the response is sent.
+
+                It can be a regular `def` function or an `async def` function.
+                """
+            ),
+        ],
+        *args: P.args,
+        **kwargs: P.kwargs,
+    ) -> None:
+        """
+        Add a function to be called in the background after the response is sent.
+
+        Read more about it in the
+        [FastAPI docs for Background Tasks](https://fastapi.tiangolo.com/tutorial/background-tasks/).
+        """
+        return super().add_task(func, *args, **kwargs)
diff --git a/fastapi/datastructures.py b/fastapi/datastructures.py
index b2865cd40..ce03e3ce4 100644
--- a/fastapi/datastructures.py
+++ b/fastapi/datastructures.py
@@ -1,4 +1,14 @@
-from typing import Any, Callable, Dict, Iterable, Type, TypeVar, cast
+from typing import (
+    Any,
+    BinaryIO,
+    Callable,
+    Dict,
+    Iterable,
+    Optional,
+    Type,
+    TypeVar,
+    cast,
+)
 
 from fastapi._compat import (
     PYDANTIC_V2,
@@ -14,9 +24,120 @@ from starlette.datastructures import Headers as Headers  # noqa: F401
 from starlette.datastructures import QueryParams as QueryParams  # noqa: F401
 from starlette.datastructures import State as State  # noqa: F401
 from starlette.datastructures import UploadFile as StarletteUploadFile
+from typing_extensions import Annotated, Doc  # type: ignore [attr-defined]
 
 
 class UploadFile(StarletteUploadFile):
+    """
+    A file uploaded in a request.
+
+    Define it as a *path operation function* (or dependency) parameter.
+
+    If you are using a regular `def` function, you can use the `upload_file.file`
+    attribute to access the raw standard Python file (blocking, not async), useful and
+    needed for non-async code.
+
+    Read more about it in the
+    [FastAPI docs for Request Files](https://fastapi.tiangolo.com/tutorial/request-files/).
+
+    ## Example
+
+    ```python
+    from typing import Annotated
+
+    from fastapi import FastAPI, File, UploadFile
+
+    app = FastAPI()
+
+
+    @app.post("/files/")
+    async def create_file(file: Annotated[bytes, File()]):
+        return {"file_size": len(file)}
+
+
+    @app.post("/uploadfile/")
+    async def create_upload_file(file: UploadFile):
+        return {"filename": file.filename}
+    ```
+    """
+
+    file: Annotated[
+        BinaryIO,
+        Doc("The standard Python file object (non-async)."),
+    ]
+    filename: Annotated[Optional[str], Doc("The original file name.")]
+    size: Annotated[Optional[int], Doc("The size of the file in bytes.")]
+    headers: Annotated[Headers, Doc("The headers of the request.")]
+    content_type: Annotated[
+        Optional[str], Doc("The content type of the request, from the headers.")
+    ]
+
+    async def write(
+        self,
+        data: Annotated[
+            bytes,
+            Doc(
+                """
+                The bytes to write to the file.
+                """
+            ),
+        ],
+    ) -> None:
+        """
+        Write some bytes to the file.
+
+        You normally wouldn't use this from a file you read in a request.
+
+        To be awaitable, compatible with async, this is run in threadpool.
+        """
+        return await super().write(data)
+
+    async def read(
+        self,
+        size: Annotated[
+            int,
+            Doc(
+                """
+                The number of bytes to read from the file.
+                """
+            ),
+        ] = -1,
+    ) -> bytes:
+        """
+        Read some bytes from the file.
+
+        To be awaitable, compatible with async, this is run in threadpool.
+        """
+        return await super().read(size)
+
+    async def seek(
+        self,
+        offset: Annotated[
+            int,
+            Doc(
+                """
+                The position in bytes to seek to in the file.
+                """
+            ),
+        ],
+    ) -> None:
+        """
+        Move to a position in the file.
+
+        Any next read or write will be done from that position.
+
+        To be awaitable, compatible with async, this is run in threadpool.
+        """
+        return await super().seek(offset)
+
+    async def close(self) -> None:
+        """
+        Close the file.
+
+        To be awaitable, compatible with async, this is run in threadpool.
+        """
+        return await super().close()
+
     @classmethod
     def __get_validators__(cls: Type["UploadFile"]) -> Iterable[Callable[..., Any]]:
         yield cls.validate
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index e2915268c..96e07a45c 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -44,6 +44,7 @@ from fastapi._compat import (
     serialize_sequence_value,
     value_is_sequence,
 )
+from fastapi.background import BackgroundTasks
 from fastapi.concurrency import (
     AsyncExitStack,
     asynccontextmanager,
@@ -56,7 +57,7 @@ from fastapi.security.oauth2 import OAuth2, SecurityScopes
 from fastapi.security.open_id_connect_url import OpenIdConnect
 from fastapi.utils import create_response_field, get_path_param_names
 from pydantic.fields import FieldInfo
-from starlette.background import BackgroundTasks
+from starlette.background import BackgroundTasks as StarletteBackgroundTasks
 from starlette.concurrency import run_in_threadpool
 from starlette.datastructures import FormData, Headers, QueryParams, UploadFile
 from starlette.requests import HTTPConnection, Request
@@ -305,7 +306,7 @@ def add_non_field_param_to_dependency(
     elif lenient_issubclass(type_annotation, Response):
         dependant.response_param_name = param_name
         return True
-    elif lenient_issubclass(type_annotation, BackgroundTasks):
+    elif lenient_issubclass(type_annotation, StarletteBackgroundTasks):
         dependant.background_tasks_param_name = param_name
         return True
     elif lenient_issubclass(type_annotation, SecurityScopes):
@@ -382,7 +383,14 @@ def analyze_param(
 
     if lenient_issubclass(
         type_annotation,
-        (Request, WebSocket, HTTPConnection, Response, BackgroundTasks, SecurityScopes),
+        (
+            Request,
+            WebSocket,
+            HTTPConnection,
+            Response,
+            StarletteBackgroundTasks,
+            SecurityScopes,
+        ),
     ):
         assert depends is None, f"Cannot specify `Depends` for type {type_annotation!r}"
         assert (
@@ -510,14 +518,14 @@ async def solve_dependencies(
     request: Union[Request, WebSocket],
     dependant: Dependant,
     body: Optional[Union[Dict[str, Any], FormData]] = None,
-    background_tasks: Optional[BackgroundTasks] = None,
+    background_tasks: Optional[StarletteBackgroundTasks] = None,
     response: Optional[Response] = None,
     dependency_overrides_provider: Optional[Any] = None,
     dependency_cache: Optional[Dict[Tuple[Callable[..., Any], Tuple[str]], Any]] = None,
 ) -> Tuple[
     Dict[str, Any],
     List[Any],
-    Optional[BackgroundTasks],
+    Optional[StarletteBackgroundTasks],
     Response,
     Dict[Tuple[Callable[..., Any], Tuple[str]], Any],
 ]:
diff --git a/fastapi/encoders.py b/fastapi/encoders.py
index 30493697e..e50171393 100644
--- a/fastapi/encoders.py
+++ b/fastapi/encoders.py
@@ -22,6 +22,7 @@ from pydantic import BaseModel
 from pydantic.color import Color
 from pydantic.networks import AnyUrl, NameEmail
 from pydantic.types import SecretBytes, SecretStr
+from typing_extensions import Annotated, Doc  # type: ignore [attr-defined]
 
 from ._compat import PYDANTIC_V2, Url, _model_dump
 
@@ -99,16 +100,107 @@ encoders_by_class_tuples = generate_encoders_by_class_tuples(ENCODERS_BY_TYPE)
 
 
 def jsonable_encoder(
-    obj: Any,
-    include: Optional[IncEx] = None,
-    exclude: Optional[IncEx] = None,
-    by_alias: bool = True,
-    exclude_unset: bool = False,
-    exclude_defaults: bool = False,
-    exclude_none: bool = False,
-    custom_encoder: Optional[Dict[Any, Callable[[Any], Any]]] = None,
-    sqlalchemy_safe: bool = True,
+    obj: Annotated[
+        Any,
+        Doc(
+            """
+            The input object to convert to JSON.
+            """
+        ),
+    ],
+    include: Annotated[
+        Optional[IncEx],
+        Doc(
+            """
+            Pydantic's `include` parameter, passed to Pydantic models to set the
+            fields to include.
+            """
+        ),
+    ] = None,
+    exclude: Annotated[
+        Optional[IncEx],
+        Doc(
+            """
+            Pydantic's `exclude` parameter, passed to Pydantic models to set the
+            fields to exclude.
+            """
+        ),
+    ] = None,
+    by_alias: Annotated[
+        bool,
+        Doc(
+            """
+            Pydantic's `by_alias` parameter, passed to Pydantic models to define if
+            the output should use the alias names (when provided) or the Python
+            attribute names. In an API, if you set an alias, it's probably because you
+            want to use it in the result, so you probably want to leave this set to
+            `True`.
+            """
+        ),
+    ] = True,
+    exclude_unset: Annotated[
+        bool,
+        Doc(
+            """
+            Pydantic's `exclude_unset` parameter, passed to Pydantic models to define
+            if it should exclude from the output the fields that were not explicitly
+            set (and that only had their default values).
+            """
+        ),
+    ] = False,
+    exclude_defaults: Annotated[
+        bool,
+        Doc(
+            """
+            Pydantic's `exclude_defaults` parameter, passed to Pydantic models to define
+            if it should exclude from the output the fields that had the same default
+            value, even when they were explicitly set.
+            """
+        ),
+    ] = False,
+    exclude_none: Annotated[
+        bool,
+        Doc(
+            """
+            Pydantic's `exclude_none` parameter, passed to Pydantic models to define
+            if it should exclude from the output any fields that have a `None` value.
+            """
+        ),
+    ] = False,
+    custom_encoder: Annotated[
+        Optional[Dict[Any, Callable[[Any], Any]]],
+        Doc(
+            """
+            Pydantic's `custom_encoder` parameter, passed to Pydantic models to define
+            a custom encoder.
+            """
+        ),
+    ] = None,
+    sqlalchemy_safe: Annotated[
+        bool,
+        Doc(
+            """
+            Exclude from the output any fields that start with the name `_sa`.
+
+            This is mainly a hack for compatibility with SQLAlchemy objects, they
+            store internal SQLAlchemy-specific state in attributes named with `_sa`,
+            and those objects can't (and shouldn't be) serialized to JSON.
+            """
+        ),
+    ] = True,
 ) -> Any:
+    """
+    Convert any object to something that can be encoded in JSON.
+
+    This is used internally by FastAPI to make sure anything you return can be
+    encoded as JSON before it is sent to the client.
+
+    You can also use it yourself, for example to convert objects before saving them
+    in a database that supports only JSON.
+
+    Read more about it in the
+    [FastAPI docs for JSON Compatible Encoder](https://fastapi.tiangolo.com/tutorial/encoder/).
+    """
     custom_encoder = custom_encoder or {}
     if custom_encoder:
         if type(obj) in custom_encoder:
diff --git a/fastapi/exceptions.py b/fastapi/exceptions.py
index 42f4709fb..680d288e4 100644
--- a/fastapi/exceptions.py
+++ b/fastapi/exceptions.py
@@ -1,20 +1,141 @@
-from typing import Any, Dict, Optional, Sequence, Type
+from typing import Any, Dict, Optional, Sequence, Type, Union
 
 from pydantic import BaseModel, create_model
 from starlette.exceptions import HTTPException as StarletteHTTPException
-from starlette.exceptions import WebSocketException as WebSocketException  # noqa: F401
+from starlette.exceptions import WebSocketException as StarletteWebSocketException
+from typing_extensions import Annotated, Doc  # type: ignore [attr-defined]
 
 
 class HTTPException(StarletteHTTPException):
+    """
+    An HTTP exception you can raise in your own code to show errors to the client.
+
+    This is for client errors, invalid authentication, invalid data, etc. Not for server
+    errors in your code.
+
+    Read more about it in the
+    [FastAPI docs for Handling Errors](https://fastapi.tiangolo.com/tutorial/handling-errors/).
+
+    ## Example
+
+    ```python
+    from fastapi import FastAPI, HTTPException
+
+    app = FastAPI()
+
+    items = {"foo": "The Foo Wrestlers"}
+
+
+    @app.get("/items/{item_id}")
+    async def read_item(item_id: str):
+        if item_id not in items:
+            raise HTTPException(status_code=404, detail="Item not found")
+        return {"item": items[item_id]}
+    ```
+    """
+
     def __init__(
         self,
-        status_code: int,
-        detail: Any = None,
-        headers: Optional[Dict[str, str]] = None,
+        status_code: Annotated[
+            int,
+            Doc(
+                """
+                HTTP status code to send to the client.
+                """
+            ),
+        ],
+        detail: Annotated[
+            Any,
+            Doc(
+                """
+                Any data to be sent to the client in the `detail` key of the JSON
+                response.
+                """
+            ),
+        ] = None,
+        headers: Annotated[
+            Optional[Dict[str, str]],
+            Doc(
+                """
+                Any headers to send to the client in the response.
+                """
+            ),
+        ] = None,
     ) -> None:
         super().__init__(status_code=status_code, detail=detail, headers=headers)
 
 
+class WebSocketException(StarletteWebSocketException):
+    """
+    A WebSocket exception you can raise in your own code to show errors to the client.
+
+    This is for client errors, invalid authentication, invalid data, etc. Not for server
+    errors in your code.
+
+    Read more about it in the
+    [FastAPI docs for WebSockets](https://fastapi.tiangolo.com/advanced/websockets/).
+
+    ## Example
+
+    ```python
+    from typing import Annotated
+
+    from fastapi import (
+        Cookie,
+        FastAPI,
+        WebSocket,
+        WebSocketException,
+        status,
+    )
+
+    app = FastAPI()
+
+    @app.websocket("/items/{item_id}/ws")
+    async def websocket_endpoint(
+        *,
+        websocket: WebSocket,
+        session: Annotated[str | None, Cookie()] = None,
+        item_id: str,
+    ):
+        if session is None:
+            raise WebSocketException(code=status.WS_1008_POLICY_VIOLATION)
+        await websocket.accept()
+        while True:
+            data = await websocket.receive_text()
+            await websocket.send_text(f"Session cookie is: {session}")
+            await websocket.send_text(f"Message text was: {data}, for item ID: {item_id}")
+    ```
+    """
+
+    def __init__(
+        self,
+        code: Annotated[
+            int,
+            Doc(
+                """
+                A closing code from the
+                [valid codes defined in the specification](https://datatracker.ietf.org/doc/html/rfc6455#section-7.4.1).
+                """
+            ),
+        ],
+        reason: Annotated[
+            Union[str, None],
+            Doc(
+                """
+                The reason to close the WebSocket connection.
+
+                It is UTF-8-encoded data. The interpretation of the reason is up to the
+                application, it is not specified by the WebSocket specification.
+
+                It could contain text that could be human-readable or interpretable
+                by the client code, etc.
+                """
+            ),
+        ] = None,
+    ) -> None:
+        super().__init__(code=code, reason=reason)
+
+
 RequestErrorModel: Type[BaseModel] = create_model("Request")
 WebSocketErrorModel: Type[BaseModel] = create_model("WebSocket")
 
diff --git a/fastapi/openapi/docs.py b/fastapi/openapi/docs.py
index 81f67dcc5..8cf0d17a1 100644
--- a/fastapi/openapi/docs.py
+++ b/fastapi/openapi/docs.py
@@ -3,8 +3,18 @@ from typing import Any, Dict, Optional
 
 from fastapi.encoders import jsonable_encoder
 from starlette.responses import HTMLResponse
+from typing_extensions import Annotated, Doc  # type: ignore [attr-defined]
 
-swagger_ui_default_parameters = {
+swagger_ui_default_parameters: Annotated[
+    Dict[str, Any],
+    Doc(
+        """
+        Default configurations for Swagger UI.
+
+        You can use it as a template to add any other configurations needed.
+        """
+    ),
+] = {
     "dom_id": "#swagger-ui",
     "layout": "BaseLayout",
     "deepLinking": True,
@@ -15,15 +25,91 @@ swagger_ui_default_parameters = {
 
 def get_swagger_ui_html(
     *,
-    openapi_url: str,
-    title: str,
-    swagger_js_url: str = "https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui-bundle.js",
-    swagger_css_url: str = "https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui.css",
-    swagger_favicon_url: str = "https://fastapi.tiangolo.com/img/favicon.png",
-    oauth2_redirect_url: Optional[str] = None,
-    init_oauth: Optional[Dict[str, Any]] = None,
-    swagger_ui_parameters: Optional[Dict[str, Any]] = None,
+    openapi_url: Annotated[
+        str,
+        Doc(
+            """
+            The OpenAPI URL that Swagger UI should load and use.
+
+            This is normally done automatically by FastAPI using the default URL
+            `/openapi.json`.
+            """
+        ),
+    ],
+    title: Annotated[
+        str,
+        Doc(
+            """
+            The HTML `<title>` content, normally shown in the browser tab.
+            """
+        ),
+    ],
+    swagger_js_url: Annotated[
+        str,
+        Doc(
+            """
+            The URL to use to load the Swagger UI JavaScript.
+
+            It is normally set to a CDN URL.
+            """
+        ),
+    ] = "https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui-bundle.js",
+    swagger_css_url: Annotated[
+        str,
+        Doc(
+            """
+            The URL to use to load the Swagger UI CSS.
+
+            It is normally set to a CDN URL.
+            """
+        ),
+    ] = "https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui.css",
+    swagger_favicon_url: Annotated[
+        str,
+        Doc(
+            """
+            The URL of the favicon to use. It is normally shown in the browser tab.
+            """
+        ),
+    ] = "https://fastapi.tiangolo.com/img/favicon.png",
+    oauth2_redirect_url: Annotated[
+        Optional[str],
+        Doc(
+            """
+            The OAuth2 redirect URL, it is normally automatically handled by FastAPI.
+            """
+        ),
+    ] = None,
+    init_oauth: Annotated[
+        Optional[Dict[str, Any]],
+        Doc(
+            """
+            A dictionary with Swagger UI OAuth2 initialization configurations.
+            """
+        ),
+    ] = None,
+    swagger_ui_parameters: Annotated[
+        Optional[Dict[str, Any]],
+        Doc(
+            """
+            Configuration parameters for Swagger UI.
+
+            It defaults to [swagger_ui_default_parameters][fastapi.openapi.docs.swagger_ui_default_parameters].
+            """
+        ),
+    ] = None,
 ) -> HTMLResponse:
+    """
+    Generate and return the HTML  that loads Swagger UI for the interactive
+    API docs (normally served at `/docs`).
+
+    You would only call this function yourself if you needed to override some parts,
+    for example the URLs to use to load Swagger UI's JavaScript and CSS.
+
+    Read more about it in the
+    [FastAPI docs for Configure Swagger UI](https://fastapi.tiangolo.com/how-to/configure-swagger-ui/)
+    and the [FastAPI docs for Custom Docs UI Static Assets (Self-Hosting)](https://fastapi.tiangolo.com/how-to/custom-docs-ui-assets/).
+    """
     current_swagger_ui_parameters = swagger_ui_default_parameters.copy()
     if swagger_ui_parameters:
         current_swagger_ui_parameters.update(swagger_ui_parameters)
@@ -74,12 +160,62 @@ def get_swagger_ui_html(
 
 def get_redoc_html(
     *,
-    openapi_url: str,
-    title: str,
-    redoc_js_url: str = "https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js",
-    redoc_favicon_url: str = "https://fastapi.tiangolo.com/img/favicon.png",
-    with_google_fonts: bool = True,
+    openapi_url: Annotated[
+        str,
+        Doc(
+            """
+            The OpenAPI URL that ReDoc should load and use.
+
+            This is normally done automatically by FastAPI using the default URL
+            `/openapi.json`.
+            """
+        ),
+    ],
+    title: Annotated[
+        str,
+        Doc(
+            """
+            The HTML `<title>` content, normally shown in the browser tab.
+            """
+        ),
+    ],
+    redoc_js_url: Annotated[
+        str,
+        Doc(
+            """
+            The URL to use to load the ReDoc JavaScript.
+
+            It is normally set to a CDN URL.
+            """
+        ),
+    ] = "https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js",
+    redoc_favicon_url: Annotated[
+        str,
+        Doc(
+            """
+            The URL of the favicon to use. It is normally shown in the browser tab.
+            """
+        ),
+    ] = "https://fastapi.tiangolo.com/img/favicon.png",
+    with_google_fonts: Annotated[
+        bool,
+        Doc(
+            """
+            Load and use Google Fonts.
+            """
+        ),
+    ] = True,
 ) -> HTMLResponse:
+    """
+    Generate and return the HTML response that loads ReDoc for the alternative
+    API docs (normally served at `/redoc`).
+
+    You would only call this function yourself if you needed to override some parts,
+    for example the URLs to use to load ReDoc's JavaScript and CSS.
+
+    Read more about it in the
+    [FastAPI docs for Custom Docs UI Static Assets (Self-Hosting)](https://fastapi.tiangolo.com/how-to/custom-docs-ui-assets/).
+    """
     html = f"""
     <!DOCTYPE html>
     <html>
@@ -118,6 +254,11 @@ def get_redoc_html(
 
 
 def get_swagger_ui_oauth2_redirect_html() -> HTMLResponse:
+    """
+    Generate the HTML response with the OAuth2 redirection for Swagger UI.
+
+    You normally don't need to use or change this.
+    """
     # copied from https://github.com/swagger-api/swagger-ui/blob/v4.14.0/dist/oauth2-redirect.html
     html = """
     <!doctype html>
diff --git a/fastapi/param_functions.py b/fastapi/param_functions.py
index 63914d1d6..3f6dbc959 100644
--- a/fastapi/param_functions.py
+++ b/fastapi/param_functions.py
@@ -3,43 +3,218 @@ from typing import Any, Callable, Dict, List, Optional, Sequence, Union
 from fastapi import params
 from fastapi._compat import Undefined
 from fastapi.openapi.models import Example
-from typing_extensions import Annotated, deprecated
+from typing_extensions import Annotated, Doc, deprecated  # type: ignore [attr-defined]
 
 _Unset: Any = Undefined
 
 
 def Path(  # noqa: N802
-    default: Any = ...,
+    default: Annotated[
+        Any,
+        Doc(
+            """
+            Default value if the parameter field is not set.
+
+            This doesn't affect `Path` parameters as the value is always required.
+            The parameter is available only for compatibility.
+            """
+        ),
+    ] = ...,
     *,
-    default_factory: Union[Callable[[], Any], None] = _Unset,
-    alias: Optional[str] = None,
-    alias_priority: Union[int, None] = _Unset,
+    default_factory: Annotated[
+        Union[Callable[[], Any], None],
+        Doc(
+            """
+            A callable to generate the default value.
+
+            This doesn't affect `Path` parameters as the value is always required.
+            The parameter is available only for compatibility.
+            """
+        ),
+    ] = _Unset,
+    alias: Annotated[
+        Optional[str],
+        Doc(
+            """
+            An alternative name for the parameter field.
+
+            This will be used to extract the data and for the generated OpenAPI.
+            It is particularly useful when you can't use the name you want because it
+            is a Python reserved keyword or similar.
+            """
+        ),
+    ] = None,
+    alias_priority: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Priority of the alias. This affects whether an alias generator is used.
+            """
+        ),
+    ] = _Unset,
     # TODO: update when deprecating Pydantic v1, import these types
     # validation_alias: str | AliasPath | AliasChoices | None
-    validation_alias: Union[str, None] = None,
-    serialization_alias: Union[str, None] = None,
-    title: Optional[str] = None,
-    description: Optional[str] = None,
-    gt: Optional[float] = None,
-    ge: Optional[float] = None,
-    lt: Optional[float] = None,
-    le: Optional[float] = None,
-    min_length: Optional[int] = None,
-    max_length: Optional[int] = None,
-    pattern: Optional[str] = None,
+    validation_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Whitelist' validation step. The parameter field will be the single one
+            allowed by the alias or set of aliases defined.
+            """
+        ),
+    ] = None,
+    serialization_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Blacklist' validation step. The vanilla parameter field will be the
+            single one of the alias' or set of aliases' fields and all the other
+            fields will be ignored at serialization time.
+            """
+        ),
+    ] = None,
+    title: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable title.
+            """
+        ),
+    ] = None,
+    description: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable description.
+            """
+        ),
+    ] = None,
+    gt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than. If set, value must be greater than this. Only applicable to
+            numbers.
+            """
+        ),
+    ] = None,
+    ge: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than or equal. If set, value must be greater than or equal to
+            this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    lt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than. If set, value must be less than this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    le: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than or equal. If set, value must be less than or equal to this.
+            Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    min_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Minimum length for strings.
+            """
+        ),
+    ] = None,
+    max_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Maximum length for strings.
+            """
+        ),
+    ] = None,
+    pattern: Annotated[
+        Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
+    ] = None,
     regex: Annotated[
         Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
         deprecated(
             "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead."
         ),
     ] = None,
-    discriminator: Union[str, None] = None,
-    strict: Union[bool, None] = _Unset,
-    multiple_of: Union[float, None] = _Unset,
-    allow_inf_nan: Union[bool, None] = _Unset,
-    max_digits: Union[int, None] = _Unset,
-    decimal_places: Union[int, None] = _Unset,
-    examples: Optional[List[Any]] = None,
+    discriminator: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            Parameter field name for discriminating the type in a tagged union.
+            """
+        ),
+    ] = None,
+    strict: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            If `True`, strict validation is applied to the field.
+            """
+        ),
+    ] = _Unset,
+    multiple_of: Annotated[
+        Union[float, None],
+        Doc(
+            """
+            Value must be a multiple of this. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    allow_inf_nan: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            Allow `inf`, `-inf`, `nan`. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    max_digits: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of allow digits for strings.
+            """
+        ),
+    ] = _Unset,
+    decimal_places: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of decimal places allowed for numbers.
+            """
+        ),
+    ] = _Unset,
+    examples: Annotated[
+        Optional[List[Any]],
+        Doc(
+            """
+            Example values for this field.
+            """
+        ),
+    ] = None,
     example: Annotated[
         Optional[Any],
         deprecated(
@@ -47,12 +222,87 @@ def Path(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
-    openapi_examples: Optional[Dict[str, Example]] = None,
-    deprecated: Optional[bool] = None,
-    include_in_schema: bool = True,
-    json_schema_extra: Union[Dict[str, Any], None] = None,
-    **extra: Any,
+    openapi_examples: Annotated[
+        Optional[Dict[str, Example]],
+        Doc(
+            """
+            OpenAPI-specific examples.
+
+            It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+            Swagger UI (that provides the `/docs` interface) has better support for the
+            OpenAPI-specific examples than the JSON Schema `examples`, that's the main
+            use case for this.
+
+            Read more about it in the
+            [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter).
+            """
+        ),
+    ] = None,
+    deprecated: Annotated[
+        Optional[bool],
+        Doc(
+            """
+            Mark this parameter field as deprecated.
+
+            It will affect the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = None,
+    include_in_schema: Annotated[
+        bool,
+        Doc(
+            """
+            To include (or not) this parameter field in the generated OpenAPI.
+            You probably don't need it, but it's available.
+
+            This affects the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = True,
+    json_schema_extra: Annotated[
+        Union[Dict[str, Any], None],
+        Doc(
+            """
+            Any additional JSON schema data.
+            """
+        ),
+    ] = None,
+    **extra: Annotated[
+        Any,
+        Doc(
+            """
+            Include extra fields used by the JSON Schema.
+            """
+        ),
+        deprecated(
+            """
+            The `extra` kwargs is deprecated. Use `json_schema_extra` instead.
+            """
+        ),
+    ],
 ) -> Any:
+    """
+    Declare a path parameter for a *path operation*.
+
+    Read more about it in the
+    [FastAPI docs for Path Parameters and Numeric Validations](https://fastapi.tiangolo.com/tutorial/path-params-numeric-validations/).
+
+    ```python
+    from typing import Annotated
+
+    from fastapi import FastAPI, Path
+
+    app = FastAPI()
+
+
+    @app.get("/items/{item_id}")
+    async def read_items(
+        item_id: Annotated[int, Path(title="The ID of the item to get")],
+    ):
+        return {"item_id": item_id}
+    ```
+    """
     return params.Path(
         default=default,
         default_factory=default_factory,
@@ -87,37 +337,209 @@ def Path(  # noqa: N802
 
 
 def Query(  # noqa: N802
-    default: Any = Undefined,
+    default: Annotated[
+        Any,
+        Doc(
+            """
+            Default value if the parameter field is not set.
+            """
+        ),
+    ] = Undefined,
     *,
-    default_factory: Union[Callable[[], Any], None] = _Unset,
-    alias: Optional[str] = None,
-    alias_priority: Union[int, None] = _Unset,
+    default_factory: Annotated[
+        Union[Callable[[], Any], None],
+        Doc(
+            """
+            A callable to generate the default value.
+
+            This doesn't affect `Path` parameters as the value is always required.
+            The parameter is available only for compatibility.
+            """
+        ),
+    ] = _Unset,
+    alias: Annotated[
+        Optional[str],
+        Doc(
+            """
+            An alternative name for the parameter field.
+
+            This will be used to extract the data and for the generated OpenAPI.
+            It is particularly useful when you can't use the name you want because it
+            is a Python reserved keyword or similar.
+            """
+        ),
+    ] = None,
+    alias_priority: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Priority of the alias. This affects whether an alias generator is used.
+            """
+        ),
+    ] = _Unset,
     # TODO: update when deprecating Pydantic v1, import these types
     # validation_alias: str | AliasPath | AliasChoices | None
-    validation_alias: Union[str, None] = None,
-    serialization_alias: Union[str, None] = None,
-    title: Optional[str] = None,
-    description: Optional[str] = None,
-    gt: Optional[float] = None,
-    ge: Optional[float] = None,
-    lt: Optional[float] = None,
-    le: Optional[float] = None,
-    min_length: Optional[int] = None,
-    max_length: Optional[int] = None,
-    pattern: Optional[str] = None,
+    validation_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Whitelist' validation step. The parameter field will be the single one
+            allowed by the alias or set of aliases defined.
+            """
+        ),
+    ] = None,
+    serialization_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Blacklist' validation step. The vanilla parameter field will be the
+            single one of the alias' or set of aliases' fields and all the other
+            fields will be ignored at serialization time.
+            """
+        ),
+    ] = None,
+    title: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable title.
+            """
+        ),
+    ] = None,
+    description: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable description.
+            """
+        ),
+    ] = None,
+    gt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than. If set, value must be greater than this. Only applicable to
+            numbers.
+            """
+        ),
+    ] = None,
+    ge: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than or equal. If set, value must be greater than or equal to
+            this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    lt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than. If set, value must be less than this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    le: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than or equal. If set, value must be less than or equal to this.
+            Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    min_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Minimum length for strings.
+            """
+        ),
+    ] = None,
+    max_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Maximum length for strings.
+            """
+        ),
+    ] = None,
+    pattern: Annotated[
+        Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
+    ] = None,
     regex: Annotated[
         Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
         deprecated(
             "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead."
         ),
     ] = None,
-    discriminator: Union[str, None] = None,
-    strict: Union[bool, None] = _Unset,
-    multiple_of: Union[float, None] = _Unset,
-    allow_inf_nan: Union[bool, None] = _Unset,
-    max_digits: Union[int, None] = _Unset,
-    decimal_places: Union[int, None] = _Unset,
-    examples: Optional[List[Any]] = None,
+    discriminator: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            Parameter field name for discriminating the type in a tagged union.
+            """
+        ),
+    ] = None,
+    strict: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            If `True`, strict validation is applied to the field.
+            """
+        ),
+    ] = _Unset,
+    multiple_of: Annotated[
+        Union[float, None],
+        Doc(
+            """
+            Value must be a multiple of this. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    allow_inf_nan: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            Allow `inf`, `-inf`, `nan`. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    max_digits: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of allow digits for strings.
+            """
+        ),
+    ] = _Unset,
+    decimal_places: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of decimal places allowed for numbers.
+            """
+        ),
+    ] = _Unset,
+    examples: Annotated[
+        Optional[List[Any]],
+        Doc(
+            """
+            Example values for this field.
+            """
+        ),
+    ] = None,
     example: Annotated[
         Optional[Any],
         deprecated(
@@ -125,11 +547,65 @@ def Query(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
-    openapi_examples: Optional[Dict[str, Example]] = None,
-    deprecated: Optional[bool] = None,
-    include_in_schema: bool = True,
-    json_schema_extra: Union[Dict[str, Any], None] = None,
-    **extra: Any,
+    openapi_examples: Annotated[
+        Optional[Dict[str, Example]],
+        Doc(
+            """
+            OpenAPI-specific examples.
+
+            It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+            Swagger UI (that provides the `/docs` interface) has better support for the
+            OpenAPI-specific examples than the JSON Schema `examples`, that's the main
+            use case for this.
+
+            Read more about it in the
+            [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter).
+            """
+        ),
+    ] = None,
+    deprecated: Annotated[
+        Optional[bool],
+        Doc(
+            """
+            Mark this parameter field as deprecated.
+
+            It will affect the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = None,
+    include_in_schema: Annotated[
+        bool,
+        Doc(
+            """
+            To include (or not) this parameter field in the generated OpenAPI.
+            You probably don't need it, but it's available.
+
+            This affects the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = True,
+    json_schema_extra: Annotated[
+        Union[Dict[str, Any], None],
+        Doc(
+            """
+            Any additional JSON schema data.
+            """
+        ),
+    ] = None,
+    **extra: Annotated[
+        Any,
+        Doc(
+            """
+            Include extra fields used by the JSON Schema.
+            """
+        ),
+        deprecated(
+            """
+            The `extra` kwargs is deprecated. Use `json_schema_extra` instead.
+            """
+        ),
+    ],
 ) -> Any:
     return params.Query(
         default=default,
@@ -165,38 +641,220 @@ def Query(  # noqa: N802
 
 
 def Header(  # noqa: N802
-    default: Any = Undefined,
+    default: Annotated[
+        Any,
+        Doc(
+            """
+            Default value if the parameter field is not set.
+            """
+        ),
+    ] = Undefined,
     *,
-    default_factory: Union[Callable[[], Any], None] = _Unset,
-    alias: Optional[str] = None,
-    alias_priority: Union[int, None] = _Unset,
+    default_factory: Annotated[
+        Union[Callable[[], Any], None],
+        Doc(
+            """
+            A callable to generate the default value.
+
+            This doesn't affect `Path` parameters as the value is always required.
+            The parameter is available only for compatibility.
+            """
+        ),
+    ] = _Unset,
+    alias: Annotated[
+        Optional[str],
+        Doc(
+            """
+            An alternative name for the parameter field.
+
+            This will be used to extract the data and for the generated OpenAPI.
+            It is particularly useful when you can't use the name you want because it
+            is a Python reserved keyword or similar.
+            """
+        ),
+    ] = None,
+    alias_priority: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Priority of the alias. This affects whether an alias generator is used.
+            """
+        ),
+    ] = _Unset,
     # TODO: update when deprecating Pydantic v1, import these types
     # validation_alias: str | AliasPath | AliasChoices | None
-    validation_alias: Union[str, None] = None,
-    serialization_alias: Union[str, None] = None,
-    convert_underscores: bool = True,
-    title: Optional[str] = None,
-    description: Optional[str] = None,
-    gt: Optional[float] = None,
-    ge: Optional[float] = None,
-    lt: Optional[float] = None,
-    le: Optional[float] = None,
-    min_length: Optional[int] = None,
-    max_length: Optional[int] = None,
-    pattern: Optional[str] = None,
+    validation_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Whitelist' validation step. The parameter field will be the single one
+            allowed by the alias or set of aliases defined.
+            """
+        ),
+    ] = None,
+    serialization_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Blacklist' validation step. The vanilla parameter field will be the
+            single one of the alias' or set of aliases' fields and all the other
+            fields will be ignored at serialization time.
+            """
+        ),
+    ] = None,
+    convert_underscores: Annotated[
+        bool,
+        Doc(
+            """
+            Automatically convert underscores to hyphens in the parameter field name.
+
+            Read more about it in the
+            [FastAPI docs for Header Parameters](https://fastapi.tiangolo.com/tutorial/header-params/#automatic-conversion)
+            """
+        ),
+    ] = True,
+    title: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable title.
+            """
+        ),
+    ] = None,
+    description: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable description.
+            """
+        ),
+    ] = None,
+    gt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than. If set, value must be greater than this. Only applicable to
+            numbers.
+            """
+        ),
+    ] = None,
+    ge: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than or equal. If set, value must be greater than or equal to
+            this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    lt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than. If set, value must be less than this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    le: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than or equal. If set, value must be less than or equal to this.
+            Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    min_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Minimum length for strings.
+            """
+        ),
+    ] = None,
+    max_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Maximum length for strings.
+            """
+        ),
+    ] = None,
+    pattern: Annotated[
+        Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
+    ] = None,
     regex: Annotated[
         Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
         deprecated(
             "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead."
         ),
     ] = None,
-    discriminator: Union[str, None] = None,
-    strict: Union[bool, None] = _Unset,
-    multiple_of: Union[float, None] = _Unset,
-    allow_inf_nan: Union[bool, None] = _Unset,
-    max_digits: Union[int, None] = _Unset,
-    decimal_places: Union[int, None] = _Unset,
-    examples: Optional[List[Any]] = None,
+    discriminator: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            Parameter field name for discriminating the type in a tagged union.
+            """
+        ),
+    ] = None,
+    strict: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            If `True`, strict validation is applied to the field.
+            """
+        ),
+    ] = _Unset,
+    multiple_of: Annotated[
+        Union[float, None],
+        Doc(
+            """
+            Value must be a multiple of this. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    allow_inf_nan: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            Allow `inf`, `-inf`, `nan`. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    max_digits: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of allow digits for strings.
+            """
+        ),
+    ] = _Unset,
+    decimal_places: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of decimal places allowed for numbers.
+            """
+        ),
+    ] = _Unset,
+    examples: Annotated[
+        Optional[List[Any]],
+        Doc(
+            """
+            Example values for this field.
+            """
+        ),
+    ] = None,
     example: Annotated[
         Optional[Any],
         deprecated(
@@ -204,11 +862,65 @@ def Header(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
-    openapi_examples: Optional[Dict[str, Example]] = None,
-    deprecated: Optional[bool] = None,
-    include_in_schema: bool = True,
-    json_schema_extra: Union[Dict[str, Any], None] = None,
-    **extra: Any,
+    openapi_examples: Annotated[
+        Optional[Dict[str, Example]],
+        Doc(
+            """
+            OpenAPI-specific examples.
+
+            It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+            Swagger UI (that provides the `/docs` interface) has better support for the
+            OpenAPI-specific examples than the JSON Schema `examples`, that's the main
+            use case for this.
+
+            Read more about it in the
+            [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter).
+            """
+        ),
+    ] = None,
+    deprecated: Annotated[
+        Optional[bool],
+        Doc(
+            """
+            Mark this parameter field as deprecated.
+
+            It will affect the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = None,
+    include_in_schema: Annotated[
+        bool,
+        Doc(
+            """
+            To include (or not) this parameter field in the generated OpenAPI.
+            You probably don't need it, but it's available.
+
+            This affects the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = True,
+    json_schema_extra: Annotated[
+        Union[Dict[str, Any], None],
+        Doc(
+            """
+            Any additional JSON schema data.
+            """
+        ),
+    ] = None,
+    **extra: Annotated[
+        Any,
+        Doc(
+            """
+            Include extra fields used by the JSON Schema.
+            """
+        ),
+        deprecated(
+            """
+            The `extra` kwargs is deprecated. Use `json_schema_extra` instead.
+            """
+        ),
+    ],
 ) -> Any:
     return params.Header(
         default=default,
@@ -245,37 +957,209 @@ def Header(  # noqa: N802
 
 
 def Cookie(  # noqa: N802
-    default: Any = Undefined,
+    default: Annotated[
+        Any,
+        Doc(
+            """
+            Default value if the parameter field is not set.
+            """
+        ),
+    ] = Undefined,
     *,
-    default_factory: Union[Callable[[], Any], None] = _Unset,
-    alias: Optional[str] = None,
-    alias_priority: Union[int, None] = _Unset,
+    default_factory: Annotated[
+        Union[Callable[[], Any], None],
+        Doc(
+            """
+            A callable to generate the default value.
+
+            This doesn't affect `Path` parameters as the value is always required.
+            The parameter is available only for compatibility.
+            """
+        ),
+    ] = _Unset,
+    alias: Annotated[
+        Optional[str],
+        Doc(
+            """
+            An alternative name for the parameter field.
+
+            This will be used to extract the data and for the generated OpenAPI.
+            It is particularly useful when you can't use the name you want because it
+            is a Python reserved keyword or similar.
+            """
+        ),
+    ] = None,
+    alias_priority: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Priority of the alias. This affects whether an alias generator is used.
+            """
+        ),
+    ] = _Unset,
     # TODO: update when deprecating Pydantic v1, import these types
     # validation_alias: str | AliasPath | AliasChoices | None
-    validation_alias: Union[str, None] = None,
-    serialization_alias: Union[str, None] = None,
-    title: Optional[str] = None,
-    description: Optional[str] = None,
-    gt: Optional[float] = None,
-    ge: Optional[float] = None,
-    lt: Optional[float] = None,
-    le: Optional[float] = None,
-    min_length: Optional[int] = None,
-    max_length: Optional[int] = None,
-    pattern: Optional[str] = None,
+    validation_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Whitelist' validation step. The parameter field will be the single one
+            allowed by the alias or set of aliases defined.
+            """
+        ),
+    ] = None,
+    serialization_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Blacklist' validation step. The vanilla parameter field will be the
+            single one of the alias' or set of aliases' fields and all the other
+            fields will be ignored at serialization time.
+            """
+        ),
+    ] = None,
+    title: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable title.
+            """
+        ),
+    ] = None,
+    description: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable description.
+            """
+        ),
+    ] = None,
+    gt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than. If set, value must be greater than this. Only applicable to
+            numbers.
+            """
+        ),
+    ] = None,
+    ge: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than or equal. If set, value must be greater than or equal to
+            this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    lt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than. If set, value must be less than this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    le: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than or equal. If set, value must be less than or equal to this.
+            Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    min_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Minimum length for strings.
+            """
+        ),
+    ] = None,
+    max_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Maximum length for strings.
+            """
+        ),
+    ] = None,
+    pattern: Annotated[
+        Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
+    ] = None,
     regex: Annotated[
         Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
         deprecated(
             "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead."
         ),
     ] = None,
-    discriminator: Union[str, None] = None,
-    strict: Union[bool, None] = _Unset,
-    multiple_of: Union[float, None] = _Unset,
-    allow_inf_nan: Union[bool, None] = _Unset,
-    max_digits: Union[int, None] = _Unset,
-    decimal_places: Union[int, None] = _Unset,
-    examples: Optional[List[Any]] = None,
+    discriminator: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            Parameter field name for discriminating the type in a tagged union.
+            """
+        ),
+    ] = None,
+    strict: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            If `True`, strict validation is applied to the field.
+            """
+        ),
+    ] = _Unset,
+    multiple_of: Annotated[
+        Union[float, None],
+        Doc(
+            """
+            Value must be a multiple of this. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    allow_inf_nan: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            Allow `inf`, `-inf`, `nan`. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    max_digits: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of allow digits for strings.
+            """
+        ),
+    ] = _Unset,
+    decimal_places: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of decimal places allowed for numbers.
+            """
+        ),
+    ] = _Unset,
+    examples: Annotated[
+        Optional[List[Any]],
+        Doc(
+            """
+            Example values for this field.
+            """
+        ),
+    ] = None,
     example: Annotated[
         Optional[Any],
         deprecated(
@@ -283,11 +1167,65 @@ def Cookie(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
-    openapi_examples: Optional[Dict[str, Example]] = None,
-    deprecated: Optional[bool] = None,
-    include_in_schema: bool = True,
-    json_schema_extra: Union[Dict[str, Any], None] = None,
-    **extra: Any,
+    openapi_examples: Annotated[
+        Optional[Dict[str, Example]],
+        Doc(
+            """
+            OpenAPI-specific examples.
+
+            It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+            Swagger UI (that provides the `/docs` interface) has better support for the
+            OpenAPI-specific examples than the JSON Schema `examples`, that's the main
+            use case for this.
+
+            Read more about it in the
+            [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter).
+            """
+        ),
+    ] = None,
+    deprecated: Annotated[
+        Optional[bool],
+        Doc(
+            """
+            Mark this parameter field as deprecated.
+
+            It will affect the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = None,
+    include_in_schema: Annotated[
+        bool,
+        Doc(
+            """
+            To include (or not) this parameter field in the generated OpenAPI.
+            You probably don't need it, but it's available.
+
+            This affects the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = True,
+    json_schema_extra: Annotated[
+        Union[Dict[str, Any], None],
+        Doc(
+            """
+            Any additional JSON schema data.
+            """
+        ),
+    ] = None,
+    **extra: Annotated[
+        Any,
+        Doc(
+            """
+            Include extra fields used by the JSON Schema.
+            """
+        ),
+        deprecated(
+            """
+            The `extra` kwargs is deprecated. Use `json_schema_extra` instead.
+            """
+        ),
+    ],
 ) -> Any:
     return params.Cookie(
         default=default,
@@ -323,39 +1261,232 @@ def Cookie(  # noqa: N802
 
 
 def Body(  # noqa: N802
-    default: Any = Undefined,
+    default: Annotated[
+        Any,
+        Doc(
+            """
+            Default value if the parameter field is not set.
+            """
+        ),
+    ] = Undefined,
     *,
-    default_factory: Union[Callable[[], Any], None] = _Unset,
-    embed: bool = False,
-    media_type: str = "application/json",
-    alias: Optional[str] = None,
-    alias_priority: Union[int, None] = _Unset,
+    default_factory: Annotated[
+        Union[Callable[[], Any], None],
+        Doc(
+            """
+            A callable to generate the default value.
+
+            This doesn't affect `Path` parameters as the value is always required.
+            The parameter is available only for compatibility.
+            """
+        ),
+    ] = _Unset,
+    embed: Annotated[
+        bool,
+        Doc(
+            """
+            When `embed` is `True`, the parameter will be expected in a JSON body as a
+            key instead of being the JSON body itself.
+
+            This happens automatically when more than one `Body` parameter is declared.
+
+            Read more about it in the
+            [FastAPI docs for Body - Multiple Parameters](https://fastapi.tiangolo.com/tutorial/body-multiple-params/#embed-a-single-body-parameter).
+            """
+        ),
+    ] = False,
+    media_type: Annotated[
+        str,
+        Doc(
+            """
+            The media type of this parameter field. Changing it would affect the
+            generated OpenAPI, but currently it doesn't affect the parsing of the data.
+            """
+        ),
+    ] = "application/json",
+    alias: Annotated[
+        Optional[str],
+        Doc(
+            """
+            An alternative name for the parameter field.
+
+            This will be used to extract the data and for the generated OpenAPI.
+            It is particularly useful when you can't use the name you want because it
+            is a Python reserved keyword or similar.
+            """
+        ),
+    ] = None,
+    alias_priority: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Priority of the alias. This affects whether an alias generator is used.
+            """
+        ),
+    ] = _Unset,
     # TODO: update when deprecating Pydantic v1, import these types
     # validation_alias: str | AliasPath | AliasChoices | None
-    validation_alias: Union[str, None] = None,
-    serialization_alias: Union[str, None] = None,
-    title: Optional[str] = None,
-    description: Optional[str] = None,
-    gt: Optional[float] = None,
-    ge: Optional[float] = None,
-    lt: Optional[float] = None,
-    le: Optional[float] = None,
-    min_length: Optional[int] = None,
-    max_length: Optional[int] = None,
-    pattern: Optional[str] = None,
+    validation_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Whitelist' validation step. The parameter field will be the single one
+            allowed by the alias or set of aliases defined.
+            """
+        ),
+    ] = None,
+    serialization_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Blacklist' validation step. The vanilla parameter field will be the
+            single one of the alias' or set of aliases' fields and all the other
+            fields will be ignored at serialization time.
+            """
+        ),
+    ] = None,
+    title: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable title.
+            """
+        ),
+    ] = None,
+    description: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable description.
+            """
+        ),
+    ] = None,
+    gt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than. If set, value must be greater than this. Only applicable to
+            numbers.
+            """
+        ),
+    ] = None,
+    ge: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than or equal. If set, value must be greater than or equal to
+            this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    lt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than. If set, value must be less than this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    le: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than or equal. If set, value must be less than or equal to this.
+            Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    min_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Minimum length for strings.
+            """
+        ),
+    ] = None,
+    max_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Maximum length for strings.
+            """
+        ),
+    ] = None,
+    pattern: Annotated[
+        Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
+    ] = None,
     regex: Annotated[
         Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
         deprecated(
             "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead."
         ),
     ] = None,
-    discriminator: Union[str, None] = None,
-    strict: Union[bool, None] = _Unset,
-    multiple_of: Union[float, None] = _Unset,
-    allow_inf_nan: Union[bool, None] = _Unset,
-    max_digits: Union[int, None] = _Unset,
-    decimal_places: Union[int, None] = _Unset,
-    examples: Optional[List[Any]] = None,
+    discriminator: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            Parameter field name for discriminating the type in a tagged union.
+            """
+        ),
+    ] = None,
+    strict: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            If `True`, strict validation is applied to the field.
+            """
+        ),
+    ] = _Unset,
+    multiple_of: Annotated[
+        Union[float, None],
+        Doc(
+            """
+            Value must be a multiple of this. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    allow_inf_nan: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            Allow `inf`, `-inf`, `nan`. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    max_digits: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of allow digits for strings.
+            """
+        ),
+    ] = _Unset,
+    decimal_places: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of decimal places allowed for numbers.
+            """
+        ),
+    ] = _Unset,
+    examples: Annotated[
+        Optional[List[Any]],
+        Doc(
+            """
+            Example values for this field.
+            """
+        ),
+    ] = None,
     example: Annotated[
         Optional[Any],
         deprecated(
@@ -363,11 +1494,65 @@ def Body(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
-    openapi_examples: Optional[Dict[str, Example]] = None,
-    deprecated: Optional[bool] = None,
-    include_in_schema: bool = True,
-    json_schema_extra: Union[Dict[str, Any], None] = None,
-    **extra: Any,
+    openapi_examples: Annotated[
+        Optional[Dict[str, Example]],
+        Doc(
+            """
+            OpenAPI-specific examples.
+
+            It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+            Swagger UI (that provides the `/docs` interface) has better support for the
+            OpenAPI-specific examples than the JSON Schema `examples`, that's the main
+            use case for this.
+
+            Read more about it in the
+            [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter).
+            """
+        ),
+    ] = None,
+    deprecated: Annotated[
+        Optional[bool],
+        Doc(
+            """
+            Mark this parameter field as deprecated.
+
+            It will affect the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = None,
+    include_in_schema: Annotated[
+        bool,
+        Doc(
+            """
+            To include (or not) this parameter field in the generated OpenAPI.
+            You probably don't need it, but it's available.
+
+            This affects the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = True,
+    json_schema_extra: Annotated[
+        Union[Dict[str, Any], None],
+        Doc(
+            """
+            Any additional JSON schema data.
+            """
+        ),
+    ] = None,
+    **extra: Annotated[
+        Any,
+        Doc(
+            """
+            Include extra fields used by the JSON Schema.
+            """
+        ),
+        deprecated(
+            """
+            The `extra` kwargs is deprecated. Use `json_schema_extra` instead.
+            """
+        ),
+    ],
 ) -> Any:
     return params.Body(
         default=default,
@@ -405,38 +1590,218 @@ def Body(  # noqa: N802
 
 
 def Form(  # noqa: N802
-    default: Any = Undefined,
+    default: Annotated[
+        Any,
+        Doc(
+            """
+            Default value if the parameter field is not set.
+            """
+        ),
+    ] = Undefined,
     *,
-    default_factory: Union[Callable[[], Any], None] = _Unset,
-    media_type: str = "application/x-www-form-urlencoded",
-    alias: Optional[str] = None,
-    alias_priority: Union[int, None] = _Unset,
+    default_factory: Annotated[
+        Union[Callable[[], Any], None],
+        Doc(
+            """
+            A callable to generate the default value.
+
+            This doesn't affect `Path` parameters as the value is always required.
+            The parameter is available only for compatibility.
+            """
+        ),
+    ] = _Unset,
+    media_type: Annotated[
+        str,
+        Doc(
+            """
+            The media type of this parameter field. Changing it would affect the
+            generated OpenAPI, but currently it doesn't affect the parsing of the data.
+            """
+        ),
+    ] = "application/x-www-form-urlencoded",
+    alias: Annotated[
+        Optional[str],
+        Doc(
+            """
+            An alternative name for the parameter field.
+
+            This will be used to extract the data and for the generated OpenAPI.
+            It is particularly useful when you can't use the name you want because it
+            is a Python reserved keyword or similar.
+            """
+        ),
+    ] = None,
+    alias_priority: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Priority of the alias. This affects whether an alias generator is used.
+            """
+        ),
+    ] = _Unset,
     # TODO: update when deprecating Pydantic v1, import these types
     # validation_alias: str | AliasPath | AliasChoices | None
-    validation_alias: Union[str, None] = None,
-    serialization_alias: Union[str, None] = None,
-    title: Optional[str] = None,
-    description: Optional[str] = None,
-    gt: Optional[float] = None,
-    ge: Optional[float] = None,
-    lt: Optional[float] = None,
-    le: Optional[float] = None,
-    min_length: Optional[int] = None,
-    max_length: Optional[int] = None,
-    pattern: Optional[str] = None,
+    validation_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Whitelist' validation step. The parameter field will be the single one
+            allowed by the alias or set of aliases defined.
+            """
+        ),
+    ] = None,
+    serialization_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Blacklist' validation step. The vanilla parameter field will be the
+            single one of the alias' or set of aliases' fields and all the other
+            fields will be ignored at serialization time.
+            """
+        ),
+    ] = None,
+    title: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable title.
+            """
+        ),
+    ] = None,
+    description: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable description.
+            """
+        ),
+    ] = None,
+    gt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than. If set, value must be greater than this. Only applicable to
+            numbers.
+            """
+        ),
+    ] = None,
+    ge: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than or equal. If set, value must be greater than or equal to
+            this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    lt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than. If set, value must be less than this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    le: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than or equal. If set, value must be less than or equal to this.
+            Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    min_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Minimum length for strings.
+            """
+        ),
+    ] = None,
+    max_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Maximum length for strings.
+            """
+        ),
+    ] = None,
+    pattern: Annotated[
+        Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
+    ] = None,
     regex: Annotated[
         Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
         deprecated(
             "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead."
         ),
     ] = None,
-    discriminator: Union[str, None] = None,
-    strict: Union[bool, None] = _Unset,
-    multiple_of: Union[float, None] = _Unset,
-    allow_inf_nan: Union[bool, None] = _Unset,
-    max_digits: Union[int, None] = _Unset,
-    decimal_places: Union[int, None] = _Unset,
-    examples: Optional[List[Any]] = None,
+    discriminator: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            Parameter field name for discriminating the type in a tagged union.
+            """
+        ),
+    ] = None,
+    strict: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            If `True`, strict validation is applied to the field.
+            """
+        ),
+    ] = _Unset,
+    multiple_of: Annotated[
+        Union[float, None],
+        Doc(
+            """
+            Value must be a multiple of this. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    allow_inf_nan: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            Allow `inf`, `-inf`, `nan`. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    max_digits: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of allow digits for strings.
+            """
+        ),
+    ] = _Unset,
+    decimal_places: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of decimal places allowed for numbers.
+            """
+        ),
+    ] = _Unset,
+    examples: Annotated[
+        Optional[List[Any]],
+        Doc(
+            """
+            Example values for this field.
+            """
+        ),
+    ] = None,
     example: Annotated[
         Optional[Any],
         deprecated(
@@ -444,11 +1809,65 @@ def Form(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
-    openapi_examples: Optional[Dict[str, Example]] = None,
-    deprecated: Optional[bool] = None,
-    include_in_schema: bool = True,
-    json_schema_extra: Union[Dict[str, Any], None] = None,
-    **extra: Any,
+    openapi_examples: Annotated[
+        Optional[Dict[str, Example]],
+        Doc(
+            """
+            OpenAPI-specific examples.
+
+            It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+            Swagger UI (that provides the `/docs` interface) has better support for the
+            OpenAPI-specific examples than the JSON Schema `examples`, that's the main
+            use case for this.
+
+            Read more about it in the
+            [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter).
+            """
+        ),
+    ] = None,
+    deprecated: Annotated[
+        Optional[bool],
+        Doc(
+            """
+            Mark this parameter field as deprecated.
+
+            It will affect the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = None,
+    include_in_schema: Annotated[
+        bool,
+        Doc(
+            """
+            To include (or not) this parameter field in the generated OpenAPI.
+            You probably don't need it, but it's available.
+
+            This affects the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = True,
+    json_schema_extra: Annotated[
+        Union[Dict[str, Any], None],
+        Doc(
+            """
+            Any additional JSON schema data.
+            """
+        ),
+    ] = None,
+    **extra: Annotated[
+        Any,
+        Doc(
+            """
+            Include extra fields used by the JSON Schema.
+            """
+        ),
+        deprecated(
+            """
+            The `extra` kwargs is deprecated. Use `json_schema_extra` instead.
+            """
+        ),
+    ],
 ) -> Any:
     return params.Form(
         default=default,
@@ -485,38 +1904,218 @@ def Form(  # noqa: N802
 
 
 def File(  # noqa: N802
-    default: Any = Undefined,
+    default: Annotated[
+        Any,
+        Doc(
+            """
+            Default value if the parameter field is not set.
+            """
+        ),
+    ] = Undefined,
     *,
-    default_factory: Union[Callable[[], Any], None] = _Unset,
-    media_type: str = "multipart/form-data",
-    alias: Optional[str] = None,
-    alias_priority: Union[int, None] = _Unset,
+    default_factory: Annotated[
+        Union[Callable[[], Any], None],
+        Doc(
+            """
+            A callable to generate the default value.
+
+            This doesn't affect `Path` parameters as the value is always required.
+            The parameter is available only for compatibility.
+            """
+        ),
+    ] = _Unset,
+    media_type: Annotated[
+        str,
+        Doc(
+            """
+            The media type of this parameter field. Changing it would affect the
+            generated OpenAPI, but currently it doesn't affect the parsing of the data.
+            """
+        ),
+    ] = "multipart/form-data",
+    alias: Annotated[
+        Optional[str],
+        Doc(
+            """
+            An alternative name for the parameter field.
+
+            This will be used to extract the data and for the generated OpenAPI.
+            It is particularly useful when you can't use the name you want because it
+            is a Python reserved keyword or similar.
+            """
+        ),
+    ] = None,
+    alias_priority: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Priority of the alias. This affects whether an alias generator is used.
+            """
+        ),
+    ] = _Unset,
     # TODO: update when deprecating Pydantic v1, import these types
     # validation_alias: str | AliasPath | AliasChoices | None
-    validation_alias: Union[str, None] = None,
-    serialization_alias: Union[str, None] = None,
-    title: Optional[str] = None,
-    description: Optional[str] = None,
-    gt: Optional[float] = None,
-    ge: Optional[float] = None,
-    lt: Optional[float] = None,
-    le: Optional[float] = None,
-    min_length: Optional[int] = None,
-    max_length: Optional[int] = None,
-    pattern: Optional[str] = None,
+    validation_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Whitelist' validation step. The parameter field will be the single one
+            allowed by the alias or set of aliases defined.
+            """
+        ),
+    ] = None,
+    serialization_alias: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            'Blacklist' validation step. The vanilla parameter field will be the
+            single one of the alias' or set of aliases' fields and all the other
+            fields will be ignored at serialization time.
+            """
+        ),
+    ] = None,
+    title: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable title.
+            """
+        ),
+    ] = None,
+    description: Annotated[
+        Optional[str],
+        Doc(
+            """
+            Human-readable description.
+            """
+        ),
+    ] = None,
+    gt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than. If set, value must be greater than this. Only applicable to
+            numbers.
+            """
+        ),
+    ] = None,
+    ge: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Greater than or equal. If set, value must be greater than or equal to
+            this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    lt: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than. If set, value must be less than this. Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    le: Annotated[
+        Optional[float],
+        Doc(
+            """
+            Less than or equal. If set, value must be less than or equal to this.
+            Only applicable to numbers.
+            """
+        ),
+    ] = None,
+    min_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Minimum length for strings.
+            """
+        ),
+    ] = None,
+    max_length: Annotated[
+        Optional[int],
+        Doc(
+            """
+            Maximum length for strings.
+            """
+        ),
+    ] = None,
+    pattern: Annotated[
+        Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
+    ] = None,
     regex: Annotated[
         Optional[str],
+        Doc(
+            """
+            RegEx pattern for strings.
+            """
+        ),
         deprecated(
             "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead."
         ),
     ] = None,
-    discriminator: Union[str, None] = None,
-    strict: Union[bool, None] = _Unset,
-    multiple_of: Union[float, None] = _Unset,
-    allow_inf_nan: Union[bool, None] = _Unset,
-    max_digits: Union[int, None] = _Unset,
-    decimal_places: Union[int, None] = _Unset,
-    examples: Optional[List[Any]] = None,
+    discriminator: Annotated[
+        Union[str, None],
+        Doc(
+            """
+            Parameter field name for discriminating the type in a tagged union.
+            """
+        ),
+    ] = None,
+    strict: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            If `True`, strict validation is applied to the field.
+            """
+        ),
+    ] = _Unset,
+    multiple_of: Annotated[
+        Union[float, None],
+        Doc(
+            """
+            Value must be a multiple of this. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    allow_inf_nan: Annotated[
+        Union[bool, None],
+        Doc(
+            """
+            Allow `inf`, `-inf`, `nan`. Only applicable to numbers.
+            """
+        ),
+    ] = _Unset,
+    max_digits: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of allow digits for strings.
+            """
+        ),
+    ] = _Unset,
+    decimal_places: Annotated[
+        Union[int, None],
+        Doc(
+            """
+            Maximum number of decimal places allowed for numbers.
+            """
+        ),
+    ] = _Unset,
+    examples: Annotated[
+        Optional[List[Any]],
+        Doc(
+            """
+            Example values for this field.
+            """
+        ),
+    ] = None,
     example: Annotated[
         Optional[Any],
         deprecated(
@@ -524,11 +2123,65 @@ def File(  # noqa: N802
             "although still supported. Use examples instead."
         ),
     ] = _Unset,
-    openapi_examples: Optional[Dict[str, Example]] = None,
-    deprecated: Optional[bool] = None,
-    include_in_schema: bool = True,
-    json_schema_extra: Union[Dict[str, Any], None] = None,
-    **extra: Any,
+    openapi_examples: Annotated[
+        Optional[Dict[str, Example]],
+        Doc(
+            """
+            OpenAPI-specific examples.
+
+            It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+            Swagger UI (that provides the `/docs` interface) has better support for the
+            OpenAPI-specific examples than the JSON Schema `examples`, that's the main
+            use case for this.
+
+            Read more about it in the
+            [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter).
+            """
+        ),
+    ] = None,
+    deprecated: Annotated[
+        Optional[bool],
+        Doc(
+            """
+            Mark this parameter field as deprecated.
+
+            It will affect the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = None,
+    include_in_schema: Annotated[
+        bool,
+        Doc(
+            """
+            To include (or not) this parameter field in the generated OpenAPI.
+            You probably don't need it, but it's available.
+
+            This affects the generated OpenAPI (e.g. visible at `/docs`).
+            """
+        ),
+    ] = True,
+    json_schema_extra: Annotated[
+        Union[Dict[str, Any], None],
+        Doc(
+            """
+            Any additional JSON schema data.
+            """
+        ),
+    ] = None,
+    **extra: Annotated[
+        Any,
+        Doc(
+            """
+            Include extra fields used by the JSON Schema.
+            """
+        ),
+        deprecated(
+            """
+            The `extra` kwargs is deprecated. Use `json_schema_extra` instead.
+            """
+        ),
+    ],
 ) -> Any:
     return params.File(
         default=default,
@@ -565,15 +2218,143 @@ def File(  # noqa: N802
 
 
 def Depends(  # noqa: N802
-    dependency: Optional[Callable[..., Any]] = None, *, use_cache: bool = True
+    dependency: Annotated[
+        Optional[Callable[..., Any]],
+        Doc(
+            """
+            A "dependable" callable (like a function).
+
+            Don't call it directly, FastAPI will call it for you, just pass the object
+            directly.
+            """
+        ),
+    ] = None,
+    *,
+    use_cache: Annotated[
+        bool,
+        Doc(
+            """
+            By default, after a dependency is called the first time in a request, if
+            the dependency is declared again for the rest of the request (for example
+            if the dependency is needed by several dependencies), the value will be
+            re-used for the rest of the request.
+
+            Set `use_cache` to `False` to disable this behavior and ensure the
+            dependency is called again (if declared more than once) in the same request.
+            """
+        ),
+    ] = True,
 ) -> Any:
+    """
+    Declare a FastAPI dependency.
+
+    It takes a single "dependable" callable (like a function).
+
+    Don't call it directly, FastAPI will call it for you.
+
+    Read more about it in the
+    [FastAPI docs for Dependencies](https://fastapi.tiangolo.com/tutorial/dependencies/).
+
+    **Example**
+
+    ```python
+    from typing import Annotated
+
+    from fastapi import Depends, FastAPI
+
+    app = FastAPI()
+
+
+    async def common_parameters(q: str | None = None, skip: int = 0, limit: int = 100):
+        return {"q": q, "skip": skip, "limit": limit}
+
+
+    @app.get("/items/")
+    async def read_items(commons: Annotated[dict, Depends(common_parameters)]):
+        return commons
+    ```
+    """
     return params.Depends(dependency=dependency, use_cache=use_cache)
 
 
 def Security(  # noqa: N802
-    dependency: Optional[Callable[..., Any]] = None,
+    dependency: Annotated[
+        Optional[Callable[..., Any]],
+        Doc(
+            """
+            A "dependable" callable (like a function).
+
+            Don't call it directly, FastAPI will call it for you, just pass the object
+            directly.
+            """
+        ),
+    ] = None,
     *,
-    scopes: Optional[Sequence[str]] = None,
-    use_cache: bool = True,
+    scopes: Annotated[
+        Optional[Sequence[str]],
+        Doc(
+            """
+            OAuth2 scopes required for the *path operation* that uses this Security
+            dependency.
+
+            The term "scope" comes from the OAuth2 specification, it seems to be
+            intentionaly vague and interpretable. It normally refers to permissions,
+            in cases to roles.
+
+            These scopes are integrated with OpenAPI (and the API docs at `/docs`).
+            So they are visible in the OpenAPI specification.
+            )
+            """
+        ),
+    ] = None,
+    use_cache: Annotated[
+        bool,
+        Doc(
+            """
+            By default, after a dependency is called the first time in a request, if
+            the dependency is declared again for the rest of the request (for example
+            if the dependency is needed by several dependencies), the value will be
+            re-used for the rest of the request.
+
+            Set `use_cache` to `False` to disable this behavior and ensure the
+            dependency is called again (if declared more than once) in the same request.
+            """
+        ),
+    ] = True,
 ) -> Any:
+    """
+    Declare a FastAPI Security dependency.
+
+    The only difference with a regular dependency is that it can declare OAuth2
+    scopes that will be integrated with OpenAPI and the automatic UI docs (by default
+    at `/docs`).
+
+    It takes a single "dependable" callable (like a function).
+
+    Don't call it directly, FastAPI will call it for you.
+
+    Read more about it in the
+    [FastAPI docs for Security](https://fastapi.tiangolo.com/tutorial/security/) and
+    in the
+    [FastAPI docs for OAuth2 scopes](https://fastapi.tiangolo.com/advanced/security/oauth2-scopes/).
+
+    **Example**
+
+    ```python
+    from typing import Annotated
+
+    from fastapi import Depends, FastAPI
+
+    from .db import User
+    from .security import get_current_active_user
+
+    app = FastAPI()
+
+    @app.get("/users/me/items/")
+    async def read_own_items(
+        current_user: Annotated[User, Security(get_current_active_user, scopes=["items"])]
+    ):
+        return [{"item_id": "Foo", "owner": current_user.username}]
+    ```
+    """
     return params.Security(dependency=dependency, scopes=scopes, use_cache=use_cache)
diff --git a/fastapi/responses.py b/fastapi/responses.py
index c0a13b755..6c8db6f33 100644
--- a/fastapi/responses.py
+++ b/fastapi/responses.py
@@ -21,12 +21,26 @@ except ImportError:  # pragma: nocover
 
 
 class UJSONResponse(JSONResponse):
+    """
+    JSON response using the high-performance ujson library to serialize data to JSON.
+
+    Read more about it in the
+    [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/).
+    """
+
     def render(self, content: Any) -> bytes:
         assert ujson is not None, "ujson must be installed to use UJSONResponse"
         return ujson.dumps(content, ensure_ascii=False).encode("utf-8")
 
 
 class ORJSONResponse(JSONResponse):
+    """
+    JSON response using the high-performance orjson library to serialize data to JSON.
+
+    Read more about it in the
+    [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/).
+    """
+
     def render(self, content: Any) -> bytes:
         assert orjson is not None, "orjson must be installed to use ORJSONResponse"
         return orjson.dumps(
diff --git a/fastapi/routing.py b/fastapi/routing.py
index 1e3dfb4d5..e33e1d832 100644
--- a/fastapi/routing.py
+++ b/fastapi/routing.py
@@ -69,6 +69,7 @@ from starlette.routing import (
 from starlette.routing import Mount as Mount  # noqa
 from starlette.types import ASGIApp, Lifespan, Scope
 from starlette.websockets import WebSocket
+from typing_extensions import Annotated, Doc, deprecated  # type: ignore [attr-defined]
 
 
 def _prepare_response_content(
@@ -519,30 +520,253 @@ class APIRoute(routing.Route):
 
 
 class APIRouter(routing.Router):
+    """
+    `APIRouter` class, used to group *path operations*, for example to structure
+    an app in multiple files. It would then be included in the `FastAPI` app, or
+    in another `APIRouter` (ultimately included in the app).
+
+    Read more about it in the
+    [FastAPI docs for Bigger Applications - Multiple Files](https://fastapi.tiangolo.com/tutorial/bigger-applications/).
+
+    ## Example
+
+    ```python
+    from fastapi import APIRouter, FastAPI
+
+    app = FastAPI()
+    router = APIRouter()
+
+
+    @router.get("/users/", tags=["users"])
+    async def read_users():
+        return [{"username": "Rick"}, {"username": "Morty"}]
+
+
+    app.include_router(router)
+    ```
+    """
+
     def __init__(
         self,
         *,
-        prefix: str = "",
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[params.Depends]] = None,
-        default_response_class: Type[Response] = Default(JSONResponse),
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        routes: Optional[List[routing.BaseRoute]] = None,
-        redirect_slashes: bool = True,
-        default: Optional[ASGIApp] = None,
-        dependency_overrides_provider: Optional[Any] = None,
-        route_class: Type[APIRoute] = APIRoute,
-        on_startup: Optional[Sequence[Callable[[], Any]]] = None,
-        on_shutdown: Optional[Sequence[Callable[[], Any]]] = None,
+        prefix: Annotated[str, Doc("An optional path prefix for the router.")] = "",
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to all the *path operations* in this
+                router.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to all the
+                *path operations* in this router.
+
+                Read more about it in the
+                [FastAPI docs for Bigger Applications - Multiple Files](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies).
+                """
+            ),
+        ] = None,
+        default_response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                The default response class to be used.
+
+                Read more in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#default-response-class).
+                """
+            ),
+        ] = Default(JSONResponse),
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses to be shown in OpenAPI.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Additional Responses in OpenAPI](https://fastapi.tiangolo.com/advanced/additional-responses/).
+
+                And in the
+                [FastAPI docs for Bigger Applications](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies).
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                OpenAPI callbacks that should apply to all *path operations* in this
+                router.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        routes: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                **Note**: you probably shouldn't use this parameter, it is inherited
+                from Starlette and supported for compatibility.
+
+                In FastAPI, you normally would use the *path operation* decorators,
+                like:
+
+                * `router.get()`
+                * `router.post()`
+                * etc.
+
+                ---
+
+                A list of routes to serve incoming HTTP and WebSocket requests.
+                """
+            ),
+            deprecated(
+                """
+                You normally wouldn't use this parameter with FastAPI, it is inherited
+                from Starlette and supported for compatibility.
+
+                In FastAPI, you normally would use the *path operation methods*,
+                like `router.get()`, `router.post()`, etc.
+                """
+            ),
+        ] = None,
+        redirect_slashes: Annotated[
+            bool,
+            Doc(
+                """
+                Whether to detect and redirect slashes in URLs when the client doesn't
+                use the same format.
+                """
+            ),
+        ] = True,
+        default: Annotated[
+            Optional[ASGIApp],
+            Doc(
+                """
+                Default function handler for this router. Used to handle
+                404 Not Found errors.
+                """
+            ),
+        ] = None,
+        dependency_overrides_provider: Annotated[
+            Optional[Any],
+            Doc(
+                """
+                Only used internally by FastAPI to handle dependency overrides.
+
+                You shouldn't need to use it. It normally points to the `FastAPI` app
+                object.
+                """
+            ),
+        ] = None,
+        route_class: Annotated[
+            Type[APIRoute],
+            Doc(
+                """
+                Custom route (*path operation*) class to be used by this router.
+
+                Read more about it in the
+                [FastAPI docs for Custom Request and APIRoute class](https://fastapi.tiangolo.com/how-to/custom-request-and-route/#custom-apiroute-class-in-a-router).
+                """
+            ),
+        ] = APIRoute,
+        on_startup: Annotated[
+            Optional[Sequence[Callable[[], Any]]],
+            Doc(
+                """
+                A list of startup event handler functions.
+
+                You should instead use the `lifespan` handlers.
+
+                Read more in the [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/).
+                """
+            ),
+        ] = None,
+        on_shutdown: Annotated[
+            Optional[Sequence[Callable[[], Any]]],
+            Doc(
+                """
+                A list of shutdown event handler functions.
+
+                You should instead use the `lifespan` handlers.
+
+                Read more in the
+                [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/).
+                """
+            ),
+        ] = None,
         # the generic to Lifespan[AppType] is the type of the top level application
         # which the router cannot know statically, so we use typing.Any
-        lifespan: Optional[Lifespan[Any]] = None,
-        deprecated: Optional[bool] = None,
-        include_in_schema: bool = True,
-        generate_unique_id_function: Callable[[APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        lifespan: Annotated[
+            Optional[Lifespan[Any]],
+            Doc(
+                """
+                A `Lifespan` context manager handler. This replaces `startup` and
+                `shutdown` functions with a single context manager.
+
+                Read more in the
+                [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark all *path operations* in this router as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                To include (or not) all the *path operations* in this router in the
+                generated OpenAPI.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        generate_unique_id_function: Annotated[
+            Callable[[APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> None:
         super().__init__(
             routes=routes,
@@ -755,11 +979,63 @@ class APIRouter(routing.Router):
 
     def websocket(
         self,
-        path: str,
-        name: Optional[str] = None,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                WebSocket path.
+                """
+            ),
+        ],
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A name for the WebSocket. Only used internally.
+                """
+            ),
+        ] = None,
         *,
-        dependencies: Optional[Sequence[params.Depends]] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be used for this
+                WebSocket.
+
+                Read more about it in the
+                [FastAPI docs for WebSockets](https://fastapi.tiangolo.com/advanced/websockets/).
+                """
+            ),
+        ] = None,
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Decorate a WebSocket function.
+
+        Read more about it in the
+        [FastAPI docs for WebSockets](https://fastapi.tiangolo.com/advanced/websockets/).
+
+        **Example**
+
+        ## Example
+
+        ```python
+        from fastapi import APIRouter, FastAPI, WebSocket
+
+        app = FastAPI()
+        router = APIRouter()
+
+        @router.websocket("/ws")
+        async def websocket_endpoint(websocket: WebSocket):
+            await websocket.accept()
+            while True:
+                data = await websocket.receive_text()
+                await websocket.send_text(f"Message text was: {data}")
+
+        app.include_router(router)
+        ```
+        """
+
         def decorator(func: DecoratedCallable) -> DecoratedCallable:
             self.add_api_websocket_route(
                 path, func, name=name, dependencies=dependencies
@@ -779,20 +1055,139 @@ class APIRouter(routing.Router):
 
     def include_router(
         self,
-        router: "APIRouter",
+        router: Annotated["APIRouter", Doc("The `APIRouter` to include.")],
         *,
-        prefix: str = "",
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[params.Depends]] = None,
-        default_response_class: Type[Response] = Default(JSONResponse),
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        deprecated: Optional[bool] = None,
-        include_in_schema: bool = True,
-        generate_unique_id_function: Callable[[APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        prefix: Annotated[str, Doc("An optional path prefix for the router.")] = "",
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to all the *path operations* in this
+                router.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to all the
+                *path operations* in this router.
+
+                Read more about it in the
+                [FastAPI docs for Bigger Applications - Multiple Files](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies).
+                """
+            ),
+        ] = None,
+        default_response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                The default response class to be used.
+
+                Read more in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#default-response-class).
+                """
+            ),
+        ] = Default(JSONResponse),
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses to be shown in OpenAPI.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Additional Responses in OpenAPI](https://fastapi.tiangolo.com/advanced/additional-responses/).
+
+                And in the
+                [FastAPI docs for Bigger Applications](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies).
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                OpenAPI callbacks that should apply to all *path operations* in this
+                router.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark all *path operations* in this router as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include (or not) all the *path operations* in this router in the
+                generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = True,
+        generate_unique_id_function: Annotated[
+            Callable[[APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> None:
+        """
+        Include another `APIRouter` in the same current `APIRouter`.
+
+        Read more about it in the
+        [FastAPI docs for Bigger Applications](https://fastapi.tiangolo.com/tutorial/bigger-applications/).
+
+        ## Example
+
+        ```python
+        from fastapi import APIRouter, FastAPI
+
+        app = FastAPI()
+        internal_router = APIRouter()
+        users_router = APIRouter()
+
+        @users_router.get("/users/")
+        def read_users():
+            return [{"name": "Rick"}, {"name": "Morty"}]
+
+        internal_router.include_router(users_router)
+        app.include_router(internal_router)
+        ```
+        """
         if prefix:
             assert prefix.startswith("/"), "A path prefix must start with '/'"
             assert not prefix.endswith(
@@ -900,33 +1295,354 @@ class APIRouter(routing.Router):
 
     def get(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[params.Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP GET operation.
+
+        ## Example
+
+        ```python
+        from fastapi import APIRouter, FastAPI
+
+        app = FastAPI()
+        router = APIRouter()
+
+        @router.get("/items/")
+        def read_items():
+            return [{"name": "Empanada"}, {"name": "Arepa"}]
+
+        app.include_router(router)
+        ```
+        """
         return self.api_route(
             path=path,
             response_model=response_model,
@@ -956,33 +1672,359 @@ class APIRouter(routing.Router):
 
     def put(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[params.Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP PUT operation.
+
+        ## Example
+
+        ```python
+        from fastapi import APIRouter, FastAPI
+        from pydantic import BaseModel
+
+        class Item(BaseModel):
+            name: str
+            description: str | None = None
+
+        app = FastAPI()
+        router = APIRouter()
+
+        @router.put("/items/{item_id}")
+        def replace_item(item_id: str, item: Item):
+            return {"message": "Item replaced", "id": item_id}
+
+        app.include_router(router)
+        ```
+        """
         return self.api_route(
             path=path,
             response_model=response_model,
@@ -1012,33 +2054,359 @@ class APIRouter(routing.Router):
 
     def post(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[params.Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP POST operation.
+
+        ## Example
+
+        ```python
+        from fastapi import APIRouter, FastAPI
+        from pydantic import BaseModel
+
+        class Item(BaseModel):
+            name: str
+            description: str | None = None
+
+        app = FastAPI()
+        router = APIRouter()
+
+        @router.post("/items/")
+        def create_item(item: Item):
+            return {"message": "Item created"}
+
+        app.include_router(router)
+        ```
+        """
         return self.api_route(
             path=path,
             response_model=response_model,
@@ -1068,33 +2436,354 @@ class APIRouter(routing.Router):
 
     def delete(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[params.Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP DELETE operation.
+
+        ## Example
+
+        ```python
+        from fastapi import APIRouter, FastAPI
+
+        app = FastAPI()
+        router = APIRouter()
+
+        @router.delete("/items/{item_id}")
+        def delete_item(item_id: str):
+            return {"message": "Item deleted"}
+
+        app.include_router(router)
+        ```
+        """
         return self.api_route(
             path=path,
             response_model=response_model,
@@ -1124,33 +2813,354 @@ class APIRouter(routing.Router):
 
     def options(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[params.Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP OPTIONS operation.
+
+        ## Example
+
+        ```python
+        from fastapi import APIRouter, FastAPI
+
+        app = FastAPI()
+        router = APIRouter()
+
+        @router.options("/items/")
+        def get_item_options():
+            return {"additions": ["Aji", "Guacamole"]}
+
+        app.include_router(router)
+        ```
+        """
         return self.api_route(
             path=path,
             response_model=response_model,
@@ -1180,33 +3190,359 @@ class APIRouter(routing.Router):
 
     def head(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[params.Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP HEAD operation.
+
+        ## Example
+
+        ```python
+        from fastapi import APIRouter, FastAPI
+        from pydantic import BaseModel
+
+        class Item(BaseModel):
+            name: str
+            description: str | None = None
+
+        app = FastAPI()
+        router = APIRouter()
+
+        @router.head("/items/", status_code=204)
+        def get_items_headers(response: Response):
+            response.headers["X-Cat-Dog"] = "Alone in the world"
+
+        app.include_router(router)
+        ```
+        """
         return self.api_route(
             path=path,
             response_model=response_model,
@@ -1236,33 +3572,359 @@ class APIRouter(routing.Router):
 
     def patch(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[params.Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP PATCH operation.
+
+        ## Example
+
+        ```python
+        from fastapi import APIRouter, FastAPI
+        from pydantic import BaseModel
+
+        class Item(BaseModel):
+            name: str
+            description: str | None = None
+
+        app = FastAPI()
+        router = APIRouter()
+
+        @router.patch("/items/")
+        def update_item(item: Item):
+            return {"message": "Item updated in place"}
+
+        app.include_router(router)
+        ```
+        """
         return self.api_route(
             path=path,
             response_model=response_model,
@@ -1292,33 +3954,359 @@ class APIRouter(routing.Router):
 
     def trace(
         self,
-        path: str,
+        path: Annotated[
+            str,
+            Doc(
+                """
+                The URL path to be used for this *path operation*.
+
+                For example, in `http://example.com/items`, the path is `/items`.
+                """
+            ),
+        ],
         *,
-        response_model: Any = Default(None),
-        status_code: Optional[int] = None,
-        tags: Optional[List[Union[str, Enum]]] = None,
-        dependencies: Optional[Sequence[params.Depends]] = None,
-        summary: Optional[str] = None,
-        description: Optional[str] = None,
-        response_description: str = "Successful Response",
-        responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None,
-        deprecated: Optional[bool] = None,
-        operation_id: Optional[str] = None,
-        response_model_include: Optional[IncEx] = None,
-        response_model_exclude: Optional[IncEx] = None,
-        response_model_by_alias: bool = True,
-        response_model_exclude_unset: bool = False,
-        response_model_exclude_defaults: bool = False,
-        response_model_exclude_none: bool = False,
-        include_in_schema: bool = True,
-        response_class: Type[Response] = Default(JSONResponse),
-        name: Optional[str] = None,
-        callbacks: Optional[List[BaseRoute]] = None,
-        openapi_extra: Optional[Dict[str, Any]] = None,
-        generate_unique_id_function: Callable[[APIRoute], str] = Default(
-            generate_unique_id
-        ),
+        response_model: Annotated[
+            Any,
+            Doc(
+                """
+                The type to use for the response.
+
+                It could be any valid Pydantic *field* type. So, it doesn't have to
+                be a Pydantic model, it could be other things, like a `list`, `dict`,
+                etc.
+
+                It will be used for:
+
+                * Documentation: the generated OpenAPI (and the UI at `/docs`) will
+                    show it as the response (JSON Schema).
+                * Serialization: you could return an arbitrary object and the
+                    `response_model` would be used to serialize that object into the
+                    corresponding JSON.
+                * Filtering: the JSON sent to the client will only contain the data
+                    (fields) defined in the `response_model`. If you returned an object
+                    that contains an attribute `password` but the `response_model` does
+                    not include that field, the JSON sent to the client would not have
+                    that `password`.
+                * Validation: whatever you return will be serialized with the
+                    `response_model`, converting any data as necessary to generate the
+                    corresponding JSON. But if the data in the object returned is not
+                    valid, that would mean a violation of the contract with the client,
+                    so it's an error from the API developer. So, FastAPI will raise an
+                    error and return a 500 error code (Internal Server Error).
+
+                Read more about it in the
+                [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/).
+                """
+            ),
+        ] = Default(None),
+        status_code: Annotated[
+            Optional[int],
+            Doc(
+                """
+                The default status code to be used for the response.
+
+                You could override the status code by returning a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/).
+                """
+            ),
+        ] = None,
+        tags: Annotated[
+            Optional[List[Union[str, Enum]]],
+            Doc(
+                """
+                A list of tags to be applied to the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags).
+                """
+            ),
+        ] = None,
+        dependencies: Annotated[
+            Optional[Sequence[params.Depends]],
+            Doc(
+                """
+                A list of dependencies (using `Depends()`) to be applied to the
+                *path operation*.
+
+                Read more about it in the
+                [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/).
+                """
+            ),
+        ] = None,
+        summary: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A summary for the *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                A description for the *path operation*.
+
+                If not provided, it will be extracted automatically from the docstring
+                of the *path operation function*.
+
+                It can contain Markdown.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/).
+                """
+            ),
+        ] = None,
+        response_description: Annotated[
+            str,
+            Doc(
+                """
+                The description for the default response.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = "Successful Response",
+        responses: Annotated[
+            Optional[Dict[Union[int, str], Dict[str, Any]]],
+            Doc(
+                """
+                Additional responses that could be returned by this *path operation*.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        deprecated: Annotated[
+            Optional[bool],
+            Doc(
+                """
+                Mark this *path operation* as deprecated.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        operation_id: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Custom operation ID to be used by this *path operation*.
+
+                By default, it is generated automatically.
+
+                If you provide a custom operation ID, you need to make sure it is
+                unique for the whole API.
+
+                You can customize the
+                operation ID generation with the parameter
+                `generate_unique_id_function` in the `FastAPI` class.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = None,
+        response_model_include: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to include only certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_exclude: Annotated[
+            Optional[IncEx],
+            Doc(
+                """
+                Configuration passed to Pydantic to exclude certain fields in the
+                response data.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = None,
+        response_model_by_alias: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response model
+                should be serialized by alias when an alias is used.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude).
+                """
+            ),
+        ] = True,
+        response_model_exclude_unset: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that were not set and
+                have their default values. This is different from
+                `response_model_exclude_defaults` in that if the fields are set,
+                they will be included in the response, even if the value is the same
+                as the default.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_defaults: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data
+                should have all the fields, including the ones that have the same value
+                as the default. This is different from `response_model_exclude_unset`
+                in that if the fields are set but contain the same default values,
+                they will be excluded from the response.
+
+                When `True`, default values are omitted from the response.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter).
+                """
+            ),
+        ] = False,
+        response_model_exclude_none: Annotated[
+            bool,
+            Doc(
+                """
+                Configuration passed to Pydantic to define if the response data should
+                exclude fields set to `None`.
+
+                This is much simpler (less smart) than `response_model_exclude_unset`
+                and `response_model_exclude_defaults`. You probably want to use one of
+                those two instead of this one, as those allow returning `None` values
+                when it makes sense.
+
+                Read more about it in the
+                [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none).
+                """
+            ),
+        ] = False,
+        include_in_schema: Annotated[
+            bool,
+            Doc(
+                """
+                Include this *path operation* in the generated OpenAPI schema.
+
+                This affects the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).
+                """
+            ),
+        ] = True,
+        response_class: Annotated[
+            Type[Response],
+            Doc(
+                """
+                Response class to be used for this *path operation*.
+
+                This will not be used if you return a response directly.
+
+                Read more about it in the
+                [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse).
+                """
+            ),
+        ] = Default(JSONResponse),
+        name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Name for this *path operation*. Only used internally.
+                """
+            ),
+        ] = None,
+        callbacks: Annotated[
+            Optional[List[BaseRoute]],
+            Doc(
+                """
+                List of *path operations* that will be used as OpenAPI callbacks.
+
+                This is only for OpenAPI documentation, the callbacks won't be used
+                directly.
+
+                It will be added to the generated OpenAPI (e.g. visible at `/docs`).
+
+                Read more about it in the
+                [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/).
+                """
+            ),
+        ] = None,
+        openapi_extra: Annotated[
+            Optional[Dict[str, Any]],
+            Doc(
+                """
+                Extra metadata to be included in the OpenAPI schema for this *path
+                operation*.
+
+                Read more about it in the
+                [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema).
+                """
+            ),
+        ] = None,
+        generate_unique_id_function: Annotated[
+            Callable[[APIRoute], str],
+            Doc(
+                """
+                Customize the function used to generate unique IDs for the *path
+                operations* shown in the generated OpenAPI.
+
+                This is particularly useful when automatically generating clients or
+                SDKs for your API.
+
+                Read more about it in the
+                [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function).
+                """
+            ),
+        ] = Default(generate_unique_id),
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add a *path operation* using an HTTP TRACE operation.
+
+        ## Example
+
+        ```python
+        from fastapi import APIRouter, FastAPI
+        from pydantic import BaseModel
+
+        class Item(BaseModel):
+            name: str
+            description: str | None = None
+
+        app = FastAPI()
+        router = APIRouter()
+
+        @router.put("/items/{item_id}")
+        def trace_item(item_id: str):
+            return None
+
+        app.include_router(router)
+        ```
+        """
         return self.api_route(
             path=path,
             response_model=response_model,
@@ -1346,9 +4334,34 @@ class APIRouter(routing.Router):
             generate_unique_id_function=generate_unique_id_function,
         )
 
+    @deprecated(
+        """
+        on_event is deprecated, use lifespan event handlers instead.
+
+        Read more about it in the
+        [FastAPI docs for Lifespan Events](https://fastapi.tiangolo.com/advanced/events/).
+        """
+    )
     def on_event(
-        self, event_type: str
+        self,
+        event_type: Annotated[
+            str,
+            Doc(
+                """
+                The type of event. `startup` or `shutdown`.
+                """
+            ),
+        ],
     ) -> Callable[[DecoratedCallable], DecoratedCallable]:
+        """
+        Add an event handler for the router.
+
+        `on_event` is deprecated, use `lifespan` event handlers instead.
+
+        Read more about it in the
+        [FastAPI docs for Lifespan Events](https://fastapi.tiangolo.com/advanced/events/#alternative-events-deprecated).
+        """
+
         def decorator(func: DecoratedCallable) -> DecoratedCallable:
             self.add_event_handler(event_type, func)
             return func
diff --git a/fastapi/security/api_key.py b/fastapi/security/api_key.py
index 8b2c5c080..b1a6b4f94 100644
--- a/fastapi/security/api_key.py
+++ b/fastapi/security/api_key.py
@@ -5,6 +5,7 @@ from fastapi.security.base import SecurityBase
 from starlette.exceptions import HTTPException
 from starlette.requests import Request
 from starlette.status import HTTP_403_FORBIDDEN
+from typing_extensions import Annotated, Doc  # type: ignore [attr-defined]
 
 
 class APIKeyBase(SecurityBase):
@@ -12,13 +13,83 @@ class APIKeyBase(SecurityBase):
 
 
 class APIKeyQuery(APIKeyBase):
+    """
+    API key authentication using a query parameter.
+
+    This defines the name of the query parameter that should be provided in the request
+    with the API key and integrates that into the OpenAPI documentation. It extracts
+    the key value sent in the query parameter automatically and provides it as the
+    dependency result. But it doesn't define how to send that API key to the client.
+
+    ## Usage
+
+    Create an instance object and use that object as the dependency in `Depends()`.
+
+    The dependency result will be a string containing the key value.
+
+    ## Example
+
+    ```python
+    from fastapi import Depends, FastAPI
+    from fastapi.security import APIKeyQuery
+
+    app = FastAPI()
+
+    query_scheme = APIKeyQuery(name="api_key")
+
+
+    @app.get("/items/")
+    async def read_items(api_key: str = Depends(query_scheme)):
+        return {"api_key": api_key}
+    ```
+    """
+
     def __init__(
         self,
         *,
-        name: str,
-        scheme_name: Optional[str] = None,
-        description: Optional[str] = None,
-        auto_error: bool = True,
+        name: Annotated[
+            str,
+            Doc("Query parameter name."),
+        ],
+        scheme_name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme name.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme description.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        auto_error: Annotated[
+            bool,
+            Doc(
+                """
+                By default, if the query parameter is not provided, `APIKeyQuery` will
+                automatically cancel the request and sebd the client an error.
+
+                If `auto_error` is set to `False`, when the query parameter is not
+                available, instead of erroring out, the dependency result will be
+                `None`.
+
+                This is useful when you want to have optional authentication.
+
+                It is also useful when you want to have authentication that can be
+                provided in one of multiple optional ways (for example, in a query
+                parameter or in an HTTP Bearer token).
+                """
+            ),
+        ] = True,
     ):
         self.model: APIKey = APIKey(
             **{"in": APIKeyIn.query},  # type: ignore[arg-type]
@@ -41,13 +112,79 @@ class APIKeyQuery(APIKeyBase):
 
 
 class APIKeyHeader(APIKeyBase):
+    """
+    API key authentication using a header.
+
+    This defines the name of the header that should be provided in the request with
+    the API key and integrates that into the OpenAPI documentation. It extracts
+    the key value sent in the header automatically and provides it as the dependency
+    result. But it doesn't define how to send that key to the client.
+
+    ## Usage
+
+    Create an instance object and use that object as the dependency in `Depends()`.
+
+    The dependency result will be a string containing the key value.
+
+    ## Example
+
+    ```python
+    from fastapi import Depends, FastAPI
+    from fastapi.security import APIKeyHeader
+
+    app = FastAPI()
+
+    header_scheme = APIKeyHeader(name="x-key")
+
+
+    @app.get("/items/")
+    async def read_items(key: str = Depends(header_scheme)):
+        return {"key": key}
+    ```
+    """
+
     def __init__(
         self,
         *,
-        name: str,
-        scheme_name: Optional[str] = None,
-        description: Optional[str] = None,
-        auto_error: bool = True,
+        name: Annotated[str, Doc("Header name.")],
+        scheme_name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme name.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme description.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        auto_error: Annotated[
+            bool,
+            Doc(
+                """
+                By default, if the header is not provided, `APIKeyHeader` will
+                automatically cancel the request and send the client an error.
+
+                If `auto_error` is set to `False`, when the header is not available,
+                instead of erroring out, the dependency result will be `None`.
+
+                This is useful when you want to have optional authentication.
+
+                It is also useful when you want to have authentication that can be
+                provided in one of multiple optional ways (for example, in a header or
+                in an HTTP Bearer token).
+                """
+            ),
+        ] = True,
     ):
         self.model: APIKey = APIKey(
             **{"in": APIKeyIn.header},  # type: ignore[arg-type]
@@ -70,13 +207,79 @@ class APIKeyHeader(APIKeyBase):
 
 
 class APIKeyCookie(APIKeyBase):
+    """
+    API key authentication using a cookie.
+
+    This defines the name of the cookie that should be provided in the request with
+    the API key and integrates that into the OpenAPI documentation. It extracts
+    the key value sent in the cookie automatically and provides it as the dependency
+    result. But it doesn't define how to set that cookie.
+
+    ## Usage
+
+    Create an instance object and use that object as the dependency in `Depends()`.
+
+    The dependency result will be a string containing the key value.
+
+    ## Example
+
+    ```python
+    from fastapi import Depends, FastAPI
+    from fastapi.security import APIKeyCookie
+
+    app = FastAPI()
+
+    cookie_scheme = APIKeyCookie(name="session")
+
+
+    @app.get("/items/")
+    async def read_items(session: str = Depends(cookie_scheme)):
+        return {"session": session}
+    ```
+    """
+
     def __init__(
         self,
         *,
-        name: str,
-        scheme_name: Optional[str] = None,
-        description: Optional[str] = None,
-        auto_error: bool = True,
+        name: Annotated[str, Doc("Cookie name.")],
+        scheme_name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme name.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme description.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        auto_error: Annotated[
+            bool,
+            Doc(
+                """
+                By default, if the cookie is not provided, `APIKeyCookie` will
+                automatically cancel the request and send the client an error.
+
+                If `auto_error` is set to `False`, when the cookie is not available,
+                instead of erroring out, the dependency result will be `None`.
+
+                This is useful when you want to have optional authentication.
+
+                It is also useful when you want to have authentication that can be
+                provided in one of multiple optional ways (for example, in a cookie or
+                in an HTTP Bearer token).
+                """
+            ),
+        ] = True,
     ):
         self.model: APIKey = APIKey(
             **{"in": APIKeyIn.cookie},  # type: ignore[arg-type]
diff --git a/fastapi/security/http.py b/fastapi/security/http.py
index 8fc0aafd9..3627777d6 100644
--- a/fastapi/security/http.py
+++ b/fastapi/security/http.py
@@ -10,16 +10,60 @@ from fastapi.security.utils import get_authorization_scheme_param
 from pydantic import BaseModel
 from starlette.requests import Request
 from starlette.status import HTTP_401_UNAUTHORIZED, HTTP_403_FORBIDDEN
+from typing_extensions import Annotated, Doc  # type: ignore [attr-defined]
 
 
 class HTTPBasicCredentials(BaseModel):
-    username: str
-    password: str
+    """
+    The HTTP Basic credendials given as the result of using `HTTPBasic` in a
+    dependency.
+
+    Read more about it in the
+    [FastAPI docs for HTTP Basic Auth](https://fastapi.tiangolo.com/advanced/security/http-basic-auth/).
+    """
+
+    username: Annotated[str, Doc("The HTTP Basic username.")]
+    password: Annotated[str, Doc("The HTTP Basic password.")]
 
 
 class HTTPAuthorizationCredentials(BaseModel):
-    scheme: str
-    credentials: str
+    """
+    The HTTP authorization credentials in the result of using `HTTPBearer` or
+    `HTTPDigest` in a dependency.
+
+    The HTTP authorization header value is split by the first space.
+
+    The first part is the `scheme`, the second part is the `credentials`.
+
+    For example, in an HTTP Bearer token scheme, the client will send a header
+    like:
+
+    ```
+    Authorization: Bearer deadbeef12346
+    ```
+
+    In this case:
+
+    * `scheme` will have the value `"Bearer"`
+    * `credentials` will have the value `"deadbeef12346"`
+    """
+
+    scheme: Annotated[
+        str,
+        Doc(
+            """
+            The HTTP authorization scheme extracted from the header value.
+            """
+        ),
+    ]
+    credentials: Annotated[
+        str,
+        Doc(
+            """
+            The HTTP authorization credentials extracted from the header value.
+            """
+        ),
+    ]
 
 
 class HTTPBase(SecurityBase):
@@ -51,13 +95,89 @@ class HTTPBase(SecurityBase):
 
 
 class HTTPBasic(HTTPBase):
+    """
+    HTTP Basic authentication.
+
+    ## Usage
+
+    Create an instance object and use that object as the dependency in `Depends()`.
+
+    The dependency result will be an `HTTPBasicCredentials` object containing the
+    `username` and the `password`.
+
+    Read more about it in the
+    [FastAPI docs for HTTP Basic Auth](https://fastapi.tiangolo.com/advanced/security/http-basic-auth/).
+
+    ## Example
+
+    ```python
+    from typing import Annotated
+
+    from fastapi import Depends, FastAPI
+    from fastapi.security import HTTPBasic, HTTPBasicCredentials
+
+    app = FastAPI()
+
+    security = HTTPBasic()
+
+
+    @app.get("/users/me")
+    def read_current_user(credentials: Annotated[HTTPBasicCredentials, Depends(security)]):
+        return {"username": credentials.username, "password": credentials.password}
+    ```
+    """
+
     def __init__(
         self,
         *,
-        scheme_name: Optional[str] = None,
-        realm: Optional[str] = None,
-        description: Optional[str] = None,
-        auto_error: bool = True,
+        scheme_name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme name.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        realm: Annotated[
+            Optional[str],
+            Doc(
+                """
+                HTTP Basic authentication realm.
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme description.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        auto_error: Annotated[
+            bool,
+            Doc(
+                """
+                By default, if the HTTP Basic authentication is not provided (a
+                header), `HTTPBasic` will automatically cancel the request and send the
+                client an error.
+
+                If `auto_error` is set to `False`, when the HTTP Basic authentication
+                is not available, instead of erroring out, the dependency result will
+                be `None`.
+
+                This is useful when you want to have optional authentication.
+
+                It is also useful when you want to have authentication that can be
+                provided in one of multiple optional ways (for example, in HTTP Basic
+                authentication or in an HTTP Bearer token).
+                """
+            ),
+        ] = True,
     ):
         self.model = HTTPBaseModel(scheme="basic", description=description)
         self.scheme_name = scheme_name or self.__class__.__name__
@@ -98,13 +218,81 @@ class HTTPBasic(HTTPBase):
 
 
 class HTTPBearer(HTTPBase):
+    """
+    HTTP Bearer token authentication.
+
+    ## Usage
+
+    Create an instance object and use that object as the dependency in `Depends()`.
+
+    The dependency result will be an `HTTPAuthorizationCredentials` object containing
+    the `scheme` and the `credentials`.
+
+    ## Example
+
+    ```python
+    from typing import Annotated
+
+    from fastapi import Depends, FastAPI
+    from fastapi.security import HTTPAuthorizationCredentials, HTTPBearer
+
+    app = FastAPI()
+
+    security = HTTPBearer()
+
+
+    @app.get("/users/me")
+    def read_current_user(
+        credentials: Annotated[HTTPAuthorizationCredentials, Depends(security)]
+    ):
+        return {"scheme": credentials.scheme, "credentials": credentials.credentials}
+    ```
+    """
+
     def __init__(
         self,
         *,
-        bearerFormat: Optional[str] = None,
-        scheme_name: Optional[str] = None,
-        description: Optional[str] = None,
-        auto_error: bool = True,
+        bearerFormat: Annotated[Optional[str], Doc("Bearer token format.")] = None,
+        scheme_name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme name.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme description.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        auto_error: Annotated[
+            bool,
+            Doc(
+                """
+                By default, if the HTTP Bearer token not provided (in an
+                `Authorization` header), `HTTPBearer` will automatically cancel the
+                request and send the client an error.
+
+                If `auto_error` is set to `False`, when the HTTP Bearer token
+                is not available, instead of erroring out, the dependency result will
+                be `None`.
+
+                This is useful when you want to have optional authentication.
+
+                It is also useful when you want to have authentication that can be
+                provided in one of multiple optional ways (for example, in an HTTP
+                Bearer token or in a cookie).
+                """
+            ),
+        ] = True,
     ):
         self.model = HTTPBearerModel(bearerFormat=bearerFormat, description=description)
         self.scheme_name = scheme_name or self.__class__.__name__
@@ -134,12 +322,79 @@ class HTTPBearer(HTTPBase):
 
 
 class HTTPDigest(HTTPBase):
+    """
+    HTTP Digest authentication.
+
+    ## Usage
+
+    Create an instance object and use that object as the dependency in `Depends()`.
+
+    The dependency result will be an `HTTPAuthorizationCredentials` object containing
+    the `scheme` and the `credentials`.
+
+    ## Example
+
+    ```python
+    from typing import Annotated
+
+    from fastapi import Depends, FastAPI
+    from fastapi.security import HTTPAuthorizationCredentials, HTTPDigest
+
+    app = FastAPI()
+
+    security = HTTPDigest()
+
+
+    @app.get("/users/me")
+    def read_current_user(
+        credentials: Annotated[HTTPAuthorizationCredentials, Depends(security)]
+    ):
+        return {"scheme": credentials.scheme, "credentials": credentials.credentials}
+    ```
+    """
+
     def __init__(
         self,
         *,
-        scheme_name: Optional[str] = None,
-        description: Optional[str] = None,
-        auto_error: bool = True,
+        scheme_name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme name.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme description.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        auto_error: Annotated[
+            bool,
+            Doc(
+                """
+                By default, if the HTTP Digest not provided, `HTTPDigest` will
+                automatically cancel the request and send the client an error.
+
+                If `auto_error` is set to `False`, when the HTTP Digest is not
+                available, instead of erroring out, the dependency result will
+                be `None`.
+
+                This is useful when you want to have optional authentication.
+
+                It is also useful when you want to have authentication that can be
+                provided in one of multiple optional ways (for example, in HTTP
+                Digest or in a cookie).
+                """
+            ),
+        ] = True,
     ):
         self.model = HTTPBaseModel(scheme="digest", description=description)
         self.scheme_name = scheme_name or self.__class__.__name__
diff --git a/fastapi/security/oauth2.py b/fastapi/security/oauth2.py
index e4c4357e7..d427783ad 100644
--- a/fastapi/security/oauth2.py
+++ b/fastapi/security/oauth2.py
@@ -10,51 +10,136 @@ from starlette.requests import Request
 from starlette.status import HTTP_401_UNAUTHORIZED, HTTP_403_FORBIDDEN
 
 # TODO: import from typing when deprecating Python 3.9
-from typing_extensions import Annotated
+from typing_extensions import Annotated, Doc  # type: ignore [attr-defined]
 
 
 class OAuth2PasswordRequestForm:
     """
-    This is a dependency class, use it like:
+    This is a dependency class to collect the `username` and `password` as form data
+    for an OAuth2 password flow.
 
-        @app.post("/login")
-        def login(form_data: OAuth2PasswordRequestForm = Depends()):
-            data = form_data.parse()
-            print(data.username)
-            print(data.password)
-            for scope in data.scopes:
-                print(scope)
-            if data.client_id:
-                print(data.client_id)
-            if data.client_secret:
-                print(data.client_secret)
-            return data
+    The OAuth2 specification dictates that for a password flow the data should be
+    collected using form data (instead of JSON) and that it should have the specific
+    fields `username` and `password`.
 
+    All the initialization parameters are extracted from the request.
 
-    It creates the following Form request parameters in your endpoint:
+    Read more about it in the
+    [FastAPI docs for Simple OAuth2 with Password and Bearer](https://fastapi.tiangolo.com/tutorial/security/simple-oauth2/).
 
-    grant_type: the OAuth2 spec says it is required and MUST be the fixed string "password".
-        Nevertheless, this dependency class is permissive and allows not passing it. If you want to enforce it,
-        use instead the OAuth2PasswordRequestFormStrict dependency.
-    username: username string. The OAuth2 spec requires the exact field name "username".
-    password: password string. The OAuth2 spec requires the exact field name "password".
-    scope: Optional string. Several scopes (each one a string) separated by spaces. E.g.
-        "items:read items:write users:read profile openid"
-    client_id: optional string. OAuth2 recommends sending the client_id and client_secret (if any)
-        using HTTP Basic auth, as: client_id:client_secret
-    client_secret: optional string. OAuth2 recommends sending the client_id and client_secret (if any)
-        using HTTP Basic auth, as: client_id:client_secret
+    ## Example
+
+    ```python
+    from typing import Annotated
+
+    from fastapi import Depends, FastAPI
+    from fastapi.security import OAuth2PasswordRequestForm
+
+    app = FastAPI()
+
+
+    @app.post("/login")
+    def login(form_data: Annotated[OAuth2PasswordRequestForm, Depends()]):
+        data = {}
+        data["scopes"] = []
+        for scope in form_data.scopes:
+            data["scopes"].append(scope)
+        if form_data.client_id:
+            data["client_id"] = form_data.client_id
+        if form_data.client_secret:
+            data["client_secret"] = form_data.client_secret
+        return data
+    ```
+
+    Note that for OAuth2 the scope `items:read` is a single scope in an opaque string.
+    You could have custom internal logic to separate it by colon caracters (`:`) or
+    similar, and get the two parts `items` and `read`. Many applications do that to
+    group and organize permisions, you could do it as well in your application, just
+    know that that it is application specific, it's not part of the specification.
     """
 
     def __init__(
         self,
         *,
-        grant_type: Annotated[Union[str, None], Form(pattern="password")] = None,
-        username: Annotated[str, Form()],
-        password: Annotated[str, Form()],
-        scope: Annotated[str, Form()] = "",
-        client_id: Annotated[Union[str, None], Form()] = None,
-        client_secret: Annotated[Union[str, None], Form()] = None,
+        grant_type: Annotated[
+            Union[str, None],
+            Form(pattern="password"),
+            Doc(
+                """
+                The OAuth2 spec says it is required and MUST be the fixed string
+                "password". Nevertheless, this dependency class is permissive and
+                allows not passing it. If you want to enforce it, use instead the
+                `OAuth2PasswordRequestFormStrict` dependency.
+                """
+            ),
+        ] = None,
+        username: Annotated[
+            str,
+            Form(),
+            Doc(
+                """
+                `username` string. The OAuth2 spec requires the exact field name
+                `username`.
+                """
+            ),
+        ],
+        password: Annotated[
+            str,
+            Form(),
+            Doc(
+                """
+                `password` string. The OAuth2 spec requires the exact field name
+                `password".
+                """
+            ),
+        ],
+        scope: Annotated[
+            str,
+            Form(),
+            Doc(
+                """
+                A single string with actually several scopes separated by spaces. Each
+                scope is also a string.
+
+                For example, a single string with:
+
+                ```python
+                "items:read items:write users:read profile openid"
+                ````
+
+                would represent the scopes:
+
+                * `items:read`
+                * `items:write`
+                * `users:read`
+                * `profile`
+                * `openid`
+                """
+            ),
+        ] = "",
+        client_id: Annotated[
+            Union[str, None],
+            Form(),
+            Doc(
+                """
+                If there's a `client_id`, it can be sent as part of the form fields.
+                But the OAuth2 specification recommends sending the `client_id` and
+                `client_secret` (if any) using HTTP Basic auth.
+                """
+            ),
+        ] = None,
+        client_secret: Annotated[
+            Union[str, None],
+            Form(),
+            Doc(
+                """
+                If there's a `client_password` (and a `client_id`), they can be sent
+                as part of the form fields. But the OAuth2 specification recommends
+                sending the `client_id` and `client_secret` (if any) using HTTP Basic
+                auth.
+                """
+            ),
+        ] = None,
     ):
         self.grant_type = grant_type
         self.username = username
@@ -66,23 +151,54 @@ class OAuth2PasswordRequestForm:
 
 class OAuth2PasswordRequestFormStrict(OAuth2PasswordRequestForm):
     """
-    This is a dependency class, use it like:
+    This is a dependency class to collect the `username` and `password` as form data
+    for an OAuth2 password flow.
+
+    The OAuth2 specification dictates that for a password flow the data should be
+    collected using form data (instead of JSON) and that it should have the specific
+    fields `username` and `password`.
+
+    All the initialization parameters are extracted from the request.
+
+    The only difference between `OAuth2PasswordRequestFormStrict` and
+    `OAuth2PasswordRequestForm` is that `OAuth2PasswordRequestFormStrict` requires the
+    client to send the form field `grant_type` with the value `"password"`, which
+    is required in the OAuth2 specification (it seems that for no particular reason),
+    while for `OAuth2PasswordRequestForm` `grant_type` is optional.
+
+    Read more about it in the
+    [FastAPI docs for Simple OAuth2 with Password and Bearer](https://fastapi.tiangolo.com/tutorial/security/simple-oauth2/).
+
+    ## Example
+
+    ```python
+    from typing import Annotated
+
+    from fastapi import Depends, FastAPI
+    from fastapi.security import OAuth2PasswordRequestForm
 
-        @app.post("/login")
-        def login(form_data: OAuth2PasswordRequestFormStrict = Depends()):
-            data = form_data.parse()
-            print(data.username)
-            print(data.password)
-            for scope in data.scopes:
-                print(scope)
-            if data.client_id:
-                print(data.client_id)
-            if data.client_secret:
-                print(data.client_secret)
-            return data
+    app = FastAPI()
 
 
-    It creates the following Form request parameters in your endpoint:
+    @app.post("/login")
+    def login(form_data: Annotated[OAuth2PasswordRequestFormStrict, Depends()]):
+        data = {}
+        data["scopes"] = []
+        for scope in form_data.scopes:
+            data["scopes"].append(scope)
+        if form_data.client_id:
+            data["client_id"] = form_data.client_id
+        if form_data.client_secret:
+            data["client_secret"] = form_data.client_secret
+        return data
+    ```
+
+    Note that for OAuth2 the scope `items:read` is a single scope in an opaque string.
+    You could have custom internal logic to separate it by colon caracters (`:`) or
+    similar, and get the two parts `items` and `read`. Many applications do that to
+    group and organize permisions, you could do it as well in your application, just
+    know that that it is application specific, it's not part of the specification.
+
 
     grant_type: the OAuth2 spec says it is required and MUST be the fixed string "password".
         This dependency is strict about it. If you want to be permissive, use instead the
@@ -99,12 +215,85 @@ class OAuth2PasswordRequestFormStrict(OAuth2PasswordRequestForm):
 
     def __init__(
         self,
-        grant_type: Annotated[str, Form(pattern="password")],
-        username: Annotated[str, Form()],
-        password: Annotated[str, Form()],
-        scope: Annotated[str, Form()] = "",
-        client_id: Annotated[Union[str, None], Form()] = None,
-        client_secret: Annotated[Union[str, None], Form()] = None,
+        grant_type: Annotated[
+            str,
+            Form(pattern="password"),
+            Doc(
+                """
+                The OAuth2 spec says it is required and MUST be the fixed string
+                "password". This dependency is strict about it. If you want to be
+                permissive, use instead the `OAuth2PasswordRequestForm` dependency
+                class.
+                """
+            ),
+        ],
+        username: Annotated[
+            str,
+            Form(),
+            Doc(
+                """
+                `username` string. The OAuth2 spec requires the exact field name
+                `username`.
+                """
+            ),
+        ],
+        password: Annotated[
+            str,
+            Form(),
+            Doc(
+                """
+                `password` string. The OAuth2 spec requires the exact field name
+                `password".
+                """
+            ),
+        ],
+        scope: Annotated[
+            str,
+            Form(),
+            Doc(
+                """
+                A single string with actually several scopes separated by spaces. Each
+                scope is also a string.
+
+                For example, a single string with:
+
+                ```python
+                "items:read items:write users:read profile openid"
+                ````
+
+                would represent the scopes:
+
+                * `items:read`
+                * `items:write`
+                * `users:read`
+                * `profile`
+                * `openid`
+                """
+            ),
+        ] = "",
+        client_id: Annotated[
+            Union[str, None],
+            Form(),
+            Doc(
+                """
+                If there's a `client_id`, it can be sent as part of the form fields.
+                But the OAuth2 specification recommends sending the `client_id` and
+                `client_secret` (if any) using HTTP Basic auth.
+                """
+            ),
+        ] = None,
+        client_secret: Annotated[
+            Union[str, None],
+            Form(),
+            Doc(
+                """
+                If there's a `client_password` (and a `client_id`), they can be sent
+                as part of the form fields. But the OAuth2 specification recommends
+                sending the `client_id` and `client_secret` (if any) using HTTP Basic
+                auth.
+                """
+            ),
+        ] = None,
     ):
         super().__init__(
             grant_type=grant_type,
@@ -117,13 +306,69 @@ class OAuth2PasswordRequestFormStrict(OAuth2PasswordRequestForm):
 
 
 class OAuth2(SecurityBase):
+    """
+    This is the base class for OAuth2 authentication, an instance of it would be used
+    as a dependency. All other OAuth2 classes inherit from it and customize it for
+    each OAuth2 flow.
+
+    You normally would not create a new class inheriting from it but use one of the
+    existing subclasses, and maybe compose them if you want to support multiple flows.
+
+    Read more about it in the
+    [FastAPI docs for Security](https://fastapi.tiangolo.com/tutorial/security/).
+    """
+
     def __init__(
         self,
         *,
-        flows: Union[OAuthFlowsModel, Dict[str, Dict[str, Any]]] = OAuthFlowsModel(),
-        scheme_name: Optional[str] = None,
-        description: Optional[str] = None,
-        auto_error: bool = True,
+        flows: Annotated[
+            Union[OAuthFlowsModel, Dict[str, Dict[str, Any]]],
+            Doc(
+                """
+                The dictionary of OAuth2 flows.
+                """
+            ),
+        ] = OAuthFlowsModel(),
+        scheme_name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme name.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme description.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        auto_error: Annotated[
+            bool,
+            Doc(
+                """
+                By default, if no HTTP Auhtorization header is provided, required for
+                OAuth2 authentication, it will automatically cancel the request and
+                send the client an error.
+
+                If `auto_error` is set to `False`, when the HTTP Authorization header
+                is not available, instead of erroring out, the dependency result will
+                be `None`.
+
+                This is useful when you want to have optional authentication.
+
+                It is also useful when you want to have authentication that can be
+                provided in one of multiple optional ways (for example, with OAuth2
+                or in a cookie).
+                """
+            ),
+        ] = True,
     ):
         self.model = OAuth2Model(
             flows=cast(OAuthFlowsModel, flows), description=description
@@ -144,13 +389,74 @@ class OAuth2(SecurityBase):
 
 
 class OAuth2PasswordBearer(OAuth2):
+    """
+    OAuth2 flow for authentication using a bearer token obtained with a password.
+    An instance of it would be used as a dependency.
+
+    Read more about it in the
+    [FastAPI docs for Simple OAuth2 with Password and Bearer](https://fastapi.tiangolo.com/tutorial/security/simple-oauth2/).
+    """
+
     def __init__(
         self,
-        tokenUrl: str,
-        scheme_name: Optional[str] = None,
-        scopes: Optional[Dict[str, str]] = None,
-        description: Optional[str] = None,
-        auto_error: bool = True,
+        tokenUrl: Annotated[
+            str,
+            Doc(
+                """
+                The URL to obtain the OAuth2 token. This would be the *path operation*
+                that has `OAuth2PasswordRequestForm` as a dependency.
+                """
+            ),
+        ],
+        scheme_name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme name.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        scopes: Annotated[
+            Optional[Dict[str, str]],
+            Doc(
+                """
+                The OAuth2 scopes that would be required by the *path operations* that
+                use this dependency.
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme description.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        auto_error: Annotated[
+            bool,
+            Doc(
+                """
+                By default, if no HTTP Auhtorization header is provided, required for
+                OAuth2 authentication, it will automatically cancel the request and
+                send the client an error.
+
+                If `auto_error` is set to `False`, when the HTTP Authorization header
+                is not available, instead of erroring out, the dependency result will
+                be `None`.
+
+                This is useful when you want to have optional authentication.
+
+                It is also useful when you want to have authentication that can be
+                provided in one of multiple optional ways (for example, with OAuth2
+                or in a cookie).
+                """
+            ),
+        ] = True,
     ):
         if not scopes:
             scopes = {}
@@ -180,15 +486,79 @@ class OAuth2PasswordBearer(OAuth2):
 
 
 class OAuth2AuthorizationCodeBearer(OAuth2):
+    """
+    OAuth2 flow for authentication using a bearer token obtained with an OAuth2 code
+    flow. An instance of it would be used as a dependency.
+    """
+
     def __init__(
         self,
         authorizationUrl: str,
-        tokenUrl: str,
-        refreshUrl: Optional[str] = None,
-        scheme_name: Optional[str] = None,
-        scopes: Optional[Dict[str, str]] = None,
-        description: Optional[str] = None,
-        auto_error: bool = True,
+        tokenUrl: Annotated[
+            str,
+            Doc(
+                """
+                The URL to obtain the OAuth2 token.
+                """
+            ),
+        ],
+        refreshUrl: Annotated[
+            Optional[str],
+            Doc(
+                """
+                The URL to refresh the token and obtain a new one.
+                """
+            ),
+        ] = None,
+        scheme_name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme name.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        scopes: Annotated[
+            Optional[Dict[str, str]],
+            Doc(
+                """
+                The OAuth2 scopes that would be required by the *path operations* that
+                use this dependency.
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme description.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        auto_error: Annotated[
+            bool,
+            Doc(
+                """
+                By default, if no HTTP Auhtorization header is provided, required for
+                OAuth2 authentication, it will automatically cancel the request and
+                send the client an error.
+
+                If `auto_error` is set to `False`, when the HTTP Authorization header
+                is not available, instead of erroring out, the dependency result will
+                be `None`.
+
+                This is useful when you want to have optional authentication.
+
+                It is also useful when you want to have authentication that can be
+                provided in one of multiple optional ways (for example, with OAuth2
+                or in a cookie).
+                """
+            ),
+        ] = True,
     ):
         if not scopes:
             scopes = {}
@@ -226,6 +596,45 @@ class OAuth2AuthorizationCodeBearer(OAuth2):
 
 
 class SecurityScopes:
-    def __init__(self, scopes: Optional[List[str]] = None):
-        self.scopes = scopes or []
-        self.scope_str = " ".join(self.scopes)
+    """
+    This is a special class that you can define in a parameter in a dependency to
+    obtain the OAuth2 scopes required by all the dependencies in the same chain.
+
+    This way, multiple dependencies can have different scopes, even when used in the
+    same *path operation*. And with this, you can access all the scopes required in
+    all those dependencies in a single place.
+
+    Read more about it in the
+    [FastAPI docs for OAuth2 scopes](https://fastapi.tiangolo.com/advanced/security/oauth2-scopes/).
+    """
+
+    def __init__(
+        self,
+        scopes: Annotated[
+            Optional[List[str]],
+            Doc(
+                """
+                This will be filled by FastAPI.
+                """
+            ),
+        ] = None,
+    ):
+        self.scopes: Annotated[
+            List[str],
+            Doc(
+                """
+                The list of all the scopes required by dependencies.
+                """
+            ),
+        ] = (
+            scopes or []
+        )
+        self.scope_str: Annotated[
+            str,
+            Doc(
+                """
+                All the scopes required by all the dependencies in a single string
+                separated by spaces, as defined in the OAuth2 specification.
+                """
+            ),
+        ] = " ".join(self.scopes)
diff --git a/fastapi/security/open_id_connect_url.py b/fastapi/security/open_id_connect_url.py
index 4e65f1f6c..c612b475d 100644
--- a/fastapi/security/open_id_connect_url.py
+++ b/fastapi/security/open_id_connect_url.py
@@ -5,16 +5,66 @@ from fastapi.security.base import SecurityBase
 from starlette.exceptions import HTTPException
 from starlette.requests import Request
 from starlette.status import HTTP_403_FORBIDDEN
+from typing_extensions import Annotated, Doc  # type: ignore [attr-defined]
 
 
 class OpenIdConnect(SecurityBase):
+    """
+    OpenID Connect authentication class. An instance of it would be used as a
+    dependency.
+    """
+
     def __init__(
         self,
         *,
-        openIdConnectUrl: str,
-        scheme_name: Optional[str] = None,
-        description: Optional[str] = None,
-        auto_error: bool = True,
+        openIdConnectUrl: Annotated[
+            str,
+            Doc(
+                """
+            The OpenID Connect URL.
+            """
+            ),
+        ],
+        scheme_name: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme name.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        description: Annotated[
+            Optional[str],
+            Doc(
+                """
+                Security scheme description.
+
+                It will be included in the generated OpenAPI (e.g. visible at `/docs`).
+                """
+            ),
+        ] = None,
+        auto_error: Annotated[
+            bool,
+            Doc(
+                """
+                By default, if no HTTP Auhtorization header is provided, required for
+                OpenID Connect authentication, it will automatically cancel the request
+                and send the client an error.
+
+                If `auto_error` is set to `False`, when the HTTP Authorization header
+                is not available, instead of erroring out, the dependency result will
+                be `None`.
+
+                This is useful when you want to have optional authentication.
+
+                It is also useful when you want to have authentication that can be
+                provided in one of multiple optional ways (for example, with OpenID
+                Connect or in a cookie).
+                """
+            ),
+        ] = True,
     ):
         self.model = OpenIdConnectModel(
             openIdConnectUrl=openIdConnectUrl, description=description
diff --git a/pyproject.toml b/pyproject.toml
index b49f472d5..addde1d33 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -42,7 +42,7 @@ classifiers = [
 dependencies = [
     "starlette>=0.27.0,<0.28.0",
     "pydantic>=1.7.4,!=1.8,!=1.8.1,!=2.0.0,!=2.0.1,!=2.1.0,<3.0.0",
-    "typing-extensions>=4.5.0",
+    "typing-extensions>=4.8.0",
     # TODO: remove this pin after upgrading Starlette 0.31.1
     "anyio>=3.7.1,<4.0.0",
 ]
diff --git a/requirements-docs-tests.txt b/requirements-docs-tests.txt
new file mode 100644
index 000000000..1a4a57267
--- /dev/null
+++ b/requirements-docs-tests.txt
@@ -0,0 +1,3 @@
+# For mkdocstrings and tests
+httpx >=0.23.0,<0.25.0
+black == 23.3.0
diff --git a/requirements-docs.txt b/requirements-docs.txt
index 2e667720e..3e0df6483 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -1,4 +1,5 @@
 -e .
+-r requirements-docs-tests.txt
 mkdocs-material==9.1.21
 mdx-include >=1.4.1,<2.0.0
 mkdocs-markdownextradata-plugin >=0.1.7,<0.3.0
@@ -12,3 +13,5 @@ jieba==0.42.1
 pillow==9.5.0
 # For image processing by Material for MkDocs
 cairosvg==2.7.0
+mkdocstrings[python]==0.23.0
+griffe-typingdoc==0.2.2
diff --git a/requirements-tests.txt b/requirements-tests.txt
index 6f7f4ac23..de8d3f26c 100644
--- a/requirements-tests.txt
+++ b/requirements-tests.txt
@@ -1,11 +1,10 @@
 -e .
+-r requirements-docs-tests.txt
 pydantic-settings >=2.0.0
 pytest >=7.1.3,<8.0.0
 coverage[toml] >= 6.5.0,< 8.0
 mypy ==1.4.1
 ruff ==0.0.275
-black == 23.3.0
-httpx >=0.23.0,<0.25.0
 email_validator >=1.1.1,<3.0.0
 dirty-equals ==0.6.0
 # TODO: once removing databases from tutorial, upgrade SQLAlchemy
diff --git a/scripts/docs.py b/scripts/docs.py
index 968dd9a3d..0023c670c 100644
--- a/scripts/docs.py
+++ b/scripts/docs.py
@@ -153,17 +153,21 @@ index_sponsors_template = """
 def generate_readme_content() -> str:
     en_index = en_docs_path / "docs" / "index.md"
     content = en_index.read_text("utf-8")
+    match_pre = re.search(r"</style>\n\n", content)
     match_start = re.search(r"<!-- sponsors -->", content)
     match_end = re.search(r"<!-- /sponsors -->", content)
     sponsors_data_path = en_docs_path / "data" / "sponsors.yml"
     sponsors = mkdocs.utils.yaml_load(sponsors_data_path.read_text(encoding="utf-8"))
     if not (match_start and match_end):
         raise RuntimeError("Couldn't auto-generate sponsors section")
+    if not match_pre:
+        raise RuntimeError("Couldn't find pre section (<style>) in index.md")
+    frontmatter_end = match_pre.end()
     pre_end = match_start.end()
     post_start = match_end.start()
     template = Template(index_sponsors_template)
     message = template.render(sponsors=sponsors)
-    pre_content = content[:pre_end]
+    pre_content = content[frontmatter_end:pre_end]
     post_content = content[post_start:]
     new_content = pre_content + message + post_content
     return new_content
@@ -286,7 +290,6 @@ def update_config() -> None:
         else:
             use_name = alternate_dict[url]
             new_alternate.append({"link": url, "name": use_name})
-    config["nav"][1] = {"Languages": languages}
     config["extra"]["alternate"] = new_alternate
     en_config_path.write_text(
         yaml.dump(config, sort_keys=False, width=200, allow_unicode=True),
diff --git a/scripts/mkdocs_hooks.py b/scripts/mkdocs_hooks.py
index 008751f8a..b12487b50 100644
--- a/scripts/mkdocs_hooks.py
+++ b/scripts/mkdocs_hooks.py
@@ -8,6 +8,11 @@ from mkdocs.structure.files import File, Files
 from mkdocs.structure.nav import Link, Navigation, Section
 from mkdocs.structure.pages import Page
 
+non_traslated_sections = [
+    "reference/",
+    "release-notes.md",
+]
+
 
 @lru_cache()
 def get_missing_translation_content(docs_dir: str) -> str:
@@ -123,6 +128,9 @@ def on_page_markdown(
     markdown: str, *, page: Page, config: MkDocsConfig, files: Files
 ) -> str:
     if isinstance(page.file, EnFile):
+        for excluded_section in non_traslated_sections:
+            if page.file.src_path.startswith(excluded_section):
+                return markdown
         missing_translation_content = get_missing_translation_content(config.docs_dir)
         header = ""
         body = markdown
diff --git a/tests/test_datastructures.py b/tests/test_datastructures.py
index b91467265..7e57d525c 100644
--- a/tests/test_datastructures.py
+++ b/tests/test_datastructures.py
@@ -1,3 +1,4 @@
+import io
 from pathlib import Path
 from typing import List
 
@@ -52,3 +53,20 @@ def test_upload_file_is_closed(tmp_path: Path):
 
     assert testing_file_store
     assert testing_file_store[0].file.closed
+
+
+# For UploadFile coverage, segments copied from Starlette tests
+
+
+@pytest.mark.anyio
+async def test_upload_file():
+    stream = io.BytesIO(b"data")
+    file = UploadFile(filename="file", file=stream, size=4)
+    assert await file.read() == b"data"
+    assert file.size == 4
+    await file.write(b" and more data!")
+    assert await file.read() == b""
+    assert file.size == 19
+    await file.seek(0)
+    assert await file.read() == b"data and more data!"
+    await file.close()
diff --git a/tests/test_router_events.py b/tests/test_router_events.py
index ba6b76382..1b9de18ae 100644
--- a/tests/test_router_events.py
+++ b/tests/test_router_events.py
@@ -21,6 +21,9 @@ def state() -> State:
     return State()
 
 
+@pytest.mark.filterwarnings(
+    r"ignore:\s*on_event is deprecated, use lifespan event handlers instead.*:DeprecationWarning"
+)
 def test_router_events(state: State) -> None:
     app = FastAPI()
 
diff --git a/tests/test_tutorial/test_async_sql_databases/test_tutorial001.py b/tests/test_tutorial/test_async_sql_databases/test_tutorial001.py
index 25d6df3e9..13568a532 100644
--- a/tests/test_tutorial/test_async_sql_databases/test_tutorial001.py
+++ b/tests/test_tutorial/test_async_sql_databases/test_tutorial001.py
@@ -1,13 +1,20 @@
+import pytest
+from fastapi import FastAPI
 from fastapi.testclient import TestClient
 
-from docs_src.async_sql_databases.tutorial001 import app
-
 from ...utils import needs_pydanticv1
 
 
+@pytest.fixture(name="app", scope="module")
+def get_app():
+    with pytest.warns(DeprecationWarning):
+        from docs_src.async_sql_databases.tutorial001 import app
+    yield app
+
+
 # TODO: pv2 add version with Pydantic v2
 @needs_pydanticv1
-def test_create_read():
+def test_create_read(app: FastAPI):
     with TestClient(app) as client:
         note = {"text": "Foo bar", "completed": False}
         response = client.post("/notes/", json=note)
@@ -21,7 +28,7 @@ def test_create_read():
         assert data in response.json()
 
 
-def test_openapi_schema():
+def test_openapi_schema(app: FastAPI):
     with TestClient(app) as client:
         response = client.get("/openapi.json")
         assert response.status_code == 200, response.text
diff --git a/tests/test_tutorial/test_events/test_tutorial001.py b/tests/test_tutorial/test_events/test_tutorial001.py
index a5bb299ac..f65b92d12 100644
--- a/tests/test_tutorial/test_events/test_tutorial001.py
+++ b/tests/test_tutorial/test_events/test_tutorial001.py
@@ -1,16 +1,23 @@
+import pytest
+from fastapi import FastAPI
 from fastapi.testclient import TestClient
 
-from docs_src.events.tutorial001 import app
 
+@pytest.fixture(name="app", scope="module")
+def get_app():
+    with pytest.warns(DeprecationWarning):
+        from docs_src.events.tutorial001 import app
+    yield app
 
-def test_events():
+
+def test_events(app: FastAPI):
     with TestClient(app) as client:
         response = client.get("/items/foo")
         assert response.status_code == 200, response.text
         assert response.json() == {"name": "Fighters"}
 
 
-def test_openapi_schema():
+def test_openapi_schema(app: FastAPI):
     with TestClient(app) as client:
         response = client.get("/openapi.json")
         assert response.status_code == 200, response.text
diff --git a/tests/test_tutorial/test_events/test_tutorial002.py b/tests/test_tutorial/test_events/test_tutorial002.py
index 81cbf4ab6..137294d73 100644
--- a/tests/test_tutorial/test_events/test_tutorial002.py
+++ b/tests/test_tutorial/test_events/test_tutorial002.py
@@ -1,9 +1,16 @@
+import pytest
+from fastapi import FastAPI
 from fastapi.testclient import TestClient
 
-from docs_src.events.tutorial002 import app
 
+@pytest.fixture(name="app", scope="module")
+def get_app():
+    with pytest.warns(DeprecationWarning):
+        from docs_src.events.tutorial002 import app
+    yield app
 
-def test_events():
+
+def test_events(app: FastAPI):
     with TestClient(app) as client:
         response = client.get("/items/")
         assert response.status_code == 200, response.text
@@ -12,7 +19,7 @@ def test_events():
         assert "Application shutdown" in log.read()
 
 
-def test_openapi_schema():
+def test_openapi_schema(app: FastAPI):
     with TestClient(app) as client:
         response = client.get("/openapi.json")
         assert response.status_code == 200, response.text
diff --git a/tests/test_tutorial/test_testing/test_tutorial003.py b/tests/test_tutorial/test_testing/test_tutorial003.py
index d9e16390e..2a5d67071 100644
--- a/tests/test_tutorial/test_testing/test_tutorial003.py
+++ b/tests/test_tutorial/test_testing/test_tutorial003.py
@@ -1,5 +1,7 @@
-from docs_src.app_testing.tutorial003 import test_read_items
+import pytest
 
 
 def test_main():
+    with pytest.warns(DeprecationWarning):
+        from docs_src.app_testing.tutorial003 import test_read_items
     test_read_items()

From f056d001e5fe2b29f00cdc8e68f3c01feb40ce89 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 18 Oct 2023 12:37:29 +0000
Subject: [PATCH 222/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 62ffd4b35..c3485050f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* ✨ Add reference (code API) docs with PEP 727, add subclass with custom docstrings for `BackgroundTasks`, refactor docs structure. PR [#10392](https://github.com/tiangolo/fastapi/pull/10392) by [@tiangolo](https://github.com/tiangolo).
 * ⬆ Bump dawidd6/action-download-artifact from 2.27.0 to 2.28.0. PR [#10268](https://github.com/tiangolo/fastapi/pull/10268) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ Bump actions/checkout from 3 to 4. PR [#10208](https://github.com/tiangolo/fastapi/pull/10208) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ Bump pypa/gh-action-pypi-publish from 1.8.6 to 1.8.10. PR [#10061](https://github.com/tiangolo/fastapi/pull/10061) by [@dependabot[bot]](https://github.com/apps/dependabot).

From 76e547f254f92a06d9b5a103dfa32693c3d38451 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 18 Oct 2023 16:50:22 +0400
Subject: [PATCH 223/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index c3485050f..e49394e72 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,13 +7,22 @@ hide:
 
 ## Latest Changes
 
-* ✨ Add reference (code API) docs with PEP 727, add subclass with custom docstrings for `BackgroundTasks`, refactor docs structure. PR [#10392](https://github.com/tiangolo/fastapi/pull/10392) by [@tiangolo](https://github.com/tiangolo).
+## Features
+
+* ✨ Add reference (code API) docs with PEP 727, add subclass with custom docstrings for `BackgroundTasks`, refactor docs structure. PR [#10392](https://github.com/tiangolo/fastapi/pull/10392) by [@tiangolo](https://github.com/tiangolo). New docs at [FastAPI Reference - Code API](https://fastapi.tiangolo.com/reference/).
+
+## Upgrades
+
+* ⬆️ Drop support for Python 3.7, require Python 3.8 or above. PR [#10442](https://github.com/tiangolo/fastapi/pull/10442) by [@tiangolo](https://github.com/tiangolo).
+
+### Internal
+
 * ⬆ Bump dawidd6/action-download-artifact from 2.27.0 to 2.28.0. PR [#10268](https://github.com/tiangolo/fastapi/pull/10268) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ Bump actions/checkout from 3 to 4. PR [#10208](https://github.com/tiangolo/fastapi/pull/10208) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ Bump pypa/gh-action-pypi-publish from 1.8.6 to 1.8.10. PR [#10061](https://github.com/tiangolo/fastapi/pull/10061) by [@dependabot[bot]](https://github.com/apps/dependabot).
-* ⬆️ Drop support for Python 3.7, require Python 3.8 or above. PR [#10442](https://github.com/tiangolo/fastapi/pull/10442) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, Bump.sh images. PR [#10381](https://github.com/tiangolo/fastapi/pull/10381) by [@tiangolo](https://github.com/tiangolo).
 * 👥 Update FastAPI People. PR [#10363](https://github.com/tiangolo/fastapi/pull/10363) by [@tiangolo](https://github.com/tiangolo).
+
 ## 0.103.2
 
 ### Refactors

From 38f191dcd30c7e7b7d422b4406f8eb8c6805b09d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 18 Oct 2023 16:51:07 +0400
Subject: [PATCH 224/317] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.10?=
 =?UTF-8?q?4.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 2 ++
 fastapi/__init__.py           | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index e49394e72..b78b2cb5a 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
 
 ## Latest Changes
 
+## 0.104.0
+
 ## Features
 
 * ✨ Add reference (code API) docs with PEP 727, add subclass with custom docstrings for `BackgroundTasks`, refactor docs structure. PR [#10392](https://github.com/tiangolo/fastapi/pull/10392) by [@tiangolo](https://github.com/tiangolo). New docs at [FastAPI Reference - Code API](https://fastapi.tiangolo.com/reference/).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index 981ca4945..4fdb155c2 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.103.2"
+__version__ = "0.104.0"
 
 from starlette import status as status
 

From c13aa9ed5f19feccdb41a8af465cbaa1de218630 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 20 Oct 2023 12:27:26 +0400
Subject: [PATCH 225/317] =?UTF-8?q?=F0=9F=94=A5=20Remove=20unnecessary=20d?=
 =?UTF-8?q?uplicated=20docstrings=20(#10484)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 fastapi/applications.py | 7 -------
 fastapi/routing.py      | 7 -------
 2 files changed, 14 deletions(-)

diff --git a/fastapi/applications.py b/fastapi/applications.py
index 46b7ae81b..8ca374a54 100644
--- a/fastapi/applications.py
+++ b/fastapi/applications.py
@@ -86,13 +86,6 @@ class FastAPI(Starlette):
                 **Note**: you probably shouldn't use this parameter, it is inherited
                 from Starlette and supported for compatibility.
 
-                In FastAPI, you normally would use the *path operation* decorators,
-                like:
-
-                * `app.get()`
-                * `app.post()`
-                * etc.
-
                 ---
 
                 A list of routes to serve incoming HTTP and WebSocket requests.
diff --git a/fastapi/routing.py b/fastapi/routing.py
index e33e1d832..54d53bbbf 100644
--- a/fastapi/routing.py
+++ b/fastapi/routing.py
@@ -624,13 +624,6 @@ class APIRouter(routing.Router):
                 **Note**: you probably shouldn't use this parameter, it is inherited
                 from Starlette and supported for compatibility.
 
-                In FastAPI, you normally would use the *path operation* decorators,
-                like:
-
-                * `router.get()`
-                * `router.post()`
-                * etc.
-
                 ---
 
                 A list of routes to serve incoming HTTP and WebSocket requests.

From 7670a132b3ce3374ed52c02659989a07da406985 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 20 Oct 2023 08:28:05 +0000
Subject: [PATCH 226/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b78b2cb5a..90ad69c28 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* 🔥 Remove unnecessary duplicated docstrings. PR [#10484](https://github.com/tiangolo/fastapi/pull/10484) by [@tiangolo](https://github.com/tiangolo).
 ## 0.104.0
 
 ## Features

From dc7838eec310454d9b1a41712e75d220e18e2bdd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Fri, 20 Oct 2023 12:39:03 +0400
Subject: [PATCH 227/317] =?UTF-8?q?=F0=9F=94=A5=20Drop/close=20Gitter=20ch?=
 =?UTF-8?q?at.=20Questions=20should=20go=20to=20GitHub=20Discussions,=20fr?=
 =?UTF-8?q?ee=20conversations=20to=20Discord.=20(#10485)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/em/docs/help-fastapi.md   |  2 -
 docs/en/docs/help-fastapi.md   |  2 -
 docs/en/docs/js/chat.js        |  3 --
 docs/fr/docs/help-fastapi.md   | 18 ---------
 docs/ja/docs/help-fastapi.md   | 14 -------
 docs/pl/docs/help-fastapi.md   |  2 -
 docs/pt/docs/help-fastapi.md   |  2 -
 docs/ru/docs/help-fastapi.md   |  2 -
 docs/zh/docs/help-fastapi.md   |  2 -
 scripts/gitter_releases_bot.py | 67 ----------------------------------
 scripts/notify.sh              |  5 ---
 11 files changed, 119 deletions(-)
 delete mode 100644 docs/en/docs/js/chat.js
 delete mode 100644 scripts/gitter_releases_bot.py
 delete mode 100755 scripts/notify.sh

diff --git a/docs/em/docs/help-fastapi.md b/docs/em/docs/help-fastapi.md
index d7b66185d..b998ade42 100644
--- a/docs/em/docs/help-fastapi.md
+++ b/docs/em/docs/help-fastapi.md
@@ -231,8 +231,6 @@
 
     ⚙️ 💬 🕴 🎏 🏢 💬.
 
-📤 ⏮️ <a href="https://gitter.im/tiangolo/fastapi" class="external-link" target="_blank">🥊 💬</a>, ✋️ ⚫️ 🚫 ✔️ 📻 &amp; 🏧 ⚒, 💬 🌖 ⚠, 😧 🔜 👍 ⚙️.
-
 ### 🚫 ⚙️ 💬 ❔
 
 ✔️ 🤯 👈 💬 ✔ 🌅 "🆓 💬", ⚫️ ⏩ 💭 ❔ 👈 💁‍♂️ 🏢 &amp; 🌅 ⚠ ❔,, 👆 💪 🚫 📨 ❔.
diff --git a/docs/en/docs/help-fastapi.md b/docs/en/docs/help-fastapi.md
index e977dba20..8199c9b9a 100644
--- a/docs/en/docs/help-fastapi.md
+++ b/docs/en/docs/help-fastapi.md
@@ -231,8 +231,6 @@ Join the 👥 <a href="https://discord.gg/VQjSZaeJmf" class="external-link" targ
 
     Use the chat only for other general conversations.
 
-There is also the previous <a href="https://gitter.im/tiangolo/fastapi" class="external-link" target="_blank">Gitter chat</a>, but as it doesn't have channels and advanced features, conversations are more difficult, so Discord is now the recommended system.
-
 ### Don't use the chat for questions
 
 Have in mind that as chats allow more "free conversation", it's easy to ask questions that are too general and more difficult to answer, so, you might not receive answers.
diff --git a/docs/en/docs/js/chat.js b/docs/en/docs/js/chat.js
deleted file mode 100644
index debdef4da..000000000
--- a/docs/en/docs/js/chat.js
+++ /dev/null
@@ -1,3 +0,0 @@
-((window.gitter = {}).chat = {}).options = {
-    room: 'tiangolo/fastapi'
-};
diff --git a/docs/fr/docs/help-fastapi.md b/docs/fr/docs/help-fastapi.md
index 3bc3c3a8a..525c699f5 100644
--- a/docs/fr/docs/help-fastapi.md
+++ b/docs/fr/docs/help-fastapi.md
@@ -84,24 +84,6 @@ Vous pouvez <a href="https://github.com/tiangolo/fastapi" class="external-link"
 * Pour corriger une Issue/Bug existant.
 * Pour ajouter une nouvelle fonctionnalité.
 
-## Rejoindre le chat
-
-<a href="https://gitter.im/tiangolo/fastapi?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge" target="_blank">
-    <img src="https://badges.gitter.im/tiangolo/fastapi.svg" alt="Rejoindre le chat à https://gitter.im/tiangolo/fastapi">
-</a>
-
-Rejoignez le chat sur Gitter: <a href="https://gitter.im/tiangolo/fastapi" class="external-link" target="_blank">https://gitter.im/tiangolo/fastapi</a>.
-
-Vous pouvez y avoir des conversations rapides avec d'autres personnes, aider les autres, partager des idées, etc.
-
-Mais gardez à l'esprit que, comme il permet une "conversation plus libre", il est facile de poser des questions trop générales et plus difficiles à répondre, de sorte que vous risquez de ne pas recevoir de réponses.
-
-Dans les Issues de GitHub, le modèle vous guidera pour écrire la bonne question afin que vous puissiez plus facilement obtenir une bonne réponse, ou même résoudre le problème vous-même avant même de le poser. Et dans GitHub, je peux m'assurer que je réponds toujours à tout, même si cela prend du temps. Je ne peux pas faire cela personnellement avec le chat Gitter. 😅
-
-Les conversations dans Gitter ne sont pas non plus aussi facilement consultables que dans GitHub, de sorte que les questions et les réponses peuvent se perdre dans la conversation.
-
-De l'autre côté, il y a plus de 1000 personnes dans le chat, il y a donc de fortes chances que vous y trouviez quelqu'un à qui parler, presque tout le temps. 😄
-
 ## Parrainer l'auteur
 
 Vous pouvez également soutenir financièrement l'auteur (moi) via <a href="https://github.com/sponsors/tiangolo" class="external-link" target="_blank">GitHub sponsors</a>.
diff --git a/docs/ja/docs/help-fastapi.md b/docs/ja/docs/help-fastapi.md
index 166acb586..e753b7ce3 100644
--- a/docs/ja/docs/help-fastapi.md
+++ b/docs/ja/docs/help-fastapi.md
@@ -82,20 +82,6 @@ GitHubレポジトリで<a href="https://github.com/tiangolo/fastapi/issues/new/
 * 既存のissue/バグを修正。
 * 新機能を追加。
 
-## チャットに参加
-
-Gitterでチャットに参加: <a href="https://gitter.im/tiangolo/fastapi" class="external-link" target="_blank">https://gitter.im/tiangolo/fastapi</a>.
-
-そこで、他の人と手早く会話したり、手助けやアイデアの共有などができます。
-
-しかし、「自由な会話」が許容されているので一般的すぎて回答が難しい質問もしやすくなります。そのせいで回答を得られないかもしれません。
-
-GitHub issuesでは良い回答を得やすい質問ができるように、もしくは、質問する前に自身で解決できるようにテンプレートがガイドしてくれます。そして、GitHubではたとえ時間がかかっても全てに答えているか確認できます。個人的にはGitterチャットでは同じことはできないです。😅
-
-Gitterでの会話はGitHubほど簡単に検索できないので、質問と回答が会話の中に埋もれてしまいます。
-
-一方、チャットには1000人以上いるので、いつでも話し相手が見つかる可能性が高いです。😄
-
 ## 開発者のスポンサーになる
 
 <a href="https://github.com/sponsors/tiangolo" class="external-link" target="_blank">GitHub sponsors</a>を通して開発者を経済的にサポートできます。
diff --git a/docs/pl/docs/help-fastapi.md b/docs/pl/docs/help-fastapi.md
index 723df91d1..3d02a8741 100644
--- a/docs/pl/docs/help-fastapi.md
+++ b/docs/pl/docs/help-fastapi.md
@@ -231,8 +231,6 @@ Dołącz do 👥 <a href="https://discord.gg/VQjSZaeJmf" class="external-link" t
 
     Używaj czatu tylko do innych ogólnych rozmów.
 
-Istnieje również poprzedni <a href="https://gitter.im/tiangolo/fastapi" class="external-link" target="_blank">czat na Gitter</a>, ale ponieważ nie ma tam kanałów i zaawansowanych funkcji, rozmowy są trudniejsze, dlatego teraz zalecany jest Discord.
-
 ### Nie zadawaj pytań na czacie
 
 Miej na uwadze, że ponieważ czaty pozwalają na bardziej "swobodną rozmowę", łatwo jest zadawać pytania, które są zbyt ogólne i trudniejsze do odpowiedzi, więc możesz nie otrzymać odpowiedzi.
diff --git a/docs/pt/docs/help-fastapi.md b/docs/pt/docs/help-fastapi.md
index d82ce3414..d04905197 100644
--- a/docs/pt/docs/help-fastapi.md
+++ b/docs/pt/docs/help-fastapi.md
@@ -114,8 +114,6 @@ do FastAPI.
 
     Use o chat apenas para outro tipo de assunto.
 
-Também existe o <a href="https://gitter.im/tiangolo/fastapi" class="external-link" target="_blank">chat do Gitter</a>, porém ele não possuí canais e recursos avançados, conversas são mais engessadas, por isso o Discord é mais recomendado.
-
 ### Não faça perguntas no chat
 
 Tenha em mente que os chats permitem uma "conversa mais livre", dessa forma é muito fácil fazer perguntas que são muito genéricas e dificeís de responder, assim você pode acabar não sendo respondido.
diff --git a/docs/ru/docs/help-fastapi.md b/docs/ru/docs/help-fastapi.md
index a69e37bd8..65ff768d1 100644
--- a/docs/ru/docs/help-fastapi.md
+++ b/docs/ru/docs/help-fastapi.md
@@ -223,8 +223,6 @@
 
     Используйте этот чат только для бесед на отвлечённые темы.
 
-Существует также <a href="https://gitter.im/tiangolo/fastapi" class="external-link" target="_blank">чат в Gitter</a>, но поскольку в нем нет каналов и расширенных функций, общение в нём сложнее, потому рекомендуемой системой является Discord.
-
 ### Не использовать чаты для вопросов
 
 Имейте в виду, что чаты позволяют больше "свободного общения", потому там легко задавать вопросы, которые слишком общие и на которые труднее ответить, так что Вы можете не получить нужные Вам ответы.
diff --git a/docs/zh/docs/help-fastapi.md b/docs/zh/docs/help-fastapi.md
index 2a99950e3..9b70d115a 100644
--- a/docs/zh/docs/help-fastapi.md
+++ b/docs/zh/docs/help-fastapi.md
@@ -114,8 +114,6 @@
 
     聊天室仅供闲聊。
 
-我们之前还使用过 <a href="https://gitter.im/tiangolo/fastapi" class="external-link" target="_blank">Gitter chat</a>，但它不支持频道等高级功能，聊天也比较麻烦，所以现在推荐使用 Discord。
-
 ### 别在聊天室里提问
 
 注意，聊天室更倾向于“闲聊”，经常有人会提出一些笼统得让人难以回答的问题，所以在这里提问一般没人回答。
diff --git a/scripts/gitter_releases_bot.py b/scripts/gitter_releases_bot.py
deleted file mode 100644
index a033d0d69..000000000
--- a/scripts/gitter_releases_bot.py
+++ /dev/null
@@ -1,67 +0,0 @@
-import inspect
-import os
-
-import requests
-
-room_id = "5c9c9540d73408ce4fbc1403"  # FastAPI
-# room_id = "5cc46398d73408ce4fbed233"  # Gitter development
-
-gitter_token = os.getenv("GITTER_TOKEN")
-assert gitter_token
-github_token = os.getenv("GITHUB_TOKEN")
-assert github_token
-tag_name = os.getenv("TAG")
-assert tag_name
-
-
-def get_github_graphql(tag_name: str):
-    github_graphql = """
-    {
-    repository(owner: "tiangolo", name: "fastapi") {
-        release (tagName: "{{tag_name}}" ) {
-        description
-        }
-      }
-    }
-    """
-    github_graphql = github_graphql.replace("{{tag_name}}", tag_name)
-    return github_graphql
-
-
-def get_github_release_text(tag_name: str):
-    url = "https://api.github.com/graphql"
-    headers = {"Authorization": f"Bearer {github_token}"}
-    github_graphql = get_github_graphql(tag_name=tag_name)
-    response = requests.post(url, json={"query": github_graphql}, headers=headers)
-    assert response.status_code == 200
-    data = response.json()
-    return data["data"]["repository"]["release"]["description"]
-
-
-def get_gitter_message(release_text: str):
-    text = f"""
-    New release! :tada: :rocket:
-    (by FastAPI bot)
-
-    ## {tag_name}
-    """
-    text = inspect.cleandoc(text) + "\n\n" + release_text
-    return text
-
-
-def send_gitter_message(text: str):
-    headers = {"Authorization": f"Bearer {gitter_token}"}
-    url = f"https://api.gitter.im/v1/rooms/{room_id}/chatMessages"
-    data = {"text": text}
-    response = requests.post(url, headers=headers, json=data)
-    assert response.status_code == 200
-
-
-def main():
-    release_text = get_github_release_text(tag_name=tag_name)
-    text = get_gitter_message(release_text=release_text)
-    send_gitter_message(text=text)
-
-
-if __name__ == "__main__":
-    main()
diff --git a/scripts/notify.sh b/scripts/notify.sh
deleted file mode 100755
index 8ce550026..000000000
--- a/scripts/notify.sh
+++ /dev/null
@@ -1,5 +0,0 @@
-#!/usr/bin/env bash
-
-set -e
-
-python scripts/gitter_releases_bot.py

From dcbe7f7ac0a6503254c8ac90924950b9cfb8fbf0 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 20 Oct 2023 08:39:45 +0000
Subject: [PATCH 228/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 90ad69c28..0cfb193e3 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* 🔥 Drop/close Gitter chat. Questions should go to GitHub Discussions, free conversations to Discord.. PR [#10485](https://github.com/tiangolo/fastapi/pull/10485) by [@tiangolo](https://github.com/tiangolo).
 * 🔥 Remove unnecessary duplicated docstrings. PR [#10484](https://github.com/tiangolo/fastapi/pull/10484) by [@tiangolo](https://github.com/tiangolo).
 ## 0.104.0
 

From 6eb30959bc5486ec19b31675d92744d10d11c9ba Mon Sep 17 00:00:00 2001
From: Tiago Silva <tiago.arasilva@gmail.com>
Date: Fri, 20 Oct 2023 09:52:59 +0100
Subject: [PATCH 229/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20typo=20in=20?=
 =?UTF-8?q?`docs/en/docs/reference/index.md`=20(#10467)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Fix small typo in reference/index.md
---
 docs/en/docs/reference/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/docs/reference/index.md b/docs/en/docs/reference/index.md
index 994b3c38c..512d5c25c 100644
--- a/docs/en/docs/reference/index.md
+++ b/docs/en/docs/reference/index.md
@@ -1,7 +1,7 @@
 # Reference - Code API
 
 Here's the reference or code API, the classes, functions, parameters, attributes, and
-all the FastAPI parts you can use in you applications.
+all the FastAPI parts you can use in your applications.
 
 If you want to **learn FastAPI** you are much better off reading the
 [FastAPI Tutorial](https://fastapi.tiangolo.com/tutorial/).

From 968afca0581f24b9a0e6e58bc21d03bd181b8a59 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 20 Oct 2023 08:53:37 +0000
Subject: [PATCH 230/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 0cfb193e3..00e369236 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* ✏️ Fix typo in `docs/en/docs/reference/index.md`. PR [#10467](https://github.com/tiangolo/fastapi/pull/10467) by [@tarsil](https://github.com/tarsil).
 * 🔥 Drop/close Gitter chat. Questions should go to GitHub Discussions, free conversations to Discord.. PR [#10485](https://github.com/tiangolo/fastapi/pull/10485) by [@tiangolo](https://github.com/tiangolo).
 * 🔥 Remove unnecessary duplicated docstrings. PR [#10484](https://github.com/tiangolo/fastapi/pull/10484) by [@tiangolo](https://github.com/tiangolo).
 ## 0.104.0

From 57a030175e7027ba0200c78521efc44800b6fd52 Mon Sep 17 00:00:00 2001
From: yogabonito <yogabonito@users.noreply.github.com>
Date: Fri, 20 Oct 2023 10:55:30 +0200
Subject: [PATCH 231/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20docs,=20remove?=
 =?UTF-8?q?=20references=20to=20removed=20`pydantic.Required`=20in=20`docs?=
 =?UTF-8?q?/en/docs/tutorial/query-params-str-validations.md`=20(#10469)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../tutorial/query-params-str-validations.md  | 27 +------------------
 1 file changed, 1 insertion(+), 26 deletions(-)

diff --git a/docs/en/docs/tutorial/query-params-str-validations.md b/docs/en/docs/tutorial/query-params-str-validations.md
index 0b2cf02a8..0e777f6a0 100644
--- a/docs/en/docs/tutorial/query-params-str-validations.md
+++ b/docs/en/docs/tutorial/query-params-str-validations.md
@@ -502,33 +502,8 @@ To do that, you can declare that `None` is a valid type but still use `...` as t
 !!! tip
     Pydantic, which is what powers all the data validation and serialization in FastAPI, has a special behavior when you use `Optional` or `Union[Something, None]` without a default value, you can read more about it in the Pydantic docs about <a href="https://pydantic-docs.helpmanual.io/usage/models/#required-optional-fields" class="external-link" target="_blank">Required Optional fields</a>.
 
-### Use Pydantic's `Required` instead of Ellipsis (`...`)
-
-If you feel uncomfortable using `...`, you can also import and use `Required` from Pydantic:
-
-=== "Python 3.9+"
-
-    ```Python hl_lines="4  10"
-    {!> ../../../docs_src/query_params_str_validations/tutorial006d_an_py39.py!}
-    ```
-
-=== "Python 3.8+"
-
-    ```Python hl_lines="2  9"
-    {!> ../../../docs_src/query_params_str_validations/tutorial006d_an.py!}
-    ```
-
-=== "Python 3.8+ non-Annotated"
-
-    !!! tip
-        Prefer to use the `Annotated` version if possible.
-
-    ```Python hl_lines="2  8"
-    {!> ../../../docs_src/query_params_str_validations/tutorial006d.py!}
-    ```
-
 !!! tip
-    Remember that in most of the cases, when something is required, you can simply omit the default, so you normally don't have to use `...` nor `Required`.
+    Remember that in most of the cases, when something is required, you can simply omit the default, so you normally don't have to use `...`.
 
 ## Query parameter list / multiple values
 

From cda5e770abed7efc92dbc96d4a21007ea485b4a6 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 20 Oct 2023 08:56:08 +0000
Subject: [PATCH 232/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 00e369236..6832da44e 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* 📝 Update docs, remove references to removed `pydantic.Required` in `docs/en/docs/tutorial/query-params-str-validations.md`. PR [#10469](https://github.com/tiangolo/fastapi/pull/10469) by [@yogabonito](https://github.com/yogabonito).
 * ✏️ Fix typo in `docs/en/docs/reference/index.md`. PR [#10467](https://github.com/tiangolo/fastapi/pull/10467) by [@tarsil](https://github.com/tarsil).
 * 🔥 Drop/close Gitter chat. Questions should go to GitHub Discussions, free conversations to Discord.. PR [#10485](https://github.com/tiangolo/fastapi/pull/10485) by [@tiangolo](https://github.com/tiangolo).
 * 🔥 Remove unnecessary duplicated docstrings. PR [#10484](https://github.com/tiangolo/fastapi/pull/10484) by [@tiangolo](https://github.com/tiangolo).

From 4bd14306771cab5c1bff022dd2b1827cdd0ad186 Mon Sep 17 00:00:00 2001
From: yogabonito <yogabonito@users.noreply.github.com>
Date: Fri, 20 Oct 2023 10:58:03 +0200
Subject: [PATCH 233/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20typos=20and?=
 =?UTF-8?q?=20rewordings=20in=20`docs/en/docs/tutorial/body-nested-models.?=
 =?UTF-8?q?md`=20(#10468)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/tutorial/body-nested-models.md | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/docs/en/docs/tutorial/body-nested-models.md b/docs/en/docs/tutorial/body-nested-models.md
index 3a1052397..387f0de9a 100644
--- a/docs/en/docs/tutorial/body-nested-models.md
+++ b/docs/en/docs/tutorial/body-nested-models.md
@@ -183,18 +183,18 @@ This would mean that **FastAPI** would expect a body similar to:
 
 Again, doing just that declaration, with **FastAPI** you get:
 
-* Editor support (completion, etc), even for nested models
+* Editor support (completion, etc.), even for nested models
 * Data conversion
 * Data validation
 * Automatic documentation
 
 ## Special types and validation
 
-Apart from normal singular types like `str`, `int`, `float`, etc. You can use more complex singular types that inherit from `str`.
+Apart from normal singular types like `str`, `int`, `float`, etc. you can use more complex singular types that inherit from `str`.
 
 To see all the options you have, checkout the docs for <a href="https://pydantic-docs.helpmanual.io/usage/types/" class="external-link" target="_blank">Pydantic's exotic types</a>. You will see some examples in the next chapter.
 
-For example, as in the `Image` model we have a `url` field, we can declare it to be instead of a `str`, a Pydantic's `HttpUrl`:
+For example, as in the `Image` model we have a `url` field, we can declare it to be an instance of Pydantic's `HttpUrl` instead of a `str`:
 
 === "Python 3.10+"
 
@@ -218,7 +218,7 @@ The string will be checked to be a valid URL, and documented in JSON Schema / Op
 
 ## Attributes with lists of submodels
 
-You can also use Pydantic models as subtypes of `list`, `set`, etc:
+You can also use Pydantic models as subtypes of `list`, `set`, etc.:
 
 === "Python 3.10+"
 
@@ -238,7 +238,7 @@ You can also use Pydantic models as subtypes of `list`, `set`, etc:
     {!> ../../../docs_src/body_nested_models/tutorial006.py!}
     ```
 
-This will expect (convert, validate, document, etc) a JSON body like:
+This will expect (convert, validate, document, etc.) a JSON body like:
 
 ```JSON hl_lines="11"
 {
@@ -334,15 +334,15 @@ But you don't have to worry about them either, incoming dicts are converted auto
 
 ## Bodies of arbitrary `dict`s
 
-You can also declare a body as a `dict` with keys of some type and values of other type.
+You can also declare a body as a `dict` with keys of some type and values of some other type.
 
-Without having to know beforehand what are the valid field/attribute names (as would be the case with Pydantic models).
+This way, you don't have to know beforehand what the valid field/attribute names are (as would be the case with Pydantic models).
 
 This would be useful if you want to receive keys that you don't already know.
 
 ---
 
-Other useful case is when you want to have keys of other type, e.g. `int`.
+Another useful case is when you want to have keys of another type (e.g., `int`).
 
 That's what we are going to see here.
 

From 6dac39dbcabbb8ceade5b2b96cd19b6902affbaa Mon Sep 17 00:00:00 2001
From: Surav Shrestha <98219089+suravshresth@users.noreply.github.com>
Date: Fri, 20 Oct 2023 14:43:51 +0545
Subject: [PATCH 234/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20typo=20in=20?=
 =?UTF-8?q?`docs/en/docs/reference/dependencies.md`=20(#10465)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/reference/dependencies.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/docs/reference/dependencies.md b/docs/en/docs/reference/dependencies.md
index 95cd101e4..099968267 100644
--- a/docs/en/docs/reference/dependencies.md
+++ b/docs/en/docs/reference/dependencies.md
@@ -18,7 +18,7 @@ from fastapi import Depends
 ## `Security()`
 
 For many scenarios, you can handle security (authorization, authentication, etc.) with
-dependendencies, using `Depends()`.
+dependencies, using `Depends()`.
 
 But when you want to also declare OAuth2 scopes, you can use `Security()` instead of
 `Depends()`.

From f785a6ce90bb1938779bb8e7d6124229528f9f06 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 20 Oct 2023 09:00:11 +0000
Subject: [PATCH 235/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 6832da44e..d75f9a08c 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* ✏️ Fix typos and rewordings in `docs/en/docs/tutorial/body-nested-models.md`. PR [#10468](https://github.com/tiangolo/fastapi/pull/10468) by [@yogabonito](https://github.com/yogabonito).
 * 📝 Update docs, remove references to removed `pydantic.Required` in `docs/en/docs/tutorial/query-params-str-validations.md`. PR [#10469](https://github.com/tiangolo/fastapi/pull/10469) by [@yogabonito](https://github.com/yogabonito).
 * ✏️ Fix typo in `docs/en/docs/reference/index.md`. PR [#10467](https://github.com/tiangolo/fastapi/pull/10467) by [@tarsil](https://github.com/tarsil).
 * 🔥 Drop/close Gitter chat. Questions should go to GitHub Discussions, free conversations to Discord.. PR [#10485](https://github.com/tiangolo/fastapi/pull/10485) by [@tiangolo](https://github.com/tiangolo).

From ae84ff6e44d45fe75e96fb12ae225046d99c29e8 Mon Sep 17 00:00:00 2001
From: Heinz-Alexander Fuetterer <35225576+afuetterer@users.noreply.github.com>
Date: Fri, 20 Oct 2023 11:00:44 +0200
Subject: [PATCH 236/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20typos=20in?=
 =?UTF-8?q?=20emoji=20docs=20and=20in=20some=20source=20examples=20(#10438?=
 =?UTF-8?q?)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/em/docs/deployment/concepts.md           | 14 +++++-----
 docs/em/docs/deployment/docker.md             | 26 +++++++++----------
 docs/em/docs/deployment/server-workers.md     |  8 +++---
 docs/em/docs/project-generation.md            |  2 +-
 docs/en/docs/how-to/sql-databases-peewee.md   |  2 +-
 docs_src/openapi_webhooks/tutorial001.py      |  2 +-
 fastapi/utils.py                              |  2 +-
 .../test_openapi_webhooks/test_tutorial001.py |  4 +--
 tests/test_webhooks_security.py               |  6 ++---
 9 files changed, 33 insertions(+), 33 deletions(-)

diff --git a/docs/em/docs/deployment/concepts.md b/docs/em/docs/deployment/concepts.md
index 8ce775411..162b68615 100644
--- a/docs/em/docs/deployment/concepts.md
+++ b/docs/em/docs/deployment/concepts.md
@@ -43,7 +43,7 @@
     * ⏮️ 🔢 🦲 💖 Certbot 📄 🔕
 * ✳
     * ⏮️ 🔢 🦲 💖 Certbot 📄 🔕
-* Kubernete ⏮️ 🚧 🕹 💖 👌
+* Kubernetes ⏮️ 🚧 🕹 💖 👌
     * ⏮️ 🔢 🦲 💖 🛂-👨‍💼 📄 🔕
 * 🍵 🔘 ☁ 🐕‍🦺 🍕 👫 🐕‍🦺 (✍ 🔛 👶)
 
@@ -115,7 +115,7 @@
 🖼 🧰 👈 💪 👉 👨‍🏭:
 
 * ☁
-* Kubernete
+* Kubernetes
 * ☁ ✍
 * ☁ 🐝 📳
 * ✳
@@ -165,7 +165,7 @@
 🖼, 👉 💪 🍵:
 
 * ☁
-* Kubernete
+* Kubernetes
 * ☁ ✍
 * ☁ 🐝 📳
 * ✳
@@ -233,15 +233,15 @@
     * 🐁 🔜 **🛠️ 👨‍💼** 👂 🔛 **📢** &amp; **⛴**, 🧬 🔜 ✔️ **💗 Uvicorn 👨‍🏭 🛠️**
 * **Uvicorn** 🛠️ **Uvicorn 👨‍🏭**
     * 1️⃣ Uvicorn **🛠️ 👨‍💼** 🔜 👂 🔛 **📢** &amp; **⛴**, &amp; ⚫️ 🔜 ▶️ **💗 Uvicorn 👨‍🏭 🛠️**
-* **Kubernete** &amp; 🎏 📎 **📦 ⚙️**
+* **Kubernetes** &amp; 🎏 📎 **📦 ⚙️**
     * 🕳 **☁** 🧽 🔜 👂 🔛 **📢** &amp; **⛴**. 🧬 🔜 ✔️ **💗 📦**, 🔠 ⏮️ **1️⃣ Uvicorn 🛠️** 🏃‍♂
 * **☁ 🐕‍🦺** 👈 🍵 👉 👆
     * ☁ 🐕‍🦺 🔜 🎲 **🍵 🧬 👆**. ⚫️ 🔜 🎲 ➡️ 👆 🔬 **🛠️ 🏃**, ⚖️ **📦 🖼** ⚙️, 🙆 💼, ⚫️ 🔜 🌅 🎲 **👁 Uvicorn 🛠️**, &amp; ☁ 🐕‍🦺 🔜 🈚 🔁 ⚫️.
 
 !!! tip
-    🚫 😟 🚥 👫 🏬 🔃 **📦**, ☁, ⚖️ Kubernete 🚫 ⚒ 📚 🔑.
+    🚫 😟 🚥 👫 🏬 🔃 **📦**, ☁, ⚖️ Kubernetes 🚫 ⚒ 📚 🔑.
 
-    👤 🔜 💬 👆 🌅 🔃 📦 🖼, ☁, Kubernete, ♒️. 🔮 📃: [FastAPI 📦 - ☁](./docker.md){.internal-link target=_blank}.
+    👤 🔜 💬 👆 🌅 🔃 📦 🖼, ☁, Kubernetes, ♒️. 🔮 📃: [FastAPI 📦 - ☁](./docker.md){.internal-link target=_blank}.
 
 ## ⏮️ 🔁 ⏭ ▶️
 
@@ -268,7 +268,7 @@
 
 📥 💪 💭:
 
-*  "🕑 📦" Kubernete 👈 🏃 ⏭ 👆 📱 📦
+*  "🕑 📦" Kubernetes 👈 🏃 ⏭ 👆 📱 📦
 * 🎉 ✍ 👈 🏃 ⏮️ 🔁 &amp; ⤴️ ▶️ 👆 🈸
     * 👆 🔜 💪 🌌 ▶️/⏏ *👈* 🎉 ✍, 🔍 ❌, ♒️.
 
diff --git a/docs/em/docs/deployment/docker.md b/docs/em/docs/deployment/docker.md
index 51ece5599..f28735ed7 100644
--- a/docs/em/docs/deployment/docker.md
+++ b/docs/em/docs/deployment/docker.md
@@ -74,7 +74,7 @@ CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
 
 , 👆 🔜 🏃 **💗 📦** ⏮️ 🎏 👜, 💖 💽, 🐍 🈸, 🕸 💽 ⏮️ 😥 🕸 🈸, &amp; 🔗 👫 👯‍♂️ 📨 👫 🔗 🕸.
 
-🌐 📦 🧾 ⚙️ (💖 ☁ ⚖️ Kubernete) ✔️ 👫 🕸 ⚒ 🛠️ 🔘 👫.
+🌐 📦 🧾 ⚙️ (💖 ☁ ⚖️ Kubernetes) ✔️ 👫 🕸 ⚒ 🛠️ 🔘 👫.
 
 ## 📦 &amp; 🛠️
 
@@ -96,7 +96,7 @@ CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
 
 👉 ⚫️❔ 👆 🔜 💚 **🏆 💼**, 🖼:
 
-* ⚙️ **Kubernete** ⚖️ 🎏 🧰
+* ⚙️ **Kubernetes** ⚖️ 🎏 🧰
 * 🕐❔ 🏃‍♂ 🔛 **🍓 👲**
 * ⚙️ ☁ 🐕‍🦺 👈 🔜 🏃 📦 🖼 👆, ♒️.
 
@@ -395,7 +395,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 ⚫️ 💪 ➕1️⃣ 📦, 🖼 ⏮️ <a href="https://traefik.io/" class="external-link" target="_blank">Traefik</a>, 🚚 **🇺🇸🔍** &amp; **🏧** 🛠️ **📄**.
 
 !!! tip
-    Traefik ✔️ 🛠️ ⏮️ ☁, Kubernete, &amp; 🎏, ⚫️ 📶 ⏩ ⚒ 🆙 &amp; 🔗 🇺🇸🔍 👆 📦 ⏮️ ⚫️.
+    Traefik ✔️ 🛠️ ⏮️ ☁, Kubernetes, &amp; 🎏, ⚫️ 📶 ⏩ ⚒ 🆙 &amp; 🔗 🇺🇸🔍 👆 📦 ⏮️ ⚫️.
 
 👐, 🇺🇸🔍 💪 🍵 ☁ 🐕‍🦺 1️⃣ 👫 🐕‍🦺 (⏪ 🏃 🈸 📦).
 
@@ -403,7 +403,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 
 📤 🛎 ➕1️⃣ 🧰 🈚 **▶️ &amp; 🏃‍♂** 👆 📦.
 
-⚫️ 💪 **☁** 🔗, **☁ ✍**, **Kubernete**, **☁ 🐕‍🦺**, ♒️.
+⚫️ 💪 **☁** 🔗, **☁ ✍**, **Kubernetes**, **☁ 🐕‍🦺**, ♒️.
 
 🌅 (⚖️ 🌐) 💼, 📤 🙅 🎛 🛠️ 🏃 📦 🔛 🕴 &amp; 🛠️ ⏏ 🔛 ❌. 🖼, ☁, ⚫️ 📋 ⏸ 🎛 `--restart`.
 
@@ -413,7 +413,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 
 🚥 👆 ✔️ <abbr title="A group of machines that are configured to be connected and work together in some way.">🌑</abbr> 🎰 ⏮️ **☁**, ☁ 🐝 📳, 🖖, ⚖️ ➕1️⃣ 🎏 🏗 ⚙️ 🛠️ 📎 📦 🔛 💗 🎰, ⤴️ 👆 🔜 🎲 💚 **🍵 🧬** **🌑 🎚** ↩️ ⚙️ **🛠️ 👨‍💼** (💖 🐁 ⏮️ 👨‍🏭) 🔠 📦.
 
-1️⃣ 📚 📎 📦 🧾 ⚙️ 💖 Kubernete 🛎 ✔️ 🛠️ 🌌 🚚 **🧬 📦** ⏪ 🔗 **📐 ⚖** 📨 📨. 🌐 **🌑 🎚**.
+1️⃣ 📚 📎 📦 🧾 ⚙️ 💖 Kubernetes 🛎 ✔️ 🛠️ 🌌 🚚 **🧬 📦** ⏪ 🔗 **📐 ⚖** 📨 📨. 🌐 **🌑 🎚**.
 
 📚 💼, 👆 🔜 🎲 💚 🏗 **☁ 🖼 ⚪️➡️ 🖌** [🔬 🔛](#dockerfile), ❎ 👆 🔗, &amp; 🏃‍♂ **👁 Uvicorn 🛠️** ↩️ 🏃‍♂ 🕳 💖 🐁 ⏮️ Uvicorn 👨‍🏭.
 
@@ -430,7 +430,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 
 ### 1️⃣ 📐 ⚙ - 💗 👨‍🏭 📦
 
-🕐❔ 👷 ⏮️ **Kubernete** ⚖️ 🎏 📎 📦 🧾 ⚙️, ⚙️ 👫 🔗 🕸 🛠️ 🔜 ✔ 👁 **📐 ⚙** 👈 👂 🔛 👑 **⛴** 📶 📻 (📨) 🎲 **💗 📦** 🏃 👆 📱.
+🕐❔ 👷 ⏮️ **Kubernetes** ⚖️ 🎏 📎 📦 🧾 ⚙️, ⚙️ 👫 🔗 🕸 🛠️ 🔜 ✔ 👁 **📐 ⚙** 👈 👂 🔛 👑 **⛴** 📶 📻 (📨) 🎲 **💗 📦** 🏃 👆 📱.
 
 🔠 👫 📦 🏃‍♂ 👆 📱 🔜 🛎 ✔️ **1️⃣ 🛠️** (✅ Uvicorn 🛠️ 🏃 👆 FastAPI 🈸). 👫 🔜 🌐 **🌓 📦**, 🏃‍♂ 🎏 👜, ✋️ 🔠 ⏮️ 🚮 👍 🛠️, 💾, ♒️. 👈 🌌 👆 🔜 ✊ 📈 **🛠️** **🎏 🐚** 💽, ⚖️ **🎏 🎰**.
 
@@ -489,7 +489,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 
 🚥 👆 🏃 **👁 🛠️ 📍 📦** 👆 🔜 ✔️ 🌅 ⚖️ 🌘 👍-🔬, ⚖, &amp; 📉 💸 💾 🍴 🔠 👈 📦 (🌅 🌘 1️⃣ 🚥 👫 🔁).
 
-&amp; ⤴️ 👆 💪 ⚒ 👈 🎏 💾 📉 &amp; 📄 👆 📳 👆 📦 🧾 ⚙️ (🖼 **Kubernete**). 👈 🌌 ⚫️ 🔜 💪 **🔁 📦** **💪 🎰** ✊ 🔘 🏧 💸 💾 💪 👫, &amp; 💸 💪 🎰 🌑.
+&amp; ⤴️ 👆 💪 ⚒ 👈 🎏 💾 📉 &amp; 📄 👆 📳 👆 📦 🧾 ⚙️ (🖼 **Kubernetes**). 👈 🌌 ⚫️ 🔜 💪 **🔁 📦** **💪 🎰** ✊ 🔘 🏧 💸 💾 💪 👫, &amp; 💸 💪 🎰 🌑.
 
 🚥 👆 🈸 **🙅**, 👉 🔜 🎲 **🚫 ⚠**, &amp; 👆 💪 🚫 💪 ✔ 🏋️ 💾 📉. ✋️ 🚥 👆 **⚙️ 📚 💾** (🖼 ⏮️ **🎰 🏫** 🏷), 👆 🔜 ✅ ❔ 🌅 💾 👆 😩 &amp; 🔆 **🔢 📦** 👈 🏃 **🔠 🎰** (&amp; 🎲 🚮 🌖 🎰 👆 🌑).
 
@@ -497,14 +497,14 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 
 ## ⏮️ 🔁 ⏭ ▶️ &amp; 📦
 
-🚥 👆 ⚙️ 📦 (✅ ☁, Kubernete), ⤴️ 📤 2️⃣ 👑 🎯 👆 💪 ⚙️.
+🚥 👆 ⚙️ 📦 (✅ ☁, Kubernetes), ⤴️ 📤 2️⃣ 👑 🎯 👆 💪 ⚙️.
 
 ### 💗 📦
 
-🚥 👆 ✔️ **💗 📦**, 🎲 🔠 1️⃣ 🏃 **👁 🛠️** (🖼, **Kubernete** 🌑), ⤴️ 👆 🔜 🎲 💚 ✔️ **🎏 📦** 🔨 👷 **⏮️ 📶** 👁 📦, 🏃 👁 🛠️, **⏭** 🏃 🔁 👨‍🏭 📦.
+🚥 👆 ✔️ **💗 📦**, 🎲 🔠 1️⃣ 🏃 **👁 🛠️** (🖼, **Kubernetes** 🌑), ⤴️ 👆 🔜 🎲 💚 ✔️ **🎏 📦** 🔨 👷 **⏮️ 📶** 👁 📦, 🏃 👁 🛠️, **⏭** 🏃 🔁 👨‍🏭 📦.
 
 !!! info
-    🚥 👆 ⚙️ Kubernete, 👉 🔜 🎲 <a href="https://kubernetes.io/docs/concepts/workloads/pods/init-containers/" class="external-link" target="_blank">🕑 📦</a>.
+    🚥 👆 ⚙️ Kubernetes, 👉 🔜 🎲 <a href="https://kubernetes.io/docs/concepts/workloads/pods/init-containers/" class="external-link" target="_blank">🕑 📦</a>.
 
 🚥 👆 ⚙️ 💼 📤 🙅‍♂ ⚠ 🏃‍♂ 👈 ⏮️ 📶 **💗 🕰 🔗** (🖼 🚥 👆 🚫 🏃 💽 🛠️, ✋️ ✅ 🚥 💽 🔜), ⤴️ 👆 💪 🚮 👫 🔠 📦 ▶️️ ⏭ ▶️ 👑 🛠️.
 
@@ -574,7 +574,7 @@ COPY ./app /app/app
 
 ### 🕐❔ ⚙️
 
-👆 🔜 🎲 **🚫** ⚙️ 👉 🛂 🧢 🖼 (⚖️ 🙆 🎏 🎏 1️⃣) 🚥 👆 ⚙️ **Kubernete** (⚖️ 🎏) &amp; 👆 ⏪ ⚒ **🧬** 🌑 🎚, ⏮️ 💗 **📦**. 📚 💼, 👆 👍 📆 **🏗 🖼 ⚪️➡️ 🖌** 🔬 🔛: [🏗 ☁ 🖼 FastAPI](#build-a-docker-image-for-fastapi).
+👆 🔜 🎲 **🚫** ⚙️ 👉 🛂 🧢 🖼 (⚖️ 🙆 🎏 🎏 1️⃣) 🚥 👆 ⚙️ **Kubernetes** (⚖️ 🎏) &amp; 👆 ⏪ ⚒ **🧬** 🌑 🎚, ⏮️ 💗 **📦**. 📚 💼, 👆 👍 📆 **🏗 🖼 ⚪️➡️ 🖌** 🔬 🔛: [🏗 ☁ 🖼 FastAPI](#build-a-docker-image-for-fastapi).
 
 👉 🖼 🔜 ⚠ ✴️ 🎁 💼 🔬 🔛 [📦 ⏮️ 💗 🛠️ &amp; 🎁 💼](#containers-with-multiple-processes-and-special-cases). 🖼, 🚥 👆 🈸 **🙅 🥃** 👈 ⚒ 🔢 🔢 🛠️ ⚓️ 🔛 💽 👷 👍, 👆 🚫 💚 😥 ⏮️ ❎ 🛠️ 🧬 🌑 🎚, &amp; 👆 🚫 🏃 🌅 🌘 1️⃣ 📦 ⏮️ 👆 📱. ⚖️ 🚥 👆 🛠️ ⏮️ **☁ ✍**, 🏃 🔛 👁 💽, ♒️.
 
@@ -585,7 +585,7 @@ COPY ./app /app/app
 🖼:
 
 * ⏮️ **☁ ✍** 👁 💽
-* ⏮️ **Kubernete** 🌑
+* ⏮️ **Kubernetes** 🌑
 * ⏮️ ☁ 🐝 📳 🌑
 * ⏮️ ➕1️⃣ 🧰 💖 🖖
 * ⏮️ ☁ 🐕‍🦺 👈 ✊ 👆 📦 🖼 &amp; 🛠️ ⚫️
@@ -682,7 +682,7 @@ CMD ["uvicorn", "app.main:app", "--proxy-headers", "--host", "0.0.0.0", "--port"
 
 ## 🌃
 
-⚙️ 📦 ⚙️ (✅ ⏮️ **☁** &amp; **Kubernete**) ⚫️ ▶️️ 📶 🎯 🍵 🌐 **🛠️ 🔧**:
+⚙️ 📦 ⚙️ (✅ ⏮️ **☁** &amp; **Kubernetes**) ⚫️ ▶️️ 📶 🎯 🍵 🌐 **🛠️ 🔧**:
 
 * 🇺🇸🔍
 * 🏃‍♂ 🔛 🕴
diff --git a/docs/em/docs/deployment/server-workers.md b/docs/em/docs/deployment/server-workers.md
index ca068d744..b7e58c4f4 100644
--- a/docs/em/docs/deployment/server-workers.md
+++ b/docs/em/docs/deployment/server-workers.md
@@ -18,9 +18,9 @@
 📥 👤 🔜 🎦 👆 ❔ ⚙️ <a href="https://gunicorn.org/" class="external-link" target="_blank">**🐁**</a> ⏮️ **Uvicorn 👨‍🏭 🛠️**.
 
 !!! info
-    🚥 👆 ⚙️ 📦, 🖼 ⏮️ ☁ ⚖️ Kubernete, 👤 🔜 💬 👆 🌅 🔃 👈 ⏭ 📃: [FastAPI 📦 - ☁](./docker.md){.internal-link target=_blank}.
+    🚥 👆 ⚙️ 📦, 🖼 ⏮️ ☁ ⚖️ Kubernetes, 👤 🔜 💬 👆 🌅 🔃 👈 ⏭ 📃: [FastAPI 📦 - ☁](./docker.md){.internal-link target=_blank}.
 
-    🎯, 🕐❔ 🏃 🔛 **Kubernete** 👆 🔜 🎲 **🚫** 💚 ⚙️ 🐁 &amp; ↩️ 🏃 **👁 Uvicorn 🛠️ 📍 📦**, ✋️ 👤 🔜 💬 👆 🔃 ⚫️ ⏪ 👈 📃.
+    🎯, 🕐❔ 🏃 🔛 **Kubernetes** 👆 🔜 🎲 **🚫** 💚 ⚙️ 🐁 &amp; ↩️ 🏃 **👁 Uvicorn 🛠️ 📍 📦**, ✋️ 👤 🔜 💬 👆 🔃 ⚫️ ⏪ 👈 📃.
 
 ## 🐁 ⏮️ Uvicorn 👨‍🏭
 
@@ -167,7 +167,7 @@ $ uvicorn main:app --host 0.0.0.0 --port 8080 --workers 4
 
 👤 🔜 🎦 👆 **🛂 ☁ 🖼** 👈 🔌 **🐁 ⏮️ Uvicorn 👨‍🏭** &amp; 🔢 📳 👈 💪 ⚠ 🙅 💼.
 
-📤 👤 🔜 🎦 👆 ❔ **🏗 👆 👍 🖼 ⚪️➡️ 🖌** 🏃 👁 Uvicorn 🛠️ (🍵 🐁). ⚫️ 🙅 🛠️ &amp; 🎲 ⚫️❔ 👆 🔜 💚 🕐❔ ⚙️ 📎 📦 🧾 ⚙️ 💖 **Kubernete**.
+📤 👤 🔜 🎦 👆 ❔ **🏗 👆 👍 🖼 ⚪️➡️ 🖌** 🏃 👁 Uvicorn 🛠️ (🍵 🐁). ⚫️ 🙅 🛠️ &amp; 🎲 ⚫️❔ 👆 🔜 💚 🕐❔ ⚙️ 📎 📦 🧾 ⚙️ 💖 **Kubernetes**.
 
 ## 🌃
 
@@ -175,4 +175,4 @@ $ uvicorn main:app --host 0.0.0.0 --port 8080 --workers 4
 
 👆 💪 ⚙️ 👉 🧰 &amp; 💭 🚥 👆 ⚒ 🆙 **👆 👍 🛠️ ⚙️** ⏪ ✊ 💅 🎏 🛠️ 🔧 👆.
 
-✅ 👅 ⏭ 📃 💡 🔃 **FastAPI** ⏮️ 📦 (✅ ☁ &amp; Kubernete). 👆 🔜 👀 👈 👈 🧰 ✔️ 🙅 🌌 ❎ 🎏 **🛠️ 🔧** 👍. 👶
+✅ 👅 ⏭ 📃 💡 🔃 **FastAPI** ⏮️ 📦 (✅ ☁ &amp; Kubernetes). 👆 🔜 👀 👈 👈 🧰 ✔️ 🙅 🌌 ❎ 🎏 **🛠️ 🔧** 👍. 👶
diff --git a/docs/em/docs/project-generation.md b/docs/em/docs/project-generation.md
index 5fd667ad1..ae959e1d5 100644
--- a/docs/em/docs/project-generation.md
+++ b/docs/em/docs/project-generation.md
@@ -79,6 +79,6 @@
 * **🌈** 🕜 🏷 🛠️.
 * **☁ 🧠 🔎** 📨 📁 🏗.
 * **🏭 🔜** 🐍 🕸 💽 ⚙️ Uvicorn &amp; 🐁.
-* **☁ 👩‍💻** Kubernete (🦲) 🆑/💿 🛠️ 🏗.
+* **☁ 👩‍💻** Kubernetes (🦲) 🆑/💿 🛠️ 🏗.
 * **🤸‍♂** 💪 ⚒ 1️⃣ 🌈 🏗 🇪🇸 ⏮️ 🏗 🖥.
 * **💪 🏧** 🎏 🏷 🛠️ (Pytorch, 🇸🇲), 🚫 🌈.
diff --git a/docs/en/docs/how-to/sql-databases-peewee.md b/docs/en/docs/how-to/sql-databases-peewee.md
index bf2f2e714..b0ab7c633 100644
--- a/docs/en/docs/how-to/sql-databases-peewee.md
+++ b/docs/en/docs/how-to/sql-databases-peewee.md
@@ -363,7 +363,7 @@ It will have the database connection open at the beginning and will just wait so
 
 This will easily let you test that your app with Peewee and FastAPI is behaving correctly with all the stuff about threads.
 
-If you want to check how Peewee would break your app if used without modification, go the the `sql_app/database.py` file and comment the line:
+If you want to check how Peewee would break your app if used without modification, go the `sql_app/database.py` file and comment the line:
 
 ```Python
 # db._state = PeeweeConnectionState()
diff --git a/docs_src/openapi_webhooks/tutorial001.py b/docs_src/openapi_webhooks/tutorial001.py
index 5016f5b00..55822bb48 100644
--- a/docs_src/openapi_webhooks/tutorial001.py
+++ b/docs_src/openapi_webhooks/tutorial001.py
@@ -8,7 +8,7 @@ app = FastAPI()
 
 class Subscription(BaseModel):
     username: str
-    montly_fee: float
+    monthly_fee: float
     start_date: datetime
 
 
diff --git a/fastapi/utils.py b/fastapi/utils.py
index 267d64ce8..53b47a160 100644
--- a/fastapi/utils.py
+++ b/fastapi/utils.py
@@ -117,7 +117,7 @@ def create_cloned_field(
     if PYDANTIC_V2:
         return field
     # cloned_types caches already cloned types to support recursive models and improve
-    # performance by avoiding unecessary cloning
+    # performance by avoiding unnecessary cloning
     if cloned_types is None:
         cloned_types = _CLONED_TYPES_CACHE
 
diff --git a/tests/test_tutorial/test_openapi_webhooks/test_tutorial001.py b/tests/test_tutorial/test_openapi_webhooks/test_tutorial001.py
index 9111fdb2f..dc67ec401 100644
--- a/tests/test_tutorial/test_openapi_webhooks/test_tutorial001.py
+++ b/tests/test_tutorial/test_openapi_webhooks/test_tutorial001.py
@@ -85,7 +85,7 @@ def test_openapi_schema():
                 "Subscription": {
                     "properties": {
                         "username": {"type": "string", "title": "Username"},
-                        "montly_fee": {"type": "number", "title": "Montly Fee"},
+                        "monthly_fee": {"type": "number", "title": "Monthly Fee"},
                         "start_date": {
                             "type": "string",
                             "format": "date-time",
@@ -93,7 +93,7 @@ def test_openapi_schema():
                         },
                     },
                     "type": "object",
-                    "required": ["username", "montly_fee", "start_date"],
+                    "required": ["username", "monthly_fee", "start_date"],
                     "title": "Subscription",
                 },
                 "ValidationError": {
diff --git a/tests/test_webhooks_security.py b/tests/test_webhooks_security.py
index a1c7b18fb..21a694cb5 100644
--- a/tests/test_webhooks_security.py
+++ b/tests/test_webhooks_security.py
@@ -13,7 +13,7 @@ bearer_scheme = HTTPBearer()
 
 class Subscription(BaseModel):
     username: str
-    montly_fee: float
+    monthly_fee: float
     start_date: datetime
 
 
@@ -93,7 +93,7 @@ def test_openapi_schema():
                 "Subscription": {
                     "properties": {
                         "username": {"type": "string", "title": "Username"},
-                        "montly_fee": {"type": "number", "title": "Montly Fee"},
+                        "monthly_fee": {"type": "number", "title": "Monthly Fee"},
                         "start_date": {
                             "type": "string",
                             "format": "date-time",
@@ -101,7 +101,7 @@ def test_openapi_schema():
                         },
                     },
                     "type": "object",
-                    "required": ["username", "montly_fee", "start_date"],
+                    "required": ["username", "monthly_fee", "start_date"],
                     "title": "Subscription",
                 },
                 "ValidationError": {

From eb017270fca06383e7d44f45a6850d58c315760f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 20 Oct 2023 09:00:53 +0000
Subject: [PATCH 237/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d75f9a08c..9c7d78cb8 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* ✏️ Fix typo in `docs/en/docs/reference/dependencies.md`. PR [#10465](https://github.com/tiangolo/fastapi/pull/10465) by [@suravshresth](https://github.com/suravshresth).
 * ✏️ Fix typos and rewordings in `docs/en/docs/tutorial/body-nested-models.md`. PR [#10468](https://github.com/tiangolo/fastapi/pull/10468) by [@yogabonito](https://github.com/yogabonito).
 * 📝 Update docs, remove references to removed `pydantic.Required` in `docs/en/docs/tutorial/query-params-str-validations.md`. PR [#10469](https://github.com/tiangolo/fastapi/pull/10469) by [@yogabonito](https://github.com/yogabonito).
 * ✏️ Fix typo in `docs/en/docs/reference/index.md`. PR [#10467](https://github.com/tiangolo/fastapi/pull/10467) by [@tarsil](https://github.com/tarsil).

From f41eb5e0051c12d3508841a5d7c42b838fb63ad6 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 20 Oct 2023 09:03:34 +0000
Subject: [PATCH 238/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 9c7d78cb8..fd1aa90cb 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* ✏️ Fix typos in emoji docs and in some source examples. PR [#10438](https://github.com/tiangolo/fastapi/pull/10438) by [@afuetterer](https://github.com/afuetterer).
 * ✏️ Fix typo in `docs/en/docs/reference/dependencies.md`. PR [#10465](https://github.com/tiangolo/fastapi/pull/10465) by [@suravshresth](https://github.com/suravshresth).
 * ✏️ Fix typos and rewordings in `docs/en/docs/tutorial/body-nested-models.md`. PR [#10468](https://github.com/tiangolo/fastapi/pull/10468) by [@yogabonito](https://github.com/yogabonito).
 * 📝 Update docs, remove references to removed `pydantic.Required` in `docs/en/docs/tutorial/query-params-str-validations.md`. PR [#10469](https://github.com/tiangolo/fastapi/pull/10469) by [@yogabonito](https://github.com/yogabonito).

From 89e03bad1644c7a0b63960c4299ca79ebb1ae31c Mon Sep 17 00:00:00 2001
From: Giulio Davide Carparelli <giulio.davide.97@gmail.com>
Date: Fri, 20 Oct 2023 11:08:42 +0200
Subject: [PATCH 239/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20example=20valid?=
 =?UTF-8?q?ation=20error=20from=20Pydantic=20v1=20to=20match=20Pydantic=20?=
 =?UTF-8?q?v2=20in=20`docs/en/docs/tutorial/path-params.md`=20(#10043)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/tutorial/path-params.md  | 22 ++++++++++++----------
 docs/en/docs/tutorial/query-params.md | 22 ++++++++++++----------
 2 files changed, 24 insertions(+), 20 deletions(-)

diff --git a/docs/en/docs/tutorial/path-params.md b/docs/en/docs/tutorial/path-params.md
index 6594a7a8b..847b56334 100644
--- a/docs/en/docs/tutorial/path-params.md
+++ b/docs/en/docs/tutorial/path-params.md
@@ -46,16 +46,18 @@ But if you go to the browser at <a href="http://127.0.0.1:8000/items/foo" class=
 
 ```JSON
 {
-    "detail": [
-        {
-            "loc": [
-                "path",
-                "item_id"
-            ],
-            "msg": "value is not a valid integer",
-            "type": "type_error.integer"
-        }
-    ]
+  "detail": [
+    {
+      "type": "int_parsing",
+      "loc": [
+        "path",
+        "item_id"
+      ],
+      "msg": "Input should be a valid integer, unable to parse string as an integer",
+      "input": "foo",
+      "url": "https://errors.pydantic.dev/2.1/v/int_parsing"
+    }
+  ]
 }
 ```
 
diff --git a/docs/en/docs/tutorial/query-params.md b/docs/en/docs/tutorial/query-params.md
index 988ff4bf1..bc3b11948 100644
--- a/docs/en/docs/tutorial/query-params.md
+++ b/docs/en/docs/tutorial/query-params.md
@@ -173,16 +173,18 @@ http://127.0.0.1:8000/items/foo-item
 
 ```JSON
 {
-    "detail": [
-        {
-            "loc": [
-                "query",
-                "needy"
-            ],
-            "msg": "field required",
-            "type": "value_error.missing"
-        }
-    ]
+  "detail": [
+    {
+      "type": "missing",
+      "loc": [
+        "query",
+        "needy"
+      ],
+      "msg": "Field required",
+      "input": null,
+      "url": "https://errors.pydantic.dev/2.1/v/missing"
+    }
+  ]
 }
 ```
 

From 07a9b240e9a8acad3f9ab64fb921daf275aeeb85 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 20 Oct 2023 09:13:35 +0000
Subject: [PATCH 240/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index fd1aa90cb..df004dd8c 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* 📝 Update example validation error from Pydantic v1 to match Pydantic v2 in `docs/en/docs/tutorial/path-params.md`. PR [#10043](https://github.com/tiangolo/fastapi/pull/10043) by [@giuliowaitforitdavide](https://github.com/giuliowaitforitdavide).
 * ✏️ Fix typos in emoji docs and in some source examples. PR [#10438](https://github.com/tiangolo/fastapi/pull/10438) by [@afuetterer](https://github.com/afuetterer).
 * ✏️ Fix typo in `docs/en/docs/reference/dependencies.md`. PR [#10465](https://github.com/tiangolo/fastapi/pull/10465) by [@suravshresth](https://github.com/suravshresth).
 * ✏️ Fix typos and rewordings in `docs/en/docs/tutorial/body-nested-models.md`. PR [#10468](https://github.com/tiangolo/fastapi/pull/10468) by [@yogabonito](https://github.com/yogabonito).

From 9b3e166b4343941790302dd8fe943cab50ffc4c0 Mon Sep 17 00:00:00 2001
From: worldworm <13227454+worldworm@users.noreply.github.com>
Date: Fri, 20 Oct 2023 11:19:31 +0200
Subject: [PATCH 241/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20link=20to=20?=
 =?UTF-8?q?SPDX=20license=20identifier=20in=20`docs/en/docs/tutorial/metad?=
 =?UTF-8?q?ata.md`=20(#10433)?=
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/tutorial/metadata.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/docs/tutorial/metadata.md b/docs/en/docs/tutorial/metadata.md
index e75b4a0b9..504204e98 100644
--- a/docs/en/docs/tutorial/metadata.md
+++ b/docs/en/docs/tutorial/metadata.md
@@ -14,7 +14,7 @@ You can set the following fields that are used in the OpenAPI specification and
 | `version` | `string` | The version of the API. This is the version of your own application, not of OpenAPI. For example `2.5.0`. |
 | `terms_of_service` | `str` | A URL to the Terms of Service for the API. If provided, this has to be a URL. |
 | `contact` | `dict` | The contact information for the exposed API. It can contain several fields. <details><summary><code>contact</code> fields</summary><table><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td><code>name</code></td><td><code>str</code></td><td>The identifying name of the contact person/organization.</td></tr><tr><td><code>url</code></td><td><code>str</code></td><td>The URL pointing to the contact information. MUST be in the format of a URL.</td></tr><tr><td><code>email</code></td><td><code>str</code></td><td>The email address of the contact person/organization. MUST be in the format of an email address.</td></tr></tbody></table></details> |
-| `license_info` | `dict` | The license information for the exposed API. It can contain several fields. <details><summary><code>license_info</code> fields</summary><table><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td><code>name</code></td><td><code>str</code></td><td><strong>REQUIRED</strong> (if a <code>license_info</code> is set). The license name used for the API.</td></tr><tr><td><code>identifier</code></td><td><code>str</code></td><td>An <a href="https://spdx.dev/spdx-specification-21-web-version/#h.jxpfx0ykyb60" class="external-link" target="_blank">SPDX</a> license expression for the API. The <code>identifier</code> field is mutually exclusive of the <code>url</code> field. <small>Available since OpenAPI 3.1.0, FastAPI 0.99.0.</small></td></tr><tr><td><code>url</code></td><td><code>str</code></td><td>A URL to the license used for the API. MUST be in the format of a URL.</td></tr></tbody></table></details> |
+| `license_info` | `dict` | The license information for the exposed API. It can contain several fields. <details><summary><code>license_info</code> fields</summary><table><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td><code>name</code></td><td><code>str</code></td><td><strong>REQUIRED</strong> (if a <code>license_info</code> is set). The license name used for the API.</td></tr><tr><td><code>identifier</code></td><td><code>str</code></td><td>An <a href="https://spdx.org/licenses/" class="external-link" target="_blank">SPDX</a> license expression for the API. The <code>identifier</code> field is mutually exclusive of the <code>url</code> field. <small>Available since OpenAPI 3.1.0, FastAPI 0.99.0.</small></td></tr><tr><td><code>url</code></td><td><code>str</code></td><td>A URL to the license used for the API. MUST be in the format of a URL.</td></tr></tbody></table></details> |
 
 You can set them as follows:
 

From ab65486e757400b84d0116367ba3db7dcac72fd3 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 20 Oct 2023 09:21:13 +0000
Subject: [PATCH 242/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index df004dd8c..414afae12 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* ✏️ Fix link to SPDX license identifier in `docs/en/docs/tutorial/metadata.md`. PR [#10433](https://github.com/tiangolo/fastapi/pull/10433) by [@worldworm](https://github.com/worldworm).
 * 📝 Update example validation error from Pydantic v1 to match Pydantic v2 in `docs/en/docs/tutorial/path-params.md`. PR [#10043](https://github.com/tiangolo/fastapi/pull/10043) by [@giuliowaitforitdavide](https://github.com/giuliowaitforitdavide).
 * ✏️ Fix typos in emoji docs and in some source examples. PR [#10438](https://github.com/tiangolo/fastapi/pull/10438) by [@afuetterer](https://github.com/afuetterer).
 * ✏️ Fix typo in `docs/en/docs/reference/dependencies.md`. PR [#10465](https://github.com/tiangolo/fastapi/pull/10465) by [@suravshresth](https://github.com/suravshresth).

From 9bfbacfe98c877ba661e0e40c8dcac7571de819a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 21 Oct 2023 11:10:18 +0400
Subject: [PATCH 243/317] =?UTF-8?q?=F0=9F=90=9B=20Fix=20overriding=20MKDoc?=
 =?UTF-8?q?s=20theme=20lang=20in=20hook=20(#10490)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 scripts/mkdocs_hooks.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scripts/mkdocs_hooks.py b/scripts/mkdocs_hooks.py
index b12487b50..2b6a05642 100644
--- a/scripts/mkdocs_hooks.py
+++ b/scripts/mkdocs_hooks.py
@@ -24,7 +24,7 @@ def get_missing_translation_content(docs_dir: str) -> str:
 @lru_cache()
 def get_mkdocs_material_langs() -> List[str]:
     material_path = Path(material.__file__).parent
-    material_langs_path = material_path / "partials" / "languages"
+    material_langs_path = material_path / "templates" / "partials" / "languages"
     langs = [file.stem for file in material_langs_path.glob("*.html")]
     return langs
 

From 808e3bb9d56ac85e28e6f5e982f06209ad059436 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 21 Oct 2023 07:11:00 +0000
Subject: [PATCH 244/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 414afae12..163e708b8 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* 🐛 Fix overriding MKDocs theme lang in hook. PR [#10490](https://github.com/tiangolo/fastapi/pull/10490) by [@tiangolo](https://github.com/tiangolo).
 * ✏️ Fix link to SPDX license identifier in `docs/en/docs/tutorial/metadata.md`. PR [#10433](https://github.com/tiangolo/fastapi/pull/10433) by [@worldworm](https://github.com/worldworm).
 * 📝 Update example validation error from Pydantic v1 to match Pydantic v2 in `docs/en/docs/tutorial/path-params.md`. PR [#10043](https://github.com/tiangolo/fastapi/pull/10043) by [@giuliowaitforitdavide](https://github.com/giuliowaitforitdavide).
 * ✏️ Fix typos in emoji docs and in some source examples. PR [#10438](https://github.com/tiangolo/fastapi/pull/10438) by [@afuetterer](https://github.com/afuetterer).

From e8bd645fa9ee0a8ed3ba4df9cd8c743332a5d2ad Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sun, 22 Oct 2023 11:35:13 +0400
Subject: [PATCH 245/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20data=20structur?=
 =?UTF-8?q?e=20and=20render=20for=20external-links=20(#10495)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 📝 Update data structure and render for external-links

* 📝 Update translations for external links
---
 docs/em/docs/external-links.md  | 68 +++-----------------------------
 docs/en/data/external_links.yml | 22 +++++------
 docs/en/docs/external-links.md  | 70 +++------------------------------
 docs/fr/docs/external-links.md  | 61 +++-------------------------
 docs/ja/docs/external-links.md  | 61 +++-------------------------
 docs/pt/docs/external-links.md  | 61 +++-------------------------
 docs/ru/docs/external-links.md  | 61 +++-------------------------
 7 files changed, 47 insertions(+), 357 deletions(-)

diff --git a/docs/em/docs/external-links.md b/docs/em/docs/external-links.md
index 4440b1f12..5ba668bfa 100644
--- a/docs/em/docs/external-links.md
+++ b/docs/em/docs/external-links.md
@@ -11,77 +11,21 @@
 
 ## 📄
 
-### 🇪🇸
+{% for section_name, section_content in external_links.items() %}
 
-{% if external_links %}
-{% for article in external_links.articles.english %}
+## {{ section_name }}
 
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-### 🇯🇵
-
-{% if external_links %}
-{% for article in external_links.articles.japanese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-### 🇻🇳
-
-{% if external_links %}
-{% for article in external_links.articles.vietnamese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-### 🇷🇺
-
-{% if external_links %}
-{% for article in external_links.articles.russian %}
+{% for lang_name, lang_content in section_content.items() %}
 
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
+### {{ lang_name }}
 
-### 🇩🇪
+{% for item in lang_content %}
 
-{% if external_links %}
-{% for article in external_links.articles.german %}
+* <a href="{{ item.link }}" class="external-link" target="_blank">{{ item.title }}</a> by <a href="{{ item.author_link }}" class="external-link" target="_blank">{{ item.author }}</a>.
 
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### 🇹🇼
-
-{% if external_links %}
-{% for article in external_links.articles.taiwanese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-## 📻
-
-{% if external_links %}
-{% for article in external_links.podcasts.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## 💬
-
-{% if external_links %}
-{% for article in external_links.talks.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
 
 ## 🏗
 
diff --git a/docs/en/data/external_links.yml b/docs/en/data/external_links.yml
index a7f766d16..726e7eae7 100644
--- a/docs/en/data/external_links.yml
+++ b/docs/en/data/external_links.yml
@@ -1,5 +1,5 @@
-articles:
-  english:
+Articles:
+  English:
   - author: Adejumo Ridwan Suleiman
     author_link: https://www.linkedin.com/in/adejumoridwan/
     link: https://medium.com/python-in-plain-english/build-an-sms-spam-classifier-serverless-database-with-faunadb-and-fastapi-23dbb275bc5b
@@ -236,7 +236,7 @@ articles:
     author_link: https://medium.com/@krishnardt365
     link: https://medium.com/@krishnardt365/fastapi-docker-and-postgres-91943e71be92
     title: Fastapi, Docker(Docker compose) and Postgres
-  german:
+  German:
   - author: Marcel Sander (actidoo)
     author_link: https://www.actidoo.com
     link: https://www.actidoo.com/de/blog/python-fastapi-domain-driven-design
@@ -249,7 +249,7 @@ articles:
     author_link: https://hellocoding.de/autor/felix-schuermeyer/
     link: https://hellocoding.de/blog/coding-language/python/fastapi
     title: REST-API Programmieren mittels Python und dem FastAPI Modul
-  japanese:
+  Japanese:
   - author: '@bee2'
     author_link: https://qiita.com/bee2
     link: https://qiita.com/bee2/items/75d9c0d7ba20e7a4a0e9
@@ -298,7 +298,7 @@ articles:
     author_link: https://qiita.com/mtitg
     link: https://qiita.com/mtitg/items/47770e9a562dd150631d
     title: FastAPI｜DB接続してCRUDするPython製APIサーバーを構築
-  russian:
+  Russian:
   - author: Troy Köhler
     author_link: https://www.linkedin.com/in/trkohler/
     link: https://trkohler.com/fast-api-introduction-to-framework
@@ -311,18 +311,18 @@ articles:
     author_link: https://habr.com/ru/users/57uff3r/
     link: https://habr.com/ru/post/454440/
     title: 'Мелкая питонячая радость #2: Starlette - Солидная примочка – FastAPI'
-  vietnamese:
+  Vietnamese:
   - author: Nguyễn Nhân
     author_link: https://fullstackstation.com/author/figonking/
     link: https://fullstackstation.com/fastapi-trien-khai-bang-docker/
     title: 'FASTAPI: TRIỂN KHAI BẰNG DOCKER'
-  taiwanese:
+  Taiwanese:
   - author: Leon
     author_link: http://editor.leonh.space/
     link: https://editor.leonh.space/2022/tortoise/
     title: 'Tortoise ORM / FastAPI 整合快速筆記'
-podcasts:
-  english:
+Podcasts:
+  English:
   - author: Podcast.`__init__`
     author_link: https://www.pythonpodcast.com/
     link: https://www.pythonpodcast.com/fastapi-web-application-framework-episode-259/
@@ -331,8 +331,8 @@ podcasts:
     author_link: https://pythonbytes.fm/
     link: https://pythonbytes.fm/episodes/show/123/time-to-right-the-py-wrongs?time_in_sec=855
     title: FastAPI on PythonBytes
-talks:
-  english:
+Talks:
+  English:
   - author: Sebastián Ramírez (tiangolo)
     author_link: https://twitter.com/tiangolo
     link: https://www.youtube.com/watch?v=PnpTY1f4k2U
diff --git a/docs/en/docs/external-links.md b/docs/en/docs/external-links.md
index 0c91470bc..b89021ee2 100644
--- a/docs/en/docs/external-links.md
+++ b/docs/en/docs/external-links.md
@@ -9,79 +9,21 @@ Here's an incomplete list of some of them.
 !!! tip
     If you have an article, project, tool, or anything related to **FastAPI** that is not yet listed here, create a <a href="https://github.com/tiangolo/fastapi/edit/master/docs/en/data/external_links.yml" class="external-link" target="_blank">Pull Request adding it</a>.
 
-## Articles
+{% for section_name, section_content in external_links.items() %}
 
-### English
+## {{ section_name }}
 
-{% if external_links %}
-{% for article in external_links.articles.english %}
+{% for lang_name, lang_content in section_content.items() %}
 
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-### Japanese
-
-{% if external_links %}
-{% for article in external_links.articles.japanese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-### Vietnamese
+### {{ lang_name }}
 
-{% if external_links %}
-{% for article in external_links.articles.vietnamese %}
+{% for item in lang_content %}
 
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-### Russian
-
-{% if external_links %}
-{% for article in external_links.articles.russian %}
+* <a href="{{ item.link }}" class="external-link" target="_blank">{{ item.title }}</a> by <a href="{{ item.author_link }}" class="external-link" target="_blank">{{ item.author }}</a>.
 
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### German
-
-{% if external_links %}
-{% for article in external_links.articles.german %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### Taiwanese
-
-{% if external_links %}
-{% for article in external_links.articles.taiwanese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## Podcasts
-
-{% if external_links %}
-{% for article in external_links.podcasts.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## Talks
-
-{% if external_links %}
-{% for article in external_links.talks.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
 
 ## Projects
 
diff --git a/docs/fr/docs/external-links.md b/docs/fr/docs/external-links.md
index 002e6d2b2..37b8c5b13 100644
--- a/docs/fr/docs/external-links.md
+++ b/docs/fr/docs/external-links.md
@@ -9,70 +9,21 @@ Voici une liste incomplète de certains d'entre eux.
 !!! tip "Astuce"
     Si vous avez un article, projet, outil, ou quoi que ce soit lié à **FastAPI** qui n'est actuellement pas listé ici, créez une <a href="https://github.com/tiangolo/fastapi/edit/master/docs/en/data/external_links.yml" class="external-link" target="_blank">Pull Request l'ajoutant</a>.
 
-## Articles
+{% for section_name, section_content in external_links.items() %}
 
-### Anglais
+## {{ section_name }}
 
-{% if external_links %}
-{% for article in external_links.articles.english %}
+{% for lang_name, lang_content in section_content.items() %}
 
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> par <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-### Japonais
-
-{% if external_links %}
-{% for article in external_links.articles.japanese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> par <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
+### {{ lang_name }}
 
-### Vietnamien
+{% for item in lang_content %}
 
-{% if external_links %}
-{% for article in external_links.articles.vietnamese %}
+* <a href="{{ item.link }}" class="external-link" target="_blank">{{ item.title }}</a> by <a href="{{ item.author_link }}" class="external-link" target="_blank">{{ item.author }}</a>.
 
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> par <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### Russe
-
-{% if external_links %}
-{% for article in external_links.articles.russian %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> par <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### Allemand
-
-{% if external_links %}
-{% for article in external_links.articles.german %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> par <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## Podcasts
-
-{% if external_links %}
-{% for article in external_links.podcasts.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> par <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## Conférences
-
-{% if external_links %}
-{% for article in external_links.talks.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> par <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
 
 ## Projets
 
diff --git a/docs/ja/docs/external-links.md b/docs/ja/docs/external-links.md
index 6703f5fc2..aca5d5b34 100644
--- a/docs/ja/docs/external-links.md
+++ b/docs/ja/docs/external-links.md
@@ -9,70 +9,21 @@
 !!! tip "豆知識"
     ここにまだ載っていない**FastAPI**に関連する記事、プロジェクト、ツールなどがある場合は、 <a href="https://github.com/tiangolo/fastapi/edit/master/docs/en/data/external_links.yml" class="external-link" target="_blank">プルリクエストして下さい</a>。
 
-## 記事
+{% for section_name, section_content in external_links.items() %}
 
-### 英語
+## {{ section_name }}
 
-{% if external_links %}
-{% for article in external_links.articles.english %}
+{% for lang_name, lang_content in section_content.items() %}
 
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-### 日本語
-
-{% if external_links %}
-{% for article in external_links.articles.japanese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
+### {{ lang_name }}
 
-### ベトナム語
+{% for item in lang_content %}
 
-{% if external_links %}
-{% for article in external_links.articles.vietnamese %}
+* <a href="{{ item.link }}" class="external-link" target="_blank">{{ item.title }}</a> by <a href="{{ item.author_link }}" class="external-link" target="_blank">{{ item.author }}</a>.
 
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### ロシア語
-
-{% if external_links %}
-{% for article in external_links.articles.russian %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### ドイツ語
-
-{% if external_links %}
-{% for article in external_links.articles.german %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## ポッドキャスト
-
-{% if external_links %}
-{% for article in external_links.podcasts.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## トーク
-
-{% if external_links %}
-{% for article in external_links.talks.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
 
 ## プロジェクト
 
diff --git a/docs/pt/docs/external-links.md b/docs/pt/docs/external-links.md
index 6ec6c3a27..77ec32351 100644
--- a/docs/pt/docs/external-links.md
+++ b/docs/pt/docs/external-links.md
@@ -9,70 +9,21 @@ Aqui tem uma lista, incompleta, de algumas delas.
 !!! tip "Dica"
     Se você tem um artigo, projeto, ferramenta ou qualquer coisa relacionada ao **FastAPI** que ainda não está listada aqui, crie um <a href="https://github.com/tiangolo/fastapi/edit/master/docs/external-links.md" class="external-link" target="_blank">_Pull Request_ adicionando ele</a>.
 
-## Artigos
+{% for section_name, section_content in external_links.items() %}
 
-### Inglês
+## {{ section_name }}
 
-{% if external_links %}
-{% for article in external_links.articles.english %}
+{% for lang_name, lang_content in section_content.items() %}
 
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-### Japonês
-
-{% if external_links %}
-{% for article in external_links.articles.japanese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
+### {{ lang_name }}
 
-### Vietnamita
+{% for item in lang_content %}
 
-{% if external_links %}
-{% for article in external_links.articles.vietnamese %}
+* <a href="{{ item.link }}" class="external-link" target="_blank">{{ item.title }}</a> by <a href="{{ item.author_link }}" class="external-link" target="_blank">{{ item.author }}</a>.
 
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### Russo
-
-{% if external_links %}
-{% for article in external_links.articles.russian %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### Alemão
-
-{% if external_links %}
-{% for article in external_links.articles.german %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## Podcasts
-
-{% if external_links %}
-{% for article in external_links.podcasts.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## Palestras
-
-{% if external_links %}
-{% for article in external_links.talks.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
 
 ## Projetos
 
diff --git a/docs/ru/docs/external-links.md b/docs/ru/docs/external-links.md
index 4daf65898..2448ef82e 100644
--- a/docs/ru/docs/external-links.md
+++ b/docs/ru/docs/external-links.md
@@ -9,70 +9,21 @@
 !!! tip
     Если у вас есть статья, проект, инструмент или что-либо, связанное с **FastAPI**, что еще не перечислено здесь, создайте <a href="https://github.com/tiangolo/fastapi/edit/master/docs/en/data/external_links.yml" class="external-link" target="_blank">Pull Request</a>.
 
-## Статьи
+{% for section_name, section_content in external_links.items() %}
 
-### На английском
+## {{ section_name }}
 
-{% if external_links %}
-{% for article in external_links.articles.english %}
+{% for lang_name, lang_content in section_content.items() %}
 
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-### На японском
-
-{% if external_links %}
-{% for article in external_links.articles.japanese %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
+### {{ lang_name }}
 
-### На вьетнамском
+{% for item in lang_content %}
 
-{% if external_links %}
-{% for article in external_links.articles.vietnamese %}
+* <a href="{{ item.link }}" class="external-link" target="_blank">{{ item.title }}</a> by <a href="{{ item.author_link }}" class="external-link" target="_blank">{{ item.author }}</a>.
 
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### На русском
-
-{% if external_links %}
-{% for article in external_links.articles.russian %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
-
-### На немецком
-
-{% if external_links %}
-{% for article in external_links.articles.german %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## Подкасты
-
-{% if external_links %}
-{% for article in external_links.podcasts.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
-{% endfor %}
-{% endif %}
-
-## Talks
-
-{% if external_links %}
-{% for article in external_links.talks.english %}
-
-* <a href="{{ article.link }}" class="external-link" target="_blank">{{ article.title }}</a> by <a href="{{ article.author_link }}" class="external-link" target="_blank">{{ article.author }}</a>.
 {% endfor %}
-{% endif %}
 
 ## Проекты
 

From f9b53ae77834eb803f8043493bd337b8a448ae5a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 22 Oct 2023 07:35:50 +0000
Subject: [PATCH 246/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 163e708b8..60675c757 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* 📝 Update data structure and render for external-links. PR [#10495](https://github.com/tiangolo/fastapi/pull/10495) by [@tiangolo](https://github.com/tiangolo).
 * 🐛 Fix overriding MKDocs theme lang in hook. PR [#10490](https://github.com/tiangolo/fastapi/pull/10490) by [@tiangolo](https://github.com/tiangolo).
 * ✏️ Fix link to SPDX license identifier in `docs/en/docs/tutorial/metadata.md`. PR [#10433](https://github.com/tiangolo/fastapi/pull/10433) by [@worldworm](https://github.com/worldworm).
 * 📝 Update example validation error from Pydantic v1 to match Pydantic v2 in `docs/en/docs/tutorial/path-params.md`. PR [#10043](https://github.com/tiangolo/fastapi/pull/10043) by [@giuliowaitforitdavide](https://github.com/giuliowaitforitdavide).

From e0a5edaaa3796bca703ab7f914a69fed98cffcfc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sun, 22 Oct 2023 14:03:38 +0400
Subject: [PATCH 247/317] =?UTF-8?q?=F0=9F=94=A7=20Add=20`CITATION.cff`=20f?=
 =?UTF-8?q?ile=20for=20academic=20citations=20(#10496)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CITATION.cff | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 CITATION.cff

diff --git a/CITATION.cff b/CITATION.cff
new file mode 100644
index 000000000..9028248b1
--- /dev/null
+++ b/CITATION.cff
@@ -0,0 +1,24 @@
+# This CITATION.cff file was generated with cffinit.
+# Visit https://bit.ly/cffinit to generate yours today!
+
+cff-version: 1.2.0
+title: FastAPI
+message: >-
+  If you use this software, please cite it using the
+  metadata from this file.
+type: software
+authors:
+  - given-names: Sebastián
+    family-names: Ramírez
+    email: tiangolo@gmail.com
+identifiers:
+repository-code: 'https://github.com/tiangolo/fastapi'
+url: 'https://fastapi.tiangolo.com'
+abstract: >-
+  FastAPI framework, high performance, easy to learn, fast to code,
+  ready for production
+keywords:
+  - fastapi
+  - pydantic
+  - starlette
+license: MIT

From 4ef7a40eae98c0d346fbfa2472f9b52b1cbf9b8f Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 22 Oct 2023 10:04:16 +0000
Subject: [PATCH 248/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 60675c757..74b0b1b27 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* 🔧 Add `CITATION.cff` file for academic citations. PR [#10496](https://github.com/tiangolo/fastapi/pull/10496) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Update data structure and render for external-links. PR [#10495](https://github.com/tiangolo/fastapi/pull/10495) by [@tiangolo](https://github.com/tiangolo).
 * 🐛 Fix overriding MKDocs theme lang in hook. PR [#10490](https://github.com/tiangolo/fastapi/pull/10490) by [@tiangolo](https://github.com/tiangolo).
 * ✏️ Fix link to SPDX license identifier in `docs/en/docs/tutorial/metadata.md`. PR [#10433](https://github.com/tiangolo/fastapi/pull/10433) by [@worldworm](https://github.com/worldworm).

From 2e14c69c311d89dde86e8c033df87773a3a50121 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 25 Oct 2023 00:26:06 +0400
Subject: [PATCH 249/317] =?UTF-8?q?=F0=9F=91=B7=20Adopt=20Ruff=20format=20?=
 =?UTF-8?q?(#10517)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 🔧 Update pre-commit, use ruff format

* ⬆️ Upgrade dependencies, use Ruff for formatting

* 🔧 Update Ruff config

* 🔨 Update lint and format scripts, use Ruff

* 🎨 Format internals with Ruff

* 🎨 Format docs scripts

* 🎨 Format tests

* 🎨 Format extra commas in src for docs

* 📝 Update docs mentioning `@lru_cache()`, use `@lru_cache` instead to keep consistency with the format

* 🎨 Update src for docs, use plain `@lru_cache`

* 🎨 Update src for docs format and docs references
---
 .pre-commit-config.yaml                        | 14 ++------------
 docs/em/docs/advanced/settings.md              | 12 ++++++------
 .../tutorial/query-params-str-validations.md   |  4 ++--
 docs/en/docs/advanced/settings.md              | 12 ++++++------
 .../tutorial/query-params-str-validations.md   |  4 ++--
 .../tutorial/query-params-str-validations.md   |  4 ++--
 docs/zh/docs/advanced/settings.md              | 12 ++++++------
 docs_src/header_params/tutorial002_an.py       |  2 +-
 docs_src/header_params/tutorial002_an_py39.py  |  2 +-
 .../tutorial004.py                             |  2 +-
 .../tutorial004_an.py                          |  2 +-
 .../tutorial004_an_py310.py                    |  2 +-
 .../tutorial004_an_py310_regex.py              |  2 +-
 .../tutorial004_an_py39.py                     |  2 +-
 .../tutorial004_py310.py                       |  5 +++--
 .../tutorial008.py                             |  2 +-
 .../tutorial008_an.py                          |  2 +-
 .../tutorial008_an_py310.py                    |  2 +-
 .../tutorial008_an_py39.py                     |  2 +-
 .../tutorial008_py310.py                       |  5 ++---
 .../tutorial010.py                             |  2 +-
 .../tutorial010_an.py                          |  2 +-
 .../tutorial010_an_py310.py                    |  2 +-
 .../tutorial010_an_py39.py                     |  2 +-
 .../tutorial010_py310.py                       |  5 ++---
 docs_src/settings/app02/main.py                |  2 +-
 docs_src/settings/app02_an/main.py             |  2 +-
 docs_src/settings/app02_an_py39/main.py        |  2 +-
 docs_src/settings/app03/main.py                |  2 +-
 docs_src/settings/app03_an/main.py             |  2 +-
 docs_src/settings/app03_an_py39/main.py        |  2 +-
 fastapi/_compat.py                             |  6 +++---
 fastapi/applications.py                        |  6 ++----
 fastapi/security/http.py                       |  2 +-
 fastapi/security/oauth2.py                     |  4 +---
 fastapi/utils.py                               |  3 ++-
 pyproject.toml                                 | 18 ++++++++++++++++++
 requirements-docs-tests.txt                    |  1 -
 requirements-docs.txt                          |  2 ++
 requirements-tests.txt                         |  2 +-
 scripts/docs.py                                |  6 +++---
 scripts/format.sh                              |  2 +-
 scripts/lint.sh                                |  2 +-
 scripts/mkdocs_hooks.py                        |  4 ++--
 tests/test_openapi_examples.py                 |  2 +-
 tests/test_schema_extra_examples.py            |  4 ++--
 46 files changed, 94 insertions(+), 89 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 9f7085f72..a7f2fb3f2 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -13,23 +13,13 @@ repos:
         -   --unsafe
     -   id: end-of-file-fixer
     -   id: trailing-whitespace
--   repo: https://github.com/asottile/pyupgrade
-    rev: v3.7.0
-    hooks:
-    -   id: pyupgrade
-        args:
-        - --py3-plus
-        - --keep-runtime-typing
 -   repo: https://github.com/charliermarsh/ruff-pre-commit
-    rev: v0.0.275
+    rev: v0.1.2
     hooks:
     -   id: ruff
         args:
         - --fix
--   repo: https://github.com/psf/black
-    rev: 23.3.0
-    hooks:
-    -   id: black
+    -   id: ruff-format
 ci:
     autofix_commit_msg: 🎨 [pre-commit.ci] Auto format from pre-commit.com hooks
     autoupdate_commit_msg: ⬆ [pre-commit.ci] pre-commit autoupdate
diff --git a/docs/em/docs/advanced/settings.md b/docs/em/docs/advanced/settings.md
index bc50bf755..cc7a08bab 100644
--- a/docs/em/docs/advanced/settings.md
+++ b/docs/em/docs/advanced/settings.md
@@ -221,7 +221,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp" uvicorn main:app
 ```
 
 !!! tip
-    👥 🔜 🔬 `@lru_cache()` 🍖.
+    👥 🔜 🔬 `@lru_cache` 🍖.
 
     🔜 👆 💪 🤔 `get_settings()` 😐 🔢.
 
@@ -302,7 +302,7 @@ def get_settings():
 
 👥 🔜 ✍ 👈 🎚 🔠 📨, &amp; 👥 🔜 👂 `.env` 📁 🔠 📨. 👶 👶
 
-✋️ 👥 ⚙️ `@lru_cache()` 👨‍🎨 🔛 🔝, `Settings` 🎚 🔜 ✍ 🕴 🕐, 🥇 🕰 ⚫️ 🤙. 👶 👶
+✋️ 👥 ⚙️ `@lru_cache` 👨‍🎨 🔛 🔝, `Settings` 🎚 🔜 ✍ 🕴 🕐, 🥇 🕰 ⚫️ 🤙. 👶 👶
 
 ```Python hl_lines="1  10"
 {!../../../docs_src/settings/app03/main.py!}
@@ -312,14 +312,14 @@ def get_settings():
 
 #### `lru_cache` 📡 ℹ
 
-`@lru_cache()` 🔀 🔢 ⚫️ 🎀 📨 🎏 💲 👈 📨 🥇 🕰, ↩️ 💻 ⚫️ 🔄, 🛠️ 📟 🔢 🔠 🕰.
+`@lru_cache` 🔀 🔢 ⚫️ 🎀 📨 🎏 💲 👈 📨 🥇 🕰, ↩️ 💻 ⚫️ 🔄, 🛠️ 📟 🔢 🔠 🕰.
 
 , 🔢 🔛 ⚫️ 🔜 🛠️ 🕐 🔠 🌀 ❌. &amp; ⤴️ 💲 📨 🔠 👈 🌀 ❌ 🔜 ⚙️ 🔄 &amp; 🔄 🕐❔ 🔢 🤙 ⏮️ ⚫️❔ 🎏 🌀 ❌.
 
 🖼, 🚥 👆 ✔️ 🔢:
 
 ```Python
-@lru_cache()
+@lru_cache
 def say_hi(name: str, salutation: str = "Ms."):
     return f"Hello {salutation} {name}"
 ```
@@ -371,7 +371,7 @@ participant execute as Execute function
 
 👈 🌌, ⚫️ 🎭 🌖 🚥 ⚫️ 🌐 🔢. ✋️ ⚫️ ⚙️ 🔗 🔢, ⤴️ 👥 💪 🔐 ⚫️ 💪 🔬.
 
-`@lru_cache()` 🍕 `functools` ❔ 🍕 🐍 🐩 🗃, 👆 💪 ✍ 🌅 🔃 ⚫️ <a href="https://docs.python.org/3/library/functools.html#functools.lru_cache" class="external-link" target="_blank">🐍 🩺 `@lru_cache()`</a>.
+`@lru_cache` 🍕 `functools` ❔ 🍕 🐍 🐩 🗃, 👆 💪 ✍ 🌅 🔃 ⚫️ <a href="https://docs.python.org/3/library/functools.html#functools.lru_cache" class="external-link" target="_blank">🐍 🩺 `@lru_cache`</a>.
 
 ## 🌃
 
@@ -379,4 +379,4 @@ participant execute as Execute function
 
 * ⚙️ 🔗 👆 💪 📉 🔬.
 * 👆 💪 ⚙️ `.env` 📁 ⏮️ ⚫️.
-* ⚙️ `@lru_cache()` ➡️ 👆 ❎ 👂 🇨🇻 📁 🔄 &amp; 🔄 🔠 📨, ⏪ 🤝 👆 🔐 ⚫️ ⏮️ 🔬.
+* ⚙️ `@lru_cache` ➡️ 👆 ❎ 👂 🇨🇻 📁 🔄 &amp; 🔄 🔠 📨, ⏪ 🤝 👆 🔐 ⚫️ ⏮️ 🔬.
diff --git a/docs/em/docs/tutorial/query-params-str-validations.md b/docs/em/docs/tutorial/query-params-str-validations.md
index d6b67bd51..f0e455abe 100644
--- a/docs/em/docs/tutorial/query-params-str-validations.md
+++ b/docs/em/docs/tutorial/query-params-str-validations.md
@@ -371,7 +371,7 @@ http://localhost:8000/items/
 
 === "🐍 3️⃣.1️⃣0️⃣ &amp; 🔛"
 
-    ```Python hl_lines="12"
+    ```Python hl_lines="11"
     {!> ../../../docs_src/query_params_str_validations/tutorial008_py310.py!}
     ```
 
@@ -421,7 +421,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
 
 === "🐍 3️⃣.1️⃣0️⃣ &amp; 🔛"
 
-    ```Python hl_lines="17"
+    ```Python hl_lines="16"
     {!> ../../../docs_src/query_params_str_validations/tutorial010_py310.py!}
     ```
 
diff --git a/docs/en/docs/advanced/settings.md b/docs/en/docs/advanced/settings.md
index d39130777..32df90006 100644
--- a/docs/en/docs/advanced/settings.md
+++ b/docs/en/docs/advanced/settings.md
@@ -276,7 +276,7 @@ Now we create a dependency that returns a new `config.Settings()`.
     ```
 
 !!! tip
-    We'll discuss the `@lru_cache()` in a bit.
+    We'll discuss the `@lru_cache` in a bit.
 
     For now you can assume `get_settings()` is a normal function.
 
@@ -388,7 +388,7 @@ def get_settings():
 
 we would create that object for each request, and we would be reading the `.env` file for each request. ⚠️
 
-But as we are using the `@lru_cache()` decorator on top, the `Settings` object will be created only once, the first time it's called. ✔️
+But as we are using the `@lru_cache` decorator on top, the `Settings` object will be created only once, the first time it's called. ✔️
 
 === "Python 3.9+"
 
@@ -415,14 +415,14 @@ Then for any subsequent calls of `get_settings()` in the dependencies for the ne
 
 #### `lru_cache` Technical Details
 
-`@lru_cache()` modifies the function it decorates to return the same value that was returned the first time, instead of computing it again, executing the code of the function every time.
+`@lru_cache` modifies the function it decorates to return the same value that was returned the first time, instead of computing it again, executing the code of the function every time.
 
 So, the function below it will be executed once for each combination of arguments. And then the values returned by each of those combinations of arguments will be used again and again whenever the function is called with exactly the same combination of arguments.
 
 For example, if you have a function:
 
 ```Python
-@lru_cache()
+@lru_cache
 def say_hi(name: str, salutation: str = "Ms."):
     return f"Hello {salutation} {name}"
 ```
@@ -474,7 +474,7 @@ In the case of our dependency `get_settings()`, the function doesn't even take a
 
 That way, it behaves almost as if it was just a global variable. But as it uses a dependency function, then we can override it easily for testing.
 
-`@lru_cache()` is part of `functools` which is part of Python's standard library, you can read more about it in the <a href="https://docs.python.org/3/library/functools.html#functools.lru_cache" class="external-link" target="_blank">Python docs for `@lru_cache()`</a>.
+`@lru_cache` is part of `functools` which is part of Python's standard library, you can read more about it in the <a href="https://docs.python.org/3/library/functools.html#functools.lru_cache" class="external-link" target="_blank">Python docs for `@lru_cache`</a>.
 
 ## Recap
 
@@ -482,4 +482,4 @@ You can use Pydantic Settings to handle the settings or configurations for your
 
 * By using a dependency you can simplify testing.
 * You can use `.env` files with it.
-* Using `@lru_cache()` lets you avoid reading the dotenv file again and again for each request, while allowing you to override it during testing.
+* Using `@lru_cache` lets you avoid reading the dotenv file again and again for each request, while allowing you to override it during testing.
diff --git a/docs/en/docs/tutorial/query-params-str-validations.md b/docs/en/docs/tutorial/query-params-str-validations.md
index 0e777f6a0..91ae615ff 100644
--- a/docs/en/docs/tutorial/query-params-str-validations.md
+++ b/docs/en/docs/tutorial/query-params-str-validations.md
@@ -737,7 +737,7 @@ And a `description`:
     !!! tip
         Prefer to use the `Annotated` version if possible.
 
-    ```Python hl_lines="12"
+    ```Python hl_lines="11"
     {!> ../../../docs_src/query_params_str_validations/tutorial008_py310.py!}
     ```
 
@@ -835,7 +835,7 @@ Then pass the parameter `deprecated=True` to `Query`:
     !!! tip
         Prefer to use the `Annotated` version if possible.
 
-    ```Python hl_lines="17"
+    ```Python hl_lines="16"
     {!> ../../../docs_src/query_params_str_validations/tutorial010_py310.py!}
     ```
 
diff --git a/docs/ru/docs/tutorial/query-params-str-validations.md b/docs/ru/docs/tutorial/query-params-str-validations.md
index 15be5dbf6..cc826b871 100644
--- a/docs/ru/docs/tutorial/query-params-str-validations.md
+++ b/docs/ru/docs/tutorial/query-params-str-validations.md
@@ -741,7 +741,7 @@ http://localhost:8000/items/
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
 
-    ```Python hl_lines="12"
+    ```Python hl_lines="11"
     {!> ../../../docs_src/query_params_str_validations/tutorial008_py310.py!}
     ```
 
@@ -839,7 +839,7 @@ http://127.0.0.1:8000/items/?item-query=foobaritems
     !!! tip "Подсказка"
         Рекомендуется использовать версию с `Annotated` если возможно.
 
-    ```Python hl_lines="17"
+    ```Python hl_lines="16"
     {!> ../../../docs_src/query_params_str_validations/tutorial010_py310.py!}
     ```
 
diff --git a/docs/zh/docs/advanced/settings.md b/docs/zh/docs/advanced/settings.md
index 7f718acef..93e48a610 100644
--- a/docs/zh/docs/advanced/settings.md
+++ b/docs/zh/docs/advanced/settings.md
@@ -239,7 +239,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp"uvicorn main:app
     ```
 
 !!! tip
-    我们稍后会讨论 `@lru_cache()`。
+    我们稍后会讨论 `@lru_cache`。
 
     目前，您可以将 `get_settings()` 视为普通函数。
 
@@ -337,7 +337,7 @@ def get_settings():
 
 我们将为每个请求创建该对象，并且将在每个请求中读取 `.env` 文件。 ⚠️
 
-但是，由于我们在顶部使用了 `@lru_cache()` 装饰器，因此只有在第一次调用它时，才会创建 `Settings` 对象一次。 ✔️
+但是，由于我们在顶部使用了 `@lru_cache` 装饰器，因此只有在第一次调用它时，才会创建 `Settings` 对象一次。 ✔️
 
 === "Python 3.9+"
 
@@ -364,13 +364,13 @@ def get_settings():
 
 #### `lru_cache` 技术细节
 
-`@lru_cache()` 修改了它所装饰的函数，以返回第一次返回的相同值，而不是再次计算它，每次都执行函数的代码。
+`@lru_cache` 修改了它所装饰的函数，以返回第一次返回的相同值，而不是再次计算它，每次都执行函数的代码。
 
 因此，下面的函数将对每个参数组合执行一次。然后，每个参数组合返回的值将在使用完全相同的参数组合调用函数时再次使用。
 
 例如，如果您有一个函数：
 ```Python
-@lru_cache()
+@lru_cache
 def say_hi(name: str, salutation: str = "Ms."):
     return f"Hello {salutation} {name}"
 ```
@@ -422,7 +422,7 @@ participant execute as Execute function
 
 这样，它的行为几乎就像是一个全局变量。但是由于它使用了依赖项函数，因此我们可以轻松地进行测试时的覆盖。
 
-`@lru_cache()` 是 `functools` 的一部分，它是 Python 标准库的一部分，您可以在<a href="https://docs.python.org/3/library/functools.html#functools.lru_cache" class="external-link" target="_blank">Python 文档中了解有关 `@lru_cache()` 的更多信息</a>。
+`@lru_cache` 是 `functools` 的一部分，它是 Python 标准库的一部分，您可以在<a href="https://docs.python.org/3/library/functools.html#functools.lru_cache" class="external-link" target="_blank">Python 文档中了解有关 `@lru_cache` 的更多信息</a>。
 
 ## 小结
 
@@ -430,4 +430,4 @@ participant execute as Execute function
 
 * 通过使用依赖项，您可以简化测试。
 * 您可以使用 `.env` 文件。
-* 使用 `@lru_cache()` 可以避免为每个请求重复读取 dotenv 文件，同时允许您在测试时进行覆盖。
+* 使用 `@lru_cache` 可以避免为每个请求重复读取 dotenv 文件，同时允许您在测试时进行覆盖。
diff --git a/docs_src/header_params/tutorial002_an.py b/docs_src/header_params/tutorial002_an.py
index 65d972d46..82fe49ba2 100644
--- a/docs_src/header_params/tutorial002_an.py
+++ b/docs_src/header_params/tutorial002_an.py
@@ -10,6 +10,6 @@ app = FastAPI()
 async def read_items(
     strange_header: Annotated[
         Union[str, None], Header(convert_underscores=False)
-    ] = None
+    ] = None,
 ):
     return {"strange_header": strange_header}
diff --git a/docs_src/header_params/tutorial002_an_py39.py b/docs_src/header_params/tutorial002_an_py39.py
index 7f6a99f9c..008e4b6e1 100644
--- a/docs_src/header_params/tutorial002_an_py39.py
+++ b/docs_src/header_params/tutorial002_an_py39.py
@@ -9,6 +9,6 @@ app = FastAPI()
 async def read_items(
     strange_header: Annotated[
         Union[str, None], Header(convert_underscores=False)
-    ] = None
+    ] = None,
 ):
     return {"strange_header": strange_header}
diff --git a/docs_src/query_params_str_validations/tutorial004.py b/docs_src/query_params_str_validations/tutorial004.py
index 3639b6c38..64a647a16 100644
--- a/docs_src/query_params_str_validations/tutorial004.py
+++ b/docs_src/query_params_str_validations/tutorial004.py
@@ -9,7 +9,7 @@ app = FastAPI()
 async def read_items(
     q: Union[str, None] = Query(
         default=None, min_length=3, max_length=50, pattern="^fixedquery$"
-    )
+    ),
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial004_an.py b/docs_src/query_params_str_validations/tutorial004_an.py
index 24698c7b3..c75d45d63 100644
--- a/docs_src/query_params_str_validations/tutorial004_an.py
+++ b/docs_src/query_params_str_validations/tutorial004_an.py
@@ -10,7 +10,7 @@ app = FastAPI()
 async def read_items(
     q: Annotated[
         Union[str, None], Query(min_length=3, max_length=50, pattern="^fixedquery$")
-    ] = None
+    ] = None,
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial004_an_py310.py b/docs_src/query_params_str_validations/tutorial004_an_py310.py
index b7b629ee8..20cf1988f 100644
--- a/docs_src/query_params_str_validations/tutorial004_an_py310.py
+++ b/docs_src/query_params_str_validations/tutorial004_an_py310.py
@@ -9,7 +9,7 @@ app = FastAPI()
 async def read_items(
     q: Annotated[
         str | None, Query(min_length=3, max_length=50, pattern="^fixedquery$")
-    ] = None
+    ] = None,
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial004_an_py310_regex.py b/docs_src/query_params_str_validations/tutorial004_an_py310_regex.py
index 8fd375b3d..21e0d3eb8 100644
--- a/docs_src/query_params_str_validations/tutorial004_an_py310_regex.py
+++ b/docs_src/query_params_str_validations/tutorial004_an_py310_regex.py
@@ -9,7 +9,7 @@ app = FastAPI()
 async def read_items(
     q: Annotated[
         str | None, Query(min_length=3, max_length=50, regex="^fixedquery$")
-    ] = None
+    ] = None,
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial004_an_py39.py b/docs_src/query_params_str_validations/tutorial004_an_py39.py
index 8e9a6fc32..de27097b3 100644
--- a/docs_src/query_params_str_validations/tutorial004_an_py39.py
+++ b/docs_src/query_params_str_validations/tutorial004_an_py39.py
@@ -9,7 +9,7 @@ app = FastAPI()
 async def read_items(
     q: Annotated[
         Union[str, None], Query(min_length=3, max_length=50, pattern="^fixedquery$")
-    ] = None
+    ] = None,
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial004_py310.py b/docs_src/query_params_str_validations/tutorial004_py310.py
index f80798bcb..7801e7500 100644
--- a/docs_src/query_params_str_validations/tutorial004_py310.py
+++ b/docs_src/query_params_str_validations/tutorial004_py310.py
@@ -5,8 +5,9 @@ app = FastAPI()
 
 @app.get("/items/")
 async def read_items(
-    q: str
-    | None = Query(default=None, min_length=3, max_length=50, pattern="^fixedquery$")
+    q: str | None = Query(
+        default=None, min_length=3, max_length=50, pattern="^fixedquery$"
+    ),
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial008.py b/docs_src/query_params_str_validations/tutorial008.py
index d112a9ab8..e3e0b50aa 100644
--- a/docs_src/query_params_str_validations/tutorial008.py
+++ b/docs_src/query_params_str_validations/tutorial008.py
@@ -12,7 +12,7 @@ async def read_items(
         title="Query string",
         description="Query string for the items to search in the database that have a good match",
         min_length=3,
-    )
+    ),
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial008_an.py b/docs_src/query_params_str_validations/tutorial008_an.py
index 5699f1e88..01606a920 100644
--- a/docs_src/query_params_str_validations/tutorial008_an.py
+++ b/docs_src/query_params_str_validations/tutorial008_an.py
@@ -15,7 +15,7 @@ async def read_items(
             description="Query string for the items to search in the database that have a good match",
             min_length=3,
         ),
-    ] = None
+    ] = None,
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial008_an_py310.py b/docs_src/query_params_str_validations/tutorial008_an_py310.py
index 4aaadf8b4..44b3082b6 100644
--- a/docs_src/query_params_str_validations/tutorial008_an_py310.py
+++ b/docs_src/query_params_str_validations/tutorial008_an_py310.py
@@ -14,7 +14,7 @@ async def read_items(
             description="Query string for the items to search in the database that have a good match",
             min_length=3,
         ),
-    ] = None
+    ] = None,
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial008_an_py39.py b/docs_src/query_params_str_validations/tutorial008_an_py39.py
index 1c3b36176..f3f2f2c0e 100644
--- a/docs_src/query_params_str_validations/tutorial008_an_py39.py
+++ b/docs_src/query_params_str_validations/tutorial008_an_py39.py
@@ -14,7 +14,7 @@ async def read_items(
             description="Query string for the items to search in the database that have a good match",
             min_length=3,
         ),
-    ] = None
+    ] = None,
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial008_py310.py b/docs_src/query_params_str_validations/tutorial008_py310.py
index 489f631d5..574385272 100644
--- a/docs_src/query_params_str_validations/tutorial008_py310.py
+++ b/docs_src/query_params_str_validations/tutorial008_py310.py
@@ -5,13 +5,12 @@ app = FastAPI()
 
 @app.get("/items/")
 async def read_items(
-    q: str
-    | None = Query(
+    q: str | None = Query(
         default=None,
         title="Query string",
         description="Query string for the items to search in the database that have a good match",
         min_length=3,
-    )
+    ),
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial010.py b/docs_src/query_params_str_validations/tutorial010.py
index 3314f8b6d..ff29176fe 100644
--- a/docs_src/query_params_str_validations/tutorial010.py
+++ b/docs_src/query_params_str_validations/tutorial010.py
@@ -16,7 +16,7 @@ async def read_items(
         max_length=50,
         pattern="^fixedquery$",
         deprecated=True,
-    )
+    ),
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial010_an.py b/docs_src/query_params_str_validations/tutorial010_an.py
index c5df00897..ed343230f 100644
--- a/docs_src/query_params_str_validations/tutorial010_an.py
+++ b/docs_src/query_params_str_validations/tutorial010_an.py
@@ -19,7 +19,7 @@ async def read_items(
             pattern="^fixedquery$",
             deprecated=True,
         ),
-    ] = None
+    ] = None,
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial010_an_py310.py b/docs_src/query_params_str_validations/tutorial010_an_py310.py
index a8e8c099b..775095bda 100644
--- a/docs_src/query_params_str_validations/tutorial010_an_py310.py
+++ b/docs_src/query_params_str_validations/tutorial010_an_py310.py
@@ -18,7 +18,7 @@ async def read_items(
             pattern="^fixedquery$",
             deprecated=True,
         ),
-    ] = None
+    ] = None,
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial010_an_py39.py b/docs_src/query_params_str_validations/tutorial010_an_py39.py
index 955880dd6..b126c116f 100644
--- a/docs_src/query_params_str_validations/tutorial010_an_py39.py
+++ b/docs_src/query_params_str_validations/tutorial010_an_py39.py
@@ -18,7 +18,7 @@ async def read_items(
             pattern="^fixedquery$",
             deprecated=True,
         ),
-    ] = None
+    ] = None,
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/query_params_str_validations/tutorial010_py310.py b/docs_src/query_params_str_validations/tutorial010_py310.py
index 9ea7b3c49..530e6cf5b 100644
--- a/docs_src/query_params_str_validations/tutorial010_py310.py
+++ b/docs_src/query_params_str_validations/tutorial010_py310.py
@@ -5,8 +5,7 @@ app = FastAPI()
 
 @app.get("/items/")
 async def read_items(
-    q: str
-    | None = Query(
+    q: str | None = Query(
         default=None,
         alias="item-query",
         title="Query string",
@@ -15,7 +14,7 @@ async def read_items(
         max_length=50,
         pattern="^fixedquery$",
         deprecated=True,
-    )
+    ),
 ):
     results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
     if q:
diff --git a/docs_src/settings/app02/main.py b/docs_src/settings/app02/main.py
index 163aa2614..941f82e6b 100644
--- a/docs_src/settings/app02/main.py
+++ b/docs_src/settings/app02/main.py
@@ -7,7 +7,7 @@ from .config import Settings
 app = FastAPI()
 
 
-@lru_cache()
+@lru_cache
 def get_settings():
     return Settings()
 
diff --git a/docs_src/settings/app02_an/main.py b/docs_src/settings/app02_an/main.py
index cb679202d..3a578cc33 100644
--- a/docs_src/settings/app02_an/main.py
+++ b/docs_src/settings/app02_an/main.py
@@ -8,7 +8,7 @@ from .config import Settings
 app = FastAPI()
 
 
-@lru_cache()
+@lru_cache
 def get_settings():
     return Settings()
 
diff --git a/docs_src/settings/app02_an_py39/main.py b/docs_src/settings/app02_an_py39/main.py
index 61be74fcb..6d5db12a8 100644
--- a/docs_src/settings/app02_an_py39/main.py
+++ b/docs_src/settings/app02_an_py39/main.py
@@ -8,7 +8,7 @@ from .config import Settings
 app = FastAPI()
 
 
-@lru_cache()
+@lru_cache
 def get_settings():
     return Settings()
 
diff --git a/docs_src/settings/app03/main.py b/docs_src/settings/app03/main.py
index 69bc8c6e0..ea64a5709 100644
--- a/docs_src/settings/app03/main.py
+++ b/docs_src/settings/app03/main.py
@@ -7,7 +7,7 @@ from . import config
 app = FastAPI()
 
 
-@lru_cache()
+@lru_cache
 def get_settings():
     return config.Settings()
 
diff --git a/docs_src/settings/app03_an/main.py b/docs_src/settings/app03_an/main.py
index c33b98f47..2f64b9cd1 100644
--- a/docs_src/settings/app03_an/main.py
+++ b/docs_src/settings/app03_an/main.py
@@ -8,7 +8,7 @@ from . import config
 app = FastAPI()
 
 
-@lru_cache()
+@lru_cache
 def get_settings():
     return config.Settings()
 
diff --git a/docs_src/settings/app03_an_py39/main.py b/docs_src/settings/app03_an_py39/main.py
index b89c6b6cf..62f347639 100644
--- a/docs_src/settings/app03_an_py39/main.py
+++ b/docs_src/settings/app03_an_py39/main.py
@@ -8,7 +8,7 @@ from . import config
 app = FastAPI()
 
 
-@lru_cache()
+@lru_cache
 def get_settings():
     return config.Settings()
 
diff --git a/fastapi/_compat.py b/fastapi/_compat.py
index a4b305d42..fc605d0ec 100644
--- a/fastapi/_compat.py
+++ b/fastapi/_compat.py
@@ -197,9 +197,9 @@ if PYDANTIC_V2:
         if "$ref" not in json_schema:
             # TODO remove when deprecating Pydantic v1
             # Ref: https://github.com/pydantic/pydantic/blob/d61792cc42c80b13b23e3ffa74bc37ec7c77f7d1/pydantic/schema.py#L207
-            json_schema[
-                "title"
-            ] = field.field_info.title or field.alias.title().replace("_", " ")
+            json_schema["title"] = (
+                field.field_info.title or field.alias.title().replace("_", " ")
+            )
         return json_schema
 
     def get_compat_model_name_map(fields: List[ModelField]) -> ModelNameMap:
diff --git a/fastapi/applications.py b/fastapi/applications.py
index 8ca374a54..3021d7593 100644
--- a/fastapi/applications.py
+++ b/fastapi/applications.py
@@ -896,9 +896,7 @@ class FastAPI(Starlette):
                 [FastAPI docs for OpenAPI Webhooks](https://fastapi.tiangolo.com/advanced/openapi-webhooks/).
                 """
             ),
-        ] = (
-            webhooks or routing.APIRouter()
-        )
+        ] = webhooks or routing.APIRouter()
         self.root_path = root_path or openapi_prefix
         self.state: Annotated[
             State,
@@ -951,7 +949,7 @@ class FastAPI(Starlette):
         )
         self.exception_handlers: Dict[
             Any, Callable[[Request, Any], Union[Response, Awaitable[Response]]]
-        ] = ({} if exception_handlers is None else dict(exception_handlers))
+        ] = {} if exception_handlers is None else dict(exception_handlers)
         self.exception_handlers.setdefault(HTTPException, http_exception_handler)
         self.exception_handlers.setdefault(
             RequestValidationError, request_validation_exception_handler
diff --git a/fastapi/security/http.py b/fastapi/security/http.py
index 3627777d6..738455de3 100644
--- a/fastapi/security/http.py
+++ b/fastapi/security/http.py
@@ -210,7 +210,7 @@ class HTTPBasic(HTTPBase):
         try:
             data = b64decode(param).decode("ascii")
         except (ValueError, UnicodeDecodeError, binascii.Error):
-            raise invalid_user_credentials_exc
+            raise invalid_user_credentials_exc  # noqa: B904
         username, separator, password = data.partition(":")
         if not separator:
             raise invalid_user_credentials_exc
diff --git a/fastapi/security/oauth2.py b/fastapi/security/oauth2.py
index d427783ad..9281dfb64 100644
--- a/fastapi/security/oauth2.py
+++ b/fastapi/security/oauth2.py
@@ -626,9 +626,7 @@ class SecurityScopes:
                 The list of all the scopes required by dependencies.
                 """
             ),
-        ] = (
-            scopes or []
-        )
+        ] = scopes or []
         self.scope_str: Annotated[
             str,
             Doc(
diff --git a/fastapi/utils.py b/fastapi/utils.py
index 53b47a160..f8463dda2 100644
--- a/fastapi/utils.py
+++ b/fastapi/utils.py
@@ -152,7 +152,8 @@ def create_cloned_field(
         ]
     if field.key_field:  # type: ignore[attr-defined]
         new_field.key_field = create_cloned_field(  # type: ignore[attr-defined]
-            field.key_field, cloned_types=cloned_types  # type: ignore[attr-defined]
+            field.key_field,  # type: ignore[attr-defined]
+            cloned_types=cloned_types,
         )
     new_field.validators = field.validators  # type: ignore[attr-defined]
     new_field.pre_validators = field.pre_validators  # type: ignore[attr-defined]
diff --git a/pyproject.toml b/pyproject.toml
index addde1d33..e67486ae3 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -130,11 +130,13 @@ select = [
     "I",  # isort
     "C",  # flake8-comprehensions
     "B",  # flake8-bugbear
+    "UP",  # pyupgrade
 ]
 ignore = [
     "E501",  # line too long, handled by black
     "B008",  # do not perform function calls in argument defaults
     "C901",  # too complex
+    "W191", # indentation contains tabs
 ]
 
 [tool.ruff.per-file-ignores]
@@ -154,6 +156,22 @@ ignore = [
 "docs_src/query_params_str_validations/tutorial012_an_py39.py" = ["B006"]
 "docs_src/query_params_str_validations/tutorial013_an.py" = ["B006"]
 "docs_src/query_params_str_validations/tutorial013_an_py39.py" = ["B006"]
+"docs_src/security/tutorial004.py" = ["B904"]
+"docs_src/security/tutorial004_an.py" = ["B904"]
+"docs_src/security/tutorial004_an_py310.py" = ["B904"]
+"docs_src/security/tutorial004_an_py39.py" = ["B904"]
+"docs_src/security/tutorial004_py310.py" = ["B904"]
+"docs_src/security/tutorial005.py" = ["B904"]
+"docs_src/security/tutorial005_an.py" = ["B904"]
+"docs_src/security/tutorial005_an_py310.py" = ["B904"]
+"docs_src/security/tutorial005_an_py39.py" = ["B904"]
+"docs_src/security/tutorial005_py310.py" = ["B904"]
+"docs_src/security/tutorial005_py39.py" = ["B904"]
+
 
 [tool.ruff.isort]
 known-third-party = ["fastapi", "pydantic", "starlette"]
+
+[tool.ruff.pyupgrade]
+# Preserve types, even if a file imports `from __future__ import annotations`.
+keep-runtime-typing = true
diff --git a/requirements-docs-tests.txt b/requirements-docs-tests.txt
index 1a4a57267..b82df4933 100644
--- a/requirements-docs-tests.txt
+++ b/requirements-docs-tests.txt
@@ -1,3 +1,2 @@
 # For mkdocstrings and tests
 httpx >=0.23.0,<0.25.0
-black == 23.3.0
diff --git a/requirements-docs.txt b/requirements-docs.txt
index 3e0df6483..69302f655 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -15,3 +15,5 @@ pillow==9.5.0
 cairosvg==2.7.0
 mkdocstrings[python]==0.23.0
 griffe-typingdoc==0.2.2
+# For griffe, it formats with black
+black==23.3.0
diff --git a/requirements-tests.txt b/requirements-tests.txt
index de8d3f26c..e1a976c13 100644
--- a/requirements-tests.txt
+++ b/requirements-tests.txt
@@ -4,7 +4,7 @@ pydantic-settings >=2.0.0
 pytest >=7.1.3,<8.0.0
 coverage[toml] >= 6.5.0,< 8.0
 mypy ==1.4.1
-ruff ==0.0.275
+ruff ==0.1.2
 email_validator >=1.1.1,<3.0.0
 dirty-equals ==0.6.0
 # TODO: once removing databases from tutorial, upgrade SQLAlchemy
diff --git a/scripts/docs.py b/scripts/docs.py
index 0023c670c..73e1900ad 100644
--- a/scripts/docs.py
+++ b/scripts/docs.py
@@ -36,7 +36,7 @@ site_path = Path("site").absolute()
 build_site_path = Path("site_build").absolute()
 
 
-@lru_cache()
+@lru_cache
 def is_mkdocs_insiders() -> bool:
     version = metadata.version("mkdocs-material")
     return "insiders" in version
@@ -104,7 +104,7 @@ def new_lang(lang: str = typer.Argument(..., callback=lang_callback)):
 def build_lang(
     lang: str = typer.Argument(
         ..., callback=lang_callback, autocompletion=complete_existing_lang
-    )
+    ),
 ) -> None:
     """
     Build the docs for a language.
@@ -251,7 +251,7 @@ def serve() -> None:
 def live(
     lang: str = typer.Argument(
         None, callback=lang_callback, autocompletion=complete_existing_lang
-    )
+    ),
 ) -> None:
     """
     Serve with livereload a docs site for a specific language.
diff --git a/scripts/format.sh b/scripts/format.sh
index 3fb3eb4f1..11f25f1ce 100755
--- a/scripts/format.sh
+++ b/scripts/format.sh
@@ -2,4 +2,4 @@
 set -x
 
 ruff fastapi tests docs_src scripts --fix
-black fastapi tests docs_src scripts
+ruff format fastapi tests docs_src scripts
diff --git a/scripts/lint.sh b/scripts/lint.sh
index 4db5caa96..c0e24db9f 100755
--- a/scripts/lint.sh
+++ b/scripts/lint.sh
@@ -5,4 +5,4 @@ set -x
 
 mypy fastapi
 ruff fastapi tests docs_src scripts
-black fastapi tests --check
+ruff format fastapi tests --check
diff --git a/scripts/mkdocs_hooks.py b/scripts/mkdocs_hooks.py
index 2b6a05642..8335a13f6 100644
--- a/scripts/mkdocs_hooks.py
+++ b/scripts/mkdocs_hooks.py
@@ -14,14 +14,14 @@ non_traslated_sections = [
 ]
 
 
-@lru_cache()
+@lru_cache
 def get_missing_translation_content(docs_dir: str) -> str:
     docs_dir_path = Path(docs_dir)
     missing_translation_path = docs_dir_path.parent.parent / "missing-translation.md"
     return missing_translation_path.read_text(encoding="utf-8")
 
 
-@lru_cache()
+@lru_cache
 def get_mkdocs_material_langs() -> List[str]:
     material_path = Path(material.__file__).parent
     material_langs_path = material_path / "templates" / "partials" / "languages"
diff --git a/tests/test_openapi_examples.py b/tests/test_openapi_examples.py
index 70664a8a4..6597e5058 100644
--- a/tests/test_openapi_examples.py
+++ b/tests/test_openapi_examples.py
@@ -28,7 +28,7 @@ def examples(
                 "value": {"data": "Data in Body examples, example2"},
             },
         },
-    )
+    ),
 ):
     return item
 
diff --git a/tests/test_schema_extra_examples.py b/tests/test_schema_extra_examples.py
index a1505afe2..b313f47e9 100644
--- a/tests/test_schema_extra_examples.py
+++ b/tests/test_schema_extra_examples.py
@@ -40,7 +40,7 @@ def create_app():
                 {"data": "Data in Body examples, example1"},
                 {"data": "Data in Body examples, example2"},
             ],
-        )
+        ),
     ):
         return item
 
@@ -54,7 +54,7 @@ def create_app():
                     {"data": "examples example_examples 1"},
                     {"data": "examples example_examples 2"},
                 ],
-            )
+            ),
         ):
             return item
 

From 223970e03c3ac43e3bec059f5b094e68029e9396 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 24 Oct 2023 20:26:43 +0000
Subject: [PATCH 250/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 74b0b1b27..0acca3761 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* 👷 Adopt Ruff format. PR [#10517](https://github.com/tiangolo/fastapi/pull/10517) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Add `CITATION.cff` file for academic citations. PR [#10496](https://github.com/tiangolo/fastapi/pull/10496) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Update data structure and render for external-links. PR [#10495](https://github.com/tiangolo/fastapi/pull/10495) by [@tiangolo](https://github.com/tiangolo).
 * 🐛 Fix overriding MKDocs theme lang in hook. PR [#10490](https://github.com/tiangolo/fastapi/pull/10490) by [@tiangolo](https://github.com/tiangolo).

From f7e338dcd832b4fb9d3236f622fb6bf6e97ef40d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 25 Oct 2023 12:25:03 +0400
Subject: [PATCH 251/317] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors=20badg?=
 =?UTF-8?q?es,=20Databento=20(#10519)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/data/sponsors_badge.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/data/sponsors_badge.yml b/docs/en/data/sponsors_badge.yml
index d67e27c87..acbcc2205 100644
--- a/docs/en/data/sponsors_badge.yml
+++ b/docs/en/data/sponsors_badge.yml
@@ -14,6 +14,7 @@ logins:
   - nihpo
   - armand-sauzay
   - databento-bot
+  - databento
   - nanram22
   - Flint-company
   - porter-dev

From 2754d4e0fe2e45673d4ded8491a40f6d1bcd1d80 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 25 Oct 2023 08:25:52 +0000
Subject: [PATCH 252/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 0acca3761..d761fa20b 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* 🔧 Update sponsors badges, Databento. PR [#10519](https://github.com/tiangolo/fastapi/pull/10519) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Adopt Ruff format. PR [#10517](https://github.com/tiangolo/fastapi/pull/10517) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Add `CITATION.cff` file for academic citations. PR [#10496](https://github.com/tiangolo/fastapi/pull/10496) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Update data structure and render for external-links. PR [#10495](https://github.com/tiangolo/fastapi/pull/10495) by [@tiangolo](https://github.com/tiangolo).

From e45cbb7e5e804079a0eb57b3175a77b4d18a5fe0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sun, 29 Oct 2023 13:12:11 +0400
Subject: [PATCH 253/317] =?UTF-8?q?=F0=9F=91=B7=20Install=20MkDocs=20Mater?=
 =?UTF-8?q?ial=20Insiders=20only=20when=20secrets=20are=20available,=20for?=
 =?UTF-8?q?=20Dependabot=20(#10544)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/workflows/build-docs.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/build-docs.yml b/.github/workflows/build-docs.yml
index 4100781c5..701c74697 100644
--- a/.github/workflows/build-docs.yml
+++ b/.github/workflows/build-docs.yml
@@ -50,7 +50,7 @@ jobs:
         run: pip install -r requirements-docs.txt
       # Install MkDocs Material Insiders here just to put it in the cache for the rest of the steps
       - name: Install Material for MkDocs Insiders
-        if: ( github.event_name != 'pull_request' || github.event.pull_request.head.repo.fork == false ) && steps.cache.outputs.cache-hit != 'true'
+        if: ( github.event_name != 'pull_request' || github.secret_source == 'Actions' ) && steps.cache.outputs.cache-hit != 'true'
         run: |
           pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/squidfunk/mkdocs-material-insiders.git
           pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/pawamoy-insiders/griffe-typing-deprecated.git
@@ -88,7 +88,7 @@ jobs:
         if: steps.cache.outputs.cache-hit != 'true'
         run: pip install -r requirements-docs.txt
       - name: Install Material for MkDocs Insiders
-        if: ( github.event_name != 'pull_request' || github.event.pull_request.head.repo.fork == false ) && steps.cache.outputs.cache-hit != 'true'
+        if: ( github.event_name != 'pull_request' || github.secret_source != 'Actions' ) && steps.cache.outputs.cache-hit != 'true'
         run: |
           pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/squidfunk/mkdocs-material-insiders.git
           pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/pawamoy-insiders/griffe-typing-deprecated.git

From 072c701b0ed5c831f6c923d2af9d89eef4eacbf7 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 29 Oct 2023 09:12:56 +0000
Subject: [PATCH 254/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d761fa20b..9db471b3f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* 👷 Install MkDocs Material Insiders only when secrets are available, for Dependabot. PR [#10544](https://github.com/tiangolo/fastapi/pull/10544) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors badges, Databento. PR [#10519](https://github.com/tiangolo/fastapi/pull/10519) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Adopt Ruff format. PR [#10517](https://github.com/tiangolo/fastapi/pull/10517) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Add `CITATION.cff` file for academic citations. PR [#10496](https://github.com/tiangolo/fastapi/pull/10496) by [@tiangolo](https://github.com/tiangolo).

From e0c5beb5c8d22c90e9ae8c0d72728a60d451edd2 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 29 Oct 2023 13:32:50 +0400
Subject: [PATCH 255/317] =?UTF-8?q?=E2=AC=86=20Bump=20mkdocs-material=20fr?=
 =?UTF-8?q?om=209.1.21=20to=209.4.7=20(#10545)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Bumps [mkdocs-material](https://github.com/squidfunk/mkdocs-material) from 9.1.21 to 9.4.7.
- [Release notes](https://github.com/squidfunk/mkdocs-material/releases)
- [Changelog](https://github.com/squidfunk/mkdocs-material/blob/master/CHANGELOG)
- [Commits](https://github.com/squidfunk/mkdocs-material/compare/9.1.21...9.4.7)

---
updated-dependencies:
- dependency-name: mkdocs-material
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 requirements-docs.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements-docs.txt b/requirements-docs.txt
index 69302f655..83dc94ee0 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -1,6 +1,6 @@
 -e .
 -r requirements-docs-tests.txt
-mkdocs-material==9.1.21
+mkdocs-material==9.4.7
 mdx-include >=1.4.1,<2.0.0
 mkdocs-markdownextradata-plugin >=0.1.7,<0.3.0
 mkdocs-redirects>=1.2.1,<1.3.0

From 378e590757814099abdd49a7e42d1a393db2a206 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 29 Oct 2023 09:33:30 +0000
Subject: [PATCH 257/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 9db471b3f..036e8c45c 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* ⬆ Bump mkdocs-material from 9.1.21 to 9.4.7. PR [#10545](https://github.com/tiangolo/fastapi/pull/10545) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * 👷 Install MkDocs Material Insiders only when secrets are available, for Dependabot. PR [#10544](https://github.com/tiangolo/fastapi/pull/10544) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors badges, Databento. PR [#10519](https://github.com/tiangolo/fastapi/pull/10519) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Adopt Ruff format. PR [#10517](https://github.com/tiangolo/fastapi/pull/10517) by [@tiangolo](https://github.com/tiangolo).

From 38db1fe074ba48b8b60827d0aa4e523d888e5a07 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 29 Oct 2023 09:33:47 +0000
Subject: [PATCH 258/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 036e8c45c..94c3451f8 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* ⬆ Update mkdocs-material requirement from <9.0.0,>=8.1.4 to >=8.1.4,<10.0.0. PR [#5862](https://github.com/tiangolo/fastapi/pull/5862) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ Bump mkdocs-material from 9.1.21 to 9.4.7. PR [#10545](https://github.com/tiangolo/fastapi/pull/10545) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * 👷 Install MkDocs Material Insiders only when secrets are available, for Dependabot. PR [#10544](https://github.com/tiangolo/fastapi/pull/10544) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors badges, Databento. PR [#10519](https://github.com/tiangolo/fastapi/pull/10519) by [@tiangolo](https://github.com/tiangolo).

From 0b83491843ddeecea6708a58b25cd895f446e364 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 29 Oct 2023 13:49:21 +0400
Subject: [PATCH 259/317] =?UTF-8?q?=E2=AC=86=20Bump=20pillow=20from=209.5.?=
 =?UTF-8?q?0=20to=2010.1.0=20(#10446)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Bumps [pillow](https://github.com/python-pillow/Pillow) from 9.5.0 to 10.1.0.
- [Release notes](https://github.com/python-pillow/Pillow/releases)
- [Changelog](https://github.com/python-pillow/Pillow/blob/main/CHANGES.rst)
- [Commits](https://github.com/python-pillow/Pillow/compare/9.5.0...10.1.0)

---
updated-dependencies:
- dependency-name: pillow
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 requirements-docs.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements-docs.txt b/requirements-docs.txt
index 83dc94ee0..28408a9f1 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -10,7 +10,7 @@ pyyaml >=5.3.1,<7.0.0
 # For Material for MkDocs, Chinese search
 jieba==0.42.1
 # For image processing by Material for MkDocs
-pillow==9.5.0
+pillow==10.1.0
 # For image processing by Material for MkDocs
 cairosvg==2.7.0
 mkdocstrings[python]==0.23.0

From b84f9f6ecb4292fb51f22314ff7e60b3eadb97c0 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 29 Oct 2023 09:49:57 +0000
Subject: [PATCH 260/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 94c3451f8..ea2284cd5 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* ⬆ Bump pillow from 9.5.0 to 10.1.0. PR [#10446](https://github.com/tiangolo/fastapi/pull/10446) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ Update mkdocs-material requirement from <9.0.0,>=8.1.4 to >=8.1.4,<10.0.0. PR [#5862](https://github.com/tiangolo/fastapi/pull/5862) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ Bump mkdocs-material from 9.1.21 to 9.4.7. PR [#10545](https://github.com/tiangolo/fastapi/pull/10545) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * 👷 Install MkDocs Material Insiders only when secrets are available, for Dependabot. PR [#10544](https://github.com/tiangolo/fastapi/pull/10544) by [@tiangolo](https://github.com/tiangolo).

From fbe6ba6df119b4f028f06cbcceb2ba4782899b1f Mon Sep 17 00:00:00 2001
From: Dmitry <nor808@yandex.ru>
Date: Mon, 30 Oct 2023 10:01:00 +0300
Subject: [PATCH 261/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20typo=20in=20?=
 =?UTF-8?q?`docs/em/docs/index.md`,=20Python=203.8=20(#10521)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

typo in index page

7️⃣❌ ->  8️⃣✅
---
 docs/em/docs/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/em/docs/index.md b/docs/em/docs/index.md
index ea8a9d41c..c7df28160 100644
--- a/docs/em/docs/index.md
+++ b/docs/em/docs/index.md
@@ -27,7 +27,7 @@
 
 ---
 
-FastAPI 🏛, ⏩ (↕-🎭), 🕸 🛠️ 🏗 🛠️ ⏮️ 🐍 3️⃣.7️⃣ ➕ ⚓️ 🔛 🐩 🐍 🆎 🔑.
+FastAPI 🏛, ⏩ (↕-🎭), 🕸 🛠️ 🏗 🛠️ ⏮️ 🐍 3️⃣.8️⃣ ➕ ⚓️ 🔛 🐩 🐍 🆎 🔑.
 
 🔑 ⚒:
 

From cbc8f186649419b962d978a4d604dee69ed70fd3 Mon Sep 17 00:00:00 2001
From: Hasnat Sajid <86589885+hasnatsajid@users.noreply.github.com>
Date: Mon, 30 Oct 2023 12:05:01 +0500
Subject: [PATCH 262/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20links=20in?=
 =?UTF-8?q?=20`docs/em/docs/async.md`=20(#10507)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/em/docs/async.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/em/docs/async.md b/docs/em/docs/async.md
index 13b362b5d..ddcae1573 100644
--- a/docs/em/docs/async.md
+++ b/docs/em/docs/async.md
@@ -409,11 +409,11 @@ async def read_burgers():
 
 ### 🔗
 
-🎏 ✔ [🔗](/tutorial/dependencies/index.md){.internal-link target=_blank}. 🚥 🔗 🐩 `def` 🔢 ↩️ `async def`, ⚫️ 🏃 🔢 🧵.
+🎏 ✔ [🔗](./tutorial/dependencies/index.md){.internal-link target=_blank}. 🚥 🔗 🐩 `def` 🔢 ↩️ `async def`, ⚫️ 🏃 🔢 🧵.
 
 ### 🎧-🔗
 
-👆 💪 ✔️ 💗 🔗 &amp; [🎧-🔗](/tutorial/dependencies/sub-dependencies.md){.internal-link target=_blank} 🚫 🔠 🎏 (🔢 🔢 🔑), 👫 💪 ✍ ⏮️ `async def` &amp; ⏮️ 😐 `def`. ⚫️ 🔜 👷, &amp; 🕐 ✍ ⏮️ 😐 `def` 🔜 🤙 🔛 🔢 🧵 (⚪️➡️ 🧵) ↩️ ➖ "⌛".
+👆 💪 ✔️ 💗 🔗 &amp; [🎧-🔗](./tutorial/dependencies/sub-dependencies.md){.internal-link target=_blank} 🚫 🔠 🎏 (🔢 🔢 🔑), 👫 💪 ✍ ⏮️ `async def` &amp; ⏮️ 😐 `def`. ⚫️ 🔜 👷, &amp; 🕐 ✍ ⏮️ 😐 `def` 🔜 🤙 🔛 🔢 🧵 (⚪️➡️ 🧵) ↩️ ➖ "⌛".
 
 ### 🎏 🚙 🔢
 

From 6b903ff1fbafd09f821a3c9f370317aaa1b26892 Mon Sep 17 00:00:00 2001
From: Hasnat Sajid <86589885+hasnatsajid@users.noreply.github.com>
Date: Mon, 30 Oct 2023 12:07:15 +0500
Subject: [PATCH 263/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Update=20links=20i?=
 =?UTF-8?q?n=20`docs/en/docs/async.md`=20and=20`docs/zh/docs/async.md`=20t?=
 =?UTF-8?q?o=20make=20them=20relative=20(#10498)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/async.md | 4 ++--
 docs/zh/docs/async.md | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/en/docs/async.md b/docs/en/docs/async.md
index 3d4b1956a..2ead1f2db 100644
--- a/docs/en/docs/async.md
+++ b/docs/en/docs/async.md
@@ -409,11 +409,11 @@ Still, in both situations, chances are that **FastAPI** will [still be faster](/
 
 ### Dependencies
 
-The same applies for [dependencies](/tutorial/dependencies/index.md){.internal-link target=_blank}. If a dependency is a standard `def` function instead of `async def`, it is run in the external threadpool.
+The same applies for [dependencies](./tutorial/dependencies/index.md){.internal-link target=_blank}. If a dependency is a standard `def` function instead of `async def`, it is run in the external threadpool.
 
 ### Sub-dependencies
 
-You can have multiple dependencies and [sub-dependencies](/tutorial/dependencies/sub-dependencies.md){.internal-link target=_blank} requiring each other (as parameters of the function definitions), some of them might be created with `async def` and some with normal `def`. It would still work, and the ones created with normal `def` would be called on an external thread (from the threadpool) instead of being "awaited".
+You can have multiple dependencies and [sub-dependencies](./tutorial/dependencies/sub-dependencies.md){.internal-link target=_blank} requiring each other (as parameters of the function definitions), some of them might be created with `async def` and some with normal `def`. It would still work, and the ones created with normal `def` would be called on an external thread (from the threadpool) instead of being "awaited".
 
 ### Other utility functions
 
diff --git a/docs/zh/docs/async.md b/docs/zh/docs/async.md
index 7cc76fc86..59eebd049 100644
--- a/docs/zh/docs/async.md
+++ b/docs/zh/docs/async.md
@@ -409,11 +409,11 @@ Starlette （和 **FastAPI**） 是基于 <a href="https://anyio.readthedocs.io/
 
 ### 依赖
 
-这同样适用于[依赖](/tutorial/dependencies/index.md){.internal-link target=_blank}。如果一个依赖是标准的 `def` 函数而不是 `async def`，它将被运行在外部线程池中。
+这同样适用于[依赖](./tutorial/dependencies/index.md){.internal-link target=_blank}。如果一个依赖是标准的 `def` 函数而不是 `async def`，它将被运行在外部线程池中。
 
 ### 子依赖
 
-你可以拥有多个相互依赖的依赖以及[子依赖](/tutorial/dependencies/sub-dependencies.md){.internal-link target=_blank} （作为函数的参数），它们中的一些可能是通过 `async def` 声明，也可能是通过 `def` 声明。它们仍然可以正常工作，这些通过 `def` 声明的函数将会在外部线程中调用（来自线程池），而不是"被等待"。
+你可以拥有多个相互依赖的依赖以及[子依赖](./tutorial/dependencies/sub-dependencies.md){.internal-link target=_blank} （作为函数的参数），它们中的一些可能是通过 `async def` 声明，也可能是通过 `def` 声明。它们仍然可以正常工作，这些通过 `def` 声明的函数将会在外部线程中调用（来自线程池），而不是"被等待"。
 
 ### 其他函数
 

From 0066578bbedf9c41349f61b660ca47fc37990484 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 30 Oct 2023 07:42:04 +0000
Subject: [PATCH 264/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index ea2284cd5..38462ce6d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* ✏️ Fix typo in `docs/em/docs/index.md`, Python 3.8. PR [#10521](https://github.com/tiangolo/fastapi/pull/10521) by [@kerriop](https://github.com/kerriop).
 * ⬆ Bump pillow from 9.5.0 to 10.1.0. PR [#10446](https://github.com/tiangolo/fastapi/pull/10446) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ Update mkdocs-material requirement from <9.0.0,>=8.1.4 to >=8.1.4,<10.0.0. PR [#5862](https://github.com/tiangolo/fastapi/pull/5862) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ Bump mkdocs-material from 9.1.21 to 9.4.7. PR [#10545](https://github.com/tiangolo/fastapi/pull/10545) by [@dependabot[bot]](https://github.com/apps/dependabot).

From 7702c5af361606fad8d031ab3e10c9b30ac2b781 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 30 Oct 2023 07:51:12 +0000
Subject: [PATCH 265/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 38462ce6d..2b1f8dc38 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* ✏️ Fix links in `docs/em/docs/async.md`. PR [#10507](https://github.com/tiangolo/fastapi/pull/10507) by [@hasnatsajid](https://github.com/hasnatsajid).
 * ✏️ Fix typo in `docs/em/docs/index.md`, Python 3.8. PR [#10521](https://github.com/tiangolo/fastapi/pull/10521) by [@kerriop](https://github.com/kerriop).
 * ⬆ Bump pillow from 9.5.0 to 10.1.0. PR [#10446](https://github.com/tiangolo/fastapi/pull/10446) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ Update mkdocs-material requirement from <9.0.0,>=8.1.4 to >=8.1.4,<10.0.0. PR [#5862](https://github.com/tiangolo/fastapi/pull/5862) by [@dependabot[bot]](https://github.com/apps/dependabot).

From e7204ac7bf01ecc39cc37ef28fda3406a24a2ed8 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 30 Oct 2023 07:52:04 +0000
Subject: [PATCH 266/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2b1f8dc38..a079bfd18 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* ✏️ Update links in `docs/en/docs/async.md` and `docs/zh/docs/async.md` to make them relative. PR [#10498](https://github.com/tiangolo/fastapi/pull/10498) by [@hasnatsajid](https://github.com/hasnatsajid).
 * ✏️ Fix links in `docs/em/docs/async.md`. PR [#10507](https://github.com/tiangolo/fastapi/pull/10507) by [@hasnatsajid](https://github.com/hasnatsajid).
 * ✏️ Fix typo in `docs/em/docs/index.md`, Python 3.8. PR [#10521](https://github.com/tiangolo/fastapi/pull/10521) by [@kerriop](https://github.com/kerriop).
 * ⬆ Bump pillow from 9.5.0 to 10.1.0. PR [#10446](https://github.com/tiangolo/fastapi/pull/10446) by [@dependabot[bot]](https://github.com/apps/dependabot).

From 759378d67ff73da99a3f096aff42fc50ac900e61 Mon Sep 17 00:00:00 2001
From: Koke <31826970+White-Mask@users.noreply.github.com>
Date: Mon, 30 Oct 2023 05:00:16 -0300
Subject: [PATCH 267/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Update=20Pydantic?=
 =?UTF-8?q?=20links=20to=20dotenv=20support=20(#10511)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/em/docs/advanced/settings.md | 2 +-
 docs/en/docs/advanced/settings.md | 2 +-
 docs/zh/docs/advanced/settings.md | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/em/docs/advanced/settings.md b/docs/em/docs/advanced/settings.md
index cc7a08bab..2ebe8ffcb 100644
--- a/docs/em/docs/advanced/settings.md
+++ b/docs/em/docs/advanced/settings.md
@@ -254,7 +254,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp" uvicorn main:app
 
     ✋️ 🇨🇻 📁 🚫 🤙 ✔️ ✔️ 👈 ☑ 📁.
 
-Pydantic ✔️ 🐕‍🦺 👂 ⚪️➡️ 👉 🆎 📁 ⚙️ 🔢 🗃. 👆 💪 ✍ 🌖 <a href="https://pydantic-docs.helpmanual.io/usage/settings/#dotenv-env-support" class="external-link" target="_blank">Pydantic ⚒: 🇨🇻 (.🇨🇻) 🐕‍🦺</a>.
+Pydantic ✔️ 🐕‍🦺 👂 ⚪️➡️ 👉 🆎 📁 ⚙️ 🔢 🗃. 👆 💪 ✍ 🌖 <a href="https://docs.pydantic.dev/latest/concepts/pydantic_settings/#dotenv-env-support" class="external-link" target="_blank">Pydantic ⚒: 🇨🇻 (.🇨🇻) 🐕‍🦺</a>.
 
 !!! tip
     👉 👷, 👆 💪 `pip install python-dotenv`.
diff --git a/docs/en/docs/advanced/settings.md b/docs/en/docs/advanced/settings.md
index 32df90006..f6db8d2b1 100644
--- a/docs/en/docs/advanced/settings.md
+++ b/docs/en/docs/advanced/settings.md
@@ -326,7 +326,7 @@ This practice is common enough that it has a name, these environment variables a
 
     But a dotenv file doesn't really have to have that exact filename.
 
-Pydantic has support for reading from these types of files using an external library. You can read more at <a href="https://pydantic-docs.helpmanual.io/usage/settings/#dotenv-env-support" class="external-link" target="_blank">Pydantic Settings: Dotenv (.env) support</a>.
+Pydantic has support for reading from these types of files using an external library. You can read more at <a href="https://docs.pydantic.dev/latest/concepts/pydantic_settings/#dotenv-env-support" class="external-link" target="_blank">Pydantic Settings: Dotenv (.env) support</a>.
 
 !!! tip
     For this to work, you need to `pip install python-dotenv`.
diff --git a/docs/zh/docs/advanced/settings.md b/docs/zh/docs/advanced/settings.md
index 93e48a610..76070fb7f 100644
--- a/docs/zh/docs/advanced/settings.md
+++ b/docs/zh/docs/advanced/settings.md
@@ -289,7 +289,7 @@ $ ADMIN_EMAIL="deadpool@example.com" APP_NAME="ChimichangApp"uvicorn main:app
 
     但是，dotenv 文件实际上不一定要具有确切的文件名。
 
-Pydantic 支持使用外部库从这些类型的文件中读取。您可以在<a href="https://pydantic-docs.helpmanual.io/usage/settings/#dotenv-env-support" class="external-link" target="_blank">Pydantic 设置: Dotenv (.env) 支持</a>中阅读更多相关信息。
+Pydantic 支持使用外部库从这些类型的文件中读取。您可以在<a href="https://docs.pydantic.dev/latest/concepts/pydantic_settings/#dotenv-env-support" class="external-link" target="_blank">Pydantic 设置: Dotenv (.env) 支持</a>中阅读更多相关信息。
 
 !!! tip
     要使其工作，您需要执行 `pip install python-dotenv`。

From e4b21c6eab7cd58caf3c6c492ea1ce7945425dd1 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 30 Oct 2023 08:08:48 +0000
Subject: [PATCH 268/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index a079bfd18..57fb5ac2f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* ✏️ Update Pydantic links to dotenv support. PR [#10511](https://github.com/tiangolo/fastapi/pull/10511) by [@White-Mask](https://github.com/White-Mask).
 * ✏️ Update links in `docs/en/docs/async.md` and `docs/zh/docs/async.md` to make them relative. PR [#10498](https://github.com/tiangolo/fastapi/pull/10498) by [@hasnatsajid](https://github.com/hasnatsajid).
 * ✏️ Fix links in `docs/em/docs/async.md`. PR [#10507](https://github.com/tiangolo/fastapi/pull/10507) by [@hasnatsajid](https://github.com/hasnatsajid).
 * ✏️ Fix typo in `docs/em/docs/index.md`, Python 3.8. PR [#10521](https://github.com/tiangolo/fastapi/pull/10521) by [@kerriop](https://github.com/kerriop).

From 758a8f29e1c5b11a44499d23f003d61febb6e617 Mon Sep 17 00:00:00 2001
From: Alejandra Klachquin <aklachquin@gmail.com>
Date: Mon, 30 Oct 2023 06:58:58 -0300
Subject: [PATCH 269/317] =?UTF-8?q?=F0=9F=93=8C=20Pin=20Swagger=20UI=20ver?=
 =?UTF-8?q?sion=20to=205.9.0=20temporarily=20to=20handle=20a=20bug=20crash?=
 =?UTF-8?q?ing=20it=20in=205.9.1=20(#10529)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
 docs/en/docs/how-to/custom-docs-ui-assets.md                | 4 ++--
 docs_src/custom_docs_ui/tutorial001.py                      | 4 ++--
 fastapi/openapi/docs.py                                     | 4 ++--
 tests/test_tutorial/test_custom_docs_ui/test_tutorial001.py | 6 ++++--
 4 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/docs/en/docs/how-to/custom-docs-ui-assets.md b/docs/en/docs/how-to/custom-docs-ui-assets.md
index f26324869..9726be2c7 100644
--- a/docs/en/docs/how-to/custom-docs-ui-assets.md
+++ b/docs/en/docs/how-to/custom-docs-ui-assets.md
@@ -96,8 +96,8 @@ You can probably right-click each link and select an option similar to `Save lin
 
 **Swagger UI** uses the files:
 
-* <a href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui-bundle.js" class="external-link" target="_blank">`swagger-ui-bundle.js`</a>
-* <a href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui.css" class="external-link" target="_blank">`swagger-ui.css`</a>
+* <a href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.9.0/swagger-ui-bundle.js" class="external-link" target="_blank">`swagger-ui-bundle.js`</a>
+* <a href="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.9.0/swagger-ui.css" class="external-link" target="_blank">`swagger-ui.css`</a>
 
 And **ReDoc** uses the file:
 
diff --git a/docs_src/custom_docs_ui/tutorial001.py b/docs_src/custom_docs_ui/tutorial001.py
index f7ceb0c2f..4384433e3 100644
--- a/docs_src/custom_docs_ui/tutorial001.py
+++ b/docs_src/custom_docs_ui/tutorial001.py
@@ -14,8 +14,8 @@ async def custom_swagger_ui_html():
         openapi_url=app.openapi_url,
         title=app.title + " - Swagger UI",
         oauth2_redirect_url=app.swagger_ui_oauth2_redirect_url,
-        swagger_js_url="https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js",
-        swagger_css_url="https://unpkg.com/swagger-ui-dist@5/swagger-ui.css",
+        swagger_js_url="https://unpkg.com/swagger-ui-dist@5.9.0/swagger-ui-bundle.js",
+        swagger_css_url="https://unpkg.com/swagger-ui-dist@5.9.0/swagger-ui.css",
     )
 
 
diff --git a/fastapi/openapi/docs.py b/fastapi/openapi/docs.py
index 8cf0d17a1..69473d19c 100644
--- a/fastapi/openapi/docs.py
+++ b/fastapi/openapi/docs.py
@@ -53,7 +53,7 @@ def get_swagger_ui_html(
             It is normally set to a CDN URL.
             """
         ),
-    ] = "https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui-bundle.js",
+    ] = "https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.9.0/swagger-ui-bundle.js",
     swagger_css_url: Annotated[
         str,
         Doc(
@@ -63,7 +63,7 @@ def get_swagger_ui_html(
             It is normally set to a CDN URL.
             """
         ),
-    ] = "https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui.css",
+    ] = "https://cdn.jsdelivr.net/npm/swagger-ui-dist@5.9.0/swagger-ui.css",
     swagger_favicon_url: Annotated[
         str,
         Doc(
diff --git a/tests/test_tutorial/test_custom_docs_ui/test_tutorial001.py b/tests/test_tutorial/test_custom_docs_ui/test_tutorial001.py
index aff070d74..34a18b12c 100644
--- a/tests/test_tutorial/test_custom_docs_ui/test_tutorial001.py
+++ b/tests/test_tutorial/test_custom_docs_ui/test_tutorial001.py
@@ -20,8 +20,10 @@ def client():
 def test_swagger_ui_html(client: TestClient):
     response = client.get("/docs")
     assert response.status_code == 200, response.text
-    assert "https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js" in response.text
-    assert "https://unpkg.com/swagger-ui-dist@5/swagger-ui.css" in response.text
+    assert (
+        "https://unpkg.com/swagger-ui-dist@5.9.0/swagger-ui-bundle.js" in response.text
+    )
+    assert "https://unpkg.com/swagger-ui-dist@5.9.0/swagger-ui.css" in response.text
 
 
 def test_swagger_ui_oauth2_redirect_html(client: TestClient):

From 0f1ddf5f69187f7f7666ffc7b58a0010d21e3289 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 30 Oct 2023 09:59:37 +0000
Subject: [PATCH 270/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 57fb5ac2f..5565d362a 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* 📌 Pin Swagger UI version to 5.9.0 temporarily to handle a bug crashing it in 5.9.1. PR [#10529](https://github.com/tiangolo/fastapi/pull/10529) by [@alejandraklachquin](https://github.com/alejandraklachquin).
 * ✏️ Update Pydantic links to dotenv support. PR [#10511](https://github.com/tiangolo/fastapi/pull/10511) by [@White-Mask](https://github.com/White-Mask).
 * ✏️ Update links in `docs/en/docs/async.md` and `docs/zh/docs/async.md` to make them relative. PR [#10498](https://github.com/tiangolo/fastapi/pull/10498) by [@hasnatsajid](https://github.com/hasnatsajid).
 * ✏️ Fix links in `docs/em/docs/async.md`. PR [#10507](https://github.com/tiangolo/fastapi/pull/10507) by [@hasnatsajid](https://github.com/hasnatsajid).

From 6c53ddd084185c40f9ff960747ba1c9b5e2ce094 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Mon, 30 Oct 2023 14:04:14 +0400
Subject: [PATCH 271/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 28 +++++++++++++++++++---------
 1 file changed, 19 insertions(+), 9 deletions(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 5565d362a..a52973f6f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,7 +7,25 @@ hide:
 
 ## Latest Changes
 
+### Fixes
+
 * 📌 Pin Swagger UI version to 5.9.0 temporarily to handle a bug crashing it in 5.9.1. PR [#10529](https://github.com/tiangolo/fastapi/pull/10529) by [@alejandraklachquin](https://github.com/alejandraklachquin).
+    * This is not really a bug in FastAPI but in Swagger UI, nevertheless pinning the version will work while a soulution is found on the [Swagger UI side](https://github.com/swagger-api/swagger-ui/issues/9337).
+
+### Docs
+
+* 📝 Update data structure and render for external-links. PR [#10495](https://github.com/tiangolo/fastapi/pull/10495) by [@tiangolo](https://github.com/tiangolo).
+* ✏️ Fix link to SPDX license identifier in `docs/en/docs/tutorial/metadata.md`. PR [#10433](https://github.com/tiangolo/fastapi/pull/10433) by [@worldworm](https://github.com/worldworm).
+* 📝 Update example validation error from Pydantic v1 to match Pydantic v2 in `docs/en/docs/tutorial/path-params.md`. PR [#10043](https://github.com/tiangolo/fastapi/pull/10043) by [@giuliowaitforitdavide](https://github.com/giuliowaitforitdavide).
+* ✏️ Fix typos in emoji docs and in some source examples. PR [#10438](https://github.com/tiangolo/fastapi/pull/10438) by [@afuetterer](https://github.com/afuetterer).
+* ✏️ Fix typo in `docs/en/docs/reference/dependencies.md`. PR [#10465](https://github.com/tiangolo/fastapi/pull/10465) by [@suravshresth](https://github.com/suravshresth).
+* ✏️ Fix typos and rewordings in `docs/en/docs/tutorial/body-nested-models.md`. PR [#10468](https://github.com/tiangolo/fastapi/pull/10468) by [@yogabonito](https://github.com/yogabonito).
+* 📝 Update docs, remove references to removed `pydantic.Required` in `docs/en/docs/tutorial/query-params-str-validations.md`. PR [#10469](https://github.com/tiangolo/fastapi/pull/10469) by [@yogabonito](https://github.com/yogabonito).
+* ✏️ Fix typo in `docs/en/docs/reference/index.md`. PR [#10467](https://github.com/tiangolo/fastapi/pull/10467) by [@tarsil](https://github.com/tarsil).
+* 🔥 Remove unnecessary duplicated docstrings. PR [#10484](https://github.com/tiangolo/fastapi/pull/10484) by [@tiangolo](https://github.com/tiangolo).
+
+### Internal
+
 * ✏️ Update Pydantic links to dotenv support. PR [#10511](https://github.com/tiangolo/fastapi/pull/10511) by [@White-Mask](https://github.com/White-Mask).
 * ✏️ Update links in `docs/en/docs/async.md` and `docs/zh/docs/async.md` to make them relative. PR [#10498](https://github.com/tiangolo/fastapi/pull/10498) by [@hasnatsajid](https://github.com/hasnatsajid).
 * ✏️ Fix links in `docs/em/docs/async.md`. PR [#10507](https://github.com/tiangolo/fastapi/pull/10507) by [@hasnatsajid](https://github.com/hasnatsajid).
@@ -19,17 +37,9 @@ hide:
 * 🔧 Update sponsors badges, Databento. PR [#10519](https://github.com/tiangolo/fastapi/pull/10519) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Adopt Ruff format. PR [#10517](https://github.com/tiangolo/fastapi/pull/10517) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Add `CITATION.cff` file for academic citations. PR [#10496](https://github.com/tiangolo/fastapi/pull/10496) by [@tiangolo](https://github.com/tiangolo).
-* 📝 Update data structure and render for external-links. PR [#10495](https://github.com/tiangolo/fastapi/pull/10495) by [@tiangolo](https://github.com/tiangolo).
 * 🐛 Fix overriding MKDocs theme lang in hook. PR [#10490](https://github.com/tiangolo/fastapi/pull/10490) by [@tiangolo](https://github.com/tiangolo).
-* ✏️ Fix link to SPDX license identifier in `docs/en/docs/tutorial/metadata.md`. PR [#10433](https://github.com/tiangolo/fastapi/pull/10433) by [@worldworm](https://github.com/worldworm).
-* 📝 Update example validation error from Pydantic v1 to match Pydantic v2 in `docs/en/docs/tutorial/path-params.md`. PR [#10043](https://github.com/tiangolo/fastapi/pull/10043) by [@giuliowaitforitdavide](https://github.com/giuliowaitforitdavide).
-* ✏️ Fix typos in emoji docs and in some source examples. PR [#10438](https://github.com/tiangolo/fastapi/pull/10438) by [@afuetterer](https://github.com/afuetterer).
-* ✏️ Fix typo in `docs/en/docs/reference/dependencies.md`. PR [#10465](https://github.com/tiangolo/fastapi/pull/10465) by [@suravshresth](https://github.com/suravshresth).
-* ✏️ Fix typos and rewordings in `docs/en/docs/tutorial/body-nested-models.md`. PR [#10468](https://github.com/tiangolo/fastapi/pull/10468) by [@yogabonito](https://github.com/yogabonito).
-* 📝 Update docs, remove references to removed `pydantic.Required` in `docs/en/docs/tutorial/query-params-str-validations.md`. PR [#10469](https://github.com/tiangolo/fastapi/pull/10469) by [@yogabonito](https://github.com/yogabonito).
-* ✏️ Fix typo in `docs/en/docs/reference/index.md`. PR [#10467](https://github.com/tiangolo/fastapi/pull/10467) by [@tarsil](https://github.com/tarsil).
 * 🔥 Drop/close Gitter chat. Questions should go to GitHub Discussions, free conversations to Discord.. PR [#10485](https://github.com/tiangolo/fastapi/pull/10485) by [@tiangolo](https://github.com/tiangolo).
-* 🔥 Remove unnecessary duplicated docstrings. PR [#10484](https://github.com/tiangolo/fastapi/pull/10484) by [@tiangolo](https://github.com/tiangolo).
+
 ## 0.104.0
 
 ## Features

From 7e5afe2cb9bf1fa30c04a4dd393ea397a46db29b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Mon, 30 Oct 2023 14:04:54 +0400
Subject: [PATCH 272/317] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.10?=
 =?UTF-8?q?4.1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 3 +++
 fastapi/__init__.py           | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index a52973f6f..3f05787fd 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,9 @@ hide:
 
 ## Latest Changes
 
+
+## 0.104.1
+
 ### Fixes
 
 * 📌 Pin Swagger UI version to 5.9.0 temporarily to handle a bug crashing it in 5.9.1. PR [#10529](https://github.com/tiangolo/fastapi/pull/10529) by [@alejandraklachquin](https://github.com/alejandraklachquin).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index 4fdb155c2..c81f09b27 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.104.0"
+__version__ = "0.104.1"
 
 from starlette import status as status
 

From 1c25e2d8dc99331290e99e17814ec4d83adce725 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Mon, 30 Oct 2023 15:12:57 +0400
Subject: [PATCH 273/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 3f05787fd..fee5b1080 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,7 +13,7 @@ hide:
 ### Fixes
 
 * 📌 Pin Swagger UI version to 5.9.0 temporarily to handle a bug crashing it in 5.9.1. PR [#10529](https://github.com/tiangolo/fastapi/pull/10529) by [@alejandraklachquin](https://github.com/alejandraklachquin).
-    * This is not really a bug in FastAPI but in Swagger UI, nevertheless pinning the version will work while a soulution is found on the [Swagger UI side](https://github.com/swagger-api/swagger-ui/issues/9337).
+    * This is not really a bug in FastAPI but in Swagger UI, nevertheless pinning the version will work while a solution is found on the [Swagger UI side](https://github.com/swagger-api/swagger-ui/issues/9337).
 
 ### Docs
 

From 4f89886b0030f7f0bb1bdb363b7c50ad96445a03 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 4 Nov 2023 05:52:42 +0400
Subject: [PATCH 274/317] =?UTF-8?q?=F0=9F=91=B7=20Upgrade=20latest-changes?=
 =?UTF-8?q?=20GitHub=20Action=20(#10587)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/workflows/latest-changes.yml | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/latest-changes.yml b/.github/workflows/latest-changes.yml
index ffec5ee5e..b9b550d5e 100644
--- a/.github/workflows/latest-changes.yml
+++ b/.github/workflows/latest-changes.yml
@@ -34,9 +34,12 @@ jobs:
         if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.debug_enabled == 'true' }}
         with:
           limit-access-to-actor: true
-      - uses: docker://tiangolo/latest-changes:0.0.3
+      - uses: docker://tiangolo/latest-changes:0.2.0
+      # - uses: tiangolo/latest-changes@main
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           latest_changes_file: docs/en/docs/release-notes.md
-          latest_changes_header: '## Latest Changes\n\n'
+          latest_changes_header: '## Latest Changes'
+          end_regex: '^## '
           debug_logs: true
+          label_header_prefix: '### '

From 46335068d2130839ca64a0484dd5b0ff2eeda818 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 4 Nov 2023 01:53:13 +0000
Subject: [PATCH 275/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index fee5b1080..b0c13f5af 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,7 @@ hide:
 
 ## Latest Changes
 
+* 👷 Upgrade latest-changes GitHub Action. PR [#10587](https://github.com/tiangolo/fastapi/pull/10587) by [@tiangolo](https://github.com/tiangolo).
 
 ## 0.104.1
 

From b04d07c9339b3ac3b1cf72724231982c318c2907 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 4 Nov 2023 06:02:18 +0400
Subject: [PATCH 276/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
 =?UTF-8?q?,=20move=20and=20check=20latest-changes=20(#10588)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b0c13f5af..186d2117c 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
 
 ## Latest Changes
 
+### Internal
+
 * 👷 Upgrade latest-changes GitHub Action. PR [#10587](https://github.com/tiangolo/fastapi/pull/10587) by [@tiangolo](https://github.com/tiangolo).
 
 ## 0.104.1

From 480620372a662aa9025c47410fbc90a255b2fc94 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 4 Nov 2023 02:03:01 +0000
Subject: [PATCH 277/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 186d2117c..b62656982 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Internal
 
+* 📝 Update release notes, move and check latest-changes. PR [#10588](https://github.com/tiangolo/fastapi/pull/10588) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Upgrade latest-changes GitHub Action. PR [#10587](https://github.com/tiangolo/fastapi/pull/10587) by [@tiangolo](https://github.com/tiangolo).
 
 ## 0.104.1

From 781984b22651d04a33a260d981d59da53fd950f6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 18 Nov 2023 14:38:01 +0100
Subject: [PATCH 278/317] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors,=20add?=
 =?UTF-8?q?=20Reflex=20(#10676)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                                   |   1 +
 docs/en/data/sponsors.yml                   |   3 +++
 docs/en/data/sponsors_badge.yml             |   1 +
 docs/en/docs/img/sponsors/reflex-banner.png | Bin 0 -> 8143 bytes
 docs/en/docs/img/sponsors/reflex.png        | Bin 0 -> 11293 bytes
 docs/en/overrides/main.html                 |   6 ++++++
 6 files changed, 11 insertions(+)
 create mode 100644 docs/en/docs/img/sponsors/reflex-banner.png
 create mode 100644 docs/en/docs/img/sponsors/reflex.png

diff --git a/README.md b/README.md
index aeb29b587..06c0c4452 100644
--- a/README.md
+++ b/README.md
@@ -51,6 +51,7 @@ The key features are:
 <a href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=main-badge" target="_blank" title="Fern | SDKs and API docs"><img src="https://fastapi.tiangolo.com/img/sponsors/fern.svg"></a>
 <a href="https://www.porter.run" target="_blank" title="Deploy FastAPI on AWS with a few clicks"><img src="https://fastapi.tiangolo.com/img/sponsors/porter.png"></a>
 <a href="https://bump.sh/fastapi?utm_source=fastapi&utm_medium=referral&utm_campaign=sponsor" target="_blank" title="Automate FastAPI documentation generation with Bump.sh"><img src="https://fastapi.tiangolo.com/img/sponsors/bump-sh.svg"></a>
+<a href="https://reflex.dev" target="_blank" title="Reflex"><img src="https://fastapi.tiangolo.com/img/sponsors/reflex.png"></a>
 <a href="https://www.deta.sh/?ref=fastapi" target="_blank" title="The launchpad for all your (team's) ideas"><img src="https://fastapi.tiangolo.com/img/sponsors/deta.svg"></a>
 <a href="https://training.talkpython.fm/fastapi-courses" target="_blank" title="FastAPI video courses on demand from people you trust"><img src="https://fastapi.tiangolo.com/img/sponsors/talkpython.png"></a>
 <a href="https://testdriven.io/courses/tdd-fastapi/" target="_blank" title="Learn to build high-quality web apps with best practices"><img src="https://fastapi.tiangolo.com/img/sponsors/testdriven.svg"></a>
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index dac47d2f0..f2e07cbd8 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -14,6 +14,9 @@ gold:
   - url: https://bump.sh/fastapi?utm_source=fastapi&utm_medium=referral&utm_campaign=sponsor
     title: Automate FastAPI documentation generation with Bump.sh
     img: https://fastapi.tiangolo.com/img/sponsors/bump-sh.svg
+  - url: https://reflex.dev
+    title: Reflex
+    img: https://fastapi.tiangolo.com/img/sponsors/reflex.png
 silver:
   - url: https://www.deta.sh/?ref=fastapi
     title: The launchpad for all your (team's) ideas
diff --git a/docs/en/data/sponsors_badge.yml b/docs/en/data/sponsors_badge.yml
index acbcc2205..43b69bf00 100644
--- a/docs/en/data/sponsors_badge.yml
+++ b/docs/en/data/sponsors_badge.yml
@@ -21,3 +21,4 @@ logins:
   - fern-api
   - ndimares
   - svixhq
+  - Alek99
diff --git a/docs/en/docs/img/sponsors/reflex-banner.png b/docs/en/docs/img/sponsors/reflex-banner.png
new file mode 100644
index 0000000000000000000000000000000000000000..3095c3a7b40906a8f6476c97370d03f95470e461
GIT binary patch
literal 8143
zcmV;=A28sFP)<h;3K|Lk000e1NJLTq00C$K001Zm1^@s6)5>5C00009a7bBm000XU
z000XU0RWnu7ytkPKxsomP;*c-LjVAHoMT{Me2|lzTg;-sz>u3)QWWIwq!1AqrNI7(
zftf*sfs=ucK{heDxWG5qErbCGiWAF=lS_(n7*N2sYYdDa`m%0DVqS_|`yBVC^Ro|%
z<y$7Kb1ju)zz?`mQj3#;^dBHrNiHZVVPIecx`siiyrclcb^)?Qk~0!hfb0k$Tc-%<
zKp?vXB%Tgo&j7KLAnY|Dc2P)>Gmw1%$W};4VkaT7b8||Qp>6=Vo+mXgG#E&80I>{1
zF+%`@F@rM>HEdut&Om6upa=>t^l&InGd6<g;&EbNV7>SM|7TSO2KLDe41Xv5|Nnd8
z|NsB|7#NsmF)$nuLFjM3&%j{2AH+h4c>(zw&4IzR6(Oc!!N4HM#lUc)q9Cy-5iG<E
z#7t?K3=E%^GcfQ*GB5~V0P2Yb067L+F2Mqoz5oCK1ZP1_K>z@;j|==^1pojZB}qg<
zRCodHU1^XU#g%^5-E$w3KtcyILI#OoF|vi^a5z>H;QhfNy!coynYF#<w!Iw2Ha5cG
z!5}c0OA`3t^m+{fWP^|8^bZ>(Hi%eDBGwo$$F7A&Xhyf@*35Kw?)&nn&Z@5NuI{d$
z=@EL0QdebVzI=Io`RdE88iy=7ht7#VxaZ&hAy(s@7?0B=I@l#mWl5RI4-OGjF@b7_
zDw;)g%At<s3aTPzod-#bs;A0qTVh3|OQ*&DzWu{5KYa8(f9jwPw>XYDdG*zIkNEh<
z=lm*>h%d=XU0{Svr~y>ss2`UyMv!Ubc1NtR+U+ZpRd81_cl_u2TKKLfh)ftujiKet
z?k256V=4y@j6VLx8=YTYym;<TTuYGe=;(+oTsZq44>$|!@QKKOyShYJzrq(*AlaCg
zv5ZVb`6{TOJ!LA4Or6McL@b4}68?@QgpLq&uCK>=^oSCVif0hjVcSuv2pX5N)YsR1
ze!)lP{OT0yNFaMTKkV4ibJ`KpT3-lb?}U&Nj2)Nqm62)W_C}~M5>;c^AR<%@M**z#
ztQ=p;@g-s+&3Qr%^n+J+?-@Mp$RnFyk{)zZQ~k-gA{IS+j+YcU)tBrYlp=*@`Vv%(
zr!9rljgOMzv&dv+W$5vC&7s5HsD2|W(}Th~US%t&V7(ub(xfI%3-K%6=#i0Bys6Rk
z6DAHIS1x+_QYPq)w+$6hSK&qw1@Bs(ukiQuvFjmaPq2q%d_{<&o5694BeNYRHbrng
z0B9#Qnv9zatG4~C8IY?1j3ZPQiJA&FKsX>4IU-iJr<bht0|31C6ltz=MkMmCvxby(
zT2No#0ZOG(lpIx?Ardt)ipOKr*jPt3?3xxW?p!WdzsjT7wL>A&(gr6M4y@D3bd2LU
z(u1zrT|Lzb$_JTuT&*6R2y;gild^nci`H<E0I$e-QHGvKBa;N?o!vc@NW>`?cNh>I
z21JLFgGm}0P4T@xYCq~QEW{P1SIzZ;Qlo-mF+p|ptk=l^Eq-m#6`BsSe+56WjSMr=
zCfTk;4uH0TlOipz5~>#Zs4C=;mt0XL)k;z12V%WAC#CWP+`$aMQGsl=%3%L6O`hCH
zhfiyv-kw43E&^16>_1H7(jWu%t{n=bixq&g<D{vk&I`^)gb-QRh-1PL9l$<vfW7dP
zkP}Fj*eaCQ3=bL+d#RATy5ThnE3;>}Q9B=y&aK;MD<An}@#0T}%18KgLvN?njj-7|
zJeL$I!=y>Abi(}OWky>&eY)GTb-(e(o7B_On^lHt0m5o~+zt=Kxl%=ASS7u<v63vX
z{Xo9a<CPdw2%sMh92k{!LLAgaOaURhYE;tD;0To>sZ^Q)HgjzN*ne(c2Z46HhV2_<
zUGV}`ODqPjT}X<9(Yhcha@IedPhsWSZ(mK{{?66%{PrK*OKaEuGH?7nd$-760Pb05
zonKHl4#*R%_m11|mFM@}e<uU<*?H4`x`6KG%g?4Y_uZ*<KhC=E(7HKn_VR4qU--hM
zE{N~ivxQ2QG6z=J<b8dE)X&GvSyM|>P=tuAs{r=VvrreU5q*6FT-G6);V)~DR2i^|
ztdn9ARbINfc2je61GTg?Q8h{Hq<U`iVHz45p<3peV+?Y!nCfEy?|4ETr3iq%vANC@
z2EbLEbed{w6Iu7{Un8(*csR*mUziJLU!7udJrcyqAqgds>_`$+w4!(3-bznC{z6vr
z?b~<LLqB~wl#YAv`UQRMvXv#}pG!p6VOF>;;1$|C_H0|T<CHIcJ05=E*Yr=HzJ^};
z<HlTuMpFK;;>l9vKgzM|op-j<BM&~~IW}+lD-|p2U*1U1|Ht~QaDekUpSgxMyu2xl
zn!ME>c!=WaYJh2tT|4_|@16k~K9HpPhFa#BYk6TXK{4sYnz)*3pcs3@Lh{k?ckY+o
zw!d5Y?SMeHTPCdwRK=G6+e`oZ&R*(zzgN;Ixq#W0;o(s#C~3)YI0>d{sH;02dQlQI
zz_K$>%?gJnxxuCo0_;ONr1y&mNCLWI@sdwu#hrh`@l>?<Y>{PHmR$y$rtl{(YaEx6
z*d%@Xtu6G>1JBU8pFiDmf78Y{={X)q7hm?d+=(L;;W_ia&Mb0x#nBiNN{f!PaM5wp
z-#<w6jy<X(^^hamfQzw}ci(=G9(m{)F86HqavQ0e0TtI*e*FSE_x#ferZ=XqX8`W%
z+C`^-YH45u17a1Ckb2+WwvPt-M&!<nc#Xrq3HD^wjty|U38oRSAcudTJ_v`S787@L
z^-_{)iyhs)G=D)GQy{VIeD!sj3p$!gWl<Taw2*phIBh>q6n*TyA9i>n9}OzGTpYAU
zj0@~(wG$-fg<a2844!@mFA{QSY)AMm1#knM;Fq;b32Z39@m_w}g%WhbWCq^X&<!O^
zj*L)-e7gOBTvR{I6Zt)!ZAV6uG<(ir{D_k%N<}k2PJ*I<bg|dmwS5;Y{Mg^g$M}}!
zCQl;7dxr-qz^SFBF)$B!LZAVT1%QRL!Gyw_$Kania~kCWW9WXD<DIzZ?*cXDyN`PS
z7HFE6!@fd|vh?Id^2jCqoX2*~W7f>6vTnnO@SVK#&U;opL@Tm>*c+ZZZ+1yk!mYPo
zEvYP+dgWJcrKg^Fk<K~qw9s6&>1(;-A{ccDkNw1j*=>k>UERCo`Mi0-ZD``moDsea
zjP&*%;6=evuK#*U)G8`N9?TrX90j%jL6Jm}6_5f@;Z?))ZD^{Izr({R+Q|!tvyLqA
zZMXnF8JX177#c<8*Ry|!`q;K9hc!}5Yi*z^<g1kUvhYNL2i*~#gAO*jsMzIuq7_gc
znLQyC)i>5Ku=dh^Zp6c<HPMl6lc}~YL16?y0Kvd{_<^VC+25_Fr+;^k9LUWU2;Xwk
z1M*&r1oQ#A_|nhOMVEfoqw66~|1f*w5O`Ym|MYr~j;uoIALM=Aw^p&&t{$187vB4_
zGncyOx7_p~UG<F%Xw_Yh$v86^0Pp+Bbqp5MXfvn#+U2*=dCO0eaiI_QZ@cp<7l;8Q
zk7(OWxv#wD0y-%V*xGUhgVCmq|Knc&@;7(OJdB*pkLNQOP`lYX#6$<V{>Dpa8GDL;
z0M4b~q~E+r<#XZ1pQQ^g`K)^%vgXGt<nQy(uBVmXe~{KabGHOc+&AgY;Ch2?>z;g3
zmUG>&@0Q`K?|Dqt114A0k*z<=H2)wE@Nk<kfs-mLz`Bp0EFS&&EpD1yZ+?(oXBy-w
zw(-iZX6%D3{lpjL?}-bKqt!oJ;f7=KSaa`Va!q3fmtoD1u9Nj*%Dh_NgZS@5C&~`$
z1rss)-mSM^6$tdX<iOylbaF6$YU|?OofZ0(eEg)7Y4yv12Wq3HHZJ!^*Dz-+6pK)B
z;n0vHwl{3@!s4Uc&WHT;B#`7hckddIU_E1Ii`<9pp*)<zV1XDN9UV>r>2`KgXu+-p
zEc^wDS-e}aIM_?ZqTZ{ozLqncEuc)y0-!CRAzbRCM07<Npxd7uJ2(vWq4KyouPx`F
zpMO!(FVknV(Bvr%v~y=a_3Rs>|K7Zvrtl-tR0iuwlN<7;1;9bj>ES(Nuy6X)oATO#
z>l15Vl;8y5#=yt*D(0O}<j4Jm+EWE6;ryaMeU6^g_wjqtrJvC`Ih2bZ2B-p@?`Ob;
z=ld*Q8<6wMfBx6crI-FM7u+BLYRykpxEduGF>r!{xZ?6#Y1Q42(R~`w0PFyxi!>lT
z#kLjWq27AO)lx4wROk(oZmz#ae{qY9w~{9`@U#GoumT$4)*oIi>lk1P3ITN-24IYR
z078JG!)ZW2G&eQM`gwut6aWW62e7SwWh1S)b`>pHcwA8ch6x0Myx{4ZN$SfC_E&!O
zHVKYKAI{Cw20U*7_!=%(fByhocf+MQ^zWv1PpdZk@)vL5I`}oMxZx6+FTfezIwlsx
zTk-9C<s@JOe7~L~@QeG8q7Hu)zI<3{OMu#7dI4Y=i)AJx;I2psy@;3jO)&LQS6{<p
zrk~>2CBa=C>4y*G=Y-`$M~)pv*d+ol+JQcf5@-4%7E4Kx#?iU8ho6`yxn8!?6UHBo
zF+lSKfWm=~$tga&47mA4?tr*IKP8cCH%AaaZ_NRU*Is*dPOdnY_^Vcy;f?^n<ubSc
zjfp_#bH%@YQ%){^*|d2BwYRqwl{aSmw)V;L*t>gxwsrQ<j`#cMBa3D+(AEVfvIJf+
zKo}k?s0Ius1JKX^?iF_+0vu01Ws&qo0jh>d0I&m0Am=SVRi*(Q62^T5=z-fcy3S;;
z6X52Tr6(<tS^zL-oVkRad)B+yw19QAFi7J-TzHE{@Td#Gc;%0?<qnK<mlx(uZGqR>
ztPfKf|JYi<z=TNx2S5q{Ta3(QZ{O52KnV7uEeZiB%rN=l0(!1vP_rYTu0U%bF4}PJ
zJe3zX;bH(9AZ!HbS7@Mx4m>p(eP~mF=(*>qdTzGr4*+dHeb}<(q=jx-=FMwY6M|6m
z7n}yPE3RiSeR2A-rP|vbpr&R;Wz3yBo6j5NF?a4!w0ZMii{iAE2dkV33BV}=w?TF6
zO{bFCyf2onM|lwsV-CnH`Cp;*fKBi?xW2rE^>pstLT6}|nA|Y}NgJw#LE6!alv%cf
zDrg!mw0=<~*5_UOncz}Z5h5sm7!`y3h&D8sl#%Ni5(Oz5Gf*}&I3KG4;<=3*<UqoJ
zg8;0%y7tg59Y1x`%{#VT@q3<UUve{(1Ca+#DPptEf#wUNf6yDjifDkeUs5$q^xYdT
zmVkF1dyS^t@Gwt0Wl?@RL=NLB{F-c&YyY5k-9q?&-TyLTXe(O)mhdWXyZHe(3=`eV
zFxv$!S#41Yevn<l;0apg!izt{-uea!rT|h3uvO%sP$V$=@-&l*DVzPo1nJ}T5(CiX
ziu71hpcL?Sp4>Am9h_dK6_PHkA>4&Jp^aDGw%%%|zf6clMSnRw*MP`)_M3uIg`*T1
z4_UocsP5JCxNdH))pU!O9?>j}RUpci4$>Sn#X<uU7T9iCd1F?1XXiHQX+q$Io)NH1
z0-kaqkJHErCmc_gU4CI;c#sspH;<qUH~Y&V$n&Dh^UuFT&p-E)JcrGz*JM8({Lu2k
zSFH)Rpt*1F5Ouz{kA?<Dsg^mk8BBXjo8GKekqZcTWq7;rEEj(4c)FJ#;g8kej4p_Q
zIAhT?`tJ8G(Usv_5eldv$sx`PM<IaA#LB*{27@k8x4y<gU~`UzN|V3Ttrv;x#XWdq
zE5HAMq!E^$vS{3#hrowh9cZWo3Di0a09&fSV}|Ey(*Z>rNAO&yDbS^CkOlp)?#Y+f
zTi+lll$Ff?Mpd;zla8qm?46EEuv=r0$55R4<aA8Pog5fbBfRLRULI5)uEI}8(!N6S
z)M}g=0LM}2)o%c9N>e6TZxHJL1sSjwax6DD*N_u1q;1+o*t)VBKqb}y9p23VxGn#D
zHut*LdT9iJc1DhEY(ZP+TmywKpXIqZUQysWpR_`E0si>Ue}2=YWLDpIrzgJ23jmFY
z36d9}b%L#1_Ay}XksYG_s7W;Q$ktH6Y^1rRfnNUOM!CoauL|7{Aht|zg<5*@$C!8h
z1ufKkCA={#8s5kJukpa(;XKJ6>Pebfc$?Fo<D(IB)g`ErSMJ`JNx$~Rz<A)Qm!7;(
zf-mR_{{r9oS2nqxH2}g;E&zWlLSj1@(&O<LgBxWH+rXH>B=7pxR(bs{^RM0AyObB2
zhszc@FR}&PG0FuG^=FzML47~~u+KlYUX}~zD67Xlwg=_z>mQPKnmx+%nAX4~g>r+h
zg@?Oj=^|-6CMZx8pgsyon5Soe=o!nF(4!AOBPaExCj~#9*!D>(BiD`^OE9^vS@k&U
zewxlc_cW;kWjTXsj^+qoY-wnyrTy&e0OO2D3@;apba4rM;HHH_O~9M>mLXUiObhkO
zHQo?BY-$0!a@48v&eeS^5IS*ua9=GN2F1;MyF>m@dByC5Ru{psE9S72sJI+ZF1IjI
z<b@UA4;^zDgY)E2!0cCp0b;h#p=SWtaBVnEaLS+x9%f#+Yx{$ekHvzU0cUtHa({5|
zpnQn~vg}h!ygL~37y;ny=0(BPypZ=ObKB5;EK?}{t$Y9*ENo!`5jL6~2u1*w?tPw2
zu4nKOLV0}{;NZ2fun58Z6*pc=VP)MDFS(#%7V#jUNdTzuD&^z1E*B<>nMF(hkOh*v
z-6VkrWxqn|p6b@o2EDKcy=U_^78PCl*1klqGvC_6ZGrIHZdT=7b^i+a_z%7o^|Fp9
zLD&xc0J<>X>?uzH0f!9xuej=h!27WK2e&-Hhq4d(ue@EY70r}e6Ekg&c7xY1^XIyK
z<lk<l>%Vg^UG$|JWEk2|=A-M_P4BirLslCo|JU0r_H|=ZEluJD_x-%s4vM0IpGKu;
z3a?nw7>3qxlz*$iRNmL#Gro9-HKEB<8oinN#UaXU5Xo4Cc_F5~^_m*T^LAj+>)u|P
zBUffdIce+p*wNK@=hP!wuAw|K^{_ee7c{`8*EeL{hqrmf*A&HJzmAPC<B86ne>}Ce
zX1}QNo8LYmf3YyQ@I>`jx8Q9fJm0v1$8Kl_?7)~5pd0(04XrY5>Kyqizqt`Wl_1Y=
z@ggMhgkGZ?9(2%-jYVv$@t}9^+Ct@u$Q2qyS45gen45(K3tTI2dN6Bin^BEzc2|7m
zHd^!J>xx?NDpo|+NpynU7XbPd_TpY(=7E=0BiJc&8-wptPv5PmkQ|@(tXBJtNScB@
zVQgi?W(RD)i{mwKU7nW74HD~64ghmwV~xeNi%_2*1+c!~xsPUlNO{@@cr)MP$N+dD
zJ&^64Lo|J6YlaICkiEMG?`oUVeC?QiZWOdZF;YzDc%um2*u@dF-48Fvgw8X9o-1;N
zh@jC@e1@Xz2&IX9>KlWRT}dDgn|W0NSRRmt_x=KN&)78qZ+-fVslkh^6GY4lDiBFo
zfNC(b1OMBzYe0I+hRy)JIOmwdsVLFIad05Xo_iwihmuT~Oy)SAYojCUJ@O!M*B*4D
zqvIxC5dCJf&0}XCGI~`@k>$y!CNM-4j#+vhVQ-e0m!%V)81@slGzBjPscm;l0~eAC
z=Hof3posiI*a2bhP^h^0p7qPlS7QS>VNfRrlK`Bt#V!_4%Pn_?(!g2`sKs47`)Ti<
z;umniS=aEQ<o0cSbj-1n^HLX{bOGVe(bC!=UG9ASI<4L$WF|xir@OoF&Lav?9G%uD
zL)-1odg=}Yue4WxdJ{B;`R0ZU@AdAp_S<9c>@bvpKRieQ^qS9o<`Sa=Nw%@>d>tGV
zNvpOSWih%@mLO`TkgX!?%zD!)0vU5K_MAj7;|av$<|I_JC!R~H)K~y84t!ZoF4W1_
zy3-OUXUuAq;0!PNLq`|zpnV=K()aftpufGlQ=ZQ|?r_edxWCLYI+CW&_j+h}M9|T5
z4`-^SKJQ;v*|%F!9CEk!jvf6!oI17X8&r&x&`2e>YZ)CPip9O+lNz_jx~_-^Ug$;y
zc~y`G@t#yj#uJFE4SdJhkg>=f-__{v9hQ`adI?2Pk|_=Vb4yDdwauPV)XpggKzVd@
zly>j#r*7uChX#g~ckY<CwiOBO(jC6H1=Tw>4uf*7<em?o+9D^Bd;q<7@8F&7vzdd2
zuI{j3vzq{*JXV05H+e+pGgcn*n1FF5N9TBf@OT4oM3a6r%g@yzM@(;#$Kb$-d~*=x
z!a`tuLyf!rt=O_6ek`8gr|1UBclY-lkRLs>Uq+JO0wM3SvJ2CE6Z^KCTk53_Ob||i
zZFVA^cI3A>Fa^YR42Znel~ACPWGwQE1eEO=GCCf4tUTmO0&>MYV-a{d@$-rxqf(O|
zEZ}Slw&77k+pgu?hjDzSp@v!+<N@~Jh(Qx$BZj1lC5l^qvrwNCHJ&`a`GJWdQB$M7
zwnvn=;$!k#9C+0mk#+{eD6-W`YUBy&C2MewfJYuv4|$@2@i+kSm;lvSjH|JhiC|<n
zjv!BRN501(!8RV(i+JHgencs*K1+(Uo(00Je2hr_A_3RD>wTTsSaqICd&-f6vJQ;^
zkt*#aR|+%_3NRLx*I&Wt(Mi;Ot%@b%(NftWL7D+p#A5|Mcw|3eYv<bcm%sC+grrG*
z9Z&wz*wk=u=mH#!pgb;K@&^@=D-Fh#^oEO2T8-X#iAg53L{(nLa~=+C%kkQWhtiw}
zIA|`y&~P6mM;Wbid^6;O1Im!x-$O1<Z=o9{=1~bio`7H+x!y`UDig(qL*kKQ>so&|
zsffrK!Cvl>VVr$WNDq4Cz`nl0enCwwAhSy|sPsfdB&&p%oHfde&qRa{EM6)CoR!d9
zNieR2S1cll5_!H8o%WcJQYJqgB!#Ne$q^agJZQfDD;)JTyRL1$f0;3B67}{7=|v~P
z{S~I-EGjR0Wx(J55_gokBk1gv0HaEJn`P^+G(c2x0?CtC8Br=LmVZ*Nn(>xM@wEbA
z9ad6FqNM)g;qPtP{TeM$<~YYRe{<UJH{J9?>!gMgsTipQC|3kUf;{EYGzDKoq%%T^
z^jjFBLd`OU`o;oCssZ?mRd+D$fi6`d$K)~<_Us>e{j9~SPkpz4#V+~2;?Yx275n-|
z{`TSdZHwz0Y9{ARU5SN~$a;wBa{4@K@1Tl7xvBwq48eE|9r3DCIwl}ntw=tGUT-8>
z<x#S;yXUQ+|7`ttUf=S@TfM!nC1uo(j*i$9cMVTDP?tF2pTG3?pPv8G_64a_Ize))
zhu{TE{by)}ckdtmI)T7`J)y32s8G{#nuPr7sSx&ym1^6zBmbTN?m0RR?#1LMobc|v
z%u>;$)}I}4?a*<&wg`yB!Tg{4930NHN~FLiyxlMN>0pyqWvJ5$D_tQ`e-}a7<;XvF
zrqdhUvYd{{mBt^g(m28&M_4bGX1pHr1#(MQ&_{HY0y4FuDu&EYCR~<X+u-<Yw)%l*
z8q74IBmcg=yvpcOWie)D%79$$I=2iqmEf<OY&%R^tw$T455BGZy}E*~y(RU=F?~&0
z?6nE!c0bFKw5oHf#KLX^f8R5GA?@Ddv@u7RIJ(PQeL$#gC%?0)&rP`FPp58p>c*45
zx6X`3^3Ob3(Hz|uy?s3}tz+jGG(O1JPfTcx91DT0`g8Nm=yn|cIL>ZMyS`%i#=mLA
zv{g6y*S6nrGU?5iL}fq0wWoC6eg<`kxRd<LpWolS_GhpDwm#MH#{APa?_alWT`FVo
zIp@UZ{Qko&v6|#GkxopZ6xF*56DcP_HO!F=b9-V(UtDCu(juOSImzUx%U!3EaSls4
zl25@hBwwp4O6jr3>2Yq|Gh))2IQFk!hijj_kFULYx1pGH&<UGxTa0FOWdwiKw?>u|
z_Mj|v^)Z#k(&OeY?Kb(10{Ru3@3ULp<GOLfwSK!?vcA}MykSJ6nL04`(rCs;sf$#d
z1=R!68JkocriIBLg7#5mQo8KAPjXm7*I$rs6Q>Sst(sNpLR@LTu0PW!)On^qxJsmX
zqeQ;E5($;g)TdovZu{uG;`+Wfz3F#ow_#!HH*saXI;>Zu9Dl#F>ssZj`n8F#%B$KO
zI_<umu``q2Zgbf+^tHbax_u#`$D)a6m09&+HOA1Ux;eQm>KxT>nK4HJ=XU=v*Y-J?
z{^hGz_x#ZKuk83|<Kr<JiN$L7QnG*N?2k4K{NWGZOF53?^<MCH;wL}Z5#O?f63Hz+
zPI}fPC$_y+kp56xI^FBc<lh~!9??$i)VZybsI8r*b2!2XA9vH&wXs$)BEwrbE)mX2
zrzK8HoOU|v$9>lTt&fQBr6(z!EatpjrsKP9B=f+%F2d`U+8&ac<*#3C8z8XnJ-$X-
z=&#-0BRbpKJ@MQ!a2-saW#<Q*JGnk4$*`DJM%an)qujJ?n=F&J4yNn0=6<JD2dEe1
z-RZO6Tu;|}sm;`lu0yUHd{htZB6Z68M0h);XX&=n>5SItx{ciSkoPlf*lF5@D66fJ
z$A~YzUFRlT+HAFTTGzu-zP6V!b(u^(p+($&#CeX)GIglZw(AcHX2N^ix{&?X>X)`H
zWYxv=^l^Ayi|q2caa<ca-TJECj(Dc;H*q};2vg^#zfhZLC$<}H!v9nsQT5<&L%T1K
z)tAgY)fbyMY#^(ymEE1L9uqc|b?nAHU%6{_nL15hGWO_SWlO6-pE)%C$7cNRs!ycb
p+V-XlFw-G9B!}dX9Fppm{|Bc|9aq$DQ8xep002ovPDHLkV1h+O@}&R(

literal 0
HcmV?d00001

diff --git a/docs/en/docs/img/sponsors/reflex.png b/docs/en/docs/img/sponsors/reflex.png
new file mode 100644
index 0000000000000000000000000000000000000000..59c46a1104140e8a1778a0819b1d3743cee0176f
GIT binary patch
literal 11293
zcmV+&EaKCNP)<h;3K|Lk000e1NJLTq008g+003kN1^@s6xT3ws00009a7bBm000XU
z000XU0RWnu7ytkPKxsomP;*c-LjVAHoMT{Me2|lzTg;-sz>u3)QWWIwq!1AqrNI7(
zftf*sfs=ucK{heDxWG5qErbCGiWAF=lS_(n7*N2sYYdDa`m%0DVqS_|`yBVC^Ro|%
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
T*-t(000000NkvXXu0mjf_P{u$

literal 0
HcmV?d00001

diff --git a/docs/en/overrides/main.html b/docs/en/overrides/main.html
index 4c7f19fd4..ed08028ec 100644
--- a/docs/en/overrides/main.html
+++ b/docs/en/overrides/main.html
@@ -52,6 +52,12 @@
         <img class="sponsor-image" src="/img/sponsors/bump-sh-banner.svg" />
       </a>
     </div>
+    <div class="item">
+      <a title="Reflex" style="display: block; position: relative;" href="https://reflex.dev" target="_blank">
+        <span class="sponsor-badge">sponsor</span>
+        <img class="sponsor-image" src="/img/sponsors/reflex-banner.png" />
+      </a>
+    </div>
   </div>
 </div>
 {% endblock %}

From 81bab7761770264e5f6901d0a50fe5d79a5bffa1 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 18 Nov 2023 13:38:23 +0000
Subject: [PATCH 279/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b62656982..4b6a1967b 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Internal
 
+* 🔧 Update sponsors, add Reflex. PR [#10676](https://github.com/tiangolo/fastapi/pull/10676) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Update release notes, move and check latest-changes. PR [#10588](https://github.com/tiangolo/fastapi/pull/10588) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Upgrade latest-changes GitHub Action. PR [#10587](https://github.com/tiangolo/fastapi/pull/10587) by [@tiangolo](https://github.com/tiangolo).
 

From 71d51a99531da8489772bc295d88a0a9a452d45d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sat, 18 Nov 2023 14:47:04 +0100
Subject: [PATCH 280/317] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors,=20add?=
 =?UTF-8?q?=20Codacy=20(#10677)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                            |   1 +
 docs/en/data/sponsors.yml            |   3 +++
 docs/en/data/sponsors_badge.yml      |   1 +
 docs/en/docs/img/sponsors/codacy.png | Bin 0 -> 30480 bytes
 4 files changed, 5 insertions(+)
 create mode 100644 docs/en/docs/img/sponsors/codacy.png

diff --git a/README.md b/README.md
index 06c0c4452..655038c6f 100644
--- a/README.md
+++ b/README.md
@@ -60,6 +60,7 @@ The key features are:
 <a href="https://databento.com/" target="_blank" title="Pay as you go for market data"><img src="https://fastapi.tiangolo.com/img/sponsors/databento.svg"></a>
 <a href="https://speakeasyapi.dev?utm_source=fastapi+repo&utm_medium=github+sponsorship" target="_blank" title="SDKs for your API | Speakeasy"><img src="https://fastapi.tiangolo.com/img/sponsors/speakeasy.png"></a>
 <a href="https://www.svix.com/" target="_blank" title="Svix - Webhooks as a service"><img src="https://fastapi.tiangolo.com/img/sponsors/svix.svg"></a>
+<a href="https://www.codacy.com/?utm_source=github&utm_medium=sponsors&utm_id=pioneers" target="_blank" title="Take code reviews from hours to minutes"><img src="https://fastapi.tiangolo.com/img/sponsors/codacy.png"></a>
 
 <!-- /sponsors -->
 
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index f2e07cbd8..4f98c01a0 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -42,6 +42,9 @@ silver:
   - url: https://www.svix.com/
     title: Svix - Webhooks as a service
     img: https://fastapi.tiangolo.com/img/sponsors/svix.svg
+  - url: https://www.codacy.com/?utm_source=github&utm_medium=sponsors&utm_id=pioneers
+    title: Take code reviews from hours to minutes
+    img: https://fastapi.tiangolo.com/img/sponsors/codacy.png
 bronze:
   - url: https://www.exoflare.com/open-source/?utm_source=FastAPI&utm_campaign=open_source
     title: Biosecurity risk assessments made easy.
diff --git a/docs/en/data/sponsors_badge.yml b/docs/en/data/sponsors_badge.yml
index 43b69bf00..4078454a8 100644
--- a/docs/en/data/sponsors_badge.yml
+++ b/docs/en/data/sponsors_badge.yml
@@ -22,3 +22,4 @@ logins:
   - ndimares
   - svixhq
   - Alek99
+  - codacy
diff --git a/docs/en/docs/img/sponsors/codacy.png b/docs/en/docs/img/sponsors/codacy.png
new file mode 100644
index 0000000000000000000000000000000000000000..baa615c2a836413df2aec00ff582162c759a4aab
GIT binary patch
literal 30480
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
Z{9hD0a-~Z>ZF>L!002ovPDHLkV1i{;0#5({

literal 0
HcmV?d00001


From ac93277d3b506f4076aee1af6ae5a86406f545c6 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 18 Nov 2023 13:47:35 +0000
Subject: [PATCH 281/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 4b6a1967b..34bbab135 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Internal
 
+* 🔧 Update sponsors, add Codacy. PR [#10677](https://github.com/tiangolo/fastapi/pull/10677) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, add Reflex. PR [#10676](https://github.com/tiangolo/fastapi/pull/10676) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Update release notes, move and check latest-changes. PR [#10588](https://github.com/tiangolo/fastapi/pull/10588) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Upgrade latest-changes GitHub Action. PR [#10587](https://github.com/tiangolo/fastapi/pull/10587) by [@tiangolo](https://github.com/tiangolo).

From 1560879a8417f71d038e25532577f78b55a69b11 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 28 Nov 2023 11:52:35 +0100
Subject: [PATCH 282/317] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors,=20add?=
 =?UTF-8?q?=20Scalar=20(#10728)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                                   | 1 +
 docs/en/data/sponsors.yml                   | 3 +++
 docs/en/docs/img/sponsors/scalar-banner.svg | 1 +
 docs/en/docs/img/sponsors/scalar.svg        | 1 +
 docs/en/overrides/main.html                 | 6 ++++++
 5 files changed, 12 insertions(+)
 create mode 100644 docs/en/docs/img/sponsors/scalar-banner.svg
 create mode 100644 docs/en/docs/img/sponsors/scalar.svg

diff --git a/README.md b/README.md
index 655038c6f..b53076dcb 100644
--- a/README.md
+++ b/README.md
@@ -52,6 +52,7 @@ The key features are:
 <a href="https://www.porter.run" target="_blank" title="Deploy FastAPI on AWS with a few clicks"><img src="https://fastapi.tiangolo.com/img/sponsors/porter.png"></a>
 <a href="https://bump.sh/fastapi?utm_source=fastapi&utm_medium=referral&utm_campaign=sponsor" target="_blank" title="Automate FastAPI documentation generation with Bump.sh"><img src="https://fastapi.tiangolo.com/img/sponsors/bump-sh.svg"></a>
 <a href="https://reflex.dev" target="_blank" title="Reflex"><img src="https://fastapi.tiangolo.com/img/sponsors/reflex.png"></a>
+<a href="https://github.com/scalar/scalar/?utm_source=fastapi&utm_medium=website&utm_campaign=main-badge" target="_blank" title="Scalar: Beautiful Open-Source API References from Swagger/OpenAPI files"><img src="https://fastapi.tiangolo.com/img/sponsors/scalar.svg"></a>
 <a href="https://www.deta.sh/?ref=fastapi" target="_blank" title="The launchpad for all your (team's) ideas"><img src="https://fastapi.tiangolo.com/img/sponsors/deta.svg"></a>
 <a href="https://training.talkpython.fm/fastapi-courses" target="_blank" title="FastAPI video courses on demand from people you trust"><img src="https://fastapi.tiangolo.com/img/sponsors/talkpython.png"></a>
 <a href="https://testdriven.io/courses/tdd-fastapi/" target="_blank" title="Learn to build high-quality web apps with best practices"><img src="https://fastapi.tiangolo.com/img/sponsors/testdriven.svg"></a>
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index 4f98c01a0..1a253f649 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -17,6 +17,9 @@ gold:
   - url: https://reflex.dev
     title: Reflex
     img: https://fastapi.tiangolo.com/img/sponsors/reflex.png
+  - url: https://github.com/scalar/scalar/?utm_source=fastapi&utm_medium=website&utm_campaign=main-badge
+    title: "Scalar: Beautiful Open-Source API References from Swagger/OpenAPI files"
+    img: https://fastapi.tiangolo.com/img/sponsors/scalar.svg
 silver:
   - url: https://www.deta.sh/?ref=fastapi
     title: The launchpad for all your (team's) ideas
diff --git a/docs/en/docs/img/sponsors/scalar-banner.svg b/docs/en/docs/img/sponsors/scalar-banner.svg
new file mode 100644
index 000000000..bab74e2d7
--- /dev/null
+++ b/docs/en/docs/img/sponsors/scalar-banner.svg
@@ -0,0 +1 @@
+<svg width="300px" height="40px" viewBox="0 0 300 40" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"><defs><radialGradient cx="67.9042312%" cy="42.9553939%" fx="67.9042312%" fy="42.9553939%" r="59.2625266%" gradientTransform="matrix(.708 .502 -.411 .865 .37 -.28)" id="g"><stop stop-color="#FFF" offset="0%"/><stop stop-color="#AFAFAF" offset="100%"/></radialGradient><polygon id="c" points="8.40529079e-13 0.554129891 253.25984 8.42600936e-17 253.25984 21.7040109 228.693879 34.3251885 8.40529079e-13 38.5541299"/><rect id="a" x="0" y="0" width="300" height="40" rx="20"/><path d="M13.95 0a15.65 15.65 0 0 1 7.36 1.7l11.16.07.15-.07C34.82.6 37.23.05 39.84.05c1.92 0 3.7.27 5.37.8.84.28 1.63.62 2.38 1.02l10.75.07.5-1.51h13.78l.54 1.61 5.82.04V.48h12.91v10.25l10.68.28 2.8-8.47.67-2.06h13.79l.43 1.32 5.92.08V.53h14c2.31 0 4.41.44 6.26 1.33 1.93.94 3.47 2.32 4.56 4.11a11.74 11.74 0 0 1 1.62 6.21v.14l8.47.22c.32-1.77.88-3.39 1.7-4.84a14 14 0 0 1 5.62-5.58 15.9 15.9 0 0 1 7.63-1.86c1.92 0 3.7.27 5.37.8.59.2 1.15.42 1.7.68l11.6.03c2.14-1 4.49-1.5 7.02-1.5 2.54 0 4.91.5 7.07 1.54l7.18.02V.69h13.6l.5 1.18 7.12.02.5-1.2h13.6v31.45h-12.75v-2.29l-.07.19-.75 1.9h-8.18l-.74-1.91-.07-.18v2.3h-12.76v-1.23l-7.25-.02c-2.14 1.01-4.48 1.51-7 1.51-2.55 0-4.91-.51-7.06-1.54l-11.5-.02a15.95 15.95 0 0 1-7.12 1.57 16.1 16.1 0 0 1-7.2-1.6l-5.47-.02a6.27 6.27 0 0 1-4.32 1.69 6.36 6.36 0 0 1-3.88-1.28l-.16-.13.5.9h-14.37l-.65-1.23h-1.4v1.24h-12.92v-.06h-9.8L116 30.7l-6.13-.02-.37 1.25H78.98v-.05h-9.8l-.4-1.29h-6.1l-.39 1.3H48.46l.44-1.34h-1.76l-.82.4-.44.18c-1.79.72-3.8 1.07-6.04 1.07-2.68 0-5.15-.56-7.37-1.68l-10.73-.03c-.36.18-.72.35-1.1.5A18.05 18.05 0 0 1 14 32.1c-2.57 0-4.88-.39-6.9-1.2a11.02 11.02 0 0 1-5.21-4.15A12.28 12.28 0 0 1 0 19.87L0 16.85h2.48l-.13-.16a9.08 9.08 0 0 1-1.69-5.24v-.33A10 10 0 0 1 2.52 5.1 11.6 11.6 0 0 1 7.4 1.27 16.21 16.21 0 0 1 13.95 0Zm145.12 22.58a3.4 3.4 0 0 0-2.47 1 3.23 3.23 0 0 0-1.01 2.43c-.01.97.32 1.79 1 2.47.7.67 1.51 1 2.48 1 .6 0 1.18-.15 1.7-.46.52-.3.94-.73 1.27-1.25a3.28 3.28 0 0 0-.56-4.18c-.7-.68-1.5-1.01-2.41-1.01Z" id="e"/></defs><g fill="none" fill-rule="evenodd"><mask id="b" fill="#fff"><use xlink:href="#a"/></mask><g mask="url(#b)"><g transform="translate(23 1)"><mask id="d" fill="#fff"><use xlink:href="#c"/></mask><path d="M160.82 32.78a4.9 4.9 0 0 1-3.57-1.46 4.77 4.77 0 0 1-1.47-3.57 4.68 4.68 0 0 1 1.47-3.51 4.91 4.91 0 0 1 3.57-1.46 4.9 4.9 0 0 1 3.5 1.46 4.75 4.75 0 0 1 .8 6.05 5.4 5.4 0 0 1-1.84 1.82c-.75.45-1.57.67-2.46.67Z" fill="#2C328B" fill-rule="nonzero" mask="url(#d)"/><g mask="url(#d)"><g transform="rotate(-1.5 243.78 -22.04)"><mask id="f" fill="#fff"><use xlink:href="#e"/></mask><use fill="#79C5BE" fill-rule="nonzero" xlink:href="#e"/><path d="M17.38 11.3a2.7 2.7 0 0 0-.93-1.94c-.55-.46-1.38-.7-2.5-.7-.71 0-1.3.1-1.75.26-.45.17-.78.4-1 .7-.21.28-.32.61-.33.99-.02.3.04.58.16.82.13.25.34.47.62.66.28.2.64.37 1.08.53.44.16.96.3 1.57.42l2.09.45c1.4.3 2.61.7 3.61 1.18 1 .49 1.83 1.06 2.46 1.72a6.3 6.3 0 0 1 1.41 2.22c.3.82.46 1.72.47 2.69 0 1.67-.43 3.09-1.26 4.25a7.67 7.67 0 0 1-3.54 2.64c-1.54.6-3.39.91-5.54.91a15.6 15.6 0 0 1-5.79-.98 8.02 8.02 0 0 1-3.82-3.03A9.34 9.34 0 0 1 3 19.85h6.56c.05.78.24 1.44.59 1.97s.84.93 1.47 1.2a5.7 5.7 0 0 0 2.27.41c.74 0 1.35-.09 1.85-.27.5-.18.88-.44 1.13-.76.26-.32.4-.69.4-1.1 0-.4-.13-.74-.38-1.03-.24-.3-.64-.56-1.2-.8-.55-.23-1.3-.45-2.25-.66l-2.53-.55a11.6 11.6 0 0 1-5.33-2.45 5.92 5.92 0 0 1-1.93-4.7 7 7 0 0 1 1.3-4.25A8.62 8.62 0 0 1 8.6 4.02 13.24 13.24 0 0 1 13.95 3c2.05 0 3.83.34 5.33 1.03a8.03 8.03 0 0 1 3.48 2.9 7.87 7.87 0 0 1 1.23 4.37h-6.61Zm34.05 1.65h-7.01a4.85 4.85 0 0 0-.4-1.58 3.75 3.75 0 0 0-2.2-2.02 5.26 5.26 0 0 0-1.78-.28c-1.16 0-2.14.28-2.94.84-.8.57-1.4 1.37-1.81 2.43a10.44 10.44 0 0 0-.62 3.79c0 1.56.21 2.86.63 3.9a4.9 4.9 0 0 0 1.82 2.37c.8.52 1.75.79 2.87.79.64 0 1.21-.08 1.72-.25a3.72 3.72 0 0 0 2.23-1.81c.23-.43.4-.93.48-1.47l7 .05a9.44 9.44 0 0 1-.9 3.28 10.65 10.65 0 0 1-5.77 5.36c-1.4.57-3.04.85-4.9.85-2.34 0-4.44-.5-6.29-1.5-1.85-1-3.31-2.48-4.39-4.43a14.63 14.63 0 0 1-1.6-7.14c0-2.84.54-5.22 1.63-7.17a11 11 0 0 1 4.43-4.41c1.85-1 3.93-1.5 6.21-1.5 1.61 0 3.09.22 4.44.66 1.35.44 2.54 1.08 3.55 1.92a9.58 9.58 0 0 1 2.47 3.1c.62 1.23 1 2.63 1.13 4.22Zm30.55 15.98V3.48h6.91v19.89h10.3v5.56H81.97Zm-21.92-.05h-7.45L61 3.43h9.44l8.4 25.45H71.4l-5.57-18.44h-.2l-5.57 18.44Zm-1.39-10.04H72.7V24H58.67v-5.17Zm48.6 10.1H99.8l8.4-25.46h9.45l8.4 25.45h-7.46l-5.57-18.44h-.2l-5.56 18.44Zm-1.4-10.05h14.02v5.17h-14.02V18.9ZM129.18 29V3.53h11c1.88 0 3.53.35 4.95 1.03a7.72 7.72 0 0 1 3.3 2.97 8.77 8.77 0 0 1 1.19 4.65c0 1.82-.4 3.36-1.22 4.61a7.53 7.53 0 0 1-3.39 2.84c-1.45.63-3.15.95-5.09.95h-6.56v-5.37h5.17c.81 0 1.5-.1 2.08-.3.58-.2 1.02-.53 1.33-.98.31-.44.47-1.03.47-1.75 0-.73-.16-1.32-.47-1.78-.3-.46-.75-.8-1.33-1.02a5.85 5.85 0 0 0-2.08-.33h-2.44v19.94h-6.9ZM144.1 17.3 150.46 29h-7.5l-6.22-11.69h7.36Zm43.53-4.14h-7.01a4.85 4.85 0 0 0-.4-1.58 3.75 3.75 0 0 0-2.2-2.02 5.26 5.26 0 0 0-1.78-.28c-1.16 0-2.14.28-2.94.84-.8.57-1.4 1.37-1.81 2.43a10.44 10.44 0 0 0-.62 3.79c0 1.55.21 2.86.63 3.9a4.9 4.9 0 0 0 1.82 2.37c.8.52 1.75.79 2.87.79.64 0 1.21-.08 1.72-.25a3.73 3.73 0 0 0 2.23-1.81c.24-.44.4-.93.48-1.47l7 .05a9.44 9.44 0 0 1-.9 3.28 10.65 10.65 0 0 1-5.77 5.35c-1.4.58-3.04.86-4.9.86-2.34 0-4.44-.5-6.29-1.5-1.85-1-3.31-2.48-4.39-4.43a14.63 14.63 0 0 1-1.6-7.14c0-2.84.54-5.23 1.63-7.17a11 11 0 0 1 4.43-4.41c1.86-1 3.93-1.5 6.21-1.5 1.61 0 3.09.22 4.44.66 1.35.44 2.54 1.08 3.56 1.92a9.58 9.58 0 0 1 2.46 3.1c.62 1.23 1 2.63 1.13 4.22Zm26.48 3.18c0 2.83-.55 5.22-1.66 7.16a11.04 11.04 0 0 1-4.46 4.41 13.1 13.1 0 0 1-6.26 1.5c-2.32 0-4.42-.5-6.28-1.5a11.1 11.1 0 0 1-4.45-4.43 14.32 14.32 0 0 1-1.65-7.14c0-2.84.55-5.23 1.65-7.17a11.01 11.01 0 0 1 4.45-4.41c1.86-1 3.96-1.5 6.28-1.5 2.3 0 4.39.5 6.26 1.5 1.88 1 3.36 2.47 4.46 4.41a14.33 14.33 0 0 1 1.66 7.17Zm-7.11 0c0-1.53-.2-2.81-.6-3.86-.4-1.05-1-1.85-1.78-2.39a4.95 4.95 0 0 0-2.9-.81c-1.14 0-2.1.27-2.88.81a4.96 4.96 0 0 0-1.78 2.39c-.4 1.05-.6 2.33-.6 3.86 0 1.52.2 2.8.6 3.86.4 1.04 1 1.84 1.78 2.38.78.55 1.74.82 2.89.82 1.14 0 2.1-.27 2.89-.82a4.96 4.96 0 0 0 1.78-2.38c.4-1.05.6-2.34.6-3.86Zm11.98-12.65h8.6l5.91 14.42h.3l5.92-14.42h8.6v25.45h-6.76V14.43h-.2l-5.67 14.51h-4.08l-5.66-14.61h-.2v14.81h-6.76V3.7Z" fill="#2C328B" fill-rule="nonzero" mask="url(#f)"/></g></g><path d="M252.59 19.06v2.64l-7.45 4.77-13.48 6.37-4.56.11c8.86-12.46 14.5-19.3 16.94-20.54 2.43-1.24 5.28.98 8.55 6.65Z" fill="url(#g)" mask="url(#d)"/></g></g></g></svg>
diff --git a/docs/en/docs/img/sponsors/scalar.svg b/docs/en/docs/img/sponsors/scalar.svg
new file mode 100644
index 000000000..174c57ee2
--- /dev/null
+++ b/docs/en/docs/img/sponsors/scalar.svg
@@ -0,0 +1 @@
+<svg width="240px" height="99px" viewBox="0 0 240 99" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"><defs><rect id="a" x="0" y="0" width="240" height="99" rx="6"/></defs><g fill="none" fill-rule="evenodd"><mask id="b" fill="#fff"><use xlink:href="#a"/></mask><use fill="#0078D7" xlink:href="#a"/><rect fill="#D2D2C6" mask="url(#b)" width="74" height="100"/><image mask="url(#b)" x="0.0797953321" y="-0.423984273" width="73.7373737" height="100" xlink:href="data:image/png;base64,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"/><g mask="url(#b)" fill="#FFF" fill-rule="nonzero"><g transform="translate(83.6 10.6)"><path d="M4.2 11.4H.5V.5h3.7c1.1 0 2 .2 2.8.7.8.4 1.4 1 1.8 1.9.5.8.7 1.7.7 2.9 0 1.1-.3 2-.7 2.9-.4.8-1 1.4-1.8 1.9-.8.4-1.7.6-2.8.6ZM2.4 9.7h1.7A4 4 0 0 0 6 9.3c.5-.3.9-.7 1.1-1.2A5 5 0 0 0 7.5 6a5 5 0 0 0-.4-2.1c-.2-.6-.6-1-1.1-1.2-.5-.3-1.1-.5-1.9-.5H2.4v7.5ZM14.3 11.6a4 4 0 0 1-2.1-.5c-.6-.4-1-.9-1.4-1.5-.3-.6-.5-1.4-.5-2.2 0-.9.2-1.6.5-2.2.3-.7.8-1.2 1.4-1.5a4 4 0 0 1 2-.6 4 4 0 0 1 2.1.6c.6.3 1 .8 1.4 1.5.3.6.5 1.3.5 2.2 0 .8-.2 1.6-.5 2.2-.3.6-.8 1.1-1.4 1.5a4 4 0 0 1-2 .5Zm0-1.5c.4 0 .8-.2 1-.4.3-.2.6-.6.7-1 .2-.4.2-.8.2-1.3s0-1-.2-1.4c-.1-.4-.4-.7-.6-1-.3-.2-.7-.3-1.1-.3-.5 0-.8.1-1.1.3l-.7 1a4 4 0 0 0-.2 1.4c0 .5 0 1 .2 1.3.2.4.4.8.7 1 .3.2.6.4 1 .4ZM22.8 11.6a4 4 0 0 1-2-.5c-.7-.4-1.1-.9-1.4-1.5-.3-.7-.5-1.4-.5-2.2 0-.9.2-1.6.5-2.2a3.6 3.6 0 0 1 3.4-2 4 4 0 0 1 1.8.3c.5.3.9.6 1.2 1 .3.5.5 1 .5 1.6h-1.8c-.1-.4-.3-.7-.6-1-.2-.3-.6-.4-1-.4-.5 0-.8.1-1.1.3a2 2 0 0 0-.7 1c-.2.3-.3.8-.3 1.3 0 .6.1 1 .3 1.5.2.4.4.7.7.9.3.2.6.3 1 .3l.8-.1.6-.5.3-.8h1.8a3 3 0 0 1-1.7 2.6 4 4 0 0 1-1.8.4ZM32.6 8V3.3h1.9v8.1h-1.9V10l-1 1.1c-.4.3-1 .4-1.5.4-.6 0-1 0-1.4-.3-.5-.3-.8-.6-1-1-.2-.5-.4-1-.4-1.7V3.3h2v4.9c0 .5.1.9.4 1.2.3.3.7.5 1.1.5a1.8 1.8 0 0 0 1.5-.9c.2-.2.3-.6.3-1ZM36 11.4V3.3h1.7v1.3h.1c.2-.4.5-.8.9-1a2.4 2.4 0 0 1 2.8 0c.4.2.7.6.8 1h.1c.2-.4.5-.8 1-1 .4-.3.9-.5 1.5-.5.7 0 1.3.3 1.8.8.5.4.7 1.1.7 2v5.5h-2V6.2c0-.5 0-.8-.3-1-.3-.3-.6-.4-1-.4-.5 0-.8.1-1.1.4-.3.3-.4.7-.4 1.1v5.1h-1.9V6.2c0-.5-.1-.8-.4-1-.2-.3-.6-.4-1-.4-.2 0-.5 0-.7.2l-.6.6-.2.9v5H36ZM52.4 11.6c-.8 0-1.5-.2-2-.5-.7-.4-1.1-.8-1.5-1.5-.3-.6-.4-1.4-.4-2.2 0-.8.1-1.6.4-2.2a3.6 3.6 0 0 1 3.4-2c.5 0 1 0 1.5.2a3.3 3.3 0 0 1 2 2c.2.5.3 1.2.3 1.9v.6h-6.7V6.6h4.8c0-.4 0-.7-.2-1a1.8 1.8 0 0 0-1.6-1 1.9 1.9 0 0 0-1.8 1l-.2 1v1.2c0 .5 0 1 .2 1.2.2.4.4.6.8.8.3.2.6.3 1 .3l.8-.1.6-.4c.2-.1.3-.3.4-.6l1.8.2c-.1.5-.3 1-.7 1.3-.3.3-.7.6-1.2.8-.5.2-1 .3-1.7.3ZM59 6.6v4.8h-1.9V3.3H59v1.3c.3-.4.6-.8 1-1 .4-.3 1-.5 1.5-.5.6 0 1 .2 1.5.4l1 1c.2.5.3 1 .3 1.7v5.2h-2V6.5c0-.5 0-1-.3-1.3-.3-.3-.7-.4-1.2-.4-.3 0-.6 0-.9.2-.3.1-.5.4-.6.6-.2.3-.2.6-.2 1ZM69.8 3.3v1.4h-4.7V3.3h4.7Zm-3.5-2h1.9V9l.1.6.3.2.5.1a2 2 0 0 0 .5 0l.4 1.5a4.3 4.3 0 0 1-1.2.1c-.5 0-.9 0-1.3-.2a2 2 0 0 1-.9-.7c-.2-.4-.3-.8-.3-1.3v-8ZM73.1 10v.5c0 .5-.2 1-.3 1.4a18 18 0 0 1-.7 2.2h-1.3a264.2 264.2 0 0 1 .6-3.6V10h1.7ZM81.3 11.4h-3.7V.5h3.8c1 0 2 .2 2.8.7.8.4 1.4 1 1.8 1.9.4.8.6 1.7.6 2.9 0 1.1-.2 2-.6 2.9-.4.8-1 1.4-1.8 1.9-.8.4-1.8.6-2.9.6Zm-1.7-1.7h1.6a4 4 0 0 0 2-.4c.4-.3.8-.7 1-1.2a5 5 0 0 0 .5-2.1 5 5 0 0 0-.4-2.1c-.3-.6-.7-1-1.2-1.2-.5-.3-1-.5-1.8-.5h-1.7v7.5ZM87.8 11.4V3.3h2v8.1h-2Zm1-9.3c-.3 0-.6-.1-.8-.3a1 1 0 0 1-.3-.8c0-.2.1-.5.3-.7.3-.2.5-.3.8-.3.3 0 .6.1.8.3.2.2.3.5.3.7 0 .3 0 .6-.3.8-.2.2-.5.3-.8.3ZM97.7 5.4l-1.8.2c0-.2-.1-.3-.3-.5l-.4-.4-.8-.1c-.4 0-.7 0-1 .2-.3.2-.4.4-.4.7 0 .3 0 .5.3.6.1.2.4.3.8.4l1.4.3c.8.1 1.4.4 1.8.8.3.3.5.8.5 1.4 0 .5-.1 1-.4 1.3a3 3 0 0 1-1.2 1c-.6.2-1.2.3-1.9.3-1 0-1.8-.2-2.4-.6-.6-.5-1-1-1-1.8l1.8-.2c.1.4.3.7.6.9l1 .2c.5 0 .9 0 1.1-.2.3-.2.5-.5.5-.7 0-.3-.1-.5-.3-.6a2 2 0 0 0-.8-.4L93.4 8c-.8-.1-1.4-.4-1.8-.8a2 2 0 0 1-.5-1.5c0-.5.1-1 .4-1.3.3-.4.6-.6 1.1-.8.5-.2 1.1-.4 1.8-.4 1 0 1.7.3 2.2.7.6.4 1 1 1 1.6ZM102.4 11.6a4 4 0 0 1-2-.5c-.6-.4-1.1-.9-1.4-1.5-.3-.7-.5-1.4-.5-2.2 0-.9.2-1.6.5-2.2a3.6 3.6 0 0 1 3.4-2 4 4 0 0 1 1.8.3c.5.3 1 .6 1.2 1 .3.5.5 1 .5 1.6h-1.8c0-.4-.2-.7-.5-1-.3-.3-.7-.4-1.1-.4-.4 0-.8.1-1 .3a2 2 0 0 0-.8 1l-.2 1.3c0 .6 0 1 .2 1.5.2.4.4.7.7.9.3.2.7.3 1 .3l.8-.1.6-.5.3-.8h1.8a3 3 0 0 1-1.7 2.6 4 4 0 0 1-1.8.4ZM110.5 11.6a4 4 0 0 1-2-.5c-.6-.4-1-.9-1.4-1.5-.3-.6-.5-1.4-.5-2.2 0-.9.2-1.6.5-2.2.3-.7.8-1.2 1.4-1.5a4 4 0 0 1 2-.6 4 4 0 0 1 2.1.6c.6.3 1 .8 1.4 1.5.3.6.5 1.3.5 2.2 0 .8-.2 1.6-.5 2.2-.3.6-.8 1.1-1.4 1.5a4 4 0 0 1-2 .5Zm0-1.5c.5 0 .8-.2 1.1-.4.3-.2.5-.6.7-1l.2-1.3c0-.5 0-1-.2-1.4l-.7-1c-.3-.2-.6-.3-1-.3-.5 0-.9.1-1.2.3-.2.3-.5.6-.6 1a4 4 0 0 0-.2 1.4c0 .5 0 1 .2 1.3.1.4.4.8.6 1 .3.2.7.4 1.1.4Z"/><polygon points="122.552812 3.25461648 119.639104 11.4364347 117.508422 11.4364347 114.594715 3.25461648 116.650823 3.25461648 118.53115 9.33238636 118.616377 9.33238636 120.50203 3.25461648"/><path d="M126.7 11.6c-.9 0-1.6-.2-2.2-.5-.6-.4-1-.8-1.3-1.5-.4-.6-.5-1.4-.5-2.2 0-.8.1-1.6.5-2.2a3.6 3.6 0 0 1 3.4-2c.5 0 1 0 1.4.2a3.3 3.3 0 0 1 2 2c.2.5.3 1.2.3 1.9v.6h-6.7V6.6h4.9c0-.4-.1-.7-.3-1a1.8 1.8 0 0 0-1.6-1 1.9 1.9 0 0 0-1.7 1l-.3 1v1.2c0 .5 0 1 .3 1.2.1.4.4.6.7.8.3.2.7.3 1 .3l.9-.1.5-.4c.2-.1.3-.3.4-.6l1.8.2c0 .5-.3 1-.6 1.3l-1.2.8c-.5.2-1.1.3-1.7.3ZM131.4 11.4V3.3h1.8v1.3h.1a2 2 0 0 1 2-1.5 5.5 5.5 0 0 1 .7 0V5l-.4-.1a4 4 0 0 0-.5 0 2 2 0 0 0-1 .2 1.7 1.7 0 0 0-.8 1.5v4.8h-2ZM2.7 30.6c-.5 0-1 0-1.4-.3-.4-.2-.7-.4-1-.8C.2 29 0 28.7 0 28c0-.4 0-.8.3-1.1.1-.3.4-.5.7-.7.2-.2.6-.3 1-.4l1.1-.2a37.4 37.4 0 0 0 1.8-.4c.2 0 .2-.2.2-.4 0-.4 0-.7-.3-1-.3-.2-.6-.3-1-.3-.5 0-.9.1-1.2.3-.3.2-.4.5-.5.8l-1.8-.3a2.9 2.9 0 0 1 1.9-2c.4-.2 1-.3 1.5-.3.4 0 .8 0 1.2.2.4 0 .8.2 1 .4.4.3.7.5.9.9.2.4.3.8.3 1.4v5.4H5.2v-1a2.3 2.3 0 0 1-1.3 1l-1.2.2Zm.5-1.4c.4 0 .8 0 1-.2l.7-.7c.2-.2.2-.5.2-.8v-1l-.3.2h-.5a14.8 14.8 0 0 1-1 .2l-.7.2-.5.4a1 1 0 0 0-.2.6c0 .4 0 .6.3.8.3.2.6.3 1 .3ZM10.4 25.6v4.8h-2v-8.1h1.9v1.3c.3-.4.6-.8 1-1 .4-.3 1-.5 1.5-.5.6 0 1 .2 1.5.4l1 1c.2.5.3 1 .3 1.7v5.2h-2v-4.9c0-.5 0-1-.3-1.3-.3-.3-.7-.4-1.2-.4-.3 0-.6 0-.9.2-.3.1-.5.4-.6.6-.2.3-.2.6-.2 1ZM20 30.6a3.1 3.1 0 0 1-2.9-2c-.3-.6-.4-1.3-.4-2.2 0-1 .1-1.7.4-2.3.3-.7.7-1.1 1.3-1.5.5-.3 1-.5 1.7-.5.4 0 .8.1 1.1.3.4.2.6.3.8.6l.4.6v-4h2v10.8h-1.9v-1.3h-.1l-.4.7a2.4 2.4 0 0 1-2 .8Zm.6-1.6c.4 0 .8-.1 1-.3l.7-1 .2-1.4c0-.5 0-1-.2-1.3a2 2 0 0 0-.6-1c-.3-.2-.7-.3-1.1-.3-.4 0-.8.1-1 .4a2 2 0 0 0-.7.9c-.2.4-.2.8-.2 1.3 0 .6 0 1 .2 1.4.1.4.3.7.6 1 .3.2.7.3 1.1.3Z"/><polygon points="28.6839458 21.1839489 28.6839458 19.5273438 37.387781 19.5273438 37.387781 21.1839489 34.015977 21.1839489 34.015977 30.4364347 32.0557498 30.4364347 32.0557498 21.1839489"/><path d="M40.8 30.6c-.8 0-1.5-.2-2-.5-.7-.4-1.1-.8-1.5-1.5-.3-.6-.4-1.4-.4-2.2 0-.8.1-1.6.5-2.2a3.6 3.6 0 0 1 3.3-2c.5 0 1 0 1.5.2a3.3 3.3 0 0 1 2 2c.2.5.3 1.2.3 1.9v.6h-6.7v-1.3h4.8c0-.4 0-.7-.2-1a1.8 1.8 0 0 0-1.6-1 1.9 1.9 0 0 0-1.8 1l-.2 1v1.2c0 .5 0 1 .2 1.2.2.4.5.6.8.8.3.2.6.3 1 .3l.8-.1c.3-.1.5-.2.6-.4.2-.1.3-.3.4-.6l1.8.2c-.1.5-.3 1-.6 1.3l-1.3.8c-.5.2-1 .3-1.7.3ZM52 24.4l-1.7.2c0-.2-.2-.3-.3-.5l-.5-.4-.8-.1c-.4 0-.7 0-1 .2-.2.2-.4.4-.4.7 0 .3.1.5.3.6.2.2.5.3.9.4l1.4.3c.8.1 1.3.4 1.7.8.4.3.6.8.6 1.4 0 .5-.2 1-.5 1.3a3 3 0 0 1-1.2 1c-.5.2-1.1.3-1.8.3-1 0-1.8-.2-2.4-.6-.6-.5-1-1-1.1-1.8L47 28c0 .4.2.7.5.9l1 .2c.5 0 1 0 1.2-.2.3-.2.4-.5.4-.7 0-.3 0-.5-.3-.6a2 2 0 0 0-.8-.4l-1.4-.3c-.8-.1-1.3-.4-1.7-.8a2 2 0 0 1-.6-1.5c0-.5.1-1 .4-1.3.3-.4.7-.6 1.2-.8.5-.2 1-.4 1.7-.4 1 0 1.7.3 2.3.7.5.4.9 1 1 1.6ZM57.3 22.3v1.4h-4.7v-1.4h4.7Zm-3.5-2h1.9V28l.1.6.3.2.5.1a2 2 0 0 0 .5 0l.4 1.5a4.3 4.3 0 0 1-1.2.1c-.5 0-.9 0-1.3-.2a2 2 0 0 1-.9-.7c-.2-.4-.3-.8-.3-1.3v-8ZM63 30.4H61l3.8-10.9h2.5l3.8 11h-2l-3-8.7-3 8.6Zm0-4.2h5.8v1.5h-5.7v-1.5ZM71.9 30.4V19.5h4c1 0 1.6.2 2.2.5.6.3 1 .7 1.3 1.3.3.5.4 1.1.4 1.8s-.1 1.4-.4 1.9c-.3.5-.7 1-1.3 1.3-.6.3-1.3.5-2.1.5h-2.7V25h2.4c.5 0 .9 0 1.2-.2l.7-.7.2-1c0-.4 0-.8-.2-1-.2-.4-.4-.6-.7-.8l-1.2-.2h-1.8v9.2h-2Z"/><polygon points="82.9651016 19.5273438 82.9651016 30.4364347 80.9888943 30.4364347 80.9888943 19.5273438"/><path d="m91 24.4-1.8.2c0-.2-.2-.3-.3-.5l-.5-.4-.7-.1c-.4 0-.8 0-1 .2-.3.2-.4.4-.4.7 0 .3 0 .5.2.6.2.2.5.3 1 .4l1.3.3c.8.1 1.4.4 1.7.8.4.3.6.8.6 1.4 0 .5-.1 1-.4 1.3a3 3 0 0 1-1.3 1c-.5.2-1.1.3-1.8.3-1 0-1.8-.2-2.4-.6-.6-.5-1-1-1.1-1.8L86 28c0 .4.2.7.5.9l1.1.2c.5 0 .8 0 1.1-.2.3-.2.4-.5.4-.7 0-.3 0-.5-.2-.6a2 2 0 0 0-.9-.4l-1.4-.3c-.8-.1-1.3-.4-1.7-.8a2 2 0 0 1-.6-1.5c0-.5.2-1 .4-1.3.3-.4.7-.6 1.2-.8.5-.2 1-.4 1.7-.4 1 0 1.8.3 2.3.7.6.4.9 1 1 1.6Z"/><polygon points="96.9873827 30.4364347 94.675593 22.2546165 96.6411469 22.2546165 98.0793572 28.0074574 98.153931 28.0074574 99.6241015 22.2546165 101.568349 22.2546165 103.038519 27.9754972 103.11842 27.9754972 104.535323 22.2546165 106.506204 22.2546165 104.189087 30.4364347 102.18092 30.4364347 100.646829 24.9073153 100.534968 24.9073153 99.000877 30.4364347"/><path d="M107.3 30.4v-8.1h2v8.1h-2Zm1-9.3c-.3 0-.6-.1-.8-.3a1 1 0 0 1-.4-.8l.4-.7c.2-.2.5-.3.8-.3.3 0 .5.1.8.3.2.2.3.5.3.7 0 .3-.1.6-.3.8-.3.2-.5.3-.8.3ZM114.7 22.3v1.4H110v-1.4h4.7Zm-3.5-2h2v8.3l.4.2.4.1a2 2 0 0 0 .6 0l.3 1.5a4.3 4.3 0 0 1-1.2.1c-.4 0-.9 0-1.3-.2a2 2 0 0 1-.9-.7c-.2-.4-.3-.8-.3-1.3v-8ZM117.9 25.6v4.8h-2V19.5h2v4.1c.2-.4.5-.8 1-1 .3-.3.8-.5 1.5-.5.5 0 1 .2 1.5.4.4.2.7.6 1 1 .2.5.3 1 .3 1.7v5.2h-2v-4.9c0-.5 0-1-.4-1.3-.2-.3-.6-.4-1.2-.4-.3 0-.6 0-.9.2l-.6.6a2 2 0 0 0-.2 1ZM6.4 41.5c0-.4-.3-.8-.6-1-.4-.3-.9-.4-1.5-.4l-1 .1-.7.5a1.2 1.2 0 0 0 0 1.4l.4.4.6.3.6.2 1 .2 1.2.4 1 .6c.4.3.6.6.8 1 .2.3.2.7.2 1.2a3 3 0 0 1-1.9 2.8c-.6.3-1.3.4-2.2.4-.8 0-1.6-.1-2.2-.4-.6-.3-1.1-.6-1.5-1.1-.3-.5-.5-1.2-.5-1.9h2a1.7 1.7 0 0 0 1 1.5c.4.2.8.2 1.2.2.4 0 .8 0 1.1-.2.4-.1.6-.3.8-.5.2-.3.3-.5.3-.8 0-.3-.1-.6-.3-.7-.1-.2-.4-.4-.7-.5a7 7 0 0 0-1-.4l-1.2-.3a5 5 0 0 1-2.2-1c-.5-.5-.7-1.1-.7-1.9 0-.6.1-1.2.5-1.7.3-.5.8-.9 1.4-1.1a5 5 0 0 1 2-.4c.8 0 1.5.1 2.1.4.6.2 1 .6 1.4 1 .3.6.5 1.1.5 1.7H6.4ZM13.1 49.6a4 4 0 0 1-2-.5c-.7-.4-1.1-.9-1.4-1.5-.3-.7-.5-1.4-.5-2.2 0-.9.2-1.6.5-2.2a3.6 3.6 0 0 1 3.4-2 4 4 0 0 1 1.8.3c.5.3 1 .6 1.2 1 .3.5.5 1 .5 1.6h-1.8c0-.4-.3-.7-.5-1-.3-.3-.7-.4-1.2-.4-.4 0-.7.1-1 .3a2 2 0 0 0-.7 1c-.2.3-.2.8-.2 1.3 0 .6 0 1 .2 1.5.2.4.4.7.7.9.3.2.6.3 1 .3l.8-.1.6-.5.3-.8h1.8a3 3 0 0 1-1.7 2.6 4 4 0 0 1-1.8.4ZM20 49.6c-.5 0-1 0-1.4-.3-.4-.2-.7-.4-1-.8-.2-.4-.3-.8-.3-1.4 0-.4 0-.8.2-1.1l.7-.7 1-.4 1.2-.2a37.4 37.4 0 0 0 1.8-.4l.2-.4c0-.4-.1-.7-.4-1-.2-.2-.5-.3-1-.3s-.8.1-1.1.3c-.3.2-.5.5-.6.8l-1.8-.3a2.9 2.9 0 0 1 2-2c.4-.2 1-.3 1.5-.3.4 0 .8 0 1.2.2.4 0 .7.2 1 .4.4.3.6.5.8.9.2.4.3.8.3 1.4v5.4h-1.8v-1a2.3 2.3 0 0 1-1.4 1l-1 .2Zm.5-1.4c.4 0 .7 0 1-.2l.7-.7.2-.8v-1l-.3.2h-.5a14.8 14.8 0 0 1-1 .2l-.7.2-.6.4a1 1 0 0 0-.2.6c0 .4.2.6.4.8.3.2.6.3 1 .3Z"/><polygon points="27.6426646 38.5273438 27.6426646 49.4364347 25.7143976 49.4364347 25.7143976 38.5273438"/><path d="M31.4 49.6c-.5 0-1 0-1.4-.3-.4-.2-.7-.4-1-.8-.2-.4-.3-.8-.3-1.4 0-.4 0-.8.2-1.1l.7-.7 1-.4 1.2-.2a37.4 37.4 0 0 0 1.8-.4l.2-.4c0-.4-.1-.7-.3-1-.3-.2-.6-.3-1-.3-.5 0-1 .1-1.2.3-.3.2-.5.5-.6.8l-1.8-.3a2.9 2.9 0 0 1 2-2c.4-.2 1-.3 1.5-.3.4 0 .8 0 1.2.2.4 0 .7.2 1 .4.4.3.6.5.8.9.2.4.3.8.3 1.4v5.4H34v-1a2.3 2.3 0 0 1-1.4 1l-1 .2Zm.5-1.4c.4 0 .7 0 1-.2l.7-.7.2-.8v-1l-.3.2H33a14.8 14.8 0 0 1-1 .2l-.7.2-.6.4a1 1 0 0 0-.2.6c0 .4.2.6.4.8.3.2.6.3 1 .3ZM37.1 49.4v-8.1H39v1.3a2 2 0 0 1 2-1.5 5.5 5.5 0 0 1 .8 0V43l-.4-.1a4 4 0 0 0-.5 0 2 2 0 0 0-1 .2 1.7 1.7 0 0 0-.9 1.5v4.8h-1.9ZM42.8 49.6c-.4 0-.6-.2-.9-.4-.2-.2-.3-.5-.3-.8 0-.3.1-.6.3-.8.3-.3.5-.4.9-.4.3 0 .5.1.8.4a1.1 1.1 0 0 1 .2 1.4l-.5.4-.5.2ZM51.8 49.6a4 4 0 0 1-2.1-.5c-.6-.4-1-.9-1.4-1.5-.3-.7-.5-1.4-.5-2.2 0-.9.2-1.6.5-2.2a3.6 3.6 0 0 1 3.4-2 4 4 0 0 1 1.8.3c.5.3 1 .6 1.2 1 .3.5.5 1 .6 1.6h-1.9c0-.4-.2-.7-.5-1-.3-.3-.7-.4-1.1-.4-.4 0-.8.1-1 .3a2 2 0 0 0-.8 1l-.2 1.3c0 .6 0 1 .2 1.5.2.4.4.7.7.9.3.2.7.3 1 .3l.8-.1c.3-.1.4-.3.6-.5.2-.2.3-.5.3-.8h1.9c0 .6-.3 1.1-.6 1.6a3 3 0 0 1-1.2 1 4 4 0 0 1-1.7.4ZM59.9 49.6a4 4 0 0 1-2.1-.5c-.6-.4-1-.9-1.4-1.5-.3-.6-.5-1.4-.5-2.2 0-.9.2-1.6.5-2.2.3-.7.8-1.2 1.4-1.5a4 4 0 0 1 2-.6 4 4 0 0 1 2.1.6c.6.3 1 .8 1.4 1.5.3.6.5 1.3.5 2.2 0 .8-.2 1.6-.5 2.2-.3.6-.8 1.1-1.4 1.5a4 4 0 0 1-2 .5Zm0-1.5c.4 0 .8-.2 1-.4.3-.2.6-.6.7-1l.2-1.3c0-.5 0-1-.2-1.4-.1-.4-.4-.7-.6-1-.3-.2-.7-.3-1.1-.3-.5 0-.8.1-1.1.3-.3.3-.6.6-.7 1a4 4 0 0 0-.2 1.4c0 .5 0 1 .2 1.3.1.4.4.8.7 1 .3.2.6.4 1 .4ZM64.8 49.4v-8.1h1.9v1.3c.3-.4.5-.8 1-1 .3-.3.8-.5 1.3-.5.6 0 1 .2 1.4.5.4.2.7.6.8 1h.1c.2-.4.5-.8 1-1 .4-.3.9-.5 1.5-.5.7 0 1.4.3 1.8.8.5.4.7 1.1.7 2v5.5h-1.9v-5.2c0-.5-.1-.8-.4-1-.3-.3-.6-.4-1-.4s-.8.1-1 .4c-.3.3-.5.7-.5 1.1v5.1h-1.9v-5.2c0-.5 0-.8-.3-1-.3-.3-.6-.4-1-.4-.3 0-.6 0-.8.2-.2.1-.4.3-.5.6-.2.2-.2.5-.2.9v5h-2Z"/></g></g><g mask="url(#b)" fill="#FFF" fill-rule="nonzero"><g transform="translate(83.8 76.8)"><polygon points="4.59161932 0.303622159 4.59161932 11.2127131 2.61541193 11.2127131 2.61541193 2.2265625 2.55149148 2.2265625 0 3.85653409 0 2.04545455 2.71129261 0.303622159"/><path d="M10.8 11.4c-.8 0-1.6-.2-2.2-.6-.6-.5-1.1-1.1-1.5-2-.3-.8-.5-1.8-.5-3s.2-2.2.5-3c.4-1 .9-1.5 1.5-2C9.2.4 10 .2 10.8.2c1 0 1.7.2 2.3.6.6.5 1.1 1 1.4 2 .4.8.5 1.8.5 3s-.1 2.2-.5 3c-.3.9-.8 1.5-1.4 2-.6.4-1.4.6-2.3.6Zm0-1.6c.7 0 1.3-.4 1.7-1a6 6 0 0 0 .5-3c0-.9 0-1.6-.2-2.2a3 3 0 0 0-.8-1.3c-.3-.3-.7-.5-1.2-.5-.6 0-1.2.3-1.6 1a6 6 0 0 0-.6 3c0 .8.1 1.6.3 2.2.2.6.4 1 .8 1.3.3.3.7.5 1.1.5ZM20.3 11.4c-.9 0-1.7-.2-2.3-.6-.6-.5-1-1.1-1.4-2-.4-.8-.5-1.8-.5-3s.1-2.2.5-3c.3-1 .8-1.5 1.4-2 .7-.4 1.4-.6 2.3-.6.9 0 1.6.2 2.2.6.7.5 1.1 1 1.5 2 .3.8.5 1.8.5 3s-.2 2.2-.5 3c-.4.9-.8 1.5-1.5 2-.6.4-1.3.6-2.2.6Zm0-1.6c.7 0 1.2-.4 1.6-1a6 6 0 0 0 .6-3c0-.9-.1-1.6-.3-2.2a3 3 0 0 0-.7-1.3c-.4-.3-.8-.5-1.2-.5-.7 0-1.2.3-1.6 1a6 6 0 0 0-.6 3c0 .8 0 1.6.2 2.2.2.6.5 1 .8 1.3.3.3.7.5 1.2.5ZM31.5 9.2v-.6l.3-1.2a2.1 2.1 0 0 1 2-1.2c.5 0 1 .2 1.3.4l.8.8c.2.4.2.8.2 1.2v.6c0 .4 0 .8-.2 1.1-.2.4-.5.7-.8.9-.4.2-.8.3-1.3.3s-.9 0-1.2-.3c-.4-.2-.6-.5-.8-.9-.2-.3-.3-.7-.3-1.1Zm1.4-.6v.6c0 .2 0 .5.2.7.1.3.4.4.7.4.4 0 .6-.1.7-.4.2-.2.2-.4.2-.7v-.6c0-.3 0-.6-.2-.8 0-.2-.3-.3-.7-.3-.3 0-.5 0-.7.3l-.2.8Zm-7-5.7v-.6c0-.4.2-.8.3-1.1.2-.4.5-.7.8-.9.4-.2.8-.3 1.3-.3s1 .1 1.3.3c.3.2.6.5.7.9.2.3.3.7.3 1.1V3c0 .5-.1.8-.3 1.2a2 2 0 0 1-.8.8c-.3.3-.7.4-1.2.4s-1-.1-1.3-.4a2 2 0 0 1-.8-.8L26 2.9Zm1.5-.6V3c0 .3 0 .6.2.8.1.2.3.3.7.3.3 0 .6 0 .7-.3l.2-.8v-.6c0-.2 0-.5-.2-.7-.1-.3-.4-.4-.7-.4-.4 0-.6.1-.7.4-.2.2-.2.5-.2.7Zm-1 9L34 .2h1.3l-7.5 11h-1.3ZM50.8 5.8c0 1.1-.2 2.1-.7 3a4.7 4.7 0 0 1-4.3 2.6 4.7 4.7 0 0 1-4.4-2.6c-.4-.9-.6-1.9-.6-3 0-1.2.2-2.2.6-3A4.7 4.7 0 0 1 45.8.1c1 0 1.8.2 2.6.6.7.5 1.3 1.1 1.7 2 .5.8.7 1.8.7 3Zm-2 0a5 5 0 0 0-.4-2.1 3 3 0 0 0-1-1.3c-.5-.3-1-.5-1.6-.5a3 3 0 0 0-2.6 1.7 5 5 0 0 0-.4 2.2c0 .8 0 1.5.3 2 .3.6.7 1 1.1 1.3.5.3 1 .5 1.6.5a3 3 0 0 0 2.6-1.7 5 5 0 0 0 .4-2.1ZM52 14.3V3h2v1.4l.5-.7a2.3 2.3 0 0 1 1.9-.8 3.1 3.1 0 0 1 2.9 2c.3.6.4 1.3.4 2.2 0 1-.1 1.7-.4 2.3-.3.7-.7 1.1-1.2 1.5-.5.3-1 .5-1.7.5-.5 0-.9-.1-1.2-.3l-.7-.5-.5-.7v4.4h-2ZM54 7l.1 1.4.7 1c.3.2.6.3 1 .3.5 0 .8-.1 1.1-.4.3-.2.5-.5.7-1l.2-1.3c0-.5 0-1-.2-1.3a2 2 0 0 0-.7-1c-.3-.2-.6-.3-1-.3-.5 0-.8.1-1.1.3a2 2 0 0 0-.7 1L54 7ZM64.5 11.4c-.9 0-1.6-.2-2.2-.5-.6-.4-1-.9-1.3-1.5-.4-.6-.5-1.4-.5-2.2 0-.9.1-1.6.5-2.2a3.6 3.6 0 0 1 3.4-2c.5 0 1 0 1.4.2a3.3 3.3 0 0 1 2 2c.2.5.3 1.1.3 1.9v.5h-6.7V6.3h4.8c0-.3 0-.6-.2-1a1.8 1.8 0 0 0-1.6-.9 1.9 1.9 0 0 0-1.8 1l-.2 1v1.2c0 .5 0 .9.3 1.2.1.4.4.6.7.8.3.2.7.3 1 .3l.8-.1c.3-.1.5-.2.6-.4l.4-.6L68 9c-.1.5-.3 1-.6 1.3L66 11c-.4.2-1 .3-1.6.3ZM71 6.4v4.8h-1.8V3H71v1.4h.1c.2-.4.5-.8.9-1 .4-.3 1-.5 1.5-.5.6 0 1.1.1 1.5.4.4.2.8.6 1 1 .2.5.3 1 .3 1.7v5.2h-1.9V6.3c0-.5-.1-1-.4-1.3-.3-.3-.7-.4-1.2-.4-.3 0-.6 0-.9.2l-.6.6-.2 1ZM87 3.3c-.1-.5-.3-.8-.7-1-.4-.3-.8-.5-1.4-.5-.4 0-.8 0-1.1.2l-.7.5a1.2 1.2 0 0 0 0 1.3c0 .2.2.3.4.5l.6.3.6.2 1 .2 1.3.4 1 .6.7 1c.2.3.3.7.3 1.1a3 3 0 0 1-2 2.9c-.5.2-1.3.4-2.2.4-.8 0-1.6-.2-2.2-.4-.6-.3-1-.7-1.4-1.2-.4-.5-.6-1-.6-1.8h2a1.7 1.7 0 0 0 1.1 1.5l1.1.2c.4 0 .8 0 1.1-.2.4-.1.6-.3.8-.5L87 8c0-.3 0-.5-.3-.7-.1-.2-.3-.3-.6-.4a7 7 0 0 0-1-.4l-1.3-.3a5 5 0 0 1-2.1-1c-.6-.5-.8-1.1-.8-2 0-.6.2-1.1.5-1.6.4-.5.8-.9 1.4-1.1a5 5 0 0 1 2-.4c.9 0 1.5 0 2.1.4.6.2 1 .6 1.4 1 .3.5.5 1 .5 1.7H87ZM93.7 11.4a4 4 0 0 1-2.1-.6c-.6-.3-1-.8-1.4-1.4-.3-.7-.5-1.4-.5-2.2 0-.9.2-1.6.5-2.3.3-.6.8-1.1 1.4-1.4a4 4 0 0 1 2-.6 4 4 0 0 1 2.1.6c.6.3 1 .8 1.4 1.4.3.7.5 1.4.5 2.3 0 .8-.2 1.5-.5 2.2-.3.6-.8 1-1.4 1.4a4 4 0 0 1-2 .6Zm0-1.6c.4 0 .8 0 1-.3.3-.3.6-.6.7-1l.2-1.4c0-.5 0-1-.2-1.3-.1-.4-.4-.7-.7-1-.2-.2-.6-.3-1-.3-.5 0-.9 0-1.1.3-.3.3-.6.6-.7 1a4 4 0 0 0-.2 1.3c0 .5 0 1 .2 1.4.1.4.4.7.7 1 .2.2.6.3 1 .3ZM103.9 7.8V3h1.9v8.2h-1.9V9.8c-.3.4-.6.8-1 1-.4.4-1 .5-1.5.5-.6 0-1-.1-1.5-.3l-1-1c-.1-.5-.3-1.1-.3-1.8V3h2v5c0 .5.1.9.4 1.2.3.3.7.4 1.1.4a1.8 1.8 0 0 0 1.5-.8c.2-.3.3-.6.3-1ZM107.2 11.2V3h1.9v1.4a2 2 0 0 1 2-1.5 5.5 5.5 0 0 1 .8 0v1.8h-.4a4 4 0 0 0-.5 0 2 2 0 0 0-1 .2 1.7 1.7 0 0 0-.9 1.5v4.8h-1.9ZM115.8 11.4a4 4 0 0 1-2-.6c-.7-.3-1.1-.8-1.4-1.5a4.9 4.9 0 0 1 0-4.4 3.6 3.6 0 0 1 3.4-2 4 4 0 0 1 1.8.4c.5.2.9.6 1.2 1 .3.5.5 1 .5 1.6h-1.8c-.1-.4-.3-.8-.6-1-.2-.3-.6-.4-1-.4-.5 0-.8 0-1.1.3a2 2 0 0 0-.7.9c-.2.4-.2.9-.2 1.4 0 .6 0 1 .2 1.5.2.4.4.7.7.9.3.2.6.3 1 .3.3 0 .6 0 .8-.2.2 0 .4-.2.6-.4l.3-.8h1.8a3 3 0 0 1-1.7 2.6 4 4 0 0 1-1.8.4ZM124 11.4c-.9 0-1.6-.2-2.2-.5-.5-.4-1-.9-1.3-1.5-.3-.6-.5-1.4-.5-2.2 0-.9.2-1.6.5-2.2a3.6 3.6 0 0 1 3.4-2c.5 0 1 0 1.4.2a3.3 3.3 0 0 1 2 2c.2.5.3 1.1.3 1.9v.5H121V6.3h4.9l-.3-1a1.8 1.8 0 0 0-1.6-.9 1.9 1.9 0 0 0-1.7 1l-.3 1v1.2c0 .5.1.9.3 1.2.1.4.4.6.7.8a2.3 2.3 0 0 0 1.9.1c.2 0 .4-.1.5-.3l.4-.6 1.8.2c0 .5-.3 1-.6 1.3-.3.3-.7.6-1.2.8-.5.2-1 .3-1.7.3Z"/></g></g></g></svg>
diff --git a/docs/en/overrides/main.html b/docs/en/overrides/main.html
index ed08028ec..9aa452e36 100644
--- a/docs/en/overrides/main.html
+++ b/docs/en/overrides/main.html
@@ -58,6 +58,12 @@
         <img class="sponsor-image" src="/img/sponsors/reflex-banner.png" />
       </a>
     </div>
+    <div class="item">
+      <a title="Scalar: Beautiful Open-Source API References from Swagger/OpenAPI files" style="display: block; position: relative;" href="https://github.com/scalar/scalar/?utm_source=fastapi&utm_medium=website&utm_campaign=top-banner" target="_blank">
+        <span class="sponsor-badge">sponsor</span>
+        <img class="sponsor-image" src="/img/sponsors/scalar-banner.svg" />
+      </a>
+    </div>
   </div>
 </div>
 {% endblock %}

From e9ce31e96bd61f09decc1ba8d1908fb5d3315043 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 28 Nov 2023 10:52:59 +0000
Subject: [PATCH 283/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 34bbab135..9a6c969ab 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
 
 ## Latest Changes
 
+* 🔧 Update sponsors, add Scalar. PR [#10728](https://github.com/tiangolo/fastapi/pull/10728) by [@tiangolo](https://github.com/tiangolo).
+
 ### Internal
 
 * 🔧 Update sponsors, add Codacy. PR [#10677](https://github.com/tiangolo/fastapi/pull/10677) by [@tiangolo](https://github.com/tiangolo).

From 13cef7a21a8fb941f91c981e93b138d1b44aabd6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 28 Nov 2023 13:10:12 +0100
Subject: [PATCH 284/317] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors,=20rem?=
 =?UTF-8?q?ove=20Fern=20(#10729)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                                 | 1 -
 docs/en/data/sponsors.yml                 | 3 ---
 docs/en/docs/advanced/generate-clients.md | 5 ++---
 docs/en/docs/alternatives.md              | 2 --
 docs/en/overrides/main.html               | 6 ------
 5 files changed, 2 insertions(+), 15 deletions(-)

diff --git a/README.md b/README.md
index b53076dcb..c8d17889d 100644
--- a/README.md
+++ b/README.md
@@ -48,7 +48,6 @@ The key features are:
 
 <a href="https://cryptapi.io/" target="_blank" title="CryptAPI: Your easy to use, secure and privacy oriented payment gateway."><img src="https://fastapi.tiangolo.com/img/sponsors/cryptapi.svg"></a>
 <a href="https://platform.sh/try-it-now/?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023" target="_blank" title="Build, run and scale your apps on a modern, reliable, and secure PaaS."><img src="https://fastapi.tiangolo.com/img/sponsors/platform-sh.png"></a>
-<a href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=main-badge" target="_blank" title="Fern | SDKs and API docs"><img src="https://fastapi.tiangolo.com/img/sponsors/fern.svg"></a>
 <a href="https://www.porter.run" target="_blank" title="Deploy FastAPI on AWS with a few clicks"><img src="https://fastapi.tiangolo.com/img/sponsors/porter.png"></a>
 <a href="https://bump.sh/fastapi?utm_source=fastapi&utm_medium=referral&utm_campaign=sponsor" target="_blank" title="Automate FastAPI documentation generation with Bump.sh"><img src="https://fastapi.tiangolo.com/img/sponsors/bump-sh.svg"></a>
 <a href="https://reflex.dev" target="_blank" title="Reflex"><img src="https://fastapi.tiangolo.com/img/sponsors/reflex.png"></a>
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index 1a253f649..113772964 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -5,9 +5,6 @@ gold:
   - url: https://platform.sh/try-it-now/?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023
     title: "Build, run and scale your apps on a modern, reliable, and secure PaaS."
     img: https://fastapi.tiangolo.com/img/sponsors/platform-sh.png
-  - url: https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=main-badge
-    title: Fern | SDKs and API docs
-    img: https://fastapi.tiangolo.com/img/sponsors/fern.svg
   - url: https://www.porter.run
     title: Deploy FastAPI on AWS with a few clicks
     img: https://fastapi.tiangolo.com/img/sponsors/porter.png
diff --git a/docs/en/docs/advanced/generate-clients.md b/docs/en/docs/advanced/generate-clients.md
index 07a8f039f..fb9aa643e 100644
--- a/docs/en/docs/advanced/generate-clients.md
+++ b/docs/en/docs/advanced/generate-clients.md
@@ -20,10 +20,9 @@ Some of them also ✨ [**sponsor FastAPI**](../help-fastapi.md#sponsor-the-autho
 
 And it shows their true commitment to FastAPI and its **community** (you), as they not only want to provide you a **good service** but also want to make sure you have a **good and healthy framework**, FastAPI. 🙇
 
-You might want to try their services and follow their guides:
+For example, you might want to try <a href="https://speakeasyapi.dev/?utm_source=fastapi+repo&utm_medium=github+sponsorship" class="external-link" target="_blank">Speakeasy</a>.
 
-* <a href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=docs-generate-clients" class="external-link" target="_blank">Fern</a>
-* <a href="https://speakeasyapi.dev/?utm_source=fastapi+repo&utm_medium=github+sponsorship" class="external-link" target="_blank">Speakeasy</a>
+There are also several other companies offering similar services that you can search and find online. 🤓
 
 ## Generate a TypeScript Frontend Client
 
diff --git a/docs/en/docs/alternatives.md b/docs/en/docs/alternatives.md
index a777ddb98..0f074ccf3 100644
--- a/docs/en/docs/alternatives.md
+++ b/docs/en/docs/alternatives.md
@@ -119,8 +119,6 @@ That's why when talking about version 2.0 it's common to say "Swagger", and for
 
     These two were chosen for being fairly popular and stable, but doing a quick search, you could find dozens of additional alternative user interfaces for OpenAPI (that you can use with **FastAPI**).
 
-    For example, you could try <a href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=docs-alternatives" class="external-link" target="_blank">Fern</a> which is also a FastAPI sponsor. 😎🎉
-
 ### Flask REST frameworks
 
 There are several Flask REST frameworks, but after investing the time and work into investigating them, I found that many are discontinued or abandoned, with several standing issues that made them unfit.
diff --git a/docs/en/overrides/main.html b/docs/en/overrides/main.html
index 9aa452e36..c4aea9a8e 100644
--- a/docs/en/overrides/main.html
+++ b/docs/en/overrides/main.html
@@ -34,12 +34,6 @@
         <img class="sponsor-image" src="/img/sponsors/platform-sh-banner.png" />
       </a>
     </div>
-    <div class="item">
-      <a title="Fern | SDKs and API docs" style="display: block; position: relative;" href="https://www.buildwithfern.com/?utm_source=tiangolo&utm_medium=website&utm_campaign=top-banner" target="_blank">
-        <span class="sponsor-badge">sponsor</span>
-        <img class="sponsor-image" src="/img/sponsors/fern-banner.svg" />
-      </a>
-    </div>
     <div class="item">
       <a title="Deploy FastAPI on AWS with a few clicks" style="display: block; position: relative;" href="https://www.porter.run" target="_blank">
         <span class="sponsor-badge">sponsor</span>

From 6fb951bae2cc1177cf4b03e37b751f81f690402e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 28 Nov 2023 12:10:38 +0000
Subject: [PATCH 285/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 9a6c969ab..153229bc7 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -11,6 +11,7 @@ hide:
 
 ### Internal
 
+* 🔧 Update sponsors, remove Fern. PR [#10729](https://github.com/tiangolo/fastapi/pull/10729) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, add Codacy. PR [#10677](https://github.com/tiangolo/fastapi/pull/10677) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, add Reflex. PR [#10676](https://github.com/tiangolo/fastapi/pull/10676) by [@tiangolo](https://github.com/tiangolo).
 * 📝 Update release notes, move and check latest-changes. PR [#10588](https://github.com/tiangolo/fastapi/pull/10588) by [@tiangolo](https://github.com/tiangolo).

From 99a2ec981b5dc8803d801a667cd8a56b56950730 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Thu, 30 Nov 2023 21:48:01 +0100
Subject: [PATCH 286/317] =?UTF-8?q?=F0=9F=93=9D=20Tweak=20default=20sugges?=
 =?UTF-8?q?ted=20configs=20for=20generating=20clients=20(#10736)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/advanced/generate-clients.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/en/docs/advanced/generate-clients.md b/docs/en/docs/advanced/generate-clients.md
index fb9aa643e..e8d771f71 100644
--- a/docs/en/docs/advanced/generate-clients.md
+++ b/docs/en/docs/advanced/generate-clients.md
@@ -87,7 +87,7 @@ It could look like this:
   "description": "",
   "main": "index.js",
   "scripts": {
-    "generate-client": "openapi --input http://localhost:8000/openapi.json --output ./src/client --client axios"
+    "generate-client": "openapi --input http://localhost:8000/openapi.json --output ./src/client --client axios --useOptions --useUnionTypes"
   },
   "author": "",
   "license": "",
@@ -106,7 +106,7 @@ After having that NPM `generate-client` script there, you can run it with:
 $ npm run generate-client
 
 frontend-app@1.0.0 generate-client /home/user/code/frontend-app
-> openapi --input http://localhost:8000/openapi.json --output ./src/client --client axios
+> openapi --input http://localhost:8000/openapi.json --output ./src/client --client axios --useOptions --useUnionTypes
 ```
 
 </div>
@@ -246,7 +246,7 @@ Now as the end result is in a file `openapi.json`, you would modify the `package
   "description": "",
   "main": "index.js",
   "scripts": {
-    "generate-client": "openapi --input ./openapi.json --output ./src/client --client axios"
+    "generate-client": "openapi --input ./openapi.json --output ./src/client --client axios --useOptions --useUnionTypes"
   },
   "author": "",
   "license": "",

From 8cf2fa0fe4f8701411db779176cc4cfac68d4216 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 30 Nov 2023 20:48:22 +0000
Subject: [PATCH 287/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 153229bc7..f31534457 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,10 @@ hide:
 
 * 🔧 Update sponsors, add Scalar. PR [#10728](https://github.com/tiangolo/fastapi/pull/10728) by [@tiangolo](https://github.com/tiangolo).
 
+### Docs
+
+* 📝 Tweak default suggested configs for generating clients. PR [#10736](https://github.com/tiangolo/fastapi/pull/10736) by [@tiangolo](https://github.com/tiangolo).
+
 ### Internal
 
 * 🔧 Update sponsors, remove Fern. PR [#10729](https://github.com/tiangolo/fastapi/pull/10729) by [@tiangolo](https://github.com/tiangolo).

From ca03379b655165e203460c23a2b036a04d41bd7d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Mon, 4 Dec 2023 12:10:54 +0100
Subject: [PATCH 288/317] =?UTF-8?q?=F0=9F=91=B7=20Update=20build=20docs,?=
 =?UTF-8?q?=20verify=20README=20on=20CI=20(#10750)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/workflows/build-docs.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.github/workflows/build-docs.yml b/.github/workflows/build-docs.yml
index 701c74697..51c069d9e 100644
--- a/.github/workflows/build-docs.yml
+++ b/.github/workflows/build-docs.yml
@@ -28,6 +28,8 @@ jobs:
             - docs/**
             - docs_src/**
             - requirements-docs.txt
+            - .github/workflows/build-docs.yml
+            - .github/workflows/deploy-docs.yml
   langs:
     needs:
       - changes
@@ -55,6 +57,8 @@ jobs:
           pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/squidfunk/mkdocs-material-insiders.git
           pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/pawamoy-insiders/griffe-typing-deprecated.git
           pip install git+https://${{ secrets.FASTAPI_MKDOCS_MATERIAL_INSIDERS }}@github.com/pawamoy-insiders/mkdocstrings-python.git
+      - name: Verify README
+        run: python ./scripts/docs.py verify-readme
       - name: Export Language Codes
         id: show-langs
         run: |

From 01e570c56da2e1e662cc4ebdbce18ec21320a7e6 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 4 Dec 2023 11:11:17 +0000
Subject: [PATCH 289/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f31534457..669f19de7 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -15,6 +15,7 @@ hide:
 
 ### Internal
 
+* 👷 Update build docs, verify README on CI. PR [#10750](https://github.com/tiangolo/fastapi/pull/10750) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, remove Fern. PR [#10729](https://github.com/tiangolo/fastapi/pull/10729) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, add Codacy. PR [#10677](https://github.com/tiangolo/fastapi/pull/10677) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, add Reflex. PR [#10676](https://github.com/tiangolo/fastapi/pull/10676) by [@tiangolo](https://github.com/tiangolo).

From 33493ce694d2f7f1900f6e3128268b10620405f5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 6 Dec 2023 12:33:48 +0100
Subject: [PATCH 290/317] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors,=20add?=
 =?UTF-8?q?=20PropelAuth=20(#10760)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                                       |   1 +
 docs/en/data/sponsors.yml                       |   3 +++
 docs/en/docs/img/sponsors/propelauth-banner.png | Bin 0 -> 12806 bytes
 docs/en/docs/img/sponsors/propelauth.png        | Bin 0 -> 28140 bytes
 docs/en/overrides/main.html                     |   6 ++++++
 5 files changed, 10 insertions(+)
 create mode 100644 docs/en/docs/img/sponsors/propelauth-banner.png
 create mode 100644 docs/en/docs/img/sponsors/propelauth.png

diff --git a/README.md b/README.md
index c8d17889d..2df5cba0b 100644
--- a/README.md
+++ b/README.md
@@ -52,6 +52,7 @@ The key features are:
 <a href="https://bump.sh/fastapi?utm_source=fastapi&utm_medium=referral&utm_campaign=sponsor" target="_blank" title="Automate FastAPI documentation generation with Bump.sh"><img src="https://fastapi.tiangolo.com/img/sponsors/bump-sh.svg"></a>
 <a href="https://reflex.dev" target="_blank" title="Reflex"><img src="https://fastapi.tiangolo.com/img/sponsors/reflex.png"></a>
 <a href="https://github.com/scalar/scalar/?utm_source=fastapi&utm_medium=website&utm_campaign=main-badge" target="_blank" title="Scalar: Beautiful Open-Source API References from Swagger/OpenAPI files"><img src="https://fastapi.tiangolo.com/img/sponsors/scalar.svg"></a>
+<a href="https://www.propelauth.com/?utm_source=fastapi&utm_campaign=1223&utm_medium=mainbadge" target="_blank" title="Auth, user management and more for your B2B product"><img src="https://fastapi.tiangolo.com/img/sponsors/propelauth.png"></a>
 <a href="https://www.deta.sh/?ref=fastapi" target="_blank" title="The launchpad for all your (team's) ideas"><img src="https://fastapi.tiangolo.com/img/sponsors/deta.svg"></a>
 <a href="https://training.talkpython.fm/fastapi-courses" target="_blank" title="FastAPI video courses on demand from people you trust"><img src="https://fastapi.tiangolo.com/img/sponsors/talkpython.png"></a>
 <a href="https://testdriven.io/courses/tdd-fastapi/" target="_blank" title="Learn to build high-quality web apps with best practices"><img src="https://fastapi.tiangolo.com/img/sponsors/testdriven.svg"></a>
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index 113772964..121a3b761 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -17,6 +17,9 @@ gold:
   - url: https://github.com/scalar/scalar/?utm_source=fastapi&utm_medium=website&utm_campaign=main-badge
     title: "Scalar: Beautiful Open-Source API References from Swagger/OpenAPI files"
     img: https://fastapi.tiangolo.com/img/sponsors/scalar.svg
+  - url: https://www.propelauth.com/?utm_source=fastapi&utm_campaign=1223&utm_medium=mainbadge
+    title: Auth, user management and more for your B2B product
+    img: https://fastapi.tiangolo.com/img/sponsors/propelauth.png
 silver:
   - url: https://www.deta.sh/?ref=fastapi
     title: The launchpad for all your (team's) ideas
diff --git a/docs/en/docs/img/sponsors/propelauth-banner.png b/docs/en/docs/img/sponsors/propelauth-banner.png
new file mode 100644
index 0000000000000000000000000000000000000000..7a1bb2580395a3b4168073114fa076a3fd759cd8
GIT binary patch
literal 12806
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
QZ#W?2q?9D9#0`V~2UC@28~^|S

literal 0
HcmV?d00001

diff --git a/docs/en/docs/img/sponsors/propelauth.png b/docs/en/docs/img/sponsors/propelauth.png
new file mode 100644
index 0000000000000000000000000000000000000000..8234d631f6b672d206726279a49dbea30088aee8
GIT binary patch
literal 28140
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
UF3yy*BLDyZ07*qoM6N<$f*2~LU;qFB

literal 0
HcmV?d00001

diff --git a/docs/en/overrides/main.html b/docs/en/overrides/main.html
index c4aea9a8e..476b43676 100644
--- a/docs/en/overrides/main.html
+++ b/docs/en/overrides/main.html
@@ -58,6 +58,12 @@
         <img class="sponsor-image" src="/img/sponsors/scalar-banner.svg" />
       </a>
     </div>
+    <div class="item">
+      <a title="Auth, user management and more for your B2B product" style="display: block; position: relative;" href="https://www.propelauth.com/?utm_source=fastapi&utm_campaign=1223&utm_medium=topbanner" target="_blank">
+        <span class="sponsor-badge">sponsor</span>
+        <img class="sponsor-image" src="/img/sponsors/propelauth-banner.png" />
+      </a>
+    </div>
   </div>
 </div>
 {% endblock %}

From 73dcc40f09e3587b10d3a93ee225c2f5d3fc83cb Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 6 Dec 2023 11:34:10 +0000
Subject: [PATCH 291/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 669f19de7..dcff8a69d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -15,6 +15,7 @@ hide:
 
 ### Internal
 
+* 🔧 Update sponsors, add PropelAuth. PR [#10760](https://github.com/tiangolo/fastapi/pull/10760) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Update build docs, verify README on CI. PR [#10750](https://github.com/tiangolo/fastapi/pull/10750) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, remove Fern. PR [#10729](https://github.com/tiangolo/fastapi/pull/10729) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, add Codacy. PR [#10677](https://github.com/tiangolo/fastapi/pull/10677) by [@tiangolo](https://github.com/tiangolo).

From 6f5aa81c076d22e38afbe7d602db6730e28bc3cc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 12 Dec 2023 00:22:47 +0000
Subject: [PATCH 292/317] =?UTF-8?q?=E2=9C=A8=20Add=20support=20for=20multi?=
 =?UTF-8?q?ple=20Annotated=20annotations,=20e.g.=20`Annotated[str,=20Field?=
 =?UTF-8?q?(),=20Query()]`=20(#10773)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .github/workflows/test.yml     |  4 +--
 fastapi/_compat.py             |  7 ++++-
 fastapi/dependencies/utils.py  | 53 +++++++++++++++++++---------------
 tests/test_ambiguous_params.py | 27 +++++++++++------
 tests/test_annotated.py        |  2 +-
 5 files changed, 57 insertions(+), 36 deletions(-)

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 59754525d..7ebb80efd 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -29,7 +29,7 @@ jobs:
         id: cache
         with:
           path: ${{ env.pythonLocation }}
-          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-pydantic-v2-${{ hashFiles('pyproject.toml', 'requirements-tests.txt', 'requirements-docs-tests.txt') }}-test-v06
+          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-pydantic-v2-${{ hashFiles('pyproject.toml', 'requirements-tests.txt', 'requirements-docs-tests.txt') }}-test-v07
       - name: Install Dependencies
         if: steps.cache.outputs.cache-hit != 'true'
         run: pip install -r requirements-tests.txt
@@ -62,7 +62,7 @@ jobs:
         id: cache
         with:
           path: ${{ env.pythonLocation }}
-          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-${{ matrix.pydantic-version }}-${{ hashFiles('pyproject.toml', 'requirements-tests.txt', 'requirements-docs-tests.txt') }}-test-v06
+          key: ${{ runner.os }}-python-${{ env.pythonLocation }}-${{ matrix.pydantic-version }}-${{ hashFiles('pyproject.toml', 'requirements-tests.txt', 'requirements-docs-tests.txt') }}-test-v07
       - name: Install Dependencies
         if: steps.cache.outputs.cache-hit != 'true'
         run: pip install -r requirements-tests.txt
diff --git a/fastapi/_compat.py b/fastapi/_compat.py
index fc605d0ec..35d4a8723 100644
--- a/fastapi/_compat.py
+++ b/fastapi/_compat.py
@@ -249,7 +249,12 @@ if PYDANTIC_V2:
         return is_bytes_sequence_annotation(field.type_)
 
     def copy_field_info(*, field_info: FieldInfo, annotation: Any) -> FieldInfo:
-        return type(field_info).from_annotation(annotation)
+        cls = type(field_info)
+        merged_field_info = cls.from_annotation(annotation)
+        new_field_info = copy(field_info)
+        new_field_info.metadata = merged_field_info.metadata
+        new_field_info.annotation = merged_field_info.annotation
+        return new_field_info
 
     def serialize_sequence_value(*, field: ModelField, value: Any) -> Sequence[Any]:
         origin_type = (
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index 96e07a45c..4e88410a5 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -325,10 +325,11 @@ def analyze_param(
     field_info = None
     depends = None
     type_annotation: Any = Any
-    if (
-        annotation is not inspect.Signature.empty
-        and get_origin(annotation) is Annotated
-    ):
+    use_annotation: Any = Any
+    if annotation is not inspect.Signature.empty:
+        use_annotation = annotation
+        type_annotation = annotation
+    if get_origin(use_annotation) is Annotated:
         annotated_args = get_args(annotation)
         type_annotation = annotated_args[0]
         fastapi_annotations = [
@@ -336,14 +337,21 @@ def analyze_param(
             for arg in annotated_args[1:]
             if isinstance(arg, (FieldInfo, params.Depends))
         ]
-        assert (
-            len(fastapi_annotations) <= 1
-        ), f"Cannot specify multiple `Annotated` FastAPI arguments for {param_name!r}"
-        fastapi_annotation = next(iter(fastapi_annotations), None)
+        fastapi_specific_annotations = [
+            arg
+            for arg in fastapi_annotations
+            if isinstance(arg, (params.Param, params.Body, params.Depends))
+        ]
+        if fastapi_specific_annotations:
+            fastapi_annotation: Union[
+                FieldInfo, params.Depends, None
+            ] = fastapi_specific_annotations[-1]
+        else:
+            fastapi_annotation = None
         if isinstance(fastapi_annotation, FieldInfo):
             # Copy `field_info` because we mutate `field_info.default` below.
             field_info = copy_field_info(
-                field_info=fastapi_annotation, annotation=annotation
+                field_info=fastapi_annotation, annotation=use_annotation
             )
             assert field_info.default is Undefined or field_info.default is Required, (
                 f"`{field_info.__class__.__name__}` default value cannot be set in"
@@ -356,8 +364,6 @@ def analyze_param(
                 field_info.default = Required
         elif isinstance(fastapi_annotation, params.Depends):
             depends = fastapi_annotation
-    elif annotation is not inspect.Signature.empty:
-        type_annotation = annotation
 
     if isinstance(value, params.Depends):
         assert depends is None, (
@@ -402,15 +408,15 @@ def analyze_param(
             # We might check here that `default_value is Required`, but the fact is that the same
             # parameter might sometimes be a path parameter and sometimes not. See
             # `tests/test_infer_param_optionality.py` for an example.
-            field_info = params.Path(annotation=type_annotation)
+            field_info = params.Path(annotation=use_annotation)
         elif is_uploadfile_or_nonable_uploadfile_annotation(
             type_annotation
         ) or is_uploadfile_sequence_annotation(type_annotation):
-            field_info = params.File(annotation=type_annotation, default=default_value)
+            field_info = params.File(annotation=use_annotation, default=default_value)
         elif not field_annotation_is_scalar(annotation=type_annotation):
-            field_info = params.Body(annotation=type_annotation, default=default_value)
+            field_info = params.Body(annotation=use_annotation, default=default_value)
         else:
-            field_info = params.Query(annotation=type_annotation, default=default_value)
+            field_info = params.Query(annotation=use_annotation, default=default_value)
 
     field = None
     if field_info is not None:
@@ -424,8 +430,8 @@ def analyze_param(
             and getattr(field_info, "in_", None) is None
         ):
             field_info.in_ = params.ParamTypes.query
-        use_annotation = get_annotation_from_field_info(
-            type_annotation,
+        use_annotation_from_field_info = get_annotation_from_field_info(
+            use_annotation,
             field_info,
             param_name,
         )
@@ -436,7 +442,7 @@ def analyze_param(
         field_info.alias = alias
         field = create_response_field(
             name=param_name,
-            type_=use_annotation,
+            type_=use_annotation_from_field_info,
             default=field_info.default,
             alias=alias,
             required=field_info.default in (Required, Undefined),
@@ -466,16 +472,17 @@ def is_body_param(*, param_field: ModelField, is_path_param: bool) -> bool:
 
 
 def add_param_to_fields(*, field: ModelField, dependant: Dependant) -> None:
-    field_info = cast(params.Param, field.field_info)
-    if field_info.in_ == params.ParamTypes.path:
+    field_info = field.field_info
+    field_info_in = getattr(field_info, "in_", None)
+    if field_info_in == params.ParamTypes.path:
         dependant.path_params.append(field)
-    elif field_info.in_ == params.ParamTypes.query:
+    elif field_info_in == params.ParamTypes.query:
         dependant.query_params.append(field)
-    elif field_info.in_ == params.ParamTypes.header:
+    elif field_info_in == params.ParamTypes.header:
         dependant.header_params.append(field)
     else:
         assert (
-            field_info.in_ == params.ParamTypes.cookie
+            field_info_in == params.ParamTypes.cookie
         ), f"non-body parameters must be in path, query, header or cookie: {field.name}"
         dependant.cookie_params.append(field)
 
diff --git a/tests/test_ambiguous_params.py b/tests/test_ambiguous_params.py
index 42bcc27a1..8a31442eb 100644
--- a/tests/test_ambiguous_params.py
+++ b/tests/test_ambiguous_params.py
@@ -1,6 +1,8 @@
 import pytest
 from fastapi import Depends, FastAPI, Path
 from fastapi.param_functions import Query
+from fastapi.testclient import TestClient
+from fastapi.utils import PYDANTIC_V2
 from typing_extensions import Annotated
 
 app = FastAPI()
@@ -28,18 +30,13 @@ def test_no_annotated_defaults():
             pass  # pragma: nocover
 
 
-def test_no_multiple_annotations():
+def test_multiple_annotations():
     async def dep():
         pass  # pragma: nocover
 
-    with pytest.raises(
-        AssertionError,
-        match="Cannot specify multiple `Annotated` FastAPI arguments for 'foo'",
-    ):
-
-        @app.get("/")
-        async def get(foo: Annotated[int, Query(min_length=1), Query()]):
-            pass  # pragma: nocover
+    @app.get("/multi-query")
+    async def get(foo: Annotated[int, Query(gt=2), Query(lt=10)]):
+        return foo
 
     with pytest.raises(
         AssertionError,
@@ -64,3 +61,15 @@ def test_no_multiple_annotations():
         @app.get("/")
         async def get3(foo: Annotated[int, Query(min_length=1)] = Depends(dep)):
             pass  # pragma: nocover
+
+    client = TestClient(app)
+    response = client.get("/multi-query", params={"foo": "5"})
+    assert response.status_code == 200
+    assert response.json() == 5
+
+    response = client.get("/multi-query", params={"foo": "123"})
+    assert response.status_code == 422
+
+    if PYDANTIC_V2:
+        response = client.get("/multi-query", params={"foo": "1"})
+        assert response.status_code == 422
diff --git a/tests/test_annotated.py b/tests/test_annotated.py
index 541f84bca..2222be978 100644
--- a/tests/test_annotated.py
+++ b/tests/test_annotated.py
@@ -57,7 +57,7 @@ foo_is_short = {
             {
                 "ctx": {"min_length": 1},
                 "loc": ["query", "foo"],
-                "msg": "String should have at least 1 characters",
+                "msg": "String should have at least 1 character",
                 "type": "string_too_short",
                 "input": "",
                 "url": match_pydantic_error_url("string_too_short"),

From ba99214417f4229277aced266f69511d5ce50f6d Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 12 Dec 2023 00:23:15 +0000
Subject: [PATCH 293/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index dcff8a69d..915f70696 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,10 @@ hide:
 
 * 🔧 Update sponsors, add Scalar. PR [#10728](https://github.com/tiangolo/fastapi/pull/10728) by [@tiangolo](https://github.com/tiangolo).
 
+### Features
+
+* ✨ Add support for multiple Annotated annotations, e.g. `Annotated[str, Field(), Query()]`. PR [#10773](https://github.com/tiangolo/fastapi/pull/10773) by [@tiangolo](https://github.com/tiangolo).
+
 ### Docs
 
 * 📝 Tweak default suggested configs for generating clients. PR [#10736](https://github.com/tiangolo/fastapi/pull/10736) by [@tiangolo](https://github.com/tiangolo).

From b98c65cb36b5f6ee159f4b2a99fbc380247b8820 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 12 Dec 2023 00:29:03 +0000
Subject: [PATCH 294/317] =?UTF-8?q?=F0=9F=94=A5=20Remove=20unused=20NoneTy?=
 =?UTF-8?q?pe=20(#10774)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 fastapi/types.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/fastapi/types.py b/fastapi/types.py
index 7adf565a7..3205654c7 100644
--- a/fastapi/types.py
+++ b/fastapi/types.py
@@ -6,6 +6,5 @@ from pydantic import BaseModel
 
 DecoratedCallable = TypeVar("DecoratedCallable", bound=Callable[..., Any])
 UnionType = getattr(types, "UnionType", Union)
-NoneType = getattr(types, "UnionType", None)
 ModelNameMap = Dict[Union[Type[BaseModel], Type[Enum]], str]
 IncEx = Union[Set[int], Set[str], Dict[int, Any], Dict[str, Any]]

From fc51d7e3c7908d3e588ddc57cb942129f8c55d4c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 12 Dec 2023 00:29:29 +0000
Subject: [PATCH 295/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 915f70696..a3517f51d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,10 @@ hide:
 
 * ✨ Add support for multiple Annotated annotations, e.g. `Annotated[str, Field(), Query()]`. PR [#10773](https://github.com/tiangolo/fastapi/pull/10773) by [@tiangolo](https://github.com/tiangolo).
 
+### Refactors
+
+* 🔥 Remove unused NoneType. PR [#10774](https://github.com/tiangolo/fastapi/pull/10774) by [@tiangolo](https://github.com/tiangolo).
+
 ### Docs
 
 * 📝 Tweak default suggested configs for generating clients. PR [#10736](https://github.com/tiangolo/fastapi/pull/10736) by [@tiangolo](https://github.com/tiangolo).

From d8185efb6effd36c162bc7ab8e1e2c597fb3b7a8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 12 Dec 2023 00:32:48 +0000
Subject: [PATCH 296/317] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.10?=
 =?UTF-8?q?5.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 5 +++--
 fastapi/__init__.py           | 2 +-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index a3517f51d..2d60a6aa9 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -5,9 +5,9 @@ hide:
 
 # Release Notes
 
-## Latest Changes
+## 0.105.0
 
-* 🔧 Update sponsors, add Scalar. PR [#10728](https://github.com/tiangolo/fastapi/pull/10728) by [@tiangolo](https://github.com/tiangolo).
+## Latest Changes
 
 ### Features
 
@@ -23,6 +23,7 @@ hide:
 
 ### Internal
 
+* 🔧 Update sponsors, add Scalar. PR [#10728](https://github.com/tiangolo/fastapi/pull/10728) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, add PropelAuth. PR [#10760](https://github.com/tiangolo/fastapi/pull/10760) by [@tiangolo](https://github.com/tiangolo).
 * 👷 Update build docs, verify README on CI. PR [#10750](https://github.com/tiangolo/fastapi/pull/10750) by [@tiangolo](https://github.com/tiangolo).
 * 🔧 Update sponsors, remove Fern. PR [#10729](https://github.com/tiangolo/fastapi/pull/10729) by [@tiangolo](https://github.com/tiangolo).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index c81f09b27..dd16ea34d 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.104.1"
+__version__ = "0.105.0"
 
 from starlette import status as status
 

From 36c26677682c4245183912e00fc057c05cc6cf7a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 12 Dec 2023 00:34:36 +0000
Subject: [PATCH 297/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2d60a6aa9..835df984c 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -5,10 +5,10 @@ hide:
 
 # Release Notes
 
-## 0.105.0
-
 ## Latest Changes
 
+## 0.105.0
+
 ### Features
 
 * ✨ Add support for multiple Annotated annotations, e.g. `Annotated[str, Field(), Query()]`. PR [#10773](https://github.com/tiangolo/fastapi/pull/10773) by [@tiangolo](https://github.com/tiangolo).

From dc2fdd56af0fc9f98179486151650c522530a7e4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 20 Dec 2023 18:05:37 +0100
Subject: [PATCH 298/317] =?UTF-8?q?=F0=9F=91=A5=20Update=20FastAPI=20Peopl?=
 =?UTF-8?q?e=20(#10567)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: github-actions <github-actions@github.com>
---
 docs/en/data/github_sponsors.yml |  97 ++++++++++-----------
 docs/en/data/people.yml          | 142 +++++++++++++++++--------------
 2 files changed, 124 insertions(+), 115 deletions(-)

diff --git a/docs/en/data/github_sponsors.yml b/docs/en/data/github_sponsors.yml
index b9d74ea7b..43b4b8c6b 100644
--- a/docs/en/data/github_sponsors.yml
+++ b/docs/en/data/github_sponsors.yml
@@ -1,5 +1,8 @@
 sponsors:
-- - login: bump-sh
+- - login: codacy
+    avatarUrl: https://avatars.githubusercontent.com/u/1834093?v=4
+    url: https://github.com/codacy
+  - login: bump-sh
     avatarUrl: https://avatars.githubusercontent.com/u/33217836?v=4
     url: https://github.com/bump-sh
   - login: cryptapi
@@ -11,9 +14,6 @@ sponsors:
   - login: fern-api
     avatarUrl: https://avatars.githubusercontent.com/u/102944815?v=4
     url: https://github.com/fern-api
-  - login: nanram22
-    avatarUrl: https://avatars.githubusercontent.com/u/116367316?v=4
-    url: https://github.com/nanram22
 - - login: nihpo
     avatarUrl: https://avatars.githubusercontent.com/u/1841030?u=0264956d7580f7e46687a762a7baa629f84cf97c&v=4
     url: https://github.com/nihpo
@@ -32,12 +32,12 @@ sponsors:
   - login: deepset-ai
     avatarUrl: https://avatars.githubusercontent.com/u/51827949?v=4
     url: https://github.com/deepset-ai
+  - login: databento
+    avatarUrl: https://avatars.githubusercontent.com/u/64141749?v=4
+    url: https://github.com/databento
   - login: svix
     avatarUrl: https://avatars.githubusercontent.com/u/80175132?v=4
     url: https://github.com/svix
-  - login: databento-bot
-    avatarUrl: https://avatars.githubusercontent.com/u/98378480?u=494f679996e39427f7ddb1a7de8441b7c96fb670&v=4
-    url: https://github.com/databento-bot
   - login: VincentParedes
     avatarUrl: https://avatars.githubusercontent.com/u/103889729?v=4
     url: https://github.com/VincentParedes
@@ -65,10 +65,7 @@ sponsors:
   - login: Trivie
     avatarUrl: https://avatars.githubusercontent.com/u/8161763?v=4
     url: https://github.com/Trivie
-- - login: moellenbeck
-    avatarUrl: https://avatars.githubusercontent.com/u/169372?v=4
-    url: https://github.com/moellenbeck
-  - login: birkjernstrom
+- - login: birkjernstrom
     avatarUrl: https://avatars.githubusercontent.com/u/281715?u=4be14b43f76b4bd497b1941309bb390250b405e6&v=4
     url: https://github.com/birkjernstrom
   - login: yasyf
@@ -83,15 +80,15 @@ sponsors:
   - login: mainframeindustries
     avatarUrl: https://avatars.githubusercontent.com/u/55092103?v=4
     url: https://github.com/mainframeindustries
+  - login: deployplex
+    avatarUrl: https://avatars.githubusercontent.com/u/57115726?v=4
+    url: https://github.com/deployplex
 - - login: povilasb
     avatarUrl: https://avatars.githubusercontent.com/u/1213442?u=b11f58ed6ceea6e8297c9b310030478ebdac894d&v=4
     url: https://github.com/povilasb
   - login: primer-io
     avatarUrl: https://avatars.githubusercontent.com/u/62146168?v=4
     url: https://github.com/primer-io
-- - login: NateXVI
-    avatarUrl: https://avatars.githubusercontent.com/u/48195620?u=4bc8751ae50cb087c40c1fe811764aa070b9eea6&v=4
-    url: https://github.com/NateXVI
 - - login: Kludex
     avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
     url: https://github.com/Kludex
@@ -125,12 +122,12 @@ sponsors:
   - login: tcsmith
     avatarUrl: https://avatars.githubusercontent.com/u/989034?u=7d8d741552b3279e8f4d3878679823a705a46f8f&v=4
     url: https://github.com/tcsmith
-  - login: mrkmcknz
-    avatarUrl: https://avatars.githubusercontent.com/u/1089376?u=2b9b8a8c25c33a4f6c220095638bd821cdfd13a3&v=4
-    url: https://github.com/mrkmcknz
   - login: mickaelandrieu
     avatarUrl: https://avatars.githubusercontent.com/u/1247388?u=599f6e73e452a9453f2bd91e5c3100750e731ad4&v=4
     url: https://github.com/mickaelandrieu
+  - login: knallgelb
+    avatarUrl: https://avatars.githubusercontent.com/u/2358812?u=c48cb6362b309d74cbf144bd6ad3aed3eb443e82&v=4
+    url: https://github.com/knallgelb
   - login: Shark009
     avatarUrl: https://avatars.githubusercontent.com/u/3163309?u=0c6f4091b0eda05c44c390466199826e6dc6e431&v=4
     url: https://github.com/Shark009
@@ -174,7 +171,7 @@ sponsors:
     avatarUrl: https://avatars.githubusercontent.com/u/6152183?u=c485eefca5c6329600cae63dd35e4f5682ce6924&v=4
     url: https://github.com/iwpnd
   - login: FernandoCelmer
-    avatarUrl: https://avatars.githubusercontent.com/u/6262214?u=ab6108a843a2fb9df0934f482375d2907609f3ff&v=4
+    avatarUrl: https://avatars.githubusercontent.com/u/6262214?u=d29fff3fd862fda4ca752079f13f32e84c762ea4&v=4
     url: https://github.com/FernandoCelmer
   - login: simw
     avatarUrl: https://avatars.githubusercontent.com/u/6322526?v=4
@@ -188,6 +185,9 @@ sponsors:
   - login: wdwinslow
     avatarUrl: https://avatars.githubusercontent.com/u/11562137?u=dc01daafb354135603a263729e3d26d939c0c452&v=4
     url: https://github.com/wdwinslow
+  - login: drcat101
+    avatarUrl: https://avatars.githubusercontent.com/u/11951946?u=e714b957185b8cf3d301cced7fc3ad2842122c6a&v=4
+    url: https://github.com/drcat101
   - login: jsoques
     avatarUrl: https://avatars.githubusercontent.com/u/12414216?u=620921d94196546cc8b9eae2cc4cbc3f95bab42f&v=4
     url: https://github.com/jsoques
@@ -212,9 +212,6 @@ sponsors:
   - login: Filimoa
     avatarUrl: https://avatars.githubusercontent.com/u/21352040?u=0be845711495bbd7b756e13fcaeb8efc1ebd78ba&v=4
     url: https://github.com/Filimoa
-  - login: rahulsalgare
-    avatarUrl: https://avatars.githubusercontent.com/u/21974430?u=ade6f182b94554ab8491d7421de5e78f711dcaf8&v=4
-    url: https://github.com/rahulsalgare
   - login: BrettskiPy
     avatarUrl: https://avatars.githubusercontent.com/u/30988215?u=d8a94a67e140d5ee5427724b292cc52d8827087a&v=4
     url: https://github.com/BrettskiPy
@@ -269,9 +266,12 @@ sponsors:
   - login: pyt3h
     avatarUrl: https://avatars.githubusercontent.com/u/99658549?v=4
     url: https://github.com/pyt3h
-- - login: SebTota
-    avatarUrl: https://avatars.githubusercontent.com/u/25122511?v=4
-    url: https://github.com/SebTota
+  - login: apitally
+    avatarUrl: https://avatars.githubusercontent.com/u/138365043?v=4
+    url: https://github.com/apitally
+- - login: getsentry
+    avatarUrl: https://avatars.githubusercontent.com/u/1396951?v=4
+    url: https://github.com/getsentry
 - - login: pawamoy
     avatarUrl: https://avatars.githubusercontent.com/u/3999221?u=b030e4c89df2f3a36bc4710b925bdeb6745c9856&v=4
     url: https://github.com/pawamoy
@@ -299,6 +299,9 @@ sponsors:
   - login: securancy
     avatarUrl: https://avatars.githubusercontent.com/u/606673?v=4
     url: https://github.com/securancy
+  - login: natehouk
+    avatarUrl: https://avatars.githubusercontent.com/u/805439?u=d8e4be629dc5d7efae7146157e41ee0bd129d9bc&v=4
+    url: https://github.com/natehouk
   - login: browniebroke
     avatarUrl: https://avatars.githubusercontent.com/u/861044?u=5abfca5588f3e906b31583d7ee62f6de4b68aa24&v=4
     url: https://github.com/browniebroke
@@ -323,9 +326,9 @@ sponsors:
   - login: anthonycorletti
     avatarUrl: https://avatars.githubusercontent.com/u/3477132?v=4
     url: https://github.com/anthonycorletti
-  - login: nikeee
-    avatarUrl: https://avatars.githubusercontent.com/u/4068864?u=bbe73151f2b409c120160d032dc9aa6875ef0c4b&v=4
-    url: https://github.com/nikeee
+  - login: erhan
+    avatarUrl: https://avatars.githubusercontent.com/u/3872888?u=cd9a20fcd33c5598d9d7797a78dedfc9148592f6&v=4
+    url: https://github.com/erhan
   - login: Alisa-lisa
     avatarUrl: https://avatars.githubusercontent.com/u/4137964?u=e7e393504f554f4ff15863a1e01a5746863ef9ce&v=4
     url: https://github.com/Alisa-lisa
@@ -366,7 +369,7 @@ sponsors:
     avatarUrl: https://avatars.githubusercontent.com/u/8574425?u=aad2a9674273c9275fe414d99269b7418d144089&v=4
     url: https://github.com/albertkun
   - login: xncbf
-    avatarUrl: https://avatars.githubusercontent.com/u/9462045?u=866a1311e4bd3ec5ae84185c4fcc99f397c883d7&v=4
+    avatarUrl: https://avatars.githubusercontent.com/u/9462045?u=05cb2d7c797a02f666805ad4639d9582f31d432c&v=4
     url: https://github.com/xncbf
   - login: DMantis
     avatarUrl: https://avatars.githubusercontent.com/u/9536869?v=4
@@ -398,9 +401,6 @@ sponsors:
   - login: jangia
     avatarUrl: https://avatars.githubusercontent.com/u/17927101?u=9261b9bb0c3e3bb1ecba43e8915dc58d8c9a077e&v=4
     url: https://github.com/jangia
-  - login: timzaz
-    avatarUrl: https://avatars.githubusercontent.com/u/19709244?u=264d7db95c28156363760229c30ee1116efd4eeb&v=4
-    url: https://github.com/timzaz
   - login: shuheng-liu
     avatarUrl: https://avatars.githubusercontent.com/u/22414322?u=813c45f30786c6b511b21a661def025d8f7b609e&v=4
     url: https://github.com/shuheng-liu
@@ -419,15 +419,15 @@ sponsors:
   - login: joerambo
     avatarUrl: https://avatars.githubusercontent.com/u/26282974?v=4
     url: https://github.com/joerambo
-  - login: msniezynski
-    avatarUrl: https://avatars.githubusercontent.com/u/27588547?u=0e3be5ac57dcfdf124f470bcdf74b5bf79af1b6c&v=4
-    url: https://github.com/msniezynski
   - login: rlnchow
     avatarUrl: https://avatars.githubusercontent.com/u/28018479?u=a93ca9cf1422b9ece155784a72d5f2fdbce7adff&v=4
     url: https://github.com/rlnchow
   - login: mertguvencli
     avatarUrl: https://avatars.githubusercontent.com/u/29762151?u=16a906d90df96c8cff9ea131a575c4bc171b1523&v=4
     url: https://github.com/mertguvencli
+  - login: White-Mask
+    avatarUrl: https://avatars.githubusercontent.com/u/31826970?u=8625355dc25ddf9c85a8b2b0b9932826c4c8f44c&v=4
+    url: https://github.com/White-Mask
   - login: HosamAlmoghraby
     avatarUrl: https://avatars.githubusercontent.com/u/32025281?u=aa1b09feabccbf9dc506b81c71155f32d126cefa&v=4
     url: https://github.com/HosamAlmoghraby
@@ -435,14 +435,11 @@ sponsors:
     avatarUrl: https://avatars.githubusercontent.com/u/33275230?u=eb223cad27017bb1e936ee9b429b450d092d0236&v=4
     url: https://github.com/engineerjoe440
   - login: bnkc
-    avatarUrl: https://avatars.githubusercontent.com/u/34930566?u=1a104991a2ea90bfe304bc0b9ef191c7e4891a0e&v=4
+    avatarUrl: https://avatars.githubusercontent.com/u/34930566?u=ea88e4bd668c984cff1bca3e71ab2deb37fafdc4&v=4
     url: https://github.com/bnkc
   - login: declon
     avatarUrl: https://avatars.githubusercontent.com/u/36180226?v=4
     url: https://github.com/declon
-  - login: miraedbswo
-    avatarUrl: https://avatars.githubusercontent.com/u/36796047?u=9e7a5b3e558edc61d35d0f9dfac37541bae7f56d&v=4
-    url: https://github.com/miraedbswo
   - login: DSMilestone6538
     avatarUrl: https://avatars.githubusercontent.com/u/37230924?u=f299dce910366471523155e0cb213356d34aadc1&v=4
     url: https://github.com/DSMilestone6538
@@ -458,9 +455,6 @@ sponsors:
   - login: ArtyomVancyan
     avatarUrl: https://avatars.githubusercontent.com/u/44609997?v=4
     url: https://github.com/ArtyomVancyan
-  - login: josehenriqueroveda
-    avatarUrl: https://avatars.githubusercontent.com/u/46685746?u=2e672057a7dbe1dba47e57c378fc0cac336022eb&v=4
-    url: https://github.com/josehenriqueroveda
   - login: hgalytoby
     avatarUrl: https://avatars.githubusercontent.com/u/50397689?u=f4888c2c54929bd86eed0d3971d09fcb306e5088&v=4
     url: https://github.com/hgalytoby
@@ -473,12 +467,18 @@ sponsors:
   - login: 0417taehyun
     avatarUrl: https://avatars.githubusercontent.com/u/63915557?u=47debaa860fd52c9b98c97ef357ddcec3b3fb399&v=4
     url: https://github.com/0417taehyun
+  - login: fernandosmither
+    avatarUrl: https://avatars.githubusercontent.com/u/66154723?u=a76a037b5d674938a75d2cff862fb6dfd63ec214&v=4
+    url: https://github.com/fernandosmither
   - login: romabozhanovgithub
     avatarUrl: https://avatars.githubusercontent.com/u/67696229?u=e4b921eef096415300425aca249348f8abb78ad7&v=4
     url: https://github.com/romabozhanovgithub
   - login: mbukeRepo
     avatarUrl: https://avatars.githubusercontent.com/u/70356088?u=d2eb23e2b222a3b316c4183b05a3236b32819dc2&v=4
     url: https://github.com/mbukeRepo
+  - login: PelicanQ
+    avatarUrl: https://avatars.githubusercontent.com/u/77930606?v=4
+    url: https://github.com/PelicanQ
 - - login: ssbarnea
     avatarUrl: https://avatars.githubusercontent.com/u/102495?u=b4bf6818deefe59952ac22fec6ed8c76de1b8f7c&v=4
     url: https://github.com/ssbarnea
@@ -491,18 +491,15 @@ sponsors:
   - login: sadikkuzu
     avatarUrl: https://avatars.githubusercontent.com/u/23168063?u=d179c06bb9f65c4167fcab118526819f8e0dac17&v=4
     url: https://github.com/sadikkuzu
-  - login: samnimoh
-    avatarUrl: https://avatars.githubusercontent.com/u/33413170?u=147bc516be6cb647b28d7e3b3fea3a018a331145&v=4
-    url: https://github.com/samnimoh
+  - login: msniezynski
+    avatarUrl: https://avatars.githubusercontent.com/u/27588547?u=0e3be5ac57dcfdf124f470bcdf74b5bf79af1b6c&v=4
+    url: https://github.com/msniezynski
   - login: danburonline
     avatarUrl: https://avatars.githubusercontent.com/u/34251194?u=2cad4388c1544e539ecb732d656e42fb07b4ff2d&v=4
     url: https://github.com/danburonline
   - login: rwxd
     avatarUrl: https://avatars.githubusercontent.com/u/40308458?u=cd04a39e3655923be4f25c2ba8a5a07b3da3230a&v=4
     url: https://github.com/rwxd
-  - login: shywn-mrk
-    avatarUrl: https://avatars.githubusercontent.com/u/51455763?u=389e2608e4056fe5e1f23e9ad56a9415277504d3&v=4
-    url: https://github.com/shywn-mrk
-  - login: almeida-matheus
-    avatarUrl: https://avatars.githubusercontent.com/u/66216198?u=54335eaa0ced626be5c1ff52fead1ebc032286ec&v=4
-    url: https://github.com/almeida-matheus
+  - login: IvanReyesO7
+    avatarUrl: https://avatars.githubusercontent.com/u/74359151?u=4b2c368f71e1411b462a8c2290c920ad35dc1af8&v=4
+    url: https://github.com/IvanReyesO7
diff --git a/docs/en/data/people.yml b/docs/en/data/people.yml
index db06cbdaf..2e84f1128 100644
--- a/docs/en/data/people.yml
+++ b/docs/en/data/people.yml
@@ -1,12 +1,12 @@
 maintainers:
 - login: tiangolo
-  answers: 1868
-  prs: 496
+  answers: 1870
+  prs: 508
   avatarUrl: https://avatars.githubusercontent.com/u/1326112?u=740f11212a731f56798f558ceddb0bd07642afa7&v=4
   url: https://github.com/tiangolo
 experts:
 - login: Kludex
-  count: 501
+  count: 512
   avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
   url: https://github.com/Kludex
 - login: dmontagu
@@ -26,21 +26,21 @@ experts:
   avatarUrl: https://avatars.githubusercontent.com/u/13659033?u=e8bea32d07a5ef72f7dde3b2079ceb714923ca05&v=4
   url: https://github.com/JarroVGIT
 - login: jgould22
-  count: 168
+  count: 186
   avatarUrl: https://avatars.githubusercontent.com/u/4335847?u=ed77f67e0bb069084639b24d812dbb2a2b1dc554&v=4
   url: https://github.com/jgould22
 - login: euri10
   count: 153
   avatarUrl: https://avatars.githubusercontent.com/u/1104190?u=321a2e953e6645a7d09b732786c7a8061e0f8a8b&v=4
   url: https://github.com/euri10
+- login: iudeen
+  count: 126
+  avatarUrl: https://avatars.githubusercontent.com/u/10519440?u=2843b3303282bff8b212dcd4d9d6689452e4470c&v=4
+  url: https://github.com/iudeen
 - login: phy25
   count: 126
   avatarUrl: https://avatars.githubusercontent.com/u/331403?v=4
   url: https://github.com/phy25
-- login: iudeen
-  count: 122
-  avatarUrl: https://avatars.githubusercontent.com/u/10519440?u=2843b3303282bff8b212dcd4d9d6689452e4470c&v=4
-  url: https://github.com/iudeen
 - login: raphaelauv
   count: 83
   avatarUrl: https://avatars.githubusercontent.com/u/10202690?u=e6f86f5c0c3026a15d6b51792fa3e532b12f1371&v=4
@@ -61,14 +61,14 @@ experts:
   count: 49
   avatarUrl: https://avatars.githubusercontent.com/u/516999?u=437c0c5038558c67e887ccd863c1ba0f846c03da&v=4
   url: https://github.com/sm-Fifteen
+- login: yinziyan1206
+  count: 45
+  avatarUrl: https://avatars.githubusercontent.com/u/37829370?u=da44ca53aefd5c23f346fab8e9fd2e108294c179&v=4
+  url: https://github.com/yinziyan1206
 - login: acidjunk
   count: 45
   avatarUrl: https://avatars.githubusercontent.com/u/685002?u=b5094ab4527fc84b006c0ac9ff54367bdebb2267&v=4
   url: https://github.com/acidjunk
-- login: insomnes
-  count: 45
-  avatarUrl: https://avatars.githubusercontent.com/u/16958893?u=f8be7088d5076d963984a21f95f44e559192d912&v=4
-  url: https://github.com/insomnes
 - login: Dustyposa
   count: 45
   avatarUrl: https://avatars.githubusercontent.com/u/27180793?u=5cf2877f50b3eb2bc55086089a78a36f07042889&v=4
@@ -77,18 +77,18 @@ experts:
   count: 45
   avatarUrl: https://avatars.githubusercontent.com/u/1755071?u=612704256e38d6ac9cbed24f10e4b6ac2da74ecb&v=4
   url: https://github.com/adriangb
-- login: yinziyan1206
-  count: 44
-  avatarUrl: https://avatars.githubusercontent.com/u/37829370?u=da44ca53aefd5c23f346fab8e9fd2e108294c179&v=4
-  url: https://github.com/yinziyan1206
-- login: odiseo0
-  count: 43
-  avatarUrl: https://avatars.githubusercontent.com/u/87550035?u=241a71f6b7068738b81af3e57f45ffd723538401&v=4
-  url: https://github.com/odiseo0
+- login: insomnes
+  count: 45
+  avatarUrl: https://avatars.githubusercontent.com/u/16958893?u=f8be7088d5076d963984a21f95f44e559192d912&v=4
+  url: https://github.com/insomnes
 - login: frankie567
   count: 43
   avatarUrl: https://avatars.githubusercontent.com/u/1144727?u=c159fe047727aedecbbeeaa96a1b03ceb9d39add&v=4
   url: https://github.com/frankie567
+- login: odiseo0
+  count: 43
+  avatarUrl: https://avatars.githubusercontent.com/u/87550035?u=241a71f6b7068738b81af3e57f45ffd723538401&v=4
+  url: https://github.com/odiseo0
 - login: includeamin
   count: 40
   avatarUrl: https://avatars.githubusercontent.com/u/11836741?u=8bd5ef7e62fe6a82055e33c4c0e0a7879ff8cfb6&v=4
@@ -101,14 +101,14 @@ experts:
   count: 37
   avatarUrl: https://avatars.githubusercontent.com/u/5167622?u=de8f597c81d6336fcebc37b32dfd61a3f877160c&v=4
   url: https://github.com/STeveShary
+- login: n8sty
+  count: 36
+  avatarUrl: https://avatars.githubusercontent.com/u/2964996?v=4
+  url: https://github.com/n8sty
 - login: krishnardt
   count: 35
   avatarUrl: https://avatars.githubusercontent.com/u/31960541?u=47f4829c77f4962ab437ffb7995951e41eeebe9b&v=4
   url: https://github.com/krishnardt
-- login: n8sty
-  count: 32
-  avatarUrl: https://avatars.githubusercontent.com/u/2964996?v=4
-  url: https://github.com/n8sty
 - login: panla
   count: 32
   avatarUrl: https://avatars.githubusercontent.com/u/41326348?u=ba2fda6b30110411ecbf406d187907e2b420ac19&v=4
@@ -137,18 +137,22 @@ experts:
   count: 21
   avatarUrl: https://avatars.githubusercontent.com/u/51059348?u=5fe59a56e1f2f9ccd8005d71752a8276f133ae1a&v=4
   url: https://github.com/rafsaf
-- login: JavierSanchezCastro
+- login: chris-allnutt
   count: 20
-  avatarUrl: https://avatars.githubusercontent.com/u/72013291?u=ae5679e6bd971d9d98cd5e76e8683f83642ba950&v=4
-  url: https://github.com/JavierSanchezCastro
+  avatarUrl: https://avatars.githubusercontent.com/u/565544?v=4
+  url: https://github.com/chris-allnutt
+- login: ebottos94
+  count: 20
+  avatarUrl: https://avatars.githubusercontent.com/u/100039558?u=e2c672da5a7977fd24d87ce6ab35f8bf5b1ed9fa&v=4
+  url: https://github.com/ebottos94
 - login: nsidnev
   count: 20
   avatarUrl: https://avatars.githubusercontent.com/u/22559461?u=a9cc3238217e21dc8796a1a500f01b722adb082c&v=4
   url: https://github.com/nsidnev
-- login: chris-allnutt
+- login: JavierSanchezCastro
   count: 20
-  avatarUrl: https://avatars.githubusercontent.com/u/565544?v=4
-  url: https://github.com/chris-allnutt
+  avatarUrl: https://avatars.githubusercontent.com/u/72013291?u=ae5679e6bd971d9d98cd5e76e8683f83642ba950&v=4
+  url: https://github.com/JavierSanchezCastro
 - login: chrisK824
   count: 19
   avatarUrl: https://avatars.githubusercontent.com/u/79946379?u=03d85b22d696a58a9603e55fbbbe2de6b0f4face&v=4
@@ -161,10 +165,10 @@ experts:
   count: 18
   avatarUrl: https://avatars.githubusercontent.com/u/24581770?v=4
   url: https://github.com/retnikt
-- login: ebottos94
+- login: nymous
   count: 17
-  avatarUrl: https://avatars.githubusercontent.com/u/100039558?u=e2c672da5a7977fd24d87ce6ab35f8bf5b1ed9fa&v=4
-  url: https://github.com/ebottos94
+  avatarUrl: https://avatars.githubusercontent.com/u/4216559?u=360a36fb602cded27273cbfc0afc296eece90662&v=4
+  url: https://github.com/nymous
 - login: Hultner
   count: 17
   avatarUrl: https://avatars.githubusercontent.com/u/2669034?u=115e53df959309898ad8dc9443fbb35fee71df07&v=4
@@ -181,39 +185,47 @@ experts:
   count: 17
   avatarUrl: https://avatars.githubusercontent.com/u/16540232?u=05d2beb8e034d584d0a374b99d8826327bd7f614&v=4
   url: https://github.com/caeser1996
-- login: nymous
+- login: dstlny
   count: 16
-  avatarUrl: https://avatars.githubusercontent.com/u/4216559?u=360a36fb602cded27273cbfc0afc296eece90662&v=4
-  url: https://github.com/nymous
+  avatarUrl: https://avatars.githubusercontent.com/u/41964673?u=9f2174f9d61c15c6e3a4c9e3aeee66f711ce311f&v=4
+  url: https://github.com/dstlny
 - login: jonatasoli
   count: 16
   avatarUrl: https://avatars.githubusercontent.com/u/26334101?u=071c062d2861d3dd127f6b4a5258cd8ef55d4c50&v=4
   url: https://github.com/jonatasoli
-- login: dstlny
-  count: 16
-  avatarUrl: https://avatars.githubusercontent.com/u/41964673?u=9f2174f9d61c15c6e3a4c9e3aeee66f711ce311f&v=4
-  url: https://github.com/dstlny
 - login: abhint
   count: 15
   avatarUrl: https://avatars.githubusercontent.com/u/25699289?u=b5d219277b4d001ac26fb8be357fddd88c29d51b&v=4
   url: https://github.com/abhint
 last_month_active:
+- login: jgould22
+  count: 18
+  avatarUrl: https://avatars.githubusercontent.com/u/4335847?u=ed77f67e0bb069084639b24d812dbb2a2b1dc554&v=4
+  url: https://github.com/jgould22
 - login: Kludex
-  count: 8
+  count: 10
   avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
   url: https://github.com/Kludex
+- login: White-Mask
+  count: 5
+  avatarUrl: https://avatars.githubusercontent.com/u/31826970?u=8625355dc25ddf9c85a8b2b0b9932826c4c8f44c&v=4
+  url: https://github.com/White-Mask
 - login: n8sty
-  count: 7
+  count: 4
   avatarUrl: https://avatars.githubusercontent.com/u/2964996?v=4
   url: https://github.com/n8sty
-- login: chrisK824
+- login: hasansezertasan
   count: 4
-  avatarUrl: https://avatars.githubusercontent.com/u/79946379?u=03d85b22d696a58a9603e55fbbbe2de6b0f4face&v=4
-  url: https://github.com/chrisK824
-- login: danielfcollier
+  avatarUrl: https://avatars.githubusercontent.com/u/13135006?u=e389634d494d503cca867f76c2d00cacc273a46e&v=4
+  url: https://github.com/hasansezertasan
+- login: pythonweb2
   count: 3
-  avatarUrl: https://avatars.githubusercontent.com/u/38995330?u=5799be795fc310f75f3a5fe9242307d59b194520&v=4
-  url: https://github.com/danielfcollier
+  avatarUrl: https://avatars.githubusercontent.com/u/32141163?v=4
+  url: https://github.com/pythonweb2
+- login: ebottos94
+  count: 3
+  avatarUrl: https://avatars.githubusercontent.com/u/100039558?u=e2c672da5a7977fd24d87ce6ab35f8bf5b1ed9fa&v=4
+  url: https://github.com/ebottos94
 top_contributors:
 - login: waynerv
   count: 25
@@ -349,17 +361,17 @@ top_contributors:
   url: https://github.com/rostik1410
 top_reviewers:
 - login: Kludex
-  count: 139
+  count: 145
   avatarUrl: https://avatars.githubusercontent.com/u/7353520?u=62adc405ef418f4b6c8caa93d3eb8ab107bc4927&v=4
   url: https://github.com/Kludex
+- login: BilalAlpaslan
+  count: 82
+  avatarUrl: https://avatars.githubusercontent.com/u/47563997?u=63ed66e304fe8d765762c70587d61d9196e5c82d&v=4
+  url: https://github.com/BilalAlpaslan
 - login: yezz123
   count: 80
   avatarUrl: https://avatars.githubusercontent.com/u/52716203?u=d7062cbc6eb7671d5dc9cc0e32a24ae335e0f225&v=4
   url: https://github.com/yezz123
-- login: BilalAlpaslan
-  count: 79
-  avatarUrl: https://avatars.githubusercontent.com/u/47563997?u=63ed66e304fe8d765762c70587d61d9196e5c82d&v=4
-  url: https://github.com/BilalAlpaslan
 - login: iudeen
   count: 54
   avatarUrl: https://avatars.githubusercontent.com/u/10519440?u=2843b3303282bff8b212dcd4d9d6689452e4470c&v=4
@@ -376,14 +388,14 @@ top_reviewers:
   count: 47
   avatarUrl: https://avatars.githubusercontent.com/u/59285379?v=4
   url: https://github.com/Laineyzhang55
+- login: Xewus
+  count: 47
+  avatarUrl: https://avatars.githubusercontent.com/u/85196001?u=f8e2dc7e5104f109cef944af79050ea8d1b8f914&v=4
+  url: https://github.com/Xewus
 - login: ycd
   count: 45
   avatarUrl: https://avatars.githubusercontent.com/u/62724709?u=bba5af018423a2858d49309bed2a899bb5c34ac5&v=4
   url: https://github.com/ycd
-- login: Xewus
-  count: 44
-  avatarUrl: https://avatars.githubusercontent.com/u/85196001?u=f8e2dc7e5104f109cef944af79050ea8d1b8f914&v=4
-  url: https://github.com/Xewus
 - login: cikay
   count: 41
   avatarUrl: https://avatars.githubusercontent.com/u/24587499?u=e772190a051ab0eaa9c8542fcff1892471638f2b&v=4
@@ -412,14 +424,14 @@ top_reviewers:
   count: 26
   avatarUrl: https://avatars.githubusercontent.com/u/61513630?u=320e43fe4dc7bc6efc64e9b8f325f8075634fd20&v=4
   url: https://github.com/lsglucas
+- login: Ryandaydev
+  count: 25
+  avatarUrl: https://avatars.githubusercontent.com/u/4292423?u=ba0eea19429e7cf77cf2ab8ad2f3d3af202bc1cf&v=4
+  url: https://github.com/Ryandaydev
 - login: LorhanSohaky
   count: 24
   avatarUrl: https://avatars.githubusercontent.com/u/16273730?u=095b66f243a2cd6a0aadba9a095009f8aaf18393&v=4
   url: https://github.com/LorhanSohaky
-- login: Ryandaydev
-  count: 24
-  avatarUrl: https://avatars.githubusercontent.com/u/4292423?u=809f3d1074d04bbc28012a7f17f06ea56f5bd71a&v=4
-  url: https://github.com/Ryandaydev
 - login: dmontagu
   count: 23
   avatarUrl: https://avatars.githubusercontent.com/u/35119617?u=540f30c937a6450812628b9592a1dfe91bbe148e&v=4
@@ -476,14 +488,14 @@ top_reviewers:
   count: 15
   avatarUrl: https://avatars.githubusercontent.com/u/63476957?u=6c86e59b48e0394d4db230f37fc9ad4d7e2c27c7&v=4
   url: https://github.com/delhi09
+- login: peidrao
+  count: 14
+  avatarUrl: https://avatars.githubusercontent.com/u/32584628?u=a66902b40c13647d0ed0e573d598128240a4dd04&v=4
+  url: https://github.com/peidrao
 - login: sh0nk
   count: 13
   avatarUrl: https://avatars.githubusercontent.com/u/6478810?u=af15d724875cec682ed8088a86d36b2798f981c0&v=4
   url: https://github.com/sh0nk
-- login: peidrao
-  count: 13
-  avatarUrl: https://avatars.githubusercontent.com/u/32584628?u=a66902b40c13647d0ed0e573d598128240a4dd04&v=4
-  url: https://github.com/peidrao
 - login: wdh99
   count: 13
   avatarUrl: https://avatars.githubusercontent.com/u/108172295?u=8a8fb95d5afe3e0fa33257b2aecae88d436249eb&v=4

From e7756ae7dcffa0b73767d354ca158fd6b7bc87ed Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 20 Dec 2023 17:06:01 +0000
Subject: [PATCH 299/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 835df984c..b8b6f9ae9 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
 
 ## Latest Changes
 
+* 👥 Update FastAPI People. PR [#10567](https://github.com/tiangolo/fastapi/pull/10567) by [@tiangolo](https://github.com/tiangolo).
+
 ## 0.105.0
 
 ### Features

From a4aa79e0b4cacc6b428d415d04d234a8c77af9d5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Mon, 25 Dec 2023 18:57:35 +0100
Subject: [PATCH 300/317] =?UTF-8?q?=E2=9C=A8=20Add=20support=20for=20raisi?=
 =?UTF-8?q?ng=20exceptions=20(including=20`HTTPException`)=20in=20dependen?=
 =?UTF-8?q?cies=20with=20`yield`=20in=20the=20exit=20code,=20do=20not=20su?=
 =?UTF-8?q?pport=20them=20in=20background=20tasks=20(#10831)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* ♻️ Refactor dependency AsyncExitStack logic, exit dependencies after creating the response, before sending it

* ✅ Update tests for dependencies exit, check they are finished before the response is sent

* 🔥 Remove ExitAsyncStackMiddleware as it's no longer needed

* 📝 Update docs for dependencies with yield

* 📝 Update release notes

* 📝 Add source examples for new dependencies with yield raising

* ✅ Add tests for new dependencies raising after yield

* 📝 Update release notes
---
 docs/en/docs/release-notes.md                 | 102 ++++++++
 .../dependencies/dependencies-with-yield.md   |  95 ++++---
 docs_src/dependencies/tutorial008b.py         |  30 +++
 docs_src/dependencies/tutorial008b_an.py      |  31 +++
 docs_src/dependencies/tutorial008b_an_py39.py |  32 +++
 fastapi/applications.py                       |  52 ----
 fastapi/concurrency.py                        |   1 -
 fastapi/dependencies/utils.py                 |   9 +-
 fastapi/middleware/asyncexitstack.py          |  25 --
 fastapi/routing.py                            | 231 ++++++++++--------
 pyproject.toml                                |   9 +
 tests/test_dependency_contextmanager.py       |  20 +-
 .../test_dependencies/test_tutorial008b.py    |  23 ++
 .../test_dependencies/test_tutorial008b_an.py |  23 ++
 .../test_tutorial008b_an_py39.py              |  23 ++
 15 files changed, 492 insertions(+), 214 deletions(-)
 create mode 100644 docs_src/dependencies/tutorial008b.py
 create mode 100644 docs_src/dependencies/tutorial008b_an.py
 create mode 100644 docs_src/dependencies/tutorial008b_an_py39.py
 delete mode 100644 fastapi/middleware/asyncexitstack.py
 create mode 100644 tests/test_tutorial/test_dependencies/test_tutorial008b.py
 create mode 100644 tests/test_tutorial/test_dependencies/test_tutorial008b_an.py
 create mode 100644 tests/test_tutorial/test_dependencies/test_tutorial008b_an_py39.py

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b8b6f9ae9..12bc12d26 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,108 @@ hide:
 
 ## Latest Changes
 
+### Dependencies with `yield`, `HTTPException` and Background Tasks
+
+Dependencies with `yield` now can raise `HTTPException` and other exceptions after `yield`. 🎉
+
+Read the new docs here: [Dependencies with `yield` and `HTTPException`](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-with-yield/#dependencies-with-yield-and-httpexception).
+
+```Python
+from fastapi import Depends, FastAPI, HTTPException
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+data = {
+    "plumbus": {"description": "Freshly pickled plumbus", "owner": "Morty"},
+    "portal-gun": {"description": "Gun to create portals", "owner": "Rick"},
+}
+
+
+class OwnerError(Exception):
+    pass
+
+
+def get_username():
+    try:
+        yield "Rick"
+    except OwnerError as e:
+        raise HTTPException(status_code=400, detail=f"Onwer error: {e}")
+
+
+@app.get("/items/{item_id}")
+def get_item(item_id: str, username: Annotated[str, Depends(get_username)]):
+    if item_id not in data:
+        raise HTTPException(status_code=404, detail="Item not found")
+    item = data[item_id]
+    if item["owner"] != username:
+        raise OwnerError(username)
+    return item
+```
+
+---
+
+Before FastAPI 0.106.0, raising exceptions after `yield` was not possible, the exit code in dependencies with `yield` was executed *after* the response was sent, so [Exception Handlers](../handling-errors.md#install-custom-exception-handlers){.internal-link target=_blank} would have already run.
+
+This was designed this way mainly to allow using the same objects "yielded" by dependencies inside of background tasks, because the exit code would be executed after the background tasks were finished.
+
+Nevertheless, as this would mean waiting for the response to travel through the network while unnecessarily holding a resource in a dependency with yield (for example a database connection), this was changed in FastAPI 0.106.0.
+
+Additionally, a background task is normally an independent set of logic that should be handled separately, with its own resources (e.g. its own database connection).
+
+If you used to rely on this behavior, now you should create the resources for background tasks inside the background task itself, and use internally only data that doesn't depend on the resources of dependencies with `yield`.
+
+For example, instead of using the same database session, you would create a new database session inside of the background task, and you would obtain the objects from the database using this new session. And then instead of passing the object from the database as a parameter to the background task function, you would pass the ID of that object and then obtain the object again inside the background task function.
+
+The sequence of execution before FastAPI 0.106.0 was like this diagram:
+
+Time flows from top to bottom. And each column is one of the parts interacting or executing code.
+
+```mermaid
+sequenceDiagram
+
+participant client as Client
+participant handler as Exception handler
+participant dep as Dep with yield
+participant operation as Path Operation
+participant tasks as Background tasks
+
+    Note over client,tasks: Can raise exception for dependency, handled after response is sent
+    Note over client,operation: Can raise HTTPException and can change the response
+    client ->> dep: Start request
+    Note over dep: Run code up to yield
+    opt raise
+        dep -->> handler: Raise HTTPException
+        handler -->> client: HTTP error response
+        dep -->> dep: Raise other exception
+    end
+    dep ->> operation: Run dependency, e.g. DB session
+    opt raise
+        operation -->> dep: Raise HTTPException
+        dep -->> handler: Auto forward exception
+        handler -->> client: HTTP error response
+        operation -->> dep: Raise other exception
+        dep -->> handler: Auto forward exception
+    end
+    operation ->> client: Return response to client
+    Note over client,operation: Response is already sent, can't change it anymore
+    opt Tasks
+        operation -->> tasks: Send background tasks
+    end
+    opt Raise other exception
+        tasks -->> dep: Raise other exception
+    end
+    Note over dep: After yield
+    opt Handle other exception
+        dep -->> dep: Handle exception, can't change response. E.g. close DB session.
+    end
+```
+
+The new execution flow can be found in the docs: [Execution of dependencies with `yield`](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-with-yield/#execution-of-dependencies-with-yield).
+
+### Internal
+
 * 👥 Update FastAPI People. PR [#10567](https://github.com/tiangolo/fastapi/pull/10567) by [@tiangolo](https://github.com/tiangolo).
 
 ## 0.105.0
diff --git a/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md b/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
index fe18f1f1d..4ead4682c 100644
--- a/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
+++ b/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
@@ -1,8 +1,8 @@
 # Dependencies with yield
 
-FastAPI supports dependencies that do some <abbr title='sometimes also called "exit", "cleanup", "teardown", "close", "context managers", ...'>extra steps after finishing</abbr>.
+FastAPI supports dependencies that do some <abbr title='sometimes also called "exit code", "cleanup code", "teardown code", "closing code", "context manager exit code", etc.'>extra steps after finishing</abbr>.
 
-To do this, use `yield` instead of `return`, and write the extra steps after.
+To do this, use `yield` instead of `return`, and write the extra steps (code) after.
 
 !!! tip
     Make sure to use `yield` one single time.
@@ -21,7 +21,7 @@ To do this, use `yield` instead of `return`, and write the extra steps after.
 
 For example, you could use this to create a database session and close it after finishing.
 
-Only the code prior to and including the `yield` statement is executed before sending a response:
+Only the code prior to and including the `yield` statement is executed before creating a response:
 
 ```Python hl_lines="2-4"
 {!../../../docs_src/dependencies/tutorial007.py!}
@@ -40,7 +40,7 @@ The code following the `yield` statement is executed after the response has been
 ```
 
 !!! tip
-    You can use `async` or normal functions.
+    You can use `async` or regular functions.
 
     **FastAPI** will do the right thing with each, the same as with normal dependencies.
 
@@ -114,7 +114,7 @@ And, in turn, `dependency_b` needs the value from `dependency_a` (here named `de
     {!> ../../../docs_src/dependencies/tutorial008.py!}
     ```
 
-The same way, you could have dependencies with `yield` and `return` mixed.
+The same way, you could have some dependencies with `yield` and some other dependencies with `return`, and have some of those depend on some of the others.
 
 And you could have a single dependency that requires several other dependencies with `yield`, etc.
 
@@ -131,24 +131,38 @@ You can have any combinations of dependencies that you want.
 
 You saw that you can use dependencies with `yield` and have `try` blocks that catch exceptions.
 
-It might be tempting to raise an `HTTPException` or similar in the exit code, after the `yield`. But **it won't work**.
+The same way, you could raise an `HTTPException` or similar in the exit code, after the `yield`.
 
-The exit code in dependencies with `yield` is executed *after* the response is sent, so [Exception Handlers](../handling-errors.md#install-custom-exception-handlers){.internal-link target=_blank} will have already run. There's nothing catching exceptions thrown by your dependencies in the exit code (after the `yield`).
+!!! tip
 
-So, if you raise an `HTTPException` after the `yield`, the default (or any custom) exception handler that catches `HTTPException`s and returns an HTTP 400 response won't be there to catch that exception anymore.
+    This is a somewhat advanced technique, and in most of the cases you won't really need it, as you can raise exceptions (including `HTTPException`) from inside of the rest of your application code, for example, in the *path operation function*.
 
-This is what allows anything set in the dependency (e.g. a DB session) to, for example, be used by background tasks.
+    But it's there for you if you need it. 🤓
 
-Background tasks are run *after* the response has been sent. So there's no way to raise an `HTTPException` because there's not even a way to change the response that is *already sent*.
+=== "Python 3.9+"
 
-But if a background task creates a DB error, at least you can rollback or cleanly close the session in the dependency with `yield`, and maybe log the error or report it to a remote tracking system.
+    ```Python hl_lines="18-22  31"
+    {!> ../../../docs_src/dependencies/tutorial008b_an_py39.py!}
+    ```
 
-If you have some code that you know could raise an exception, do the most normal/"Pythonic" thing and add a `try` block in that section of the code.
+=== "Python 3.8+"
 
-If you have custom exceptions that you would like to handle *before* returning the response and possibly modifying the response, maybe even raising an `HTTPException`, create a [Custom Exception Handler](../handling-errors.md#install-custom-exception-handlers){.internal-link target=_blank}.
+    ```Python hl_lines="17-21  30"
+    {!> ../../../docs_src/dependencies/tutorial008b_an.py!}
+    ```
 
-!!! tip
-    You can still raise exceptions including `HTTPException` *before* the `yield`. But not after.
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        Prefer to use the `Annotated` version if possible.
+
+    ```Python hl_lines="16-20  29"
+    {!> ../../../docs_src/dependencies/tutorial008b.py!}
+    ```
+
+An alternative you could use to catch exceptions (and possibly also raise another `HTTPException`) is ot create a [Custom Exception Handler](../handling-errors.md#install-custom-exception-handlers){.internal-link target=_blank}.
+
+## Execution of dependencies with `yield`
 
 The sequence of execution is more or less like this diagram. Time flows from top to bottom. And each column is one of the parts interacting or executing code.
 
@@ -161,34 +175,30 @@ participant dep as Dep with yield
 participant operation as Path Operation
 participant tasks as Background tasks
 
-    Note over client,tasks: Can raise exception for dependency, handled after response is sent
-    Note over client,operation: Can raise HTTPException and can change the response
+    Note over client,operation: Can raise exceptions, including HTTPException
     client ->> dep: Start request
     Note over dep: Run code up to yield
-    opt raise
-        dep -->> handler: Raise HTTPException
+    opt raise Exception
+        dep -->> handler: Raise Exception
         handler -->> client: HTTP error response
-        dep -->> dep: Raise other exception
     end
     dep ->> operation: Run dependency, e.g. DB session
     opt raise
-        operation -->> dep: Raise HTTPException
-        dep -->> handler: Auto forward exception
+        operation -->> dep: Raise Exception (e.g. HTTPException)
+        opt handle
+            dep -->> dep: Can catch exception, raise a new HTTPException, raise other exception
+            dep -->> handler: Auto forward exception
+        end
         handler -->> client: HTTP error response
-        operation -->> dep: Raise other exception
-        dep -->> handler: Auto forward exception
     end
+
     operation ->> client: Return response to client
     Note over client,operation: Response is already sent, can't change it anymore
     opt Tasks
         operation -->> tasks: Send background tasks
     end
     opt Raise other exception
-        tasks -->> dep: Raise other exception
-    end
-    Note over dep: After yield
-    opt Handle other exception
-        dep -->> dep: Handle exception, can't change response. E.g. close DB session.
+        tasks -->> tasks: Handle exceptions in the background task code
     end
 ```
 
@@ -198,10 +208,33 @@ participant tasks as Background tasks
     After one of those responses is sent, no other response can be sent.
 
 !!! tip
-    This diagram shows `HTTPException`, but you could also raise any other exception for which you create a [Custom Exception Handler](../handling-errors.md#install-custom-exception-handlers){.internal-link target=_blank}.
+    This diagram shows `HTTPException`, but you could also raise any other exception that you catch in a dependency with `yield` or with a [Custom Exception Handler](../handling-errors.md#install-custom-exception-handlers){.internal-link target=_blank}.
 
     If you raise any exception, it will be passed to the dependencies with yield, including `HTTPException`, and then **again** to the exception handlers. If there's no exception handler for that exception, it will then be handled by the default internal `ServerErrorMiddleware`, returning a 500 HTTP status code, to let the client know that there was an error in the server.
 
+## Dependencies with `yield`, `HTTPException` and Background Tasks
+
+!!! warning
+    You most probably don't need these technical details, you can skip this section and continue below.
+
+    These details are useful mainly if you were using a version of FastAPI prior to 0.106.0 and used resources from dependencies with `yield` in background tasks.
+
+Before FastAPI 0.106.0, raising exceptions after `yield` was not possible, the exit code in dependencies with `yield` was executed *after* the response was sent, so [Exception Handlers](../handling-errors.md#install-custom-exception-handlers){.internal-link target=_blank} would have already run.
+
+This was designed this way mainly to allow using the same objects "yielded" by dependencies inside of background tasks, because the exit code would be executed after the background tasks were finished.
+
+Nevertheless, as this would mean waiting for the response to travel through the network while unnecessarily holding a resource in a dependency with yield (for example a database connection), this was changed in FastAPI 0.106.0.
+
+!!! tip
+
+    Additionally, a background task is normally an independent set of logic that should be handled separately, with its own resources (e.g. its own database connection).
+
+    So, this way you will probably have cleaner code.
+
+If you used to rely on this behavior, now you should create the resources for background tasks inside the background task itself, and use internally only data that doesn't depend on the resources of dependencies with `yield`.
+
+For example, instead of using the same database session, you would create a new database session inside of the background task, and you would obtain the objects from the database using this new session. And then instead of passing the object from the database as a parameter to the background task function, you would pass the ID of that object and then obtain the object again inside the background task function.
+
 ## Context Managers
 
 ### What are "Context Managers"
@@ -220,7 +253,7 @@ Underneath, the `open("./somefile.txt")` creates an object that is a called a "C
 
 When the `with` block finishes, it makes sure to close the file, even if there were exceptions.
 
-When you create a dependency with `yield`, **FastAPI** will internally convert it to a context manager, and combine it with some other related tools.
+When you create a dependency with `yield`, **FastAPI** will internally create a context manager for it, and combine it with some other related tools.
 
 ### Using context managers in dependencies with `yield`
 
diff --git a/docs_src/dependencies/tutorial008b.py b/docs_src/dependencies/tutorial008b.py
new file mode 100644
index 000000000..4a1a70dcf
--- /dev/null
+++ b/docs_src/dependencies/tutorial008b.py
@@ -0,0 +1,30 @@
+from fastapi import Depends, FastAPI, HTTPException
+
+app = FastAPI()
+
+
+data = {
+    "plumbus": {"description": "Freshly pickled plumbus", "owner": "Morty"},
+    "portal-gun": {"description": "Gun to create portals", "owner": "Rick"},
+}
+
+
+class OwnerError(Exception):
+    pass
+
+
+def get_username():
+    try:
+        yield "Rick"
+    except OwnerError as e:
+        raise HTTPException(status_code=400, detail=f"Onwer error: {e}")
+
+
+@app.get("/items/{item_id}")
+def get_item(item_id: str, username: str = Depends(get_username)):
+    if item_id not in data:
+        raise HTTPException(status_code=404, detail="Item not found")
+    item = data[item_id]
+    if item["owner"] != username:
+        raise OwnerError(username)
+    return item
diff --git a/docs_src/dependencies/tutorial008b_an.py b/docs_src/dependencies/tutorial008b_an.py
new file mode 100644
index 000000000..3a0f1399a
--- /dev/null
+++ b/docs_src/dependencies/tutorial008b_an.py
@@ -0,0 +1,31 @@
+from fastapi import Depends, FastAPI, HTTPException
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+data = {
+    "plumbus": {"description": "Freshly pickled plumbus", "owner": "Morty"},
+    "portal-gun": {"description": "Gun to create portals", "owner": "Rick"},
+}
+
+
+class OwnerError(Exception):
+    pass
+
+
+def get_username():
+    try:
+        yield "Rick"
+    except OwnerError as e:
+        raise HTTPException(status_code=400, detail=f"Onwer error: {e}")
+
+
+@app.get("/items/{item_id}")
+def get_item(item_id: str, username: Annotated[str, Depends(get_username)]):
+    if item_id not in data:
+        raise HTTPException(status_code=404, detail="Item not found")
+    item = data[item_id]
+    if item["owner"] != username:
+        raise OwnerError(username)
+    return item
diff --git a/docs_src/dependencies/tutorial008b_an_py39.py b/docs_src/dependencies/tutorial008b_an_py39.py
new file mode 100644
index 000000000..30c9cdc69
--- /dev/null
+++ b/docs_src/dependencies/tutorial008b_an_py39.py
@@ -0,0 +1,32 @@
+from typing import Annotated
+
+from fastapi import Depends, FastAPI, HTTPException
+
+app = FastAPI()
+
+
+data = {
+    "plumbus": {"description": "Freshly pickled plumbus", "owner": "Morty"},
+    "portal-gun": {"description": "Gun to create portals", "owner": "Rick"},
+}
+
+
+class OwnerError(Exception):
+    pass
+
+
+def get_username():
+    try:
+        yield "Rick"
+    except OwnerError as e:
+        raise HTTPException(status_code=400, detail=f"Onwer error: {e}")
+
+
+@app.get("/items/{item_id}")
+def get_item(item_id: str, username: Annotated[str, Depends(get_username)]):
+    if item_id not in data:
+        raise HTTPException(status_code=404, detail="Item not found")
+    item = data[item_id]
+    if item["owner"] != username:
+        raise OwnerError(username)
+    return item
diff --git a/fastapi/applications.py b/fastapi/applications.py
index 3021d7593..597c60a56 100644
--- a/fastapi/applications.py
+++ b/fastapi/applications.py
@@ -22,7 +22,6 @@ from fastapi.exception_handlers import (
 )
 from fastapi.exceptions import RequestValidationError, WebSocketRequestValidationError
 from fastapi.logger import logger
-from fastapi.middleware.asyncexitstack import AsyncExitStackMiddleware
 from fastapi.openapi.docs import (
     get_redoc_html,
     get_swagger_ui_html,
@@ -37,8 +36,6 @@ from starlette.datastructures import State
 from starlette.exceptions import HTTPException
 from starlette.middleware import Middleware
 from starlette.middleware.base import BaseHTTPMiddleware
-from starlette.middleware.errors import ServerErrorMiddleware
-from starlette.middleware.exceptions import ExceptionMiddleware
 from starlette.requests import Request
 from starlette.responses import HTMLResponse, JSONResponse, Response
 from starlette.routing import BaseRoute
@@ -966,55 +963,6 @@ class FastAPI(Starlette):
         self.middleware_stack: Union[ASGIApp, None] = None
         self.setup()
 
-    def build_middleware_stack(self) -> ASGIApp:
-        # Duplicate/override from Starlette to add AsyncExitStackMiddleware
-        # inside of ExceptionMiddleware, inside of custom user middlewares
-        debug = self.debug
-        error_handler = None
-        exception_handlers = {}
-
-        for key, value in self.exception_handlers.items():
-            if key in (500, Exception):
-                error_handler = value
-            else:
-                exception_handlers[key] = value
-
-        middleware = (
-            [Middleware(ServerErrorMiddleware, handler=error_handler, debug=debug)]
-            + self.user_middleware
-            + [
-                Middleware(
-                    ExceptionMiddleware, handlers=exception_handlers, debug=debug
-                ),
-                # Add FastAPI-specific AsyncExitStackMiddleware for dependencies with
-                # contextvars.
-                # This needs to happen after user middlewares because those create a
-                # new contextvars context copy by using a new AnyIO task group.
-                # The initial part of dependencies with 'yield' is executed in the
-                # FastAPI code, inside all the middlewares. However, the teardown part
-                # (after 'yield') is executed in the AsyncExitStack in this middleware.
-                # If the AsyncExitStack lived outside of the custom middlewares and
-                # contextvars were set in a dependency with 'yield' in that internal
-                # contextvars context, the values would not be available in the
-                # outer context of the AsyncExitStack.
-                # By placing the middleware and the AsyncExitStack here, inside all
-                # user middlewares, the code before and after 'yield' in dependencies
-                # with 'yield' is executed in the same contextvars context. Thus, all values
-                # set in contextvars before 'yield' are still available after 'yield,' as
-                # expected.
-                # Additionally, by having this AsyncExitStack here, after the
-                # ExceptionMiddleware, dependencies can now catch handled exceptions,
-                # e.g. HTTPException, to customize the teardown code (e.g. DB session
-                # rollback).
-                Middleware(AsyncExitStackMiddleware),
-            ]
-        )
-
-        app = self.router
-        for cls, options in reversed(middleware):
-            app = cls(app=app, **options)
-        return app
-
     def openapi(self) -> Dict[str, Any]:
         """
         Generate the OpenAPI schema of the application. This is called by FastAPI
diff --git a/fastapi/concurrency.py b/fastapi/concurrency.py
index 754061c86..894bd3ed1 100644
--- a/fastapi/concurrency.py
+++ b/fastapi/concurrency.py
@@ -1,4 +1,3 @@
-from contextlib import AsyncExitStack as AsyncExitStack  # noqa
 from contextlib import asynccontextmanager as asynccontextmanager
 from typing import AsyncGenerator, ContextManager, TypeVar
 
diff --git a/fastapi/dependencies/utils.py b/fastapi/dependencies/utils.py
index 4e88410a5..b73473484 100644
--- a/fastapi/dependencies/utils.py
+++ b/fastapi/dependencies/utils.py
@@ -1,5 +1,5 @@
 import inspect
-from contextlib import contextmanager
+from contextlib import AsyncExitStack, contextmanager
 from copy import deepcopy
 from typing import (
     Any,
@@ -46,7 +46,6 @@ from fastapi._compat import (
 )
 from fastapi.background import BackgroundTasks
 from fastapi.concurrency import (
-    AsyncExitStack,
     asynccontextmanager,
     contextmanager_in_threadpool,
 )
@@ -529,6 +528,7 @@ async def solve_dependencies(
     response: Optional[Response] = None,
     dependency_overrides_provider: Optional[Any] = None,
     dependency_cache: Optional[Dict[Tuple[Callable[..., Any], Tuple[str]], Any]] = None,
+    async_exit_stack: AsyncExitStack,
 ) -> Tuple[
     Dict[str, Any],
     List[Any],
@@ -575,6 +575,7 @@ async def solve_dependencies(
             response=response,
             dependency_overrides_provider=dependency_overrides_provider,
             dependency_cache=dependency_cache,
+            async_exit_stack=async_exit_stack,
         )
         (
             sub_values,
@@ -590,10 +591,8 @@ async def solve_dependencies(
         if sub_dependant.use_cache and sub_dependant.cache_key in dependency_cache:
             solved = dependency_cache[sub_dependant.cache_key]
         elif is_gen_callable(call) or is_async_gen_callable(call):
-            stack = request.scope.get("fastapi_astack")
-            assert isinstance(stack, AsyncExitStack)
             solved = await solve_generator(
-                call=call, stack=stack, sub_values=sub_values
+                call=call, stack=async_exit_stack, sub_values=sub_values
             )
         elif is_coroutine_callable(call):
             solved = await call(**sub_values)
diff --git a/fastapi/middleware/asyncexitstack.py b/fastapi/middleware/asyncexitstack.py
deleted file mode 100644
index 30a0ae626..000000000
--- a/fastapi/middleware/asyncexitstack.py
+++ /dev/null
@@ -1,25 +0,0 @@
-from typing import Optional
-
-from fastapi.concurrency import AsyncExitStack
-from starlette.types import ASGIApp, Receive, Scope, Send
-
-
-class AsyncExitStackMiddleware:
-    def __init__(self, app: ASGIApp, context_name: str = "fastapi_astack") -> None:
-        self.app = app
-        self.context_name = context_name
-
-    async def __call__(self, scope: Scope, receive: Receive, send: Send) -> None:
-        dependency_exception: Optional[Exception] = None
-        async with AsyncExitStack() as stack:
-            scope[self.context_name] = stack
-            try:
-                await self.app(scope, receive, send)
-            except Exception as e:
-                dependency_exception = e
-                raise e
-        if dependency_exception:
-            # This exception was possibly handled by the dependency but it should
-            # still bubble up so that the ServerErrorMiddleware can return a 500
-            # or the ExceptionMiddleware can catch and handle any other exceptions
-            raise dependency_exception
diff --git a/fastapi/routing.py b/fastapi/routing.py
index 54d53bbbf..589ecca2a 100644
--- a/fastapi/routing.py
+++ b/fastapi/routing.py
@@ -216,95 +216,124 @@ def get_request_handler(
         actual_response_class = response_class
 
     async def app(request: Request) -> Response:
-        try:
-            body: Any = None
-            if body_field:
-                if is_body_form:
-                    body = await request.form()
-                    stack = request.scope.get("fastapi_astack")
-                    assert isinstance(stack, AsyncExitStack)
-                    stack.push_async_callback(body.close)
+        exception_to_reraise: Optional[Exception] = None
+        response: Union[Response, None] = None
+        async with AsyncExitStack() as async_exit_stack:
+            # TODO: remove this scope later, after a few releases
+            # This scope fastapi_astack is no longer used by FastAPI, kept for
+            # compatibility, just in case
+            request.scope["fastapi_astack"] = async_exit_stack
+            try:
+                body: Any = None
+                if body_field:
+                    if is_body_form:
+                        body = await request.form()
+                        async_exit_stack.push_async_callback(body.close)
+                    else:
+                        body_bytes = await request.body()
+                        if body_bytes:
+                            json_body: Any = Undefined
+                            content_type_value = request.headers.get("content-type")
+                            if not content_type_value:
+                                json_body = await request.json()
+                            else:
+                                message = email.message.Message()
+                                message["content-type"] = content_type_value
+                                if message.get_content_maintype() == "application":
+                                    subtype = message.get_content_subtype()
+                                    if subtype == "json" or subtype.endswith("+json"):
+                                        json_body = await request.json()
+                            if json_body != Undefined:
+                                body = json_body
+                            else:
+                                body = body_bytes
+            except json.JSONDecodeError as e:
+                validation_error = RequestValidationError(
+                    [
+                        {
+                            "type": "json_invalid",
+                            "loc": ("body", e.pos),
+                            "msg": "JSON decode error",
+                            "input": {},
+                            "ctx": {"error": e.msg},
+                        }
+                    ],
+                    body=e.doc,
+                )
+                exception_to_reraise = validation_error
+                raise validation_error from e
+            except HTTPException as e:
+                exception_to_reraise = e
+                raise
+            except Exception as e:
+                http_error = HTTPException(
+                    status_code=400, detail="There was an error parsing the body"
+                )
+                exception_to_reraise = http_error
+                raise http_error from e
+            try:
+                solved_result = await solve_dependencies(
+                    request=request,
+                    dependant=dependant,
+                    body=body,
+                    dependency_overrides_provider=dependency_overrides_provider,
+                    async_exit_stack=async_exit_stack,
+                )
+                values, errors, background_tasks, sub_response, _ = solved_result
+            except Exception as e:
+                exception_to_reraise = e
+                raise e
+            if errors:
+                validation_error = RequestValidationError(
+                    _normalize_errors(errors), body=body
+                )
+                exception_to_reraise = validation_error
+                raise validation_error
+            else:
+                try:
+                    raw_response = await run_endpoint_function(
+                        dependant=dependant, values=values, is_coroutine=is_coroutine
+                    )
+                except Exception as e:
+                    exception_to_reraise = e
+                    raise e
+                if isinstance(raw_response, Response):
+                    if raw_response.background is None:
+                        raw_response.background = background_tasks
+                    response = raw_response
                 else:
-                    body_bytes = await request.body()
-                    if body_bytes:
-                        json_body: Any = Undefined
-                        content_type_value = request.headers.get("content-type")
-                        if not content_type_value:
-                            json_body = await request.json()
-                        else:
-                            message = email.message.Message()
-                            message["content-type"] = content_type_value
-                            if message.get_content_maintype() == "application":
-                                subtype = message.get_content_subtype()
-                                if subtype == "json" or subtype.endswith("+json"):
-                                    json_body = await request.json()
-                        if json_body != Undefined:
-                            body = json_body
-                        else:
-                            body = body_bytes
-        except json.JSONDecodeError as e:
-            raise RequestValidationError(
-                [
-                    {
-                        "type": "json_invalid",
-                        "loc": ("body", e.pos),
-                        "msg": "JSON decode error",
-                        "input": {},
-                        "ctx": {"error": e.msg},
-                    }
-                ],
-                body=e.doc,
-            ) from e
-        except HTTPException:
-            raise
-        except Exception as e:
-            raise HTTPException(
-                status_code=400, detail="There was an error parsing the body"
-            ) from e
-        solved_result = await solve_dependencies(
-            request=request,
-            dependant=dependant,
-            body=body,
-            dependency_overrides_provider=dependency_overrides_provider,
-        )
-        values, errors, background_tasks, sub_response, _ = solved_result
-        if errors:
-            raise RequestValidationError(_normalize_errors(errors), body=body)
-        else:
-            raw_response = await run_endpoint_function(
-                dependant=dependant, values=values, is_coroutine=is_coroutine
-            )
-
-            if isinstance(raw_response, Response):
-                if raw_response.background is None:
-                    raw_response.background = background_tasks
-                return raw_response
-            response_args: Dict[str, Any] = {"background": background_tasks}
-            # If status_code was set, use it, otherwise use the default from the
-            # response class, in the case of redirect it's 307
-            current_status_code = (
-                status_code if status_code else sub_response.status_code
-            )
-            if current_status_code is not None:
-                response_args["status_code"] = current_status_code
-            if sub_response.status_code:
-                response_args["status_code"] = sub_response.status_code
-            content = await serialize_response(
-                field=response_field,
-                response_content=raw_response,
-                include=response_model_include,
-                exclude=response_model_exclude,
-                by_alias=response_model_by_alias,
-                exclude_unset=response_model_exclude_unset,
-                exclude_defaults=response_model_exclude_defaults,
-                exclude_none=response_model_exclude_none,
-                is_coroutine=is_coroutine,
-            )
-            response = actual_response_class(content, **response_args)
-            if not is_body_allowed_for_status_code(response.status_code):
-                response.body = b""
-            response.headers.raw.extend(sub_response.headers.raw)
-            return response
+                    response_args: Dict[str, Any] = {"background": background_tasks}
+                    # If status_code was set, use it, otherwise use the default from the
+                    # response class, in the case of redirect it's 307
+                    current_status_code = (
+                        status_code if status_code else sub_response.status_code
+                    )
+                    if current_status_code is not None:
+                        response_args["status_code"] = current_status_code
+                    if sub_response.status_code:
+                        response_args["status_code"] = sub_response.status_code
+                    content = await serialize_response(
+                        field=response_field,
+                        response_content=raw_response,
+                        include=response_model_include,
+                        exclude=response_model_exclude,
+                        by_alias=response_model_by_alias,
+                        exclude_unset=response_model_exclude_unset,
+                        exclude_defaults=response_model_exclude_defaults,
+                        exclude_none=response_model_exclude_none,
+                        is_coroutine=is_coroutine,
+                    )
+                    response = actual_response_class(content, **response_args)
+                    if not is_body_allowed_for_status_code(response.status_code):
+                        response.body = b""
+                    response.headers.raw.extend(sub_response.headers.raw)
+        # This exception was possibly handled by the dependency but it should
+        # still bubble up so that the ServerErrorMiddleware can return a 500
+        # or the ExceptionMiddleware can catch and handle any other exceptions
+        if exception_to_reraise:
+            raise exception_to_reraise
+        assert response is not None, "An error occurred while generating the request"
+        return response
 
     return app
 
@@ -313,16 +342,22 @@ def get_websocket_app(
     dependant: Dependant, dependency_overrides_provider: Optional[Any] = None
 ) -> Callable[[WebSocket], Coroutine[Any, Any, Any]]:
     async def app(websocket: WebSocket) -> None:
-        solved_result = await solve_dependencies(
-            request=websocket,
-            dependant=dependant,
-            dependency_overrides_provider=dependency_overrides_provider,
-        )
-        values, errors, _, _2, _3 = solved_result
-        if errors:
-            raise WebSocketRequestValidationError(_normalize_errors(errors))
-        assert dependant.call is not None, "dependant.call must be a function"
-        await dependant.call(**values)
+        async with AsyncExitStack() as async_exit_stack:
+            # TODO: remove this scope later, after a few releases
+            # This scope fastapi_astack is no longer used by FastAPI, kept for
+            # compatibility, just in case
+            websocket.scope["fastapi_astack"] = async_exit_stack
+            solved_result = await solve_dependencies(
+                request=websocket,
+                dependant=dependant,
+                dependency_overrides_provider=dependency_overrides_provider,
+                async_exit_stack=async_exit_stack,
+            )
+            values, errors, _, _2, _3 = solved_result
+            if errors:
+                raise WebSocketRequestValidationError(_normalize_errors(errors))
+            assert dependant.call is not None, "dependant.call must be a function"
+            await dependant.call(**values)
 
     return app
 
diff --git a/pyproject.toml b/pyproject.toml
index e67486ae3..fa072e595 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -84,6 +84,12 @@ module = "fastapi.tests.*"
 ignore_missing_imports = true
 check_untyped_defs = true
 
+[[tool.mypy.overrides]]
+module = "docs_src.*"
+disallow_incomplete_defs = false
+disallow_untyped_defs = false
+disallow_untyped_calls = false
+
 [tool.pytest.ini_options]
 addopts = [
   "--strict-config",
@@ -167,6 +173,9 @@ ignore = [
 "docs_src/security/tutorial005_an_py39.py" = ["B904"]
 "docs_src/security/tutorial005_py310.py" = ["B904"]
 "docs_src/security/tutorial005_py39.py" = ["B904"]
+"docs_src/dependencies/tutorial008b.py" = ["B904"]
+"docs_src/dependencies/tutorial008b_an.py" = ["B904"]
+"docs_src/dependencies/tutorial008b_an_py39.py" = ["B904"]
 
 
 [tool.ruff.isort]
diff --git a/tests/test_dependency_contextmanager.py b/tests/test_dependency_contextmanager.py
index 03ef56c4d..b07f9aa5b 100644
--- a/tests/test_dependency_contextmanager.py
+++ b/tests/test_dependency_contextmanager.py
@@ -1,7 +1,9 @@
+import json
 from typing import Dict
 
 import pytest
 from fastapi import BackgroundTasks, Depends, FastAPI
+from fastapi.responses import StreamingResponse
 from fastapi.testclient import TestClient
 
 app = FastAPI()
@@ -200,6 +202,13 @@ async def get_sync_context_b_bg(
     return state
 
 
+@app.middleware("http")
+async def middleware(request, call_next):
+    response: StreamingResponse = await call_next(request)
+    response.headers["x-state"] = json.dumps(state.copy())
+    return response
+
+
 client = TestClient(app)
 
 
@@ -274,9 +283,13 @@ def test_background_tasks():
     assert data["context_b"] == "started b"
     assert data["context_a"] == "started a"
     assert data["bg"] == "not set"
+    middleware_state = json.loads(response.headers["x-state"])
+    assert middleware_state["context_b"] == "finished b with a: started a"
+    assert middleware_state["context_a"] == "finished a"
+    assert middleware_state["bg"] == "not set"
     assert state["context_b"] == "finished b with a: started a"
     assert state["context_a"] == "finished a"
-    assert state["bg"] == "bg set - b: started b - a: started a"
+    assert state["bg"] == "bg set - b: finished b with a: started a - a: finished a"
 
 
 def test_sync_raise_raises():
@@ -382,4 +395,7 @@ def test_sync_background_tasks():
     assert data["sync_bg"] == "not set"
     assert state["context_b"] == "finished b with a: started a"
     assert state["context_a"] == "finished a"
-    assert state["sync_bg"] == "sync_bg set - b: started b - a: started a"
+    assert (
+        state["sync_bg"]
+        == "sync_bg set - b: finished b with a: started a - a: finished a"
+    )
diff --git a/tests/test_tutorial/test_dependencies/test_tutorial008b.py b/tests/test_tutorial/test_dependencies/test_tutorial008b.py
new file mode 100644
index 000000000..ed4f4aaca
--- /dev/null
+++ b/tests/test_tutorial/test_dependencies/test_tutorial008b.py
@@ -0,0 +1,23 @@
+from fastapi.testclient import TestClient
+
+from docs_src.dependencies.tutorial008b import app
+
+client = TestClient(app)
+
+
+def test_get_no_item():
+    response = client.get("/items/foo")
+    assert response.status_code == 404, response.text
+    assert response.json() == {"detail": "Item not found"}
+
+
+def test_owner_error():
+    response = client.get("/items/plumbus")
+    assert response.status_code == 400, response.text
+    assert response.json() == {"detail": "Onwer error: Rick"}
+
+
+def test_get_item():
+    response = client.get("/items/portal-gun")
+    assert response.status_code == 200, response.text
+    assert response.json() == {"description": "Gun to create portals", "owner": "Rick"}
diff --git a/tests/test_tutorial/test_dependencies/test_tutorial008b_an.py b/tests/test_tutorial/test_dependencies/test_tutorial008b_an.py
new file mode 100644
index 000000000..aa76ad6af
--- /dev/null
+++ b/tests/test_tutorial/test_dependencies/test_tutorial008b_an.py
@@ -0,0 +1,23 @@
+from fastapi.testclient import TestClient
+
+from docs_src.dependencies.tutorial008b_an import app
+
+client = TestClient(app)
+
+
+def test_get_no_item():
+    response = client.get("/items/foo")
+    assert response.status_code == 404, response.text
+    assert response.json() == {"detail": "Item not found"}
+
+
+def test_owner_error():
+    response = client.get("/items/plumbus")
+    assert response.status_code == 400, response.text
+    assert response.json() == {"detail": "Onwer error: Rick"}
+
+
+def test_get_item():
+    response = client.get("/items/portal-gun")
+    assert response.status_code == 200, response.text
+    assert response.json() == {"description": "Gun to create portals", "owner": "Rick"}
diff --git a/tests/test_tutorial/test_dependencies/test_tutorial008b_an_py39.py b/tests/test_tutorial/test_dependencies/test_tutorial008b_an_py39.py
new file mode 100644
index 000000000..aa76ad6af
--- /dev/null
+++ b/tests/test_tutorial/test_dependencies/test_tutorial008b_an_py39.py
@@ -0,0 +1,23 @@
+from fastapi.testclient import TestClient
+
+from docs_src.dependencies.tutorial008b_an import app
+
+client = TestClient(app)
+
+
+def test_get_no_item():
+    response = client.get("/items/foo")
+    assert response.status_code == 404, response.text
+    assert response.json() == {"detail": "Item not found"}
+
+
+def test_owner_error():
+    response = client.get("/items/plumbus")
+    assert response.status_code == 400, response.text
+    assert response.json() == {"detail": "Onwer error: Rick"}
+
+
+def test_get_item():
+    response = client.get("/items/portal-gun")
+    assert response.status_code == 200, response.text
+    assert response.json() == {"description": "Gun to create portals", "owner": "Rick"}

From 678bed2fc9cbf38ba7a6ba9782e5be1a33d852c5 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 25 Dec 2023 17:57:54 +0000
Subject: [PATCH 301/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 12bc12d26..bc6fd9d11 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -107,6 +107,10 @@ participant tasks as Background tasks
 
 The new execution flow can be found in the docs: [Execution of dependencies with `yield`](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-with-yield/#execution-of-dependencies-with-yield).
 
+### Features
+
+* ✨ Add support for raising exceptions (including `HTTPException`) in dependencies with `yield` in the exit code, do not support them in background tasks. PR [#10831](https://github.com/tiangolo/fastapi/pull/10831) by [@tiangolo](https://github.com/tiangolo).
+
 ### Internal
 
 * 👥 Update FastAPI People. PR [#10567](https://github.com/tiangolo/fastapi/pull/10567) by [@tiangolo](https://github.com/tiangolo).

From bcd5a424cdca5973a2f4927de83c8eb2ca658011 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Mon, 25 Dec 2023 19:00:47 +0100
Subject: [PATCH 302/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index bc6fd9d11..a2424a383 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,12 @@ hide:
 
 ## Latest Changes
 
+### Breaking Changes
+
+Using resources from dependencies with `yield` in background tasks is no longer supported.
+
+This change is what supports the new features, read below. 🤓
+
 ### Dependencies with `yield`, `HTTPException` and Background Tasks
 
 Dependencies with `yield` now can raise `HTTPException` and other exceptions after `yield`. 🎉

From 91510db62012b817627833e896ddb579056c5922 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Mon, 25 Dec 2023 19:01:26 +0100
Subject: [PATCH 303/317] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.10?=
 =?UTF-8?q?6.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 2 ++
 fastapi/__init__.py           | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index a2424a383..fc38cb475 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
 
 ## Latest Changes
 
+## 0.106.0
+
 ### Breaking Changes
 
 Using resources from dependencies with `yield` in background tasks is no longer supported.
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index dd16ea34d..4348bd98e 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.105.0"
+__version__ = "0.106.0"
 
 from starlette import status as status
 

From 5826c4f31f8b6e0d8a289d4c5a6c5a7f8ccb263a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Mon, 25 Dec 2023 19:06:04 +0100
Subject: [PATCH 304/317] =?UTF-8?q?=F0=9F=93=9D=20Tweak=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index fc38cb475..0c118e7c9 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -57,7 +57,7 @@ def get_item(item_id: str, username: Annotated[str, Depends(get_username)]):
 
 ---
 
-Before FastAPI 0.106.0, raising exceptions after `yield` was not possible, the exit code in dependencies with `yield` was executed *after* the response was sent, so [Exception Handlers](../handling-errors.md#install-custom-exception-handlers){.internal-link target=_blank} would have already run.
+Before FastAPI 0.106.0, raising exceptions after `yield` was not possible, the exit code in dependencies with `yield` was executed *after* the response was sent, so [Exception Handlers](https://fastapi.tiangolo.com/tutorial/handling-errors/#install-custom-exception-handlers) would have already run.
 
 This was designed this way mainly to allow using the same objects "yielded" by dependencies inside of background tasks, because the exit code would be executed after the background tasks were finished.
 

From 8b5843ebcd1ccc9582ef34b9dba0a9162140396b Mon Sep 17 00:00:00 2001
From: Alejandra <90076947+alejsdev@users.noreply.github.com>
Date: Tue, 26 Dec 2023 12:13:50 -0500
Subject: [PATCH 305/317] =?UTF-8?q?=F0=9F=93=9D=20Restructure=20Docs=20sec?=
 =?UTF-8?q?tion=20in=20Contributing=20page=20(#10844)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

📝 Restructure Docs section in Contributing page
---
 docs/en/docs/contributing.md | 58 ++++++++++++++++++++----------------
 1 file changed, 32 insertions(+), 26 deletions(-)

diff --git a/docs/en/docs/contributing.md b/docs/en/docs/contributing.md
index cfdb607d7..35bc1c501 100644
--- a/docs/en/docs/contributing.md
+++ b/docs/en/docs/contributing.md
@@ -150,32 +150,7 @@ For it to sort them correctly, you need to have FastAPI installed locally in you
 
 First, make sure you set up your environment as described above, that will install all the requirements.
 
-The documentation uses <a href="https://www.mkdocs.org/" class="external-link" target="_blank">MkDocs</a>.
-
-And there are extra tools/scripts in place to handle translations in `./scripts/docs.py`.
-
-!!! tip
-    You don't need to see the code in `./scripts/docs.py`, you just use it in the command line.
-
-All the documentation is in Markdown format in the directory `./docs/en/`.
-
-Many of the tutorials have blocks of code.
-
-In most of the cases, these blocks of code are actual complete applications that can be run as is.
-
-In fact, those blocks of code are not written inside the Markdown, they are Python files in the `./docs_src/` directory.
-
-And those Python files are included/injected in the documentation when generating the site.
-
-### Docs for tests
-
-Most of the tests actually run against the example source files in the documentation.
-
-This helps making sure that:
-
-* The documentation is up to date.
-* The documentation examples can be run as is.
-* Most of the features are covered by the documentation, ensured by test coverage.
+### Docs live
 
 During local development, there is a script that builds the site and checks for any changes, live-reloading:
 
@@ -229,6 +204,37 @@ Completion will take effect once you restart the terminal.
 
 </div>
 
+### Docs Structure
+
+The documentation uses <a href="https://www.mkdocs.org/" class="external-link" target="_blank">MkDocs</a>.
+
+And there are extra tools/scripts in place to handle translations in `./scripts/docs.py`.
+
+!!! tip
+    You don't need to see the code in `./scripts/docs.py`, you just use it in the command line.
+
+All the documentation is in Markdown format in the directory `./docs/en/`.
+
+Many of the tutorials have blocks of code.
+
+In most of the cases, these blocks of code are actual complete applications that can be run as is.
+
+In fact, those blocks of code are not written inside the Markdown, they are Python files in the `./docs_src/` directory.
+
+And those Python files are included/injected in the documentation when generating the site.
+
+### Docs for tests
+
+Most of the tests actually run against the example source files in the documentation.
+
+This helps making sure that:
+
+* The documentation is up to date.
+* The documentation examples can be run as is.
+* Most of the features are covered by the documentation, ensured by test coverage.
+
+
+
 ### Apps and docs at the same time
 
 If you run the examples with, e.g.:

From 4de60e153a73ee51e6be3378b64fc16bbd251d8a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 26 Dec 2023 17:14:13 +0000
Subject: [PATCH 306/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 0c118e7c9..b5fbdfa45 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Docs
+
+* 📝 Restructure Docs section in Contributing page. PR [#10844](https://github.com/tiangolo/fastapi/pull/10844) by [@alejsdev](https://github.com/alejsdev).
+
 ## 0.106.0
 
 ### Breaking Changes

From 505ae06c0bb2ba745587731ca88e4165b64003a6 Mon Sep 17 00:00:00 2001
From: Alejandra <90076947+alejsdev@users.noreply.github.com>
Date: Tue, 26 Dec 2023 12:23:20 -0500
Subject: [PATCH 307/317] =?UTF-8?q?=F0=9F=93=9D=20Add=20docs:=20Node.js=20?=
 =?UTF-8?q?script=20alternative=20to=20update=20OpenAPI=20for=20generated?=
 =?UTF-8?q?=20clients=20(#10845)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/advanced/generate-clients.md | 14 ++++++++---
 docs_src/generate_clients/tutorial004.js  | 29 +++++++++++++++++++++++
 2 files changed, 40 insertions(+), 3 deletions(-)
 create mode 100644 docs_src/generate_clients/tutorial004.js

diff --git a/docs/en/docs/advanced/generate-clients.md b/docs/en/docs/advanced/generate-clients.md
index e8d771f71..3a810baee 100644
--- a/docs/en/docs/advanced/generate-clients.md
+++ b/docs/en/docs/advanced/generate-clients.md
@@ -229,9 +229,17 @@ But for the generated client we could **modify** the OpenAPI operation IDs right
 
 We could download the OpenAPI JSON to a file `openapi.json` and then we could **remove that prefixed tag** with a script like this:
 
-```Python
-{!../../../docs_src/generate_clients/tutorial004.py!}
-```
+=== "Python"
+
+    ```Python
+    {!> ../../../docs_src/generate_clients/tutorial004.py!}
+    ```
+
+=== "Node.js"
+
+    ```Python
+    {!> ../../../docs_src/generate_clients/tutorial004.js!}
+    ```
 
 With that, the operation IDs would be renamed from things like `items-get_items` to just `get_items`, that way the client generator can generate simpler method names.
 
diff --git a/docs_src/generate_clients/tutorial004.js b/docs_src/generate_clients/tutorial004.js
new file mode 100644
index 000000000..18dc38267
--- /dev/null
+++ b/docs_src/generate_clients/tutorial004.js
@@ -0,0 +1,29 @@
+import * as fs from "fs";
+
+const filePath = "./openapi.json";
+
+fs.readFile(filePath, (err, data) => {
+  const openapiContent = JSON.parse(data);
+  if (err) throw err;
+
+  const paths = openapiContent.paths;
+
+  Object.keys(paths).forEach((pathKey) => {
+    const pathData = paths[pathKey];
+    Object.keys(pathData).forEach((method) => {
+      const operation = pathData[method];
+      if (operation.tags && operation.tags.length > 0) {
+        const tag = operation.tags[0];
+        const operationId = operation.operationId;
+        const toRemove = `${tag}-`;
+        if (operationId.startsWith(toRemove)) {
+          const newOperationId = operationId.substring(toRemove.length);
+          operation.operationId = newOperationId;
+        }
+      }
+    });
+  });
+  fs.writeFile(filePath, JSON.stringify(openapiContent, null, 2), (err) => {
+    if (err) throw err;
+  });
+});

From a751032c0929cdc4a891666240f0dc4849cf58a9 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 26 Dec 2023 17:23:45 +0000
Subject: [PATCH 308/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index b5fbdfa45..f683b1802 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Docs
 
+* 📝 Add docs: Node.js script alternative to update OpenAPI for generated clients. PR [#10845](https://github.com/tiangolo/fastapi/pull/10845) by [@alejsdev](https://github.com/alejsdev).
 * 📝 Restructure Docs section in Contributing page. PR [#10844](https://github.com/tiangolo/fastapi/pull/10844) by [@alejsdev](https://github.com/alejsdev).
 
 ## 0.106.0

From d633953f13d70706daa3bbc03f6b3ab66648e02f Mon Sep 17 00:00:00 2001
From: Adrian Garcia Badaracco <1755071+adriangb@users.noreply.github.com>
Date: Tue, 26 Dec 2023 20:03:07 +0100
Subject: [PATCH 309/317] =?UTF-8?q?=E2=AC=86=EF=B8=8F=20Upgrade=20Starlett?=
 =?UTF-8?q?e=20to=200.28.0=20(#9636)?=
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>
---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index fa072e595..499d0e5dc 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -40,7 +40,7 @@ classifiers = [
     "Topic :: Internet :: WWW/HTTP",
 ]
 dependencies = [
-    "starlette>=0.27.0,<0.28.0",
+    "starlette>=0.28.0,<0.29.0",
     "pydantic>=1.7.4,!=1.8,!=1.8.1,!=2.0.0,!=2.0.1,!=2.1.0,<3.0.0",
     "typing-extensions>=4.8.0",
     # TODO: remove this pin after upgrading Starlette 0.31.1

From 9090bf4084ac3bd9527a938a5dc814b139740a6b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 26 Dec 2023 19:03:31 +0000
Subject: [PATCH 310/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f683b1802..d165ba52f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Upgrades
+
+* ⬆️ Upgrade Starlette to 0.28.0. PR [#9636](https://github.com/tiangolo/fastapi/pull/9636) by [@adriangb](https://github.com/adriangb).
+
 ### Docs
 
 * 📝 Add docs: Node.js script alternative to update OpenAPI for generated clients. PR [#10845](https://github.com/tiangolo/fastapi/pull/10845) by [@alejsdev](https://github.com/alejsdev).

From f933fd6ff8db06ff77be8406ad56b6b07f13a532 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 26 Dec 2023 20:04:08 +0100
Subject: [PATCH 311/317] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.10?=
 =?UTF-8?q?7.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 2 ++
 fastapi/__init__.py           | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d165ba52f..f7b6207c2 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
 
 ## Latest Changes
 
+## 0.107.0
+
 ### Upgrades
 
 * ⬆️ Upgrade Starlette to 0.28.0. PR [#9636](https://github.com/tiangolo/fastapi/pull/9636) by [@adriangb](https://github.com/adriangb).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index 4348bd98e..8a22b74b6 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.106.0"
+__version__ = "0.107.0"
 
 from starlette import status as status
 

From c55f90df32101006ad3ddd8060d30f24c8f44eb9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 26 Dec 2023 21:12:34 +0100
Subject: [PATCH 312/317] =?UTF-8?q?=E2=AC=86=EF=B8=8F=20Upgrade=20Starlett?=
 =?UTF-8?q?e=20to=20`>=3D0.29.0,<0.33.0`,=20update=20docs=20and=20usage=20?=
 =?UTF-8?q?of=20templates=20with=20new=20Starlette=20arguments=20(#10846)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 📝 Update docs for compatibility with Starlette 0.29.0 and new template arguments

* ⬆️ Upgrade Starlette to >=0.29.0,<0.33.0

* 📌 Remove AnyIO pin
---
 docs/em/docs/advanced/templates.md |  2 +-
 docs/en/docs/advanced/templates.md | 10 ++++++----
 docs_src/templates/tutorial001.py  |  4 +++-
 pyproject.toml                     |  4 +---
 4 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/docs/em/docs/advanced/templates.md b/docs/em/docs/advanced/templates.md
index 1fb57725a..0a73a4f47 100644
--- a/docs/em/docs/advanced/templates.md
+++ b/docs/em/docs/advanced/templates.md
@@ -27,7 +27,7 @@ $ pip install jinja2
 * 📣 `Request` 🔢 *➡ 🛠️* 👈 🔜 📨 📄.
 * ⚙️ `templates` 👆 ✍ ✍ &amp; 📨 `TemplateResponse`, 🚶‍♀️ `request` 1️⃣ 🔑-💲 👫 Jinja2️⃣ "🔑".
 
-```Python hl_lines="4  11  15-16"
+```Python hl_lines="4  11  15-18"
 {!../../../docs_src/templates/tutorial001.py!}
 ```
 
diff --git a/docs/en/docs/advanced/templates.md b/docs/en/docs/advanced/templates.md
index 38618aeeb..583abda7f 100644
--- a/docs/en/docs/advanced/templates.md
+++ b/docs/en/docs/advanced/templates.md
@@ -25,14 +25,16 @@ $ pip install jinja2
 * Import `Jinja2Templates`.
 * Create a `templates` object that you can re-use later.
 * Declare a `Request` parameter in the *path operation* that will return a template.
-* Use the `templates` you created to render and return a `TemplateResponse`, passing the `request` as one of the key-value pairs in the Jinja2 "context".
+* Use the `templates` you created to render and return a `TemplateResponse`, pass the name of the template, the request object, and a "context" dictionary with key-value pairs to be used inside of the Jinja2 template.
 
-```Python hl_lines="4  11  15-16"
+```Python hl_lines="4  11  15-18"
 {!../../../docs_src/templates/tutorial001.py!}
 ```
 
 !!! note
-    Notice that you have to pass the `request` as part of the key-value pairs in the context for Jinja2. So, you also have to declare it in your *path operation*.
+    Before FastAPI 0.108.0, Starlette 0.29.0, the `name` was the first parameter.
+
+    Also, before that, in previous versions, the `request` object was passed as part of the key-value pairs in the context for Jinja2.
 
 !!! tip
     By declaring `response_class=HTMLResponse` the docs UI will be able to know that the response will be HTML.
@@ -58,7 +60,7 @@ It will show the `id` taken from the "context" `dict` you passed:
 
 ## Templates and static files
 
-And you can also use `url_for()` inside of the template, and use it, for example, with the `StaticFiles` you mounted.
+You can also use `url_for()` inside of the template, and use it, for example, with the `StaticFiles` you mounted.
 
 ```jinja hl_lines="4"
 {!../../../docs_src/templates/templates/item.html!}
diff --git a/docs_src/templates/tutorial001.py b/docs_src/templates/tutorial001.py
index 245e7110b..81ccc8d4d 100644
--- a/docs_src/templates/tutorial001.py
+++ b/docs_src/templates/tutorial001.py
@@ -13,4 +13,6 @@ templates = Jinja2Templates(directory="templates")
 
 @app.get("/items/{id}", response_class=HTMLResponse)
 async def read_item(request: Request, id: str):
-    return templates.TemplateResponse("item.html", {"request": request, "id": id})
+    return templates.TemplateResponse(
+        request=request, name="item.html", context={"id": id}
+    )
diff --git a/pyproject.toml b/pyproject.toml
index 499d0e5dc..38728d99e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -40,11 +40,9 @@ classifiers = [
     "Topic :: Internet :: WWW/HTTP",
 ]
 dependencies = [
-    "starlette>=0.28.0,<0.29.0",
+    "starlette>=0.29.0,<0.33.0",
     "pydantic>=1.7.4,!=1.8,!=1.8.1,!=2.0.0,!=2.0.1,!=2.1.0,<3.0.0",
     "typing-extensions>=4.8.0",
-    # TODO: remove this pin after upgrading Starlette 0.31.1
-    "anyio>=3.7.1,<4.0.0",
 ]
 dynamic = ["version"]
 

From 43e2223804d79a4c7309660a411487f0fa47c1c7 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 26 Dec 2023 20:12:59 +0000
Subject: [PATCH 313/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f7b6207c2..f82577e0c 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Upgrades
+
+* ⬆️ Upgrade Starlette to `>=0.29.0,<0.33.0`, update docs and usage of templates with new Starlette arguments. PR [#10846](https://github.com/tiangolo/fastapi/pull/10846) by [@tiangolo](https://github.com/tiangolo).
+
 ## 0.107.0
 
 ### Upgrades

From fe0249a23ebb294be183b3e2cab82addbd68c42c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 26 Dec 2023 21:17:18 +0100
Subject: [PATCH 314/317] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.10?=
 =?UTF-8?q?8.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 2 ++
 fastapi/__init__.py           | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index f82577e0c..3c7936ea9 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
 
 ## Latest Changes
 
+## 0.108.0
+
 ### Upgrades
 
 * ⬆️ Upgrade Starlette to `>=0.29.0,<0.33.0`, update docs and usage of templates with new Starlette arguments. PR [#10846](https://github.com/tiangolo/fastapi/pull/10846) by [@tiangolo](https://github.com/tiangolo).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index 8a22b74b6..02ac83b5e 100644
--- a/fastapi/__init__.py
+++ b/fastapi/__init__.py
@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.107.0"
+__version__ = "0.108.0"
 
 from starlette import status as status
 

From dd790c34ff6f92dba68bef0f46a4a18ba7015f94 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 26 Dec 2023 21:37:34 +0100
Subject: [PATCH 315/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20typo=20in=20?=
 =?UTF-8?q?dependencies=20with=20yield=20source=20examples=20(#10847)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs_src/dependencies/tutorial008b.py                           | 2 +-
 docs_src/dependencies/tutorial008b_an.py                        | 2 +-
 docs_src/dependencies/tutorial008b_an_py39.py                   | 2 +-
 tests/test_tutorial/test_dependencies/test_tutorial008b.py      | 2 +-
 tests/test_tutorial/test_dependencies/test_tutorial008b_an.py   | 2 +-
 .../test_dependencies/test_tutorial008b_an_py39.py              | 2 +-
 6 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs_src/dependencies/tutorial008b.py b/docs_src/dependencies/tutorial008b.py
index 4a1a70dcf..163e96600 100644
--- a/docs_src/dependencies/tutorial008b.py
+++ b/docs_src/dependencies/tutorial008b.py
@@ -17,7 +17,7 @@ def get_username():
     try:
         yield "Rick"
     except OwnerError as e:
-        raise HTTPException(status_code=400, detail=f"Onwer error: {e}")
+        raise HTTPException(status_code=400, detail=f"Owner error: {e}")
 
 
 @app.get("/items/{item_id}")
diff --git a/docs_src/dependencies/tutorial008b_an.py b/docs_src/dependencies/tutorial008b_an.py
index 3a0f1399a..84d8f12c1 100644
--- a/docs_src/dependencies/tutorial008b_an.py
+++ b/docs_src/dependencies/tutorial008b_an.py
@@ -18,7 +18,7 @@ def get_username():
     try:
         yield "Rick"
     except OwnerError as e:
-        raise HTTPException(status_code=400, detail=f"Onwer error: {e}")
+        raise HTTPException(status_code=400, detail=f"Owner error: {e}")
 
 
 @app.get("/items/{item_id}")
diff --git a/docs_src/dependencies/tutorial008b_an_py39.py b/docs_src/dependencies/tutorial008b_an_py39.py
index 30c9cdc69..3b8434c81 100644
--- a/docs_src/dependencies/tutorial008b_an_py39.py
+++ b/docs_src/dependencies/tutorial008b_an_py39.py
@@ -19,7 +19,7 @@ def get_username():
     try:
         yield "Rick"
     except OwnerError as e:
-        raise HTTPException(status_code=400, detail=f"Onwer error: {e}")
+        raise HTTPException(status_code=400, detail=f"Owner error: {e}")
 
 
 @app.get("/items/{item_id}")
diff --git a/tests/test_tutorial/test_dependencies/test_tutorial008b.py b/tests/test_tutorial/test_dependencies/test_tutorial008b.py
index ed4f4aaca..86acba9e4 100644
--- a/tests/test_tutorial/test_dependencies/test_tutorial008b.py
+++ b/tests/test_tutorial/test_dependencies/test_tutorial008b.py
@@ -14,7 +14,7 @@ def test_get_no_item():
 def test_owner_error():
     response = client.get("/items/plumbus")
     assert response.status_code == 400, response.text
-    assert response.json() == {"detail": "Onwer error: Rick"}
+    assert response.json() == {"detail": "Owner error: Rick"}
 
 
 def test_get_item():
diff --git a/tests/test_tutorial/test_dependencies/test_tutorial008b_an.py b/tests/test_tutorial/test_dependencies/test_tutorial008b_an.py
index aa76ad6af..7f51fc52a 100644
--- a/tests/test_tutorial/test_dependencies/test_tutorial008b_an.py
+++ b/tests/test_tutorial/test_dependencies/test_tutorial008b_an.py
@@ -14,7 +14,7 @@ def test_get_no_item():
 def test_owner_error():
     response = client.get("/items/plumbus")
     assert response.status_code == 400, response.text
-    assert response.json() == {"detail": "Onwer error: Rick"}
+    assert response.json() == {"detail": "Owner error: Rick"}
 
 
 def test_get_item():
diff --git a/tests/test_tutorial/test_dependencies/test_tutorial008b_an_py39.py b/tests/test_tutorial/test_dependencies/test_tutorial008b_an_py39.py
index aa76ad6af..7f51fc52a 100644
--- a/tests/test_tutorial/test_dependencies/test_tutorial008b_an_py39.py
+++ b/tests/test_tutorial/test_dependencies/test_tutorial008b_an_py39.py
@@ -14,7 +14,7 @@ def test_get_no_item():
 def test_owner_error():
     response = client.get("/items/plumbus")
     assert response.status_code == 400, response.text
-    assert response.json() == {"detail": "Onwer error: Rick"}
+    assert response.json() == {"detail": "Owner error: Rick"}
 
 
 def test_get_item():

From 84d400b9164f0a1727322de154855023b5eee73c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 26 Dec 2023 20:37:55 +0000
Subject: [PATCH 316/317] =?UTF-8?q?=F0=9F=93=9D=20Update=20release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 3c7936ea9..d17e62414 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Docs
+
+* ✏️ Fix typo in dependencies with yield source examples. PR [#10847](https://github.com/tiangolo/fastapi/pull/10847) by [@tiangolo](https://github.com/tiangolo).
+
 ## 0.108.0
 
 ### Upgrades

From 040ad986d48bb9a400de804f7f25abb856d85e1a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 26 Dec 2023 21:47:18 +0100
Subject: [PATCH 317/317] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20typo=20in=20?=
 =?UTF-8?q?release=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/release-notes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index d17e62414..bb96bce66 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -63,7 +63,7 @@ def get_username():
     try:
         yield "Rick"
     except OwnerError as e:
-        raise HTTPException(status_code=400, detail=f"Onwer error: {e}")
+        raise HTTPException(status_code=400, detail=f"Owner error: {e}")
 
 
 @app.get("/items/{item_id}")