From e239c5637152f9322cbbe56b3b59b19fdd45c324 Mon Sep 17 00:00:00 2001
From: Alper <itsc0508@gmail.com>
Date: Sun, 4 Feb 2024 17:28:44 +0300
Subject: [PATCH 01/70] :globe_with_meridians: Update Turkish translation for
 `docs/tr/docs/fastapi-people.md` (#10547)

---
 docs/tr/docs/fastapi-people.md | 107 +++++++++++++++++----------------
 1 file changed, 56 insertions(+), 51 deletions(-)

diff --git a/docs/tr/docs/fastapi-people.md b/docs/tr/docs/fastapi-people.md
index 3e459036a..4ab43ac00 100644
--- a/docs/tr/docs/fastapi-people.md
+++ b/docs/tr/docs/fastapi-people.md
@@ -1,10 +1,15 @@
+---
+hide:
+  - navigation
+---
+
 # FastAPI Topluluğu
 
 FastAPI, her kökenden insanı ağırlayan harika bir topluluğa sahip.
 
 ## Yazan - Geliştiren
 
-Hey! 👋
+Merhaba! 👋
 
 İşte bu benim:
 
@@ -12,38 +17,37 @@ Hey! 👋
 <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>
+<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">Cevaplar: {{ user.answers }}</div><div class="count">Pull Request'ler: {{ user.prs }}</div></div>
 {% endfor %}
 
 </div>
 {% endif %}
 
-Ben **FastAPI** 'nin yazarı ve geliştiricisiyim. Bununla ilgili daha fazla bilgiyi şurada okuyabilirsiniz:
- [FastAPI yardım - yardım al - Yazar ile iletişime geç](help-fastapi.md#connect-with-the-author){.internal-link target=_blank}.
+Ben **FastAPI**'ın geliştiricisiyim. Bununla ilgili daha fazla bilgiyi şurada okuyabilirsiniz: [FastAPI yardım - yardım al -  benimle iletişime geç](help-fastapi.md#connect-with-the-author){.internal-link target=_blank}.
 
-... Burada size harika FastAPI topluluğunu göstermek istiyorum.
+...burada size harika FastAPI topluluğunu göstermek istiyorum.
 
 ---
 
-**FastAPI** topluluğundan destek alıyor. Ve katkıda bulunanları vurgulamak istiyorum.
+**FastAPI**, topluluğundan çok destek alıyor. Ben de onların katkılarını vurgulamak istiyorum.
 
-İşte o mükemmel insanlar:
+Bu insanlar:
 
-* [GitHubdaki sorunları (issues) çözmelerinde diğerlerine yardım et](help-fastapi.md#help-others-with-issues-in-github){.internal-link target=_blank}.
-* [Pull Requests oluşturun](help-fastapi.md#create-a-pull-request){.internal-link target=_blank}.
-* Pull Requests 'leri gözden geçirin, [özelliklede çevirileri](contributing.md#translations){.internal-link target=_blank}.
+* [GitHubdaki soruları cevaplayarak diğerlerine yardım ediyor](help-fastapi.md#help-others-with-questions-in-github){.internal-link target=_blank}.
+* [Pull Request'ler oluşturuyor](help-fastapi.md#create-a-pull-request){.internal-link target=_blank}.
+* Pull Request'leri gözden geçiriyorlar, [özellikle çeviriler için bu çok önemli](contributing.md#translations){.internal-link target=_blank}.
 
-Onlara bir alkış. 👏 🙇
+Onları bir alkışlayalım. 👏 🙇
 
-## Geçen ayın en aktif kullanıcıları
+## Geçen Ayın En Aktif Kullanıcıları
 
-Bunlar geçen ay boyunca [GitHub' da başkalarına sorunlarında (issues) en çok yardımcı olan ](help-fastapi.md#help-others-with-issues-in-github){.internal-link target=_blank} kullanıcılar  ☕
+Geçtiğimiz ay boyunca [GitHub'da diğerlerine en çok yardımcı olan](help-fastapi.md#help-others-with-questions-in-github){.internal-link target=_blank} kullanıcılar. ☕
 
 {% 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>
+<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">Cevaplanan soru sayısı: {{ user.count }}</div></div>
 {% endfor %}
 
 </div>
@@ -53,57 +57,57 @@ Bunlar geçen ay boyunca [GitHub' da başkalarına sorunlarında (issues) en ço
 
 İşte **FastAPI Uzmanları**. 🤓
 
-Bunlar *tüm zamanlar boyunca* [GitHub' da başkalarına sorunlarında (issues) en çok yardımcı olan](help-fastapi.md#help-others-with-issues-in-github){.internal-link target=_blank} kullanıcılar.
+Uzmanlarımız ise *tüm zamanlar boyunca* [GitHub'da insanların sorularına en çok yardımcı olan](help-fastapi.md#help-others-with-questions-in-github){.internal-link target=_blank} insanlar.
 
-Başkalarına yardım ederek uzman olduklarını kanıtladılar. ✨
+Bir çok kullanıcıya yardım ederek uzman olduklarını kanıtladılar! ✨
 
 {% 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>
+<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">Cevaplanan soru sayısı: {{ user.count }}</div></div>
 {% endfor %}
 
 </div>
 {% endif %}
 
-## En fazla katkıda bulunanlar
+## En Fazla Katkıda Bulunanlar
 
-işte **En fazla katkıda bulunanlar**. 👷
+Şimdi ise sıra **en fazla katkıda bulunanlar**da. 👷
 
-Bu kullanıcılar en çok [Pull Requests oluşturan](help-fastapi.md#create-a-pull-request){.internal-link target=_blank} ve onu kaynak koduna *birleştirenler*.
+Bu kullanıcılar en fazla [kaynak koduyla birleştirilen Pull Request'lere](help-fastapi.md#create-a-pull-request){.internal-link target=_blank} sahip!
 
-Kaynak koduna, belgelere, çevirilere vb. katkıda bulundular. 📦
+Kaynak koduna, dökümantasyona, çevirilere ve bir sürü şeye katkıda bulundular. 📦
 
 {% 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>
+<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 Request sayısı: {{ user.count }}</div></div>
 {% endfor %}
 
 </div>
 {% endif %}
 
-Çok fazla katkıda bulunan var (binden fazla), hepsini şurda görebilirsin: <a href="https://github.com/tiangolo/fastapi/graphs/contributors" class="external-link" target="_blank">FastAPI GitHub Katkıda Bulunanlar</a>. 👷
+Bunlar dışında katkıda bulunan, yüzden fazla, bir sürü insan var. Hepsini <a href="https://github.com/tiangolo/fastapi/graphs/contributors" class="external-link" target="_blank">FastAPI GitHub Katkıda Bulunanlar</a> sayfasında görebilirsin. 👷
 
-## En fazla inceleme yapanlar
+## En Fazla Değerlendirme Yapanlar
 
-İşte **En fazla inceleme yapanlar**. 🕵️
+İşte **en çok değerlendirme yapanlar**. 🕵️
 
-### Çeviri için İncelemeler
+### Çeviri Değerlendirmeleri
 
-Yalnızca birkaç dil konuşabiliyorum (ve çok da iyi değilim 😅). Bu yüzden döküman çevirilerini [**onaylama yetkisi**](contributing.md#translations){.internal-link target=_blank} siz inceleyenlere aittir. Sizler olmadan diğer birkaç dilde dokümantasyon olmazdı.
+Yalnızca birkaç dil konuşabiliyorum (ve çok da iyi değilim 😅). Bu yüzden değerlendirme yapanların da döküman çevirilerini [**onaylama yetkisi**](contributing.md#translations){.internal-link target=_blank} var. Onlar olmasaydı çeşitli dillerde dökümantasyon da olmazdı.
 
 ---
 
-**En fazla inceleme yapanlar** 🕵️ kodun, belgelerin ve özellikle **çevirilerin** kalitesini sağlamak için diğerlerinden daha fazla pull requests incelemiştir.
+**En fazla değerlendirme yapanlar** 🕵️ kodun, dökümantasyonun ve özellikle **çevirilerin** Pull Request'lerini inceleyerek kalitesinden emin oldular.
 
 {% 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>
+<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">Değerlendirme sayısı: {{ user.count }}</div></div>
 {% endfor %}
 
 </div>
@@ -113,66 +117,67 @@ Yalnızca birkaç dil konuşabiliyorum (ve çok da iyi değilim 😅). Bu yüzde
 
 işte **Sponsorlarımız**. 😎
 
-**FastAPI** ve diğer projelerde çalışmamı destekliyorlar, özellikle de <a href="https://github.com/sponsors/tiangolo" class="external-link" target="_blank">GitHub Sponsorları</a>.
+Çoğunlukla <a href="https://github.com/sponsors/tiangolo" class="external-link" target="_blank">GitHub Sponsorları</a> aracılığıyla olmak üzere, **FastAPI** ve diğer projelerdeki çalışmalarımı destekliyorlar.
+
+{% if sponsors %}
+
+{% if sponsors.gold %}
 
 ### Altın Sponsorlar
 
-{% 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 %}
 {% endif %}
 
+{% if sponsors.silver %}
+
 ### Gümüş Sponsorlar
 
-{% if sponsors %}
 {% 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 %}
+
 ### Bronz Sponsorlar
 
-{% if sponsors %}
 {% 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 %}
+
 ### Bireysel Sponsorlar
 
-{% if people %}
-{% if people.sponsors_50 %}
+{% if github_sponsors %}
+{% for group in github_sponsors.sponsors %}
 
 <div class="user-list user-list-center">
-{% for user in people.sponsors_50 %}
+
+{% 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>
 
-{% endif %}
-{% endif %}
-
-{% if people %}
-<div class="user-list user-list-center">
-{% for user in people.sponsors %}
-
-<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>
 {% endfor %}
-
-</div>
 {% endif %}
 
-## Veriler hakkında - Teknik detaylar
+## Veriler - Teknik detaylar
 
 Bu sayfanın temel amacı, topluluğun başkalarına yardım etme çabasını vurgulamaktır.
 
-Özellikle normalde daha az görünür olan ve çoğu durumda daha zahmetli olan, diğerlerine sorunlar konusunda yardımcı olmak ve pull requests'leri gözden geçirmek gibi çabalar dahil.
+Özellikle normalde daha az görünür olan ve çoğu durumda daha zahmetli olan, diğerlerine sorularında yardımcı olmak, çevirileri ve Pull Request'leri gözden geçirmek gibi çabalar dahil.
 
-Veriler ayda bir hesaplanır, işte kaynak kodu okuyabilirsin :<a href="https://github.com/tiangolo/fastapi/blob/master/.github/actions/people/app/main.py" class="external-link" target="_blank">source code here</a>.
+Veriler ayda bir hesaplanır, <a href="https://github.com/tiangolo/fastapi/blob/master/.github/actions/people/app/main.py" class="external-link" target="_blank">kaynak kodu buradan</a> okuyabilirsin.
 
-Burada sponsorların katkılarını da tekrardan vurgulamak isterim.
+Burada sponsorların katkılarını da vurguluyorum.
 
-Ayrıca algoritmayı, bölümleri, eşikleri vb. güncelleme hakkımı da saklı tutarım (her ihtimale karşı 🤷).
+Ayrıca algoritmayı, bölümleri, eşikleri vb. güncelleme hakkımı da saklı tutuyorum (her ihtimale karşı 🤷).

From 6944ae15a2396ac83ef9f1fa738ac535d24c54d4 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 4 Feb 2024 14:29:04 +0000
Subject: [PATCH 02/70] =?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 2cbeb74d2..2dcfac473 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Translations
+
+* :globe_with_meridians: Update Turkish translation for `docs/tr/docs/fastapi-people.md`. PR [#10547](https://github.com/tiangolo/fastapi/pull/10547) by [@alperiox](https://github.com/alperiox).
+
 ## 0.109.1
 
 ### Security fixes

From 739739c9d25d2ae578b540d3a7eb1c446cffde73 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sun, 4 Feb 2024 21:56:59 +0100
Subject: [PATCH 03/70] =?UTF-8?q?=F0=9F=8D=B1=20Add=20new=20FastAPI=20logo?=
 =?UTF-8?q?=20(#11090)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/en/docs/img/favicon.png                  | Bin 412 -> 5043 bytes
 docs/en/docs/img/github-social-preview.png    | Bin 58136 -> 62301 bytes
 docs/en/docs/img/github-social-preview.svg    |  89 +++++++-----------
 docs/en/docs/img/icon-transparent-bg.png      | Bin 4461 -> 0 bytes
 docs/en/docs/img/icon-white-bg.png            | Bin 5210 -> 0 bytes
 docs/en/docs/img/icon-white.svg               |  33 +++----
 .../docs/img/logo-margin/logo-teal-vector.svg |  72 +++++---------
 docs/en/docs/img/logo-margin/logo-teal.png    | Bin 17680 -> 19843 bytes
 docs/en/docs/img/logo-margin/logo-teal.svg    |  53 ++++++-----
 .../en/docs/img/logo-margin/logo-white-bg.png | Bin 21502 -> 20841 bytes
 docs/en/docs/img/logo-teal-vector.svg         |  75 ++++++---------
 docs/en/docs/img/logo-teal.svg                |  59 +++++++-----
 docs/en/overrides/partials/copyright.html     |  11 +++
 13 files changed, 178 insertions(+), 214 deletions(-)
 mode change 100755 => 100644 docs/en/docs/img/favicon.png
 delete mode 100644 docs/en/docs/img/icon-transparent-bg.png
 delete mode 100644 docs/en/docs/img/icon-white-bg.png
 create mode 100644 docs/en/overrides/partials/copyright.html

diff --git a/docs/en/docs/img/favicon.png b/docs/en/docs/img/favicon.png
old mode 100755
new mode 100644
index b3dcdd3090e52a3d94affb00a40df2fe8a56d4ba..e5b7c3ada7d093d237711560e03f6a841a4a41b2
GIT binary patch
literal 5043
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
JPDHLkV1n0j+0_65

literal 412
zcmV;N0b~A&P)<h;3K|Lk000e1NJLTq001Na001Ni1ONa4O9@aD0004FNkl<Zcmd^=
z0Yn2)7=S-v2N6Or5D26Su0Q|;0Ol|TSPKBA)mkH17&U+Z0R*%m1keNxpt!(Bi>PX*
z{K4Sv{rBz-z`hUQ_xYc@=P{f3wCEBt;){?j=lD#CN0Dbl@rgY=9LX_2EDp%wKp9cI
zMIx3-p{Zs%RFRksEYuLyRV5_kK_@^|uR#rs@lnXoM^snz5JHbR4E7P#D@Y6p1q@!)
z!9SL*p^zBsi0UO+L&BQN_xdH98agIITODdKfgP$7A7V2%MCd7*AC`zS&wFg@kqB=}
z=nRtsV`@l*p)v5uqQgGIYueH3m>eRA{b(Iyph<ON*0PV#Cc+7lsBirRYDCyf4K472
zC~goVObON8t_T#Yp`?9^7|hYLgzAW5p9~5<V?C6(Pk;`2J;W)Zc!Y%pVz{gB(<Fro
z67x>URB#|jeINrI@hBxe*(E%tWQ!K}gpBwmq{{`{%p(7v$68vzm0<1w0000<MNUMn
GLSTXsHK*7B

diff --git a/docs/en/docs/img/github-social-preview.png b/docs/en/docs/img/github-social-preview.png
index a12cbcda560406b5fb5f45b395b94837aecf2b89..4c299c1d6a1ac505e6e997e740a22436f877b5d2 100644
GIT binary patch
literal 62301
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
Xck|Gqk}qyd(tOT+b#wNY>QeK+O^kvd

literal 58136
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

diff --git a/docs/en/docs/img/github-social-preview.svg b/docs/en/docs/img/github-social-preview.svg
index 08450929e..f03a0eefd 100644
--- a/docs/en/docs/img/github-social-preview.svg
+++ b/docs/en/docs/img/github-social-preview.svg
@@ -1,42 +1,15 @@
 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
-   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
    id="svg8"
    version="1.1"
    viewBox="0 0 338.66665 169.33332"
    height="169.33333mm"
    width="338.66666mm"
-   sodipodi:docname="github-social-preview.svg"
-   inkscape:version="0.92.3 (2405546, 2018-03-11)"
-   inkscape:export-filename="/home/user/code/fastapi/docs/img/github-social-preview.png"
-   inkscape:export-xdpi="96"
-   inkscape:export-ydpi="96">
-  <sodipodi:namedview
-     pagecolor="#ffffff"
-     bordercolor="#666666"
-     borderopacity="1"
-     objecttolerance="10"
-     gridtolerance="10"
-     guidetolerance="10"
-     inkscape:pageopacity="0"
-     inkscape:pageshadow="2"
-     inkscape:window-width="1920"
-     inkscape:window-height="1025"
-     id="namedview9"
-     showgrid="false"
-     inkscape:zoom="0.52249777"
-     inkscape:cx="565.37328"
-     inkscape:cy="403.61034"
-     inkscape:window-x="0"
-     inkscape:window-y="27"
-     inkscape:window-maximized="1"
-     inkscape:current-layer="svg8" />
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:dc="http://purl.org/dc/elements/1.1/">
   <defs
      id="defs2" />
   <metadata
@@ -47,7 +20,6 @@
         <dc:format>image/svg+xml</dc:format>
         <dc:type
            rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
       </cc:Work>
     </rdf:RDF>
   </metadata>
@@ -57,42 +29,47 @@
      width="338.66666"
      height="169.33333"
      x="-1.0833333e-05"
-     y="0.71613133"
-     inkscape:export-xdpi="96"
-     inkscape:export-ydpi="96" />
+     y="0.71613133" />
   <g
-     transform="matrix(0.73259569,0,0,0.73259569,64.842852,-4.5763945)"
-     id="layer1">
-    <path
-       style="opacity:0.98000004;fill:#009688;fill-opacity:1;stroke-width:3.20526505"
-       id="path817"
-       d="m 1.4365174,55.50154 c -17.6610514,0 -31.9886064,14.327532 -31.9886064,31.988554 0,17.661036 14.327555,31.988586 31.9886064,31.988586 17.6609756,0 31.9885196,-14.32755 31.9885196,-31.988586 0,-17.661022 -14.327544,-31.988554 -31.9885196,-31.988554 z m -1.66678692,57.63069 V 93.067264 H -11.384533 L 4.6417437,61.847974 V 81.912929 H 15.379405 Z"
-       inkscape:connector-curvature="0" />
+     id="g2"
+     transform="matrix(0.73293148,0,0,0.73293148,42.286898,36.073041)">
+    <g
+       id="g2106"
+       transform="matrix(0.96564264,0,0,0.96251987,-899.3295,194.86874)">
+      <circle
+         style="fill:#009688;fill-opacity:0.980392;stroke:none;stroke-width:0.141404;stop-color:#000000"
+         id="path875-5-9-7-3-2-3-9-9-8-0-0-5-87-7"
+         cx="964.56165"
+         cy="-169.22266"
+         r="33.234192" />
+      <path
+         id="rect1249-6-3-4-4-3-6-6-1-2"
+         style="fill:#ffffff;fill-opacity:0.980392;stroke:none;stroke-width:0.146895;stop-color:#000000"
+         d="m 962.2685,-187.40837 -6.64403,14.80375 -3.03599,6.76393 -6.64456,14.80375 30.59142,-21.56768 h -14.35312 l 20.99715,-14.80375 z" />
+    </g>
     <text
-       id="text979"
-       y="114.91215"
-       x="52.115433"
-       style="font-style:normal;font-weight:normal;font-size:79.71511078px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#009688;fill-opacity:1;stroke:none;stroke-width:1.99287772"
+       id="text979-3"
+       y="59.410606"
+       x="82.667519"
+       style="font-style:normal;font-weight:normal;font-size:79.7151px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#009688;fill-opacity:1;stroke:none;stroke-width:1.99288"
        xml:space="preserve"><tspan
-         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;fill:#009688;fill-opacity:1;stroke-width:1.99287772"
-         y="114.91215"
-         x="52.115433"
-         id="tspan977">FastAPI</tspan></text>
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;fill:#009688;fill-opacity:1;stroke-width:1.99288"
+         y="59.410606"
+         x="82.667519"
+         id="tspan977-7">FastAPI</tspan></text>
   </g>
   <text
      xml:space="preserve"
-     style="font-style:normal;font-weight:normal;font-size:10.58333302px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+     style="font-style:normal;font-weight:normal;font-size:10.5833px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.264583"
      x="169.60979"
      y="119.20409"
      id="text851"><tspan
-       sodipodi:role="line"
        id="tspan849"
        x="169.60979"
        y="119.20409"
-       style="font-style:italic;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Roboto;-inkscape-font-specification:'Roboto Italic';text-align:center;text-anchor:middle;stroke-width:0.26458332">High performance, easy to learn,</tspan><tspan
-       sodipodi:role="line"
+       style="font-style:italic;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Roboto;-inkscape-font-specification:'Roboto Italic';text-align:center;text-anchor:middle;stroke-width:0.264583">High performance, easy to learn,</tspan><tspan
        x="169.60979"
        y="132.53661"
-       style="font-style:italic;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Roboto;-inkscape-font-specification:'Roboto Italic';text-align:center;text-anchor:middle;stroke-width:0.26458332"
+       style="font-style:italic;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Roboto;-inkscape-font-specification:'Roboto Italic';text-align:center;text-anchor:middle;stroke-width:0.264583"
        id="tspan855">fast to code, ready for production</tspan></text>
 </svg>
diff --git a/docs/en/docs/img/icon-transparent-bg.png b/docs/en/docs/img/icon-transparent-bg.png
deleted file mode 100644
index c3481da4ac551129e253450e0fccdc7518dbc31d..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 4461
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

diff --git a/docs/en/docs/img/icon-white-bg.png b/docs/en/docs/img/icon-white-bg.png
deleted file mode 100644
index 00888b5226bf07ace0ddf47f6e3e8b8de5a8603a..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 5210
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

diff --git a/docs/en/docs/img/icon-white.svg b/docs/en/docs/img/icon-white.svg
index cf7c0c7ec..19f0825cc 100644
--- a/docs/en/docs/img/icon-white.svg
+++ b/docs/en/docs/img/icon-white.svg
@@ -1,15 +1,15 @@
 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
    id="svg8"
    version="1.1"
    viewBox="0 0 6.3499999 6.3499999"
    height="6.3499999mm"
-   width="6.3499999mm">
+   width="6.3499999mm"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:dc="http://purl.org/dc/elements/1.1/">
   <defs
      id="defs2" />
   <metadata
@@ -20,20 +20,15 @@
         <dc:format>image/svg+xml</dc:format>
         <dc:type
            rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
       </cc:Work>
     </rdf:RDF>
   </metadata>
-  <g
-     transform="translate(-87.539286,-84.426191)"
-     id="layer1">
-    <path
-       id="path815"
-       d="m 87.539286,84.426191 h 6.35 v 6.35 h -6.35 z"
-       style="fill:none;stroke-width:0.26458332" />
-    <path
-       style="stroke-width:0.26458332;fill:#ffffff"
-       id="path817"
-       d="m 90.714286,84.960649 c -1.457854,0 -2.640542,1.182688 -2.640542,2.640542 0,1.457854 1.182688,2.640542 2.640542,2.640542 1.457854,0 2.640542,-1.182688 2.640542,-2.640542 0,-1.457854 -1.182688,-2.640542 -2.640542,-2.640542 z m -0.137583,4.757209 v -1.656292 h -0.92075 l 1.322916,-2.577042 v 1.656292 h 0.886354 z" />
-  </g>
+  <path
+     id="path875-5-9-7-3-2-3-9-9-8-0-0-5-87-7"
+     style="fill:#ffffff;fill-opacity:0.980392;stroke:none;stroke-width:0.0112167;stop-color:#000000"
+     d="M 3.175 0.53433431 A 2.6405416 2.6320024 0 0 0 0.53433431 3.166215 A 2.6405416 2.6320024 0 0 0 3.175 5.7986125 A 2.6405416 2.6320024 0 0 0 5.8156657 3.166215 A 2.6405416 2.6320024 0 0 0 3.175 0.53433431 z M 2.9925822 1.7259928 L 4.6539795 1.7259928 L 2.9858643 2.8985311 L 4.1263631 2.8985311 L 1.6960205 4.6064372 L 2.2236369 3.4344157 L 2.4649658 2.8985311 L 2.9925822 1.7259928 z " />
+  <path
+     id="path815"
+     d="M 0,0 H 6.35 V 6.35 H 0 Z"
+     style="fill:none;stroke-width:0.264583" />
 </svg>
diff --git a/docs/en/docs/img/logo-margin/logo-teal-vector.svg b/docs/en/docs/img/logo-margin/logo-teal-vector.svg
index 02183293c..3eb945c7e 100644
--- a/docs/en/docs/img/logo-margin/logo-teal-vector.svg
+++ b/docs/en/docs/img/logo-margin/logo-teal-vector.svg
@@ -1,15 +1,15 @@
 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
    width="451.52316mm"
    height="162.82199mm"
    viewBox="0 0 451.52316 162.82198"
    version="1.1"
-   id="svg8">
+   id="svg8"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:dc="http://purl.org/dc/elements/1.1/">
   <defs
      id="defs2" />
   <metadata
@@ -20,10 +20,28 @@
         <dc:format>image/svg+xml</dc:format>
         <dc:type
            rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
       </cc:Work>
     </rdf:RDF>
   </metadata>
+  <g
+     id="g2106"
+     transform="matrix(0.96564264,0,0,0.96251987,-846.8299,244.29116)">
+    <circle
+       style="fill:#009688;fill-opacity:0.980392;stroke:none;stroke-width:0.141404;stop-color:#000000"
+       id="path875-5-9-7-3-2-3-9-9-8-0-0-5-87-7"
+       cx="964.56165"
+       cy="-169.22266"
+       r="33.234192" />
+    <path
+       id="rect1249-6-3-4-4-3-6-6-1-2"
+       style="fill:#ffffff;fill-opacity:0.980392;stroke:none;stroke-width:0.146895;stop-color:#000000"
+       d="m 962.2685,-187.40837 -6.64403,14.80375 -3.03599,6.76393 -6.64456,14.80375 30.59142,-21.56768 h -14.35312 l 20.99715,-14.80375 z" />
+  </g>
+  <path
+     style="font-size:79.7151px;line-height:1.25;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;letter-spacing:0px;word-spacing:0px;fill:#009688;stroke-width:1.99288"
+     d="M 142.02261,108.83303 V 53.590465 h 33.32092 v 6.616353 h -25.58855 v 16.660457 h 22.71881 v 6.536638 h -22.71881 v 25.429117 z m 52.29297,-5.34091 q 2.6306,0 4.62348,-0.0797 2.07259,-0.15943 3.42774,-0.47829 V 90.578273 q -0.79715,-0.398576 -2.63059,-0.637721 -1.75374,-0.31886 -4.30462,-0.31886 -1.67402,0 -3.58718,0.239145 -1.83345,0.239145 -3.42775,1.036296 -1.51459,0.717436 -2.55088,2.072593 -1.0363,1.275442 -1.0363,3.427749 0,3.985755 2.55089,5.580055 2.55088,1.51459 6.93521,1.51459 z m -0.63772,-37.147239 q 4.46404,0 7.49322,1.195727 3.10889,1.116011 4.94233,3.268319 1.91317,2.072593 2.71032,5.022052 0.79715,2.869743 0.79715,6.377208 V 108.1156 q -0.95658,0.15943 -2.71031,0.47829 -1.67402,0.23914 -3.82633,0.47829 -2.15231,0.23914 -4.70319,0.39857 -2.47117,0.23915 -4.94234,0.23915 -3.50746,0 -6.45692,-0.71744 -2.94946,-0.71743 -5.10177,-2.23202 -2.1523,-1.5943 -3.34803,-4.14519 -1.19573,-2.55088 -1.19573,-6.13806 0,-3.427749 1.35516,-5.898917 1.43487,-2.471168 3.82632,-3.985755 2.39146,-1.514587 5.58006,-2.232023 3.18861,-0.717436 6.69607,-0.717436 1.11601,0 2.31174,0.15943 1.19572,0.07972 2.23202,0.31886 1.11601,0.159431 1.91316,0.318861 0.79715,0.15943 1.11601,0.239145 v -2.072593 q 0,-1.833447 -0.39857,-3.587179 -0.39858,-1.833448 -1.43487,-3.188604 -1.0363,-1.434872 -2.86975,-2.232023 -1.75373,-0.876866 -4.62347,-0.876866 -3.6669,0 -6.45693,0.558005 -2.71031,0.478291 -4.06547,1.036297 l -0.87686,-6.138063 q 1.43487,-0.637721 4.7829,-1.195727 3.34804,-0.637721 7.25408,-0.637721 z m 37.86462,37.147239 q 4.54377,0 6.69607,-1.19573 2.23203,-1.19572 2.23203,-3.826322 0,-2.710314 -2.15231,-4.304616 -2.15231,-1.594302 -7.09465,-3.587179 -2.39145,-0.956581 -4.62347,-1.913163 -2.15231,-1.036296 -3.74661,-2.391453 -1.5943,-1.355157 -2.55088,-3.268319 -0.95659,-1.913163 -0.95659,-4.703191 0,-5.500342 4.06547,-8.688946 4.06547,-3.26832 11.0804,-3.26832 1.75374,0 3.50747,0.239146 1.75373,0.15943 3.26832,0.47829 1.51458,0.239146 2.6306,0.558006 1.19572,0.31886 1.83344,0.558006 l -1.35515,6.377208 q -1.19573,-0.637721 -3.74661,-1.275442 -2.55089,-0.717436 -6.13807,-0.717436 -3.10889,0 -5.42062,1.275442 -2.31174,1.195727 -2.31174,3.826325 0,1.355157 0.47829,2.391453 0.55801,1.036296 1.5943,1.913163 1.11601,0.797151 2.71031,1.514587 1.59431,0.717436 3.82633,1.514587 2.94946,1.116011 5.2612,2.232022 2.31173,1.036297 3.90604,2.471169 1.67401,1.434871 2.55088,3.507464 0.87687,1.992878 0.87687,4.942337 0,5.739482 -4.30462,8.688942 -4.2249,2.94946 -12.1167,2.94946 -5.50034,0 -8.60923,-0.95658 -3.10889,-0.87686 -4.2249,-1.35515 l 1.35516,-6.37721 q 1.27544,0.47829 4.06547,1.43487 2.79003,0.95658 7.4135,0.95658 z m 32.84256,-36.110942 h 15.70387 v 6.217778 h -15.70387 v 19.131625 q 0,3.108889 0.47829,5.181481 0.47829,1.992878 1.43487,3.188608 0.95658,1.11601 2.39145,1.5943 1.43487,0.47829 3.34804,0.47829 3.34803,0 5.34091,-0.71744 2.07259,-0.79715 2.86974,-1.11601 l 1.43487,6.13806 q -1.11601,0.55801 -3.90604,1.35516 -2.79003,0.87687 -6.37721,0.87687 -4.2249,0 -7.01492,-1.0363 -2.71032,-1.11601 -4.38434,-3.26832 -1.67401,-2.15231 -2.39145,-5.2612 -0.63772,-3.188599 -0.63772,-7.333784 V 55.822488 l 7.41351,-1.275442 z m 62.49652,41.451852 q -1.35516,-3.58718 -2.55088,-7.01493 -1.19573,-3.507462 -2.47117,-7.094642 h -25.03054 l -5.02205,14.109572 h -8.05123 q 3.18861,-8.76866 5.97863,-16.182165 2.79003,-7.493219 5.42063,-14.189288 2.71031,-6.696069 5.34091,-12.754416 2.6306,-6.138063 5.50034,-12.116696 h 7.09465 q 2.86974,5.978633 5.50034,12.116696 2.6306,6.058347 5.2612,12.754416 2.71031,6.696069 5.50034,14.189288 2.79003,7.413505 5.97863,16.182165 z m -7.25407,-20.48678 q -2.55089,-6.935214 -5.10177,-13.392137 -2.47117,-6.536639 -5.18148,-12.515272 -2.79003,5.978633 -5.34091,12.515272 -2.47117,6.456923 -4.94234,13.392137 z m 37.86453,-35.313791 q 11.6384,0 17.85618,4.464046 6.29749,4.384331 6.29749,13.152992 0,4.782906 -1.75373,8.210656 -1.67402,3.348034 -4.94234,5.500342 -3.1886,2.072592 -7.81208,3.029174 -4.62347,0.956581 -10.44268,0.956581 h -6.13806 v 20.48678 h -7.73236 V 54.387616 q 3.26832,-0.797151 7.25407,-1.036296 4.06547,-0.318861 7.41351,-0.318861 z m 0.63772,6.775784 q -4.94234,0 -7.57294,0.239145 v 21.682508 h 5.8192 q 3.98576,0 7.17436,-0.47829 3.18861,-0.558006 5.34092,-1.753733 2.23202,-1.275441 3.42774,-3.427749 1.19573,-2.152308 1.19573,-5.500342 0,-3.188604 -1.27544,-5.261197 -1.19573,-2.072593 -3.34803,-3.268319 -2.0726,-1.275442 -4.86263,-1.753732 -2.79002,-0.478291 -5.89891,-0.478291 z m 33.16146,-6.217778 h 7.73237 v 55.242565 h -7.73237 z"
+     id="text979-1"
+     aria-label="FastAPI" />
   <rect
      y="7.1054274e-15"
      x="0"
@@ -33,43 +51,5 @@
      style="opacity:0.98000004;fill:none;fill-opacity:1;stroke-width:0.31103656" />
   <g
      id="layer1"
-     transform="translate(83.131114,-6.0791148)">
-    <path
-       d="m 1.4365174,55.50154 c -17.6610514,0 -31.9886064,14.327532 -31.9886064,31.988554 0,17.661036 14.327555,31.988586 31.9886064,31.988586 17.6609756,0 31.9885196,-14.32755 31.9885196,-31.988586 0,-17.661022 -14.327544,-31.988554 -31.9885196,-31.988554 z m -1.66678692,57.63069 V 93.067264 H -11.384533 L 4.6417437,61.847974 V 81.912929 H 15.379405 Z"
-       id="path817"
-       style="opacity:0.98000004;fill:#009688;fill-opacity:1;stroke-width:3.20526505" />
-    <g
-       id="text979"
-       style="font-style:normal;font-weight:normal;font-size:79.71511078px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#009688;fill-opacity:1;stroke:none;stroke-width:1.99287772"
-       aria-label="FastAPI">
-      <path
-         id="path845"
-         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;fill:#009688;fill-opacity:1;stroke-width:1.99287772"
-         d="M 58.970932,114.91215 V 59.669576 H 92.291849 V 66.28593 H 66.703298 v 16.660458 h 22.718807 v 6.536639 H 66.703298 v 25.429123 z" />
-      <path
-         id="path847"
-         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;fill:#009688;fill-opacity:1;stroke-width:1.99287772"
-         d="m 111.2902,109.57124 q 2.6306,0 4.62348,-0.0797 2.07259,-0.15943 3.42775,-0.47829 V 96.657387 q -0.79715,-0.398575 -2.6306,-0.637721 -1.75373,-0.31886 -4.30462,-0.31886 -1.67401,0 -3.58718,0.239145 -1.83344,0.239145 -3.42775,1.036297 -1.51458,0.717436 -2.55088,2.072592 -1.0363,1.27544 -1.0363,3.42775 0,3.98576 2.55089,5.58006 2.55088,1.51459 6.93521,1.51459 z m -0.63772,-37.147247 q 4.46405,0 7.49322,1.195727 3.10889,1.116012 4.94234,3.26832 1.91316,2.072593 2.71031,5.022052 0.79715,2.869744 0.79715,6.377209 v 25.907409 q -0.95658,0.15943 -2.71031,0.47829 -1.67402,0.23915 -3.82633,0.47829 -2.1523,0.23915 -4.70319,0.39858 -2.47117,0.23914 -4.94233,0.23914 -3.50747,0 -6.45693,-0.71743 -2.94946,-0.71744 -5.101766,-2.23203 -2.152308,-1.5943 -3.348035,-4.14518 -1.195726,-2.55088 -1.195726,-6.13806 0,-3.427754 1.355157,-5.898923 1.434872,-2.471168 3.826325,-3.985755 2.391455,-1.514587 5.580055,-2.232023 3.18861,-0.717436 6.69607,-0.717436 1.11601,0 2.31174,0.15943 1.19573,0.07972 2.23202,0.31886 1.11601,0.15943 1.91317,0.318861 0.79715,0.15943 1.11601,0.239145 v -2.072593 q 0,-1.833447 -0.39858,-3.58718 -0.39857,-1.833447 -1.43487,-3.188604 -1.0363,-1.434872 -2.86974,-2.232023 -1.75374,-0.876867 -4.62348,-0.876867 -3.6669,0 -6.45692,0.558006 -2.71032,0.478291 -4.065475,1.036297 l -0.876866,-6.138064 q 1.434871,-0.637721 4.782911,-1.195727 3.34803,-0.637721 7.25407,-0.637721 z" />
-      <path
-         id="path849"
-         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;fill:#009688;fill-opacity:1;stroke-width:1.99287772"
-         d="m 148.47606,109.57124 q 4.54376,0 6.69607,-1.19573 2.23202,-1.19573 2.23202,-3.82633 0,-2.71031 -2.1523,-4.30461 -2.15231,-1.594305 -7.09465,-3.587183 -2.39145,-0.956581 -4.62348,-1.913163 -2.1523,-1.036296 -3.74661,-2.391453 -1.5943,-1.355157 -2.55088,-3.268319 -0.95658,-1.913163 -0.95658,-4.703192 0,-5.500343 4.06547,-8.688947 4.06547,-3.26832 11.0804,-3.26832 1.75373,0 3.50746,0.239146 1.75374,0.15943 3.26832,0.47829 1.51459,0.239146 2.6306,0.558006 1.19573,0.318861 1.83345,0.558006 l -1.35516,6.377209 q -1.19572,-0.637721 -3.74661,-1.275442 -2.55088,-0.717436 -6.13806,-0.717436 -3.10889,0 -5.42063,1.275442 -2.31174,1.195727 -2.31174,3.826325 0,1.355157 0.47829,2.391454 0.55801,1.036296 1.59431,1.913162 1.11601,0.797151 2.71031,1.514587 1.5943,0.717436 3.82633,1.514587 2.94946,1.116012 5.26119,2.232024 2.31174,1.036296 3.90604,2.471168 1.67402,1.434872 2.55089,3.507465 0.87686,1.992874 0.87686,4.942334 0,5.73949 -4.30461,8.68895 -4.2249,2.94946 -12.1167,2.94946 -5.50034,0 -8.60923,-0.95658 -3.10889,-0.87687 -4.2249,-1.35516 l 1.35515,-6.37721 q 1.27545,0.47829 4.06548,1.43487 2.79002,0.95659 7.4135,0.95659 z" />
-      <path
-         id="path851"
-         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;fill:#009688;fill-opacity:1;stroke-width:1.99287772"
-         d="m 181.26388,73.46029 h 15.70387 v 6.217779 h -15.70387 v 19.131626 q 0,3.108885 0.47829,5.181485 0.47829,1.99288 1.43487,3.1886 0.95658,1.11601 2.39145,1.5943 1.43488,0.47829 3.34804,0.47829 3.34803,0 5.34091,-0.71743 2.07259,-0.79715 2.86974,-1.11601 l 1.43488,6.13806 q -1.11601,0.55801 -3.90604,1.35516 -2.79003,0.87686 -6.37721,0.87686 -4.2249,0 -7.01493,-1.03629 -2.71032,-1.11601 -4.38433,-3.26832 -1.67402,-2.15231 -2.39146,-5.2612 -0.63772,-3.1886 -0.63772,-7.33379 V 61.901599 l 7.41351,-1.275442 z" />
-      <path
-         id="path853"
-         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;fill:#009688;fill-opacity:1;stroke-width:1.99287772"
-         d="m 243.78793,114.91215 q -1.35515,-3.58718 -2.55088,-7.01493 -1.19573,-3.50747 -2.47117,-7.09465 h -25.03054 l -5.02206,14.10958 h -8.05122 q 3.1886,-8.76866 5.97863,-16.18217 2.79003,-7.49322 5.42063,-14.18929 2.71031,-6.696069 5.34091,-12.754417 2.6306,-6.138064 5.50034,-12.116697 h 7.09465 q 2.86974,5.978633 5.50034,12.116697 2.6306,6.058348 5.2612,12.754417 2.71031,6.69607 5.50034,14.18929 2.79003,7.41351 5.97864,16.18217 z m -7.25407,-20.486786 q -2.55089,-6.935215 -5.10177,-13.392139 -2.47117,-6.536639 -5.18148,-12.515272 -2.79003,5.978633 -5.34091,12.515272 -2.47117,6.456924 -4.94234,13.392139 z" />
-      <path
-         id="path855"
-         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;fill:#009688;fill-opacity:1;stroke-width:1.99287772"
-         d="m 274.32754,59.11157 q 11.6384,0 17.85618,4.464046 6.2975,4.384331 6.2975,13.152993 0,4.782907 -1.75374,8.210657 -1.67401,3.348035 -4.94233,5.500343 -3.18861,2.072592 -7.81208,3.029174 -4.62348,0.956581 -10.44268,0.956581 h -6.13807 v 20.486786 h -7.73236 V 60.466727 q 3.26832,-0.797151 7.25407,-1.036297 4.06547,-0.31886 7.41351,-0.31886 z m 0.63772,6.775784 q -4.94234,0 -7.57294,0.239146 v 21.68251 h 5.81921 q 3.98575,0 7.17436,-0.478291 3.1886,-0.558006 5.34091,-1.753732 2.23202,-1.275442 3.42775,-3.42775 1.19573,-2.152308 1.19573,-5.500343 0,-3.188604 -1.27545,-5.261197 -1.19572,-2.072593 -3.34803,-3.26832 -2.07259,-1.275441 -4.86262,-1.753732 -2.79003,-0.478291 -5.89892,-0.478291 z" />
-      <path
-         id="path857"
-         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;fill:#009688;fill-opacity:1;stroke-width:1.99287772"
-         d="m 308.08066,59.669576 h 7.73236 v 55.242574 h -7.73236 z" />
-    </g>
-  </g>
+     transform="translate(83.131114,-6.0791148)" />
 </svg>
diff --git a/docs/en/docs/img/logo-margin/logo-teal.png b/docs/en/docs/img/logo-margin/logo-teal.png
index 57d9eec137c0458dd83539835397fdd299e650ed..f08144cd92e7ae62f57e34044605c56a92c1504c 100644
GIT binary patch
literal 19843
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
DDxOq&

literal 17680
zcmeIag;N~g7d?ms2s*e+@DSW#uzYYQKoTH$aEIVJ5E9(o2_D?tL(t$pFu1z~hneks
zclTe|s;&BU6-Ci>b-#DteOJyo-Qn-l6>zaAv5=6EaFrBgwUCfd5lBeLE-%r6Gt8{y
z3&5`zuF^{HUjm2UOY<<`Z%k)JJy#^8mrMVCkm-)7N`R9TZgRSA+D?{ko~B<ckUTv-
zxojNmT+K|KEx4S%SY@7yQz9X~LQ<0b@4Z*n@rt*f;fGel#l#Y;wtn$6@{7iI`01MF
zg#W#jZGAodKB*R^SZV1qyF<c92rWiNBIzg2F(t+%C0X1z5jyXke;-7URpT)50VjT-
zaWp7pWIaE@71PC-eX}cEZ|=K{tF@L`CLWs960eR0gTnsL@qaAve=P9-wFMO0S|*WY
zI}T3A&yNdyC%Xgq;xoUsD&cq2!eT^N@cC)?nvi?!abhTIP-N}UAu+TJ`nVM=O&>&V
zMb7aDWLif1aAx7b>HLqsp3&uG{~aL;W8Fz5r>8jOw5y;^MqV-U!61{zK&lVFH8GrF
zD)ycmFypW-DMF_!G6{Tq0^o?(D%mw28H~6Qp0Q&kZ1ps|@i1whjPH4P)rNb#m-ZZ0
z^5Dpr87)&n`0r{0Z&5*nR@*2wjYBBG2Y;MR5K8;^m<EeewlJqcd`N1>MR#FWmy{dB
z|1Kr~uJvgnJ?#xt>xY*1P{|BZNH$X*`;1ooD7~J@oB5x;6?e3*xQpmBD?fie3GL0s
z_TXq~@V8$LGD8zQr5v{j;Bq7X-_1%nZ0u?ZVHMVEDUxDTBDr-rJ8QOfJnb17*1UUy
z2>$=~G8|htb5s@VM%PW!MI3ce(k+X?s$$SZ(0$Iq@31~LB!-dU-*Hg9Yb-yXFK0$h
zH1R?bRY=G!>%0PFhGzanVC>m*U*O+0;hdiYLQb%@UYmO$Ez?GNzWO3&(u7(gvFp(T
z#al;ra^x%jReKV0JAOVwm5tStfs0tfaHP?ti<u)YcdkJ9CHzytz<>V2e_8yeU7DPb
z`dD`q4*%dKOo3-X-GbwcuB=g{Ijt>6PIc@i1W#MDtzNK#^15h}cO>+YH`*0K1^ym3
zWVgLs{9nUz&6-q`6kq2~C>*6|whnE}c}h~&(ev}FqIn|EEqcwu26-qi9ytk*DbCI7
z@s-$Cj8|QBd#63eA1U>7G1JQLz^)~qPdSGpeoss;E}gQ*B~b!v<EP?^q1n&3em<$G
zoKs5}X~plq8l6}0K1wcffT#G}Z=c+v4~izxU_=cL2^(VHUS<hyPwmy)+ISEy@bO%b
zxl7e+GU4V+@8cCCUIZ=DrICxwIa4@GSvC{OHETI{7ubv=HnP6s?W!p(3yOGt`t=4h
zwOH4lDz5dVOd2DOxSc^?;q0gA?|GcrZ!y}W)QK)rprO64&_7ukeOatB3WNmll?})F
zO7APzVrg!lD71@-r3Xu2$4q<<r-TG%A5@BA?_Uy>R=78GV(e9+4Vac5MAMwJWcd<V
zmJm?5H6bGX9-~|C<TtxAZANVQ-fF3hbrUPV*%fN44!>lblwLFUU21YjruZ$ZQtDS@
z)5y!p8Wp=v$&xS9<v;h{uzEah*-Mcx#)y1v^o;%NoLd+5O@$j49w0oY!nuXg*3Mmi
z7b-j+jWO^&h8M*HS&YneZ}V_|CjAkUmpzT=ejoxt9`_#b?f`dBE8XiJ`&W?#V7IJG
z%dH;&M88wUzjH!7cJuXlMB!oYlm2;Z2Y0O)5)6*R<tvHAu1cOI3*%wT$p6r1Q7Xkx
z1o0icHNPH-MOn!?RJ#A!d-o~^RA;->J+xQ#LjOOrqmjv8SwGDyZnzuQYVsU=HQMdX
zq-KI^Y;Y%+TLiA8vf5fNhl5yhdL@Dk92KTmw&Tjr<H^9a8jF(n3M*St$V%?9>91bF
zLdJl>?2}HLVW9VV#&ENtO42>w%<d`~I7w0KA%Z2qZ9C@I10pQ`>i}I3X^8qcR?JH2
zCMkGXk^~$PrZ}S33sqWY`Hsh+pU0hpe!Sj#xU9Px@O3XkD~E4={8bD>UDA_;#=$oP
zk163>21JP~H#2C9r6yZO;iB&u<lZQSnZ4O)z`2_;Gv$E^t@wBn7N%&S-_}41vx?AK
zu4sMjUSwbq$nSFMczM#=8!HiiS+HvyQr#{lBia0-B~8GAp6xeul0fKBs}D=e1A$@d
ziHrgeJ}_D8PgT)VtsbqYC+g7J@^y_WDJ#;;+&!nJ0u1(f7-WioyI4)-^HzMiH~hio
zMqEwZ%u{fknrCL8PNOl(ePGaGx6cHG1V*mRXlK8spJuY@oAaq(npnpJ)U6zO4GqET
zpGHD5AQWxDLPmu{a5}i%h|jS6*xbHVT2jC5fRl3RS3FxWFlgzqL_NGb-`&LfOlNWb
zOPItHhs}&&fCFpdDWM8mWhc%$ehhFKnM5ZlmE!;$5A*%ktD>I#Gy0C0G-is_PA2{c
z?)#<u=l@NMf_Hp3rsp+5tsxJ}mZG;<g!C>%uj>_asF6xW>3wRYCv=mhcO?pHnpZ$9
z2SJd@D3H@Gryt%~adca+O)3EiBf?Sd@uDY>kv}cFpZTO;ROjuqIoaku8I`1voN`JA
z1PWHEU!Gb+tn~x|_ZW^%zi-u-2_=`zd@JruWZdml{eRzOBzj-zsnI-5^y`+=J*Awv
z@cyf}Y!(Nid4>@s>|z-$r=e*ygkWWtG*g%K@rUkTvgi*^+tW8@qSg1gd3``0@M;$K
z#OGy=I{qOPO>#o^Mg7W^QOvPS98}S(8*GMKgAU{8ey+O?(!U+?gr2*OQv)$r4|jLK
zB&t^rmxpwbH0?#w$eeG1iw9~pwtAuI>X}R^fw!O_qRty?FPnFxyiNm*f9hIb3}LsA
zpVJW^5HOm+Jovx;*Y}?ERyzzr1D2cWPg-atXGq{0utJGylQ>Gp;=twc@Q&PMyuW>r
ziXR)0qv{*2wcj`jvlpgrM-E;a>>wHZuSYR=pc|LeaANu<IK6b3oQ=~KZgIsD_37nJ
z-Xw3t>*9C5ru+B-P|4XFLj}(pf7RhCP<HWGn6#Ol?>;^QL#g}0cd@An)~`_xLW!rR
zc*Ux0FDSYVaAoZxmhMnRta`eI{2u$*15P6BY5WD9m}AsmNFsF<{nRt!3wrZN3O#l)
zuSaDRC>|mO)?Dpqbj~d0(%*4@EDGuwqOSR3u%_&^{H@vkE5Ln?{#sFDHh1`fK1z7;
zod>_&`r`~F9~21e`~({a?`Egs)O$!o5#kS;s?^scKZ=I7!t4cU?pUc(5hDb@4XDBL
zE_y*_8P(s^HD&jvp*N+I^neo)0)ZSu6+5FBTJd8`<x6xWyN#`lg~?y4p2MKQNU<Md
zb0mRU%Ck>@><oQ2)OD|$U4VG6WxjBJFtJJnmer&%-b$!0{QE<mfS{E8NIn}~6(^(D
zi}epFEww=K9j~h;U38_fmBX%D4_ROiL-h7*bFP6=lG3iBxS#i_IwO{h=zMEEdLw5I
zjR6LRBR3CDQRU2K52XJ#KP#~LDM<Mh%=cI;>L}@Ojfm}Tq||mt^;FFMq=w}O2O5)D
z;8;0Xc|Q(DYU!JY0fS^$`<WT-V!uz`zgP9cbY3P;JL=^i6BY-EMn+cFTo>#*Xht2^
zfaP2nDxlp`D6vDtL}I-Jd$hKe%<27rwA<OG7gMC7vICYbHL->7Fw>BAp$&z^X!^}7
zH2(Rn&ihMp<np_zx*{n7fzq%1!uk_`-C1M`I-TpexLOvFd*Q5zl|YjpX8jD(L^E@%
zlKFhVZzr|*Jnbv);5z6VgWV&Nnh82*<Gl{74o|_D)H>;U5+JI`r*JM}Td}f~nffIb
zw<3yN#%b>KmL#HqOz!oQvFK;%wSHPQ=3Qt0WUGd6B`Y6LC0R`VZflK#t&||^fzp>E
zrAuC#`#x~&2#WwAw@fx&kIA>w_P5`45gnMW9wAnzw&4bh?!91R0EU&TgpNdr-(#l4
z0x<=lAOZyl1l(_S@U;GHm*#%hwlh>-QaBjOrUrit3mYOeZ1Pg5;V1gonohy#*>zWN
z(T;fO#bc_*GroX%%C<1+!+TB?OG4uuGw8!015{-uKOnsC$iM?Hy>f;)F=-gYZw1@x
z3S>%vaur%}{e1nlu3G1&jKm431_CX@ZSj^u{Z2b+4;9(iTU>*zo=6%JpXLZDz=DY6
zD%Xw2pxbXTybPn9MW*A4d1f#6j<0_gxP6EZ3rni1s<Kt|smW=N97xGDzMAoGOhuhw
zEyoopsV=e+F1R-~aiC>CRay96eWj~mt_UQ>x>I{xmku7cD1u84F8HT?eCEDm6dE`y
z0|T?&`avvmJ4@NdCbP)xlHIc9m=9^o8_kpd&hoB)Jxk2SYc(~!0o`SYe<9`@^etoN
zGyjl>s`$42XuP-9YM-2OyIi2j$DrxM&A=oXgx2~cjjVY&r(PYZ`;k$s#VS%%KMb!&
zmwFjx`DzpO#EW>Ggr}L-%8s|0_Skz=LT#J27sfbi4j*o<&&9jVWaIzCl_5*qO~8JP
z;%G%p<P!A@7D6=PK;=BKwTaB(gBR)BD<MxTp*|{AdH~6~+La=>5vI53Z#@WKUGw^?
z>A&D;8K}}jNdXI$@N;<&8dZERqr99YYB#*sg>JB4@}rZgWk7>7K2P(?xU_0$ek%A(
zTU8}Vf9!2+?6bd(D@!W3-tQ92N*o&5Z8@ktiP(oT-1KMO8`K-<xdY+f=w3eV&J%f-
zzd}za<bj=kpRt{ssNfKP<jYnoUU<~j#BZ1~%awuy?q`_-V-eD0>vbd(I`TzQq}w{l
zgB?f{_tUr5-ZNt_u}BR4ayZVmYiAFm2yH(MRpj(HEc;!H49IGSB!yF)e3OxA&UrgM
z<78#KT384X?DshFYD4hrcy@opjd#|}lR-XMYx8({U0e`x`bx@OHbi|4QuIkjCsw5;
ztI8nFaCG!IW0F@nw!FB+Qxfd`Q5xvfY96}$Ys#8~I&ob?*N<OuY#<x!J7G|>BC+Bl
ze+(OLex`L@D_HLu9NmS)yo)(c;S|YI{p%71`qi_|5UquA{JoZJ@q$}I+&Rt(LVS$3
z?%@pide?06{PsunuHp9bd}s`Epj_<K?9=TeZwM37go*aVO_MqZ)n$)#ZDg~0!=P@L
zuE|2eYGV)oKei7*s2$#eN95You6;{i-cKQpXVAVf4o~5#?7tpm+0dD<Gdabam(veG
zepgDJTj)BRYLj;TZvV9w{iQ=9{R7fsc*Q4g0dx88&z6!EFJV(6F~uV(aTCud1{hnO
zh^Y{wUo%DQ%@Syj0xdQ@+cn07$GAOIfwvA`ukaHmR*+$e)N4Iu*ANz<L1dv$5P5Lf
zf64vD06h!Xz9045Oi%_&ha*~?cwASt_5JDxQgWxDaL_C0%2BPL>3p6g*R|tsjVq}T
z71C3z_v5IRY!u-0YQhiKSy&$_Sfj!ELx9W448Atxl7WfwyJ3|gr8b;Ncb$+r-v)Cc
zuc}P5cSQU_K0|NM`2Z4st8n_%J2R-gUe_;{Fu|GM!?;e0(w}jl!SMN9?nXR+ACjhf
zOHL!2%j&37S~ilUQg;*@t!jEybxmVG&#lBW9|AsBTlnS4TE$p2c8urL$k#Ef&lyku
z?#ej6LJP0hJ8L!Lk96p3?{WVK3v8g`r)RVJ9^kBy_}97e6^x16xafS;kg7_7Qv-1L
zdl=4qbvLL5X_3pVkbW_}u)bdF0f^oSbh3}yhkGmab50JOI>^J#=%1$TFpIX++yCfu
z4mz&dhT{ZfAe3E|mfHhSWd_L!V$eo&R*1mz6y(v7#UXg~Y{D%sZlROBgiF|w5Lro2
ziTkG7ygr=a%kNH~rB~>Jih5%5ws0crrM}0!k`pqW4HdFSR_fuTo6Z!r$Q``<SjUUJ
z_3YMklF|~BRCQQ;ixSX8hr6o9$hQfEw~R1Xpg^RL<*B-jn4}*WYE4Vth^j~;*@90J
zh~MM4EDtqza=OJ;CQM|jQ?G?=#Z77w*6z<w5)=;Q|7ItmGkrRhk#g#V7GVye4F%3z
zx7vI(UIU4r6@9GOHU0${QmKuLGIncwl2<<Dkx#p>$YuJAsIzKu!SntkFVl{JZ3ZN8
zrS~}}#^4}8UC?#gl?-Jqunv+(p*@HI<}TL&l!yajz?MF(Go=}aF8WZ#bTd&>^@xP_
zM=CG_>oz)*9Mcq?3ucfh*zHdE{cIIjj!RRpANA;6x0jh`mXtjNbSYm8v!MQYj9woj
zx4<dfB5ZDP3*@jh1g?qE{_C74!`q)F2FJy$6_XQ4>><yqyB0SPYWHVMr#Eqgdk2Ts
zf(XJ8V1+)PZsjpXg{l6vsDlOp4SVckpe09Pi$R7Z-1waewSR2P&6YHVcYL~;v?1Ae
zHYqql;nQWVWh&<?!EqvHIjkpY7lQlPiSbZ{mavAm&2b=u!)CF2Fu9~Ck@hVQ)S>Kh
zkiXKqN(q*~Xzji_b6>;E&R2El``JY#6B_qk#q0|7F0}q=s5yBc**p8hxHrBoS-f~x
zYHa>CTV}Id%E21rxpQgsm@;a+nl38%V2CCiSn%SP8vHlo6HsIZnZn&}EgWKX<WxB7
zN)&g(*n?<zBVm6QAz&R{diCWxL@HINtJDuhDi1a*$y?*Mc9S^$>yt_do4J*2<b|}F
z5r2V(Ck7YNJwJ};(AO8F=xiT=%srBsfr!|U#0UR3C3?D9nnU+3Msq&PmwN>Ygi)p<
z^y<e)jeT-CGiszphu(qizrV71s*p7PXsIZGreffy3n|lehrPG|{SuqVcHhWi9-m%(
zk`g&pH5fcDaO28I1E!DyKwDn6@Uey7AO;z25^!Kt;2+Ynp@**KqO<Gua`N1T3drZ>
zy0YDq9w%vx_$0p5E3X}x>v|5_5#(SHhsUeVUl8aPdS`U?2V3RA%iaIUTn%w+8|Uf;
znw4yV%t2;TYtBzZRuf-+X(NSURhzcG(dgx91E@rS*+IfcVt7vCx2d=~_DXM{4d2jw
z*cOu|6Oc>{usGCoi$YqQg=%=bU$Ie?)26)`*FGb*+co|QxIN~>LN|s1i(3>!dvwSy
zm5n`SHX~ZuYH$XGEv5Ge-c)>lh6=}n;Xa|l`tYSf<YG0Gy(0#5As*#;H^(C}ELAx;
zQ<=Rq(Jma$ulju{DNUQQ>~G=-{K;E6n(1QdBi=vLk2>~TFrq&=T3C8`l^A*&3giR@
zb-FZ3wRi^7;5tr|u1(l<Lu}nSVZqW*tLAdY;Nl7W6IT2{L)0o7MGvH^t(i2=%Q}Yt
zlx56)iF_ZXO{Zo8u)=Yo0awRg#w=Ysb-F?G54vWSL{6gve=nRLz<WNzI7Pa(TK@>^
z$@R`h&~i6>%vvoVdpg|RNFcS59;?xpVMwCcr+P&#_^=Zx_#=_GIw-~<Fz)<@?0TYq
zbC~=5;WT<PZ(M_Qw-VwM99r+*bQ0pi(2^MFiEJixnX|L_grIxJz&>@nF^MU}79*uL
z&G~aTf#&b6ZFJ>CoYNy$3qRq<rQoXXXXuVM1S-mJdpn`aW?R<lMjFYoA+lo-Ip?#N
z**{ufbk?@5Y;F<6qH#cLKHFUA>D2U%zvY<Dgn74Wu$7L_b|n`m5ol_0uCGp!E#sXY
z30t5&973yZc)7f(@wRa8PG{DK`<lTBsl2!R{GSre{8tk~=0nN-@N2S)RP2T;B+&OH
zk+QI&P<uw4cOmc3;u#-!4P*Z0;Cbeb<X@)%*a-?i=~O-DVq~zn0$JwDk3oDyZq+rC
zv1YGJu5YN=Tx{Vpj^}cwHU?53IKGQefu%=eaTYfMX@7=6Y9B@8ec9Dq5tLvoVCG1<
zB?TvMvf5EZM)V!5oJw4K#jMkAeVqh_i=@Drz5I9yhiD6mW>+M%wzw;!>HatYtF7Uu
z$M!j8&#zlb1sbbx5)>lJZCBWEa<F;*#;+<6*cllRm9A%6YG2keGrzc)?_x6ow`(~G
zO0QR-lpkF>N^C(#8$Z6~&%kG@;zSwTzU6;;N}#Ch#-m|$&)+}EV^mZgvxe&^3Bb7*
zW__eIZfHaMCIpSSYxV`IuZ1MWF(lsWf&7?sw-C14bw@U~&!lRcXP7i{5ykWyk5U?t
zGvQ7qZ^6B&A+D=;rIci>1}m?aHx4uhdA!mpK#24A3g$zzPbG$<y?KnpA4YYg6%?6O
z?gyiX$}Q?q1seP)2N%RYKA(q_=S5iAc!*`uWOT$mOHt|vBy_|Kebmhndnv+antT-E
zf44oq-&{`N_c~>^)x6%P)9@6%+4*kcnEPMajZb+l$%Z1cNgkh-2sA!bi4<)GL}5f~
z`=VM^W9*rgIua}f<q?Iw;B~yT(rf&pvF=Y>b~0KP8k3*aZ1sMQM(whChkf|CWl@1T
zzLK!rCfG`urL;HMsLp<5)LUaJy&ZYW43qt2{M*tklGHVU3d&Hk+JJaYxt8<NN4DOd
z_Znh*)62ip{adXYrLLh0LBeE}@EsMFnPpF%sYBLg_CKUiSHAuUiWF&lMLl(BRs?dM
zyk1iN(iiP)hjZyoPM7-FCr7gjx4z+wb<6-{6U4kic!dPuofbav)wj_OXyeQd@ZMIR
z*{4)qVGyLbv?9;vm`(y{l=wJhl<P@OmcMq=yG3o*P+8kPyY3VB&CiJCYC-OH^Zlh2
z@G(C>bj+n?Zj@$p%e)XC@%B>GE82nceJMK}e|4~GvsXnKf8@`4?84uoAo1Qu3MkVy
z^J1bJ#+%G2I!Nb1TVy_qZ|IXfuIPs=%2%UDABd~&g@enufo|A7xE`MSlEy5Ox}DdH
zuGyZ%jv@EadY?F85lpG?Z)o#AhjK3<cKk*PRq1wyPTsRAgiVjmH&mGAz<~?Zyy>w$
zm5D*0`62<4CcSHGY$Iehl7vFzptA|vBl=jDAK@CfS*c5m0M{*>oN6U-SNnwXS0cs#
z0Q^aBuBWh2|4=#ckt^Eu^kw$vMIWENErSEZva93mB*DmN6;)SJpf8u(*YzxZ@bVJR
z?en)}`K#^y=b+Ct=M9FxZXxRR@Ay7nV#kJfA!G%qyFWjmfqa!4EL`SD%(1SN+CI%6
z8??2P@mMJLYVfd?**9V7+&Y+O#D4G%JQANL0u2ACA-K%xhJvVgTU_Rsn`PW(&NrS6
zuaF9a7ETh#evR;Wa*AS2SO~wpj<eKmQo4gP`|STLOsFqhcnl)B|Iw|J$-DR8dMfRk
z&iD`P8h_s@M2wB{y38`)iQZlBxOZ!q9q}94Mc~9|AO!et+a?J*_`B4e(f&2W_B%BT
z2<D~S*U1jf@=qAyM<UB&-f3#JZQszE@)$G!B7Yr9ap%ei)0?i;v>W=%Vi?Wu7DJNr
zX3n>av41+dGOzyGw#H`FPAtW%nvG8u2w$U{n0btM7HE9wXnEQ=`l4eGAWAxLprUj9
zN>)oq>n2T(O%<z4blH@cw<1HGx66j=4;Els{+y_~BCt|C^noCWpX5y|aX3IaL%~`&
zG}xY&A66y;XF3;z9E)qOh0fgNLKMd!8KOYxy$(%Q&Ga?i$M5@SR1Y^PeY_)}XnPG0
z4t>+_TYILP*)kB=IVVFH&ne34@;%<@67jVZYBXAP@s3SKP+MY_VC}MX#^quy&@A#@
z=i3lbxu5KO=KrQpYqtLqu1l9b<?wF`3%?{r?B}H{=%g6>-b*1|2q*6Jc&+9an5x!~
z%|W8FLX|-5b!J+Df1!&W>%L8}65%`j!tKr>8EXHrx?4pqV1swtwHv7mS<Yu=t0K~d
zvze@@X$b!yQKKyykEVxe>&xK;gvl++l<M_pL6+q+a?Mm)(RrC-Jbk-Z3V~qx|EmRn
zwzq#4La<BB-jQb;D-ElWXeDr5@*JI2{c3ggBv-R*rP+ccl6^@`d-s^L?QXvKuOXkh
zak+G8e*0v%ZYW3XAUM~kR2@NlQ9PPKKtbp#h<P^6Nzy6Xhz%gQO@C5Vi<_%Efag2M
z9Chj95+4P8iN7>?!X4Dad^1~{@2@{@a|8LF?@}E~^;5xYF4fdSYjRh4+U6f$0A<50
z|2+w5OchrW(MLXw+jfU}2cG)UDe0IW>FPYHXFcLeWJQ=Aheg?q?!usw<B|9m(qoV^
zz3E_g<!}1xeaC~+CFD&xtM?*0If(h3d~|@8I>_=Bxd@)Uo_gH_xjJi^(V!QLfBJ>~
z>Z~MZ2;Ki;u$Q@A^Vc1kTCVS`cK*hn7AMX1&k5BP;_3fS>XQ6CEYC6Ks9-s}?0jLW
z`&ZrPSQqxPI!v(5+7=Trsl075QcoXWnH=(%xv-fZDGeB*>bvi|us_c8kl>{gtxF^&
zCQOyCYRNZDoe54`6}QbTZ2^9MU7k%zey4hr`c-PQs@rH>_X&t0!yS6XFV~z1`rJn@
zXUkv8bFvrEw_M&ov1XHL#vU}q;=%{aP{p=jveeasFeVe>n&F-t69SQ!^*;_iViin)
zcx#4sf#BZ^pF|edmH$V20fPzp)lrvyjj^v^pa&ti)7Zp%c5%r-6dzx??ZU$@)IoE6
zJ#%i`Wdi!lMjU@mFsS2eMqFhj79PX4zPGZwq%_=PY*CLcX?M@D<Y)Rhw&)}{PORUX
zFZ15r+fe<;K#Al1f#lfN#p-(@RkZG6ziu{~1tkNA4V5Q5X*1~eR&wWQeCw+X$;e>N
zlflu4o?b)JF+W{$qd2NvP84ZgeEgj5kD3*`OZO^x>kZhIm4AKQO8%-_d@flzX(MZ!
zTjux?C<O1rw)(Xtx=lZ?$n-b@iEsE4=F-DWWc9}3F$9k%pBhn!PdD+GaIu)7jsScj
zHI|j^xwQ*h7<q_G0-Pb~8dZp2{a%{#V{8}`F{_g}-}lXxtoVa=Qm=VCwJkIAV}Sn2
z-H5Pv`N*l*=5A%jqpo4V8q>8wA1wv7$GOv^0FZ2M_d?mlzBHP?zuvbY>I`*k|F*a;
z75G;Tg$5CH8h}?S?KWsdbXM!(E$*epF|QNQgX{DA@BCUN772Y0X<y}L=7l2hF=<3U
zAo0+fCJ*Y)U9r=-bd1RAY+2dtgdVh6cZ7loS66<|4Nfi|ZasX6&u81xQ-bpOQi43+
zqHVwk4>J?b>T!!;w-2CCG~l=1E?3s}j@a4xo96W&RLLcBenP}$w}M>KsL+}=-tSop
z{64Dr8E7V`xq&%vMO)+%%KEcfV`7B#$naaa7|6?zpzI8Vqo}0nyI)n};jf}BVMI7X
z6r;_iV!$Nb=@KsgNl{V2DXQCUz|lrU^d~G-E0jq8-w7sFmJY@7qGU;Dg_-Z8zBs9y
zUyU?+>&rP%7z-zdbi$FU?4<&jqDeU^`}TkRCwpoV^(>UN+ktT|A68yFTE4pR9V2&u
zUEMc^@h9JFakFh#4Ww8UPo(CpW2blSI(oExOG*AYF->|Rw<ioSb=c<?5B#~Tz<!X&
zP~(KW-t^L{YWw0;XmX}xP-0TlxQ!q=e#33$K)z?%B+Gs>G7WZ~v9a%BaKn$UEZUWt
z<17F1mp08QzFsbCW)mTK96voHCWQt>d4Sgc!K~u(!{fPD*H3($2IG5Y5YFz&buFsL
z>iNk#q)}wFp}mj6D`=;9>mO?_bx&7kA85c!>I1Da5#n07=StMMOu3I@iyw&do%WsI
zdTR#ND|I#g^{{M!9nh<}%*rlIS*Zl^h98RD035Jpk5lJ%0>Ng0axqWjgZJ$>bp}4-
zowXlB#iG6)Pk4`>u|(G%|LPZ;^lOYBTI}q%Z$>R5J<a{s1_L#u*EHYm_S<F2&x<$@
zA`RleYoeMoNFFFltHkiP0tqNx=$u9QJm~LXY9=~7U1y=H!zs5x^?ZI%`xmNe27@gu
z-f0Zrl6%ohhcygO`ODAWuYfL+Hp+MCcdo@!2Ngj5QQ*<srP`k6O=5<O>Qxn1{iP_Y
zliEP+!20rt6u<8e(a1^OO3YV7s0|iE1|H{*?kwy^N2};*z36zR>(43HyL;U0%T6`H
zt|x8{C!)V73W-%K{K<x^d)e{Z?Ia4>xCWDRu>7L{d!K8oL~I98N57Ajco*HBRG%ck
zR;P*j0hGvAFif_ki7szU3m&K`vYn?33<Ws-q(9A&mlbFt;%-UrZ606+9Qw}G@$Hzf
zLL^L<&!hdVqJVc|`enOxN=@1ZVwq-Td(}o={Ha@%zm#38PS<^`358e{{5*PmF?qn4
z;<ep^=BnaVw-=Hi?x$rQCUBK&IhBEN(ehu@9Sp^C{1_W3+q49aK*XCEG751?hq`y9
zm#xM@hOv~0%{0j~qY7t%m^j~Jnt==QwT;p?g`qt-oeCLK=YyKEo{pn$)}!JkIG%kY
z7;Xe0n7matT7N{ARcJ0Y2u2N6sXL=XQp~LF;X#xTC2T>2&3ux7mwk#O6^K8tM7(R!
zX%wi>w*bWF+0<lqO&WN7D<EgEIxTOx6Ix%KbkV9laE-n6+dWzDA_8N@WCwC<kw~a^
zbtYP1-(b-wMVJJ#_5A$yVV>~T;EZwnWh-SzR*f6^pD&NzKN<V#2?q)D?-VIBJPS(i
zQHm#?RrcR8bQM{pXbFuUb7cWlV-)9?sGZU_v4bHJ*C@#3;$=|&tok2J1UJvE20%Ut
zx#1|qTeLp!@8~mn;b$X_rq`2-B>OE-^m3v%;bvJAFAC)E&uqI2uWv>I{o`X#`fsv5
zi<^gs-r-2TDWHwJhn)o#5H5UieB=DzCb&+Jw&xBv{!uXgIpiTl!RRU3<_cwikge*k
z0DB$g6phIlDEl+JeW+P`e$2YAep1`P@)0P0g#f^l6eVvZe^8mZ?Y|}|uf662F9*c5
zik}<jZSk~Rp3CU|r3Y5b^z@H_AmWYNYo%9faLXD-q6HV`fDyz%T05cDa3<u~t*z}-
zY4w?gk&2KmHVhXQ1YL86DY^Tx?u|hh+<4;gfr36;MkOVpve}8&=COI3!5<bzmwi%V
z>Vfu-2CUp~XYKz|B;2AEMCig>qp&W^ErMq?7(elxCXzGuFFoKf^_iqR{gCp?a!G`o
z(vJ<j`D>u?VMR;vE^wxn=y@XR#nYrpm76~54Ni+ypcNqQp=E3e4flGHuMmz-TND7_
z$_tK2N^le8xcrnpO85FNRS?%7_0C>BghoirhM~co%>K&+l;CK@+`eD>^gkVsoBN95
z#z85*Ki)BJ9;3s#Wd8mO@Y2%HC7?bENQwU^;ri&)a+Wg%C=ysN<zOhf;sJQN<2=dl
z1rb7Mx}wLPu@#|<*C=t}zOQ9Fqt?uD0X|F|jkxqRkmjo3Uq85Q)Ar;&rbN<5*TZ##
zq8@>!PHPwZMZvTQMG#(OQ&S5E8yf21OI?{pp(}6U4^U=3qM%N6#QHrR2nZn<-CjYl
zG$fo+#!n9Orf+(d#b?=!2b2r|{<c&vg|@vteKjBTo1F4DqofZgp_VR@c|b0G`(XK;
z-5&gqg7_9gZ($FWOLR5>&4$D<=)W^w(~waSj^-RB=zlbA!qFuHlg7yOz-1+Mu=a?C
zQd;(pCkeC)GlKU20*o?KHh@N>)Mv^lC>BY>ln*VRgBB0A<U%G!32+V2qv-OG>CkVr
zvvz{GP5dayvQ>%cFg;$Td(qWM^xV9PS;O&o>Eicd5tE#*r}ZkRzvnh^Iq*`{0@iGE
zby{5Njy~Vc9%F<5v_5eXL>KRrNh%U*uioXrv4|lvs7Nx?M@+yL^H-4T@>64@aD7)b
z5*HCz*|yNV8feSZ0I-ANXfzx3bVZKZ6n7EC8=(6Bnw@f2{GhQdy@0=2tX3>AtS?YI
zP}rNMU>4V?ejd$js&$=4clM=U5)Zp5-}<FnLv((ryHenVg-VtfNdcEzlw0ldfxT2z
z$gVy>SI4^nq#EXU_Ork}41p3F8k0a-3OfSzxW12lHrvP7Do){mB0q4wQFrkqBQ;hv
zKJiSGXfF{lLmH<D4%MzSKcB3;cWcOwcGV$v7}c8RIlJvSJ1`KyX3xTQ{1k|aLNm_E
zvIZB39@B|FU#w#ufaWn4CP1Nq84!XC<v(!tkQD&F{Wo32kKDs=4irsoT{bveb2kUb
zqv}Pbr$GXZMtZXY5N&D%^#!kr8c?#@*z5HqN+i16@UAZ~(*0^1YNq48+!|rwG_K)x
z*4-y(yT&BtrX>N$;KE1%Puw`HLcMauRVz|CGJ+t%Jf&IV_!`}8I0sa#1*5t6Ix(ha
zAF^@zF9|;hiM^FMy0x|!#nTZ%f?4!D5KwlK9%s5)B(4;3!GEXM1O8D<^Yi5K9iXB}
z;If6Y%k@=+Is@ICSyCs^*06Ne!zZTnEBoN)US$jZ_+Hs1wrDlz8J~(Za}D=Oi|^)n
z5L}d*6MeX<mgked<3%`J_`bJs$MlHQF#{w{ntBoU8(~2=6apnOfJ|l*8arf3UIpqU
zDV(~(Pt(03P<`flR~vi7)6yJb{k}cgg4&(>*;&<J$B{j*a<mtI;AIc?OY%BqqNCNw
zZj69B-k7a}kxpJW90DZ}aKqo5c0CW$gRk`ua;`&zTKGT$iQ8@M{DIYvi_6xwozvQ!
z6iR#J0U5>f99;FRlgPwJPjR*!wwziH9rp41sY{{1xwpo#vVWk+;<WHfhvLWo{YS9?
zz%H&j1_D>7&FcBgO#bLhIy8>&diyyPX-oWlTQsY0_j+E;Hvun^b+>$LsTu^=_$v<~
zL$YXYbqC?N7Fhw7l|91k<$<sFpH3Jvw~j{vAc9E(*p8I!2BctVJ>^?W#QO0Unx8Cv
zq^+nOv%HoGV=PV`g#tiB4yZI(w_pc7wi9!9uW|ffu480O#<e^><RDRH=wMLWB>kJ;
zMjXcHH~+Rc%|F7a_`ds>i!UHEWSwJus!#c9NCEzq#JhKM{cgu2;}aYhX;MbWu9KGG
zBB*89b?380oZ9M>PNjzDl~cTBfr3`nRBm&aSNy!CywD#`G<^cF9JIx6*xcuFTI|Tl
zv41@UKi-t@M#Z47^+<v#Udw&;iFN-}GW-L3d!VcM2Z^YdV<7<x|24k#jf$^jf4Lrw
z0Xbt9%|_m|RL{yro;qf|Owfw>?7fIeYCuRjzq?~%7*qakH(~VAJzn`?*H`s}74X68
zk<?p<-GoW{LKt*>Js}y8*WM2Uf&c)Bf*zNo>o%jFYl2A1of{R9q;B6GF<aWXC`sjL
zcN|MajK8{&@<I|$9oTitl}T~}NLDUT@<76YD8*e>=qCoP-iG6DLbc&43@$910*=Dx
zZ;<26EZ^R~JZ;5R*JTzi0+-m(S6YX4(6pdcjiCGcjx89y(P2m3ZvAlNqR_Bi(hqwf
zlq;8qC)<JBr&*co>5tlvh9;e<pTKt-vf_ZZl*(TlVTqH1<%d<SE4r_>4I5v%VJUsz
zj#l5!xrmb)>HS9`S#mdyo}3nq{}EMLeG*%qlS!E7H=X5OXJO{vu3F|Hh<60MlyY=I
zkBoJ?)jGcf7<eAAxMcw5Lfs0`=bx6Wo}<}CoyLRn%oN`+Il%|jZ#tdym7(7xy0FEQ
zT4K@>yL5iyVLk<+ltrwUf{({l*V-l2El%EV-beQz_^Sb`I{-6ajvO$;gHZuvRlcr}
zn$Z4mn><O+B$zO<F5&7~8A`3i1?Z;M%@B32@QJEg>kpR<Q`_5u%A<h9mxs<uaIsHd
z^xp6iZ1Ky-32EN@O>q%|At4NiNB=m=@1j7+C~TN`*jg&hz4qECPN1|S(g_<Zbd7DW
zAFobK<w0N^^*`}@6ZooJQZierZuGsqypmY|l*JEnACb|%@phKFe1B4DkRaBh%}G%D
z7KlZLTTi)22U2cUKc^**5cmZ?U8LY|h02$^YyAfXES#As;R$q?*2EjioxcibBRaxk
z?AvIqDFQ6B&2H7W-A9z{yHemX12b#EVegp$iH)FOeb6dkP5DEs=k)&B3V2sP-Jol@
zUE0Y3eRxu$`&>EEg7e)PmsaO$->4Kp)u}beUAb@iW?@TYRi<b;ef3fp7^;f+L&=?}
z3d*_w5NUF3!xg^+ic#m&<42eM*;}$g-+2T8y9NNlox&(@krvLTW>ye`1<;nE(w2EG
zsXX&tL*2<Wn5xV?@<RoR@|M&G|Jccwcj!R^0TFuOnQz$*_+zDC>^~PU1(Z}jSbexr
z-~fr~41_oYATq)Rf|0-%5EJ)?-{>1<y;91fJjKfotW;Zyl42+Mpc2cF`3V5Z4H{az
zysa}^yU|ruLCBfw{=1dEM_^j%`-e+}z{G=?<$jzLTg+VmNbZJl?M4XDB^j8P-QK+0
zk)pNjNP!vx_M|7_ZvaH<D34x0-LUyH{q0L%Yi!-#k(@he%t<N&#lJ?QY~fcxKbETM
zbWb(jg%6hJ0Y=#!5<;3=kH^4Gw6akW^B9#2)*{`!Yxymh6$*@#`#A3&;}x#(p;v}Q
z)g&{58$ja&^_oj;3tlg>{WB*TV9x5lvTF-H&kSx+uY7#<m9{FnFJ7T`+Ljf1@rl7g
za(5PTXOAJ@_Ycd^Ju^a;5$Er=8l$AV%G>}={f^k<T6Se`tA^LlSq0-2Pl;JJr}3jE
z49;h=czQqqR-H69(6Z05UOTBNKMS-UzCQGyY<+5fv8JUP5`n`Cb^ZON&c#5<49*L6
z`748ln_462IW{j6jL*n@7c;wgXY}DAeG`Q4du_TIE8{Aa@l9<v{yid~<bcr%y$PS6
z+N+eia7?dB4PH;;`=;RlU`9pnfXB}9>?xt6OXAIwfk(oWjw-tA(^Yd3sgt~gC}}Il
zrPD@#p}3{(jGbv<vaVdeQ$FxgEMq3;bM;a7N$7_4)jPK0H&=EbccJmS^b+Ovc#3OI
zK<l1!h^yB1JeJmK+F30sRsU!Ajqfl5JBvRS10kw`!5g87#`a8xNjNY%v4S;<MPnvg
z=sv$z5g9ViE;AU1rAcIr{nxk5gF|!0Nw@1<E$6T(vwskIZ~Zt`wZiwC-|1&S0VLv9
z5k0~!j$Tg{q#15U0m%dE;$ayF>CxDZxi21s<%f>{<RU)ht)hm|sqN(nfP3IvlyGY}
z6Z=a^7LB2P8Mmt^e+%2sQwI}gbr&JVvw4p(#2B>V0go&eY%&UwQvniqo7?!q+HY<D
z<co88<v#DLT%_2s1Q#BcCx}~vf2n<{YAm_u-JgIOcAm`FUC}YHwF7&ExFPoK%j9D@
z_N8X#wVdEP%O?&-j6qQ6EHvq`R(SKw%_H!(uIr3@ds%9`c9-3~fks)uQS^J;U~kon
z7?fA_8;^Nm*d-{EAKCq4OQ9oOO8Ywikbwz1EnPAPli@y}eUyFkafy=l;-u8QQuXID
z?qH~l0$arYz+P^{dU#BGxJb0U$16ADQl5Byb$hxCT^F2j|D3Y6s{`xyj3~oDF}|xK
zNo;7bW=YKeb#Yut^(;8Jn&uz=)j!<tR6``-Eqz<~ha<SM5LK*V7tquGYGrviw(r@K
z$qL~6PC|Rs`4MnN8UT=NxMM$L2{P1>ytT^WEHRNX2e_m@u7&JM)4Bb=ymMpxY@8;9
z{Mz_2&D(`I+d&Uf$=xIXCTfhbbEe)dT}<zBdY&bWZvfmsGj(i$!^lslU_N$G1nfqA
z2JEliqJy<wnc0>^k&;#sPvc1Y@rK>ZgVB|*7wQwq&3&y0za7ElAFJ{UPON07G@L!i
z8aol^lI4qYA8--gjHn*?1Q;eB6$=lNC+~fc2KFnx{`B$Uu|_NdY9Xfkn>7=dI`Nv?
zXtwxVGv5Vj5YU!sNM8CFAP8hTh+GGe9>1oNUVebxmgXW_5N*}816*jH$Z%tBnuu1J
za99xl*kZv#TtJo@Tlpou5~$zZk#rkqxW?CEG3y=!_N-aUH1?2>wZgyWf+4?~TGxie
zLXsTs0Sk+oFLt++h3@2vL$5M_yHB%tEF{!Y$0-?&s+(SHrURm&#Ez7(Lc@#<TDBBu
zy{~S=KI%W!IUpAoSuJ#!UxN|7*Xhi4m3*w8)GYj(ZioJeDra+tL>}u3^u(0te`ou*
zT|ua~DCNBppeKw94Eq(8Gty{(z37*V@S@R=-|H{dJ<vP=O_O@y@@J_JgfP=Suaa<+
zl64U@*I<Y?(b2>3Ue2!zr_Z-e48DYb0&hK7c1zSiJkS--RV>h=#{t8Ivqc!Cz1DW;
zD4g70Hu7<AUZXgU^YA6NwY{NI*RyhsYovhmHy0irFZp2Kjo@*wi`=;7a|Aj!ymu)M
z5y<MQ^vE@8z1mg{a@keohJ+6^E7&J1iKb6IaRZ0}l4Mm7EN7_;ge+N2KpdY0Nappe
z#<Lm?n(i1Yj3GqMCi@~rg|_o+5^}g_8y)|2#^LW<26hqjYaX~Q{PNbnUoQIh2^&Fc
zI-c(PEGa2&51Tm|c|*M;jBt;?)?$wvL9KtOK;*0M?o$PSG7i^90U%)1qSriv*<kMA
z?Mhg*9?l03;>phb<|9B9XuES@G|-@^0vGOYwd1*(dJ2vlmmTX4vquBO)B0yHsK$)W
zqvN_pUI9}|84-M?`yh7pkM|e^lr8%rFe(#SoER)G=S<zTBdnbKcyKlrvmXY~8^pTe
z`DUat_WI3#5eFD+{p-E)O3%^7t&r<?tl2rSU7(6<?NRj~N52;COPLvL00mBn<$Q&e
zUZyC)-G}|x;e~tO5DG&rTOyEg!@S_Ij-OpSQsh=hV7I!oj}1=P$3%e0_K<$l41fkH
zF5)rdA(+Q81au1}Lk=sY=il!*G#HJJO4Y$*0Csfzm{Vp!K2&HfEh8JDG}eu?@=p%>
zH-P*&WKuJPnG=X8%fqv@YR@nXX$1oB=;D+$(<~W^;|y;7PHO2LKN@Zmp=2A*t|~>U
z44_sBgQWv+m~B0pP&aG@O%+#KuK`jb*r}O__Ek6YfZ(dFT-HG);NTyNI;`>64(pGs
ztwquHx~Rb;aYd%{Ypt0FXA(INdi_!-pUhh_K2;60rstUzel$<6+wKl@)doZc>XXDX
zpBx8WNZ(aqEL!aEg^hLfKim;7mMt?jZQlwsNN(q;w@J+1x~}tbH%6iE+b`cW<}xr)
z0Tsc9>$tTwoG<38_d#Y5`sN_*`fNQs2ZXNo@P_X_?${q^fqYIRI7Mhk3=c}qAdHwY
zqniNy5($@c4c!iSNn;V~V)ynrvpN{8hVkqW-J6LoPCL8j=K#h3pPLQ~Hn@HMPSleO
z=Wz3$c)0y47CVrlXI^hxSm-AJ{Od+?9XhG0)z6z{2OkM_0qx=yltLG}tN}>_Sx}~e
zsG|)O)`b{vS_w20kE+XAth#zvB5nR8vB)R+pN>vrvkyZ8*cRR&3xI|}qdf#7z<VPW
ziBZ{q0N0ho5<L4+dtWyBpKM4`={1Y}`dex#92#a4E}J#9t?N89;$fs1=1JezYRo>7
zN@lK9G1@@QsTuNH<g2|05vZqt|J>DcYa&h3sWB9soCj#kX+eouLp}VgK4r`dY=yhV
zPe33PnaR*Vl8j8=&QsiC8`Oi;JALj9<u|*@&MOFGn*Q6WU}JrcKQ4&^)bi@y^)5ZZ
zdD_IiXEpopC_h=wB>79arH$EI9}Ga_--;Sq-HL3<tND#hWQdMFaoh`Y-qZ29!YvW*
z=ec3_!0R>_e?)<<n{YG8toNA_c(rOb=NEL)#x@(^tG>#G<mX-c3}~#9iJ)%fOuCFr
zN2Q3_Sg)dz(V@AaluIip4+I3)Z`s(3wpE;lI9WeS@tJ{8cTpwsw(O;)T8?_uf8=>{
zTM8hK1fAlYAY$h%ATtSt4{NdFv!xuh?WC{0N-eTfyBsP~KmE_-MIx4dr;y=eXP(6;
zLPNB7hh2kjH#mW}=jgy;ikhnFT0brj&7Pk0UyLlMdk}joOquVOZR?A8Wk*9v4!_SX
zt-dBHCFVrKW~jybs%1JnfKC~%^k&FFaaciZQddyARI#&^<iGQBfn9lm&zN$bG;NnY
zSVPSd-`mX;LbGqZYV}JOmkPz&#fISlJfmaI<NSR*{1fT7PZLcT{B_rzr8~t;pkhd7
z$<>tFWoqG*NRc0BQ2-z6Si7s+riMgrX;KERCxVM{S)Q-KL(bMwb!5CyeCn#zaxk3f
zaaxFOXy_)^yzgdh)bl^5k@Is|`KFb`r3$q#P6+|J75==;Al7>Wt?H4X`D+R&+*;YY
zGwZ9-v;NZzj;GP#lrHvQwtlXPTJ<U-SV?lFpf)ga^t&gf09nk&MmSUZ)!0h+Xu@gN
z>=Po%G-11R)<;Lk5n|qjt;d6o!J0VJ`Lg72qI3A!v5Z1AZQG=44w}{<EL@VJp8!iR
z-+3avZ5z<OY8IeS(=R^NmY;FR9fmS%SY7S58voYq?#kS5o@sV~Hv6iPHZ~W}$FjEa
z4qLby&Di;Zi{Nh>pBNHT#WU10jdISu`dDu13?$eOH=jY{i|_3dG|b<;b*e&Hlux`=
z)Pkf~SmAABXS+@?T2B|Iq(kt8R?fz}qR`4ul`@RJ=Ns{E5!k|Wrh{)~)1CRI06nWr
zsUBYeud>)`f$hFb=Sz<u*Q;!rW)^6s`L(#tbgYpon=gN@{es-J8M)<WM3uYEGF5SG
zL%R^04y*eI%f0raT%~~olT-6;-~$8h|Go?GMZ9!NNi=1NR&9n_V>yO(OxIQ-Wd^kX
zTDLRHF)HOt>tp?DFxDV515{$;s91S6Jj=XV-}&m?Pb*iEEw*U4cGl-LRWrgpW$&2#
z(bFJj_;M=g=AqCVqE)SO+3kBev34*kp1vJx^X0XJM9sR9KGJyRZf<L%)kGam&PtkA
zmpF}X<7BoH=bA=yJAdYB(=?XTcF_2A)~7ZuRK4V+yaxBz%rZ)PS)bNYwBV1vmAl4l
z>8h22!&hwA=C-bUMOli?66tb@to43h#E-<VoqVVL+dmd=9~QPVG`8}orIa{?CU9uj
zq%d74`}d)GUrYbTX{CM0j{S<e&{AAYB4>$OqtwjiC>{roc9={!H*3qv&2$lR_O8v{
zV%p!z_G9t(NTESWX=Pd}V$Y><KIt;H&>?YGSD8k|A!qDu&YxwSSastQWTZXStBI!;
z$X=0XrdlcVZy8-0wxYjiDahQ}MB&sc`kWaFDUf#hiNE{ws6)`={H73=yvl@o+fJr+
z1e(DKV5Aa~5?kvBzUhD+yqgQ3Jm47l5ZqjpB9;J4iacYA7}Wj(S>l)aVo!&J#IqoP
z_?vrnYM6a<yqEZpo>Y;3_GPt$FUJj%&;);F{BXE&Uj=+hLbnCDuG!zXTM{)=D*2O>
z%5d8~*B<WN7lBeKjZ%=6^~!%isz^w0r6!+THx|3?3~irvmwa5cBo|r#3*u(Jmr=$u
z&xeCO9ew>CU|)docjevh{hB=xp!npYmhq4``^7NhvTN2yEundIwa}fR=t;CuGF>2a
z#siYu{|98{<@Nby_XQGCn&_AmS*&`=uo#zKVt9BX1-Wi^QwMvIVR90?*2p_s8s(9{
z6eI3>2}MfTiW#LyT^ZUohvBnPtfKJ(W=dii<^p5+R$5&C$^{_6KL6+V|E&dh5O7?z
XuqwmUh9A!VCZQy!E?XsS^7a1$wHKYW

diff --git a/docs/en/docs/img/logo-margin/logo-teal.svg b/docs/en/docs/img/logo-margin/logo-teal.svg
index 2fad25ef7..ce9db533b 100644
--- a/docs/en/docs/img/logo-margin/logo-teal.svg
+++ b/docs/en/docs/img/logo-margin/logo-teal.svg
@@ -1,15 +1,15 @@
 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
    width="451.52316mm"
    height="162.82199mm"
    viewBox="0 0 451.52316 162.82198"
    version="1.1"
-   id="svg8">
+   id="svg8"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:dc="http://purl.org/dc/elements/1.1/">
   <defs
      id="defs2" />
   <metadata
@@ -20,10 +20,32 @@
         <dc:format>image/svg+xml</dc:format>
         <dc:type
            rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
       </cc:Work>
     </rdf:RDF>
   </metadata>
+  <g
+     id="g2"
+     transform="translate(52.499596,49.422425)">
+    <g
+       id="g2106"
+       transform="matrix(0.96564264,0,0,0.96251987,-899.3295,194.86874)">
+      <circle
+         style="fill:#009688;fill-opacity:0.980392;stroke:none;stroke-width:0.141404;stop-color:#000000"
+         id="path875-5-9-7-3-2-3-9-9-8-0-0-5-87-7"
+         cx="964.56165"
+         cy="-169.22266"
+         r="33.234192" />
+      <path
+         id="rect1249-6-3-4-4-3-6-6-1-2"
+         style="fill:#ffffff;fill-opacity:0.980392;stroke:none;stroke-width:0.146895;stop-color:#000000"
+         d="m 962.2685,-187.40837 -6.64403,14.80375 -3.03599,6.76393 -6.64456,14.80375 30.59142,-21.56768 h -14.35312 l 20.99715,-14.80375 z" />
+    </g>
+    <path
+       style="font-size:79.7151px;line-height:1.25;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;letter-spacing:0px;word-spacing:0px;fill:#009688;stroke-width:1.99288"
+       d="M 89.523017,59.410606 V 4.1680399 H 122.84393 V 10.784393 H 97.255382 V 27.44485 h 22.718808 v 6.536638 H 97.255382 v 25.429118 z m 52.292963,-5.340912 q 2.6306,0 4.62348,-0.07972 2.07259,-0.15943 3.42774,-0.47829 V 41.155848 q -0.79715,-0.398576 -2.63059,-0.637721 -1.75374,-0.31886 -4.30462,-0.31886 -1.67402,0 -3.58718,0.239145 -1.83345,0.239145 -3.42775,1.036296 -1.51459,0.717436 -2.55088,2.072593 -1.0363,1.275442 -1.0363,3.427749 0,3.985755 2.55089,5.580058 2.55088,1.514586 6.93521,1.514586 z m -0.63772,-37.147238 q 4.46404,0 7.49322,1.195727 3.10889,1.116011 4.94233,3.268319 1.91317,2.072593 2.71032,5.022052 0.79715,2.869743 0.79715,6.377208 V 58.69317 q -0.95658,0.159431 -2.71031,0.478291 -1.67402,0.239145 -3.82633,0.478291 -2.15231,0.239145 -4.70319,0.398575 -2.47117,0.239146 -4.94234,0.239146 -3.50746,0 -6.45692,-0.717436 -2.94946,-0.717436 -5.10177,-2.232023 -2.1523,-1.594302 -3.34803,-4.145186 -1.19573,-2.550883 -1.19573,-6.138063 0,-3.427749 1.35516,-5.898917 1.43487,-2.471168 3.82632,-3.985755 2.39146,-1.514587 5.58006,-2.232023 3.18861,-0.717436 6.69607,-0.717436 1.11601,0 2.31174,0.15943 1.19572,0.07972 2.23202,0.31886 1.11601,0.159431 1.91316,0.318861 0.79715,0.15943 1.11601,0.239145 v -2.072593 q 0,-1.833447 -0.39857,-3.587179 -0.39858,-1.833448 -1.43487,-3.188604 -1.0363,-1.434872 -2.86975,-2.232023 -1.75373,-0.876866 -4.62347,-0.876866 -3.6669,0 -6.45693,0.558005 -2.71031,0.478291 -4.06547,1.036297 l -0.87686,-6.138063 q 1.43487,-0.637721 4.7829,-1.195727 3.34804,-0.637721 7.25408,-0.637721 z m 37.86462,37.147238 q 4.54377,0 6.69607,-1.195726 2.23203,-1.195727 2.23203,-3.826325 0,-2.710314 -2.15231,-4.304616 -2.15231,-1.594302 -7.09465,-3.587179 -2.39145,-0.956581 -4.62347,-1.913163 -2.15231,-1.036296 -3.74661,-2.391453 -1.5943,-1.355157 -2.55088,-3.268319 -0.95659,-1.913163 -0.95659,-4.703191 0,-5.500342 4.06547,-8.688946 4.06547,-3.26832 11.0804,-3.26832 1.75374,0 3.50747,0.239146 1.75373,0.15943 3.26832,0.47829 1.51458,0.239146 2.6306,0.558006 1.19572,0.31886 1.83344,0.558006 l -1.35515,6.377208 q -1.19573,-0.637721 -3.74661,-1.275442 -2.55089,-0.717436 -6.13807,-0.717436 -3.10889,0 -5.42062,1.275442 -2.31174,1.195727 -2.31174,3.826325 0,1.355157 0.47829,2.391453 0.55801,1.036296 1.5943,1.913163 1.11601,0.797151 2.71031,1.514587 1.59431,0.717436 3.82633,1.514587 2.94946,1.116011 5.2612,2.232022 2.31173,1.036297 3.90604,2.471169 1.67401,1.434871 2.55088,3.507464 0.87687,1.992878 0.87687,4.942337 0,5.739487 -4.30462,8.688946 -4.2249,2.949459 -12.1167,2.949459 -5.50034,0 -8.60923,-0.956582 -3.10889,-0.876866 -4.2249,-1.355156 l 1.35516,-6.377209 q 1.27544,0.478291 4.06547,1.434872 2.79003,0.956581 7.4135,0.956581 z m 32.84256,-36.110941 h 15.70387 v 6.217778 h -15.70387 v 19.131625 q 0,3.108889 0.47829,5.181481 0.47829,1.992878 1.43487,3.188604 0.95658,1.116012 2.39145,1.594302 1.43487,0.478291 3.34804,0.478291 3.34803,0 5.34091,-0.717436 2.07259,-0.797151 2.86974,-1.116011 l 1.43487,6.138063 q -1.11601,0.558005 -3.90604,1.355156 -2.79003,0.876867 -6.37721,0.876867 -4.2249,0 -7.01492,-1.036297 -2.71032,-1.116011 -4.38434,-3.268319 -1.67401,-2.152308 -2.39145,-5.261197 -0.63772,-3.188604 -0.63772,-7.333789 V 6.4000628 l 7.41351,-1.2754417 z m 62.49652,41.451853 q -1.35516,-3.587179 -2.55088,-7.014929 -1.19573,-3.507464 -2.47117,-7.094644 h -25.03054 l -5.02205,14.109573 h -8.05123 q 3.18861,-8.768661 5.97863,-16.182166 2.79003,-7.493219 5.42063,-14.189288 2.71031,-6.696069 5.34091,-12.754416 2.6306,-6.138063 5.50034,-12.1166961 h 7.09465 q 2.86974,5.9786331 5.50034,12.1166961 2.6306,6.058347 5.2612,12.754416 2.71031,6.696069 5.50034,14.189288 2.79003,7.413505 5.97863,16.182166 z m -7.25407,-20.486781 q -2.55089,-6.935214 -5.10177,-13.392137 -2.47117,-6.536639 -5.18148,-12.515272 -2.79003,5.978633 -5.34091,12.515272 -2.47117,6.456923 -4.94234,13.392137 z M 304.99242,3.6100342 q 11.6384,0 17.85618,4.4640458 6.29749,4.384331 6.29749,13.152992 0,4.782906 -1.75373,8.210656 -1.67402,3.348034 -4.94234,5.500342 -3.1886,2.072592 -7.81208,3.029174 -4.62347,0.956581 -10.44268,0.956581 h -6.13806 v 20.486781 h -7.73236 V 4.9651909 q 3.26832,-0.797151 7.25407,-1.0362963 4.06547,-0.3188604 7.41351,-0.3188604 z m 0.63772,6.7757838 q -4.94234,0 -7.57294,0.239145 v 21.682508 h 5.8192 q 3.98576,0 7.17436,-0.47829 3.18861,-0.558006 5.34092,-1.753733 2.23202,-1.275441 3.42774,-3.427749 1.19573,-2.152308 1.19573,-5.500342 0,-3.188604 -1.27544,-5.261197 -1.19573,-2.072593 -3.34803,-3.268319 -2.0726,-1.275442 -4.86263,-1.753732 -2.79002,-0.478291 -5.89891,-0.478291 z M 338.7916,4.1680399 h 7.73237 V 59.410606 h -7.73237 z"
+       id="text979-1"
+       aria-label="FastAPI" />
+  </g>
   <rect
      y="7.1054274e-15"
      x="0"
@@ -33,20 +55,5 @@
      style="opacity:0.98000004;fill:none;fill-opacity:1;stroke-width:0.31103656" />
   <g
      id="layer1"
-     transform="translate(83.131114,-6.0791148)">
-    <path
-       d="m 1.4365174,55.50154 c -17.6610514,0 -31.9886064,14.327532 -31.9886064,31.988554 0,17.661036 14.327555,31.988586 31.9886064,31.988586 17.6609756,0 31.9885196,-14.32755 31.9885196,-31.988586 0,-17.661022 -14.327544,-31.988554 -31.9885196,-31.988554 z m -1.66678692,57.63069 V 93.067264 H -11.384533 L 4.6417437,61.847974 V 81.912929 H 15.379405 Z"
-       id="path817"
-       style="opacity:0.98000004;fill:#009688;fill-opacity:1;stroke-width:3.20526505" />
-    <text
-       xml:space="preserve"
-       style="font-style:normal;font-weight:normal;font-size:79.71511078px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#009688;fill-opacity:1;stroke:none;stroke-width:1.99287772"
-       x="52.115433"
-       y="114.91215"
-       id="text979"><tspan
-         id="tspan977"
-         x="52.115433"
-         y="114.91215"
-         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;fill:#009688;fill-opacity:1;stroke-width:1.99287772">FastAPI</tspan></text>
-  </g>
+     transform="translate(83.131114,-6.0791148)" />
 </svg>
diff --git a/docs/en/docs/img/logo-margin/logo-white-bg.png b/docs/en/docs/img/logo-margin/logo-white-bg.png
index 89256db06f02eca727a47a373f33a313833b4952..b84fd285ee52d721a29af6e79fafb6ade5987469 100644
GIT binary patch
literal 20841
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
Cn`D*%

literal 21502
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

diff --git a/docs/en/docs/img/logo-teal-vector.svg b/docs/en/docs/img/logo-teal-vector.svg
index c1d1b72e4..d3dad4bec 100644
--- a/docs/en/docs/img/logo-teal-vector.svg
+++ b/docs/en/docs/img/logo-teal-vector.svg
@@ -1,15 +1,15 @@
 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   width="346.36511mm"
-   height="63.977139mm"
-   viewBox="0 0 346.36511 63.977134"
+   id="svg8"
    version="1.1"
-   id="svg8">
+   viewBox="0 0 346.52395 63.977134"
+   height="63.977139mm"
+   width="346.52396mm"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:dc="http://purl.org/dc/elements/1.1/">
   <defs
      id="defs2" />
   <metadata
@@ -20,49 +20,32 @@
         <dc:format>image/svg+xml</dc:format>
         <dc:type
            rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
       </cc:Work>
     </rdf:RDF>
   </metadata>
   <g
-     id="layer1"
-     transform="translate(30.552089,-55.50154)">
-    <path
-       d="m 1.4365174,55.50154 c -17.6610514,0 -31.9886064,14.327532 -31.9886064,31.988554 0,17.661036 14.327555,31.988586 31.9886064,31.988586 17.6609756,0 31.9885196,-14.32755 31.9885196,-31.988586 0,-17.661022 -14.327544,-31.988554 -31.9885196,-31.988554 z m -1.66678692,57.63069 V 93.067264 H -11.384533 L 4.6417437,61.847974 V 81.912929 H 15.379405 Z"
-       id="path817"
-       style="opacity:0.98000004;fill:#009688;fill-opacity:1;stroke-width:3.20526505" />
+     id="g2149">
     <g
-       id="text979"
-       style="font-style:normal;font-weight:normal;font-size:79.71511078px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#009688;fill-opacity:1;stroke:none;stroke-width:1.99287772"
-       aria-label="FastAPI">
+       id="g2141">
+      <g
+         id="g2106"
+         transform="matrix(0.96564264,0,0,0.96251987,-899.3295,194.86874)">
+        <circle
+           style="fill:#009688;fill-opacity:0.980392;stroke:none;stroke-width:0.141404;stop-color:#000000"
+           id="path875-5-9-7-3-2-3-9-9-8-0-0-5-87-7"
+           cx="964.56165"
+           cy="-169.22266"
+           r="33.234192" />
+        <path
+           id="rect1249-6-3-4-4-3-6-6-1-2"
+           style="fill:#ffffff;fill-opacity:0.980392;stroke:none;stroke-width:0.146895;stop-color:#000000"
+           d="m 962.2685,-187.40837 -6.64403,14.80375 -3.03599,6.76393 -6.64456,14.80375 30.59142,-21.56768 h -14.35312 l 20.99715,-14.80375 z" />
+      </g>
       <path
-         id="path923"
-         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;fill:#009688;fill-opacity:1;stroke-width:1.99287772"
-         d="M 58.970932,114.91215 V 59.669576 H 92.291849 V 66.28593 H 66.703298 v 16.660458 h 22.718807 v 6.536639 H 66.703298 v 25.429123 z" />
-      <path
-         id="path925"
-         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;fill:#009688;fill-opacity:1;stroke-width:1.99287772"
-         d="m 111.2902,109.57124 q 2.6306,0 4.62348,-0.0797 2.07259,-0.15943 3.42775,-0.47829 V 96.657387 q -0.79715,-0.398575 -2.6306,-0.637721 -1.75373,-0.31886 -4.30462,-0.31886 -1.67401,0 -3.58718,0.239145 -1.83344,0.239145 -3.42775,1.036297 -1.51458,0.717436 -2.55088,2.072592 -1.0363,1.27544 -1.0363,3.42775 0,3.98576 2.55089,5.58006 2.55088,1.51459 6.93521,1.51459 z m -0.63772,-37.147247 q 4.46405,0 7.49322,1.195727 3.10889,1.116012 4.94234,3.26832 1.91316,2.072593 2.71031,5.022052 0.79715,2.869744 0.79715,6.377209 v 25.907409 q -0.95658,0.15943 -2.71031,0.47829 -1.67402,0.23915 -3.82633,0.47829 -2.1523,0.23915 -4.70319,0.39858 -2.47117,0.23914 -4.94233,0.23914 -3.50747,0 -6.45693,-0.71743 -2.94946,-0.71744 -5.101766,-2.23203 -2.152308,-1.5943 -3.348035,-4.14518 -1.195726,-2.55088 -1.195726,-6.13806 0,-3.427754 1.355157,-5.898923 1.434872,-2.471168 3.826325,-3.985755 2.391455,-1.514587 5.580055,-2.232023 3.18861,-0.717436 6.69607,-0.717436 1.11601,0 2.31174,0.15943 1.19573,0.07972 2.23202,0.31886 1.11601,0.15943 1.91317,0.318861 0.79715,0.15943 1.11601,0.239145 v -2.072593 q 0,-1.833447 -0.39858,-3.58718 -0.39857,-1.833447 -1.43487,-3.188604 -1.0363,-1.434872 -2.86974,-2.232023 -1.75374,-0.876867 -4.62348,-0.876867 -3.6669,0 -6.45692,0.558006 -2.71032,0.478291 -4.065475,1.036297 l -0.876866,-6.138064 q 1.434871,-0.637721 4.782911,-1.195727 3.34803,-0.637721 7.25407,-0.637721 z" />
-      <path
-         id="path927"
-         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;fill:#009688;fill-opacity:1;stroke-width:1.99287772"
-         d="m 148.47606,109.57124 q 4.54376,0 6.69607,-1.19573 2.23202,-1.19573 2.23202,-3.82633 0,-2.71031 -2.1523,-4.30461 -2.15231,-1.594305 -7.09465,-3.587183 -2.39145,-0.956581 -4.62348,-1.913163 -2.1523,-1.036296 -3.74661,-2.391453 -1.5943,-1.355157 -2.55088,-3.268319 -0.95658,-1.913163 -0.95658,-4.703192 0,-5.500343 4.06547,-8.688947 4.06547,-3.26832 11.0804,-3.26832 1.75373,0 3.50746,0.239146 1.75374,0.15943 3.26832,0.47829 1.51459,0.239146 2.6306,0.558006 1.19573,0.318861 1.83345,0.558006 l -1.35516,6.377209 q -1.19572,-0.637721 -3.74661,-1.275442 -2.55088,-0.717436 -6.13806,-0.717436 -3.10889,0 -5.42063,1.275442 -2.31174,1.195727 -2.31174,3.826325 0,1.355157 0.47829,2.391454 0.55801,1.036296 1.59431,1.913162 1.11601,0.797151 2.71031,1.514587 1.5943,0.717436 3.82633,1.514587 2.94946,1.116012 5.26119,2.232024 2.31174,1.036296 3.90604,2.471168 1.67402,1.434872 2.55089,3.507465 0.87686,1.992874 0.87686,4.942334 0,5.73949 -4.30461,8.68895 -4.2249,2.94946 -12.1167,2.94946 -5.50034,0 -8.60923,-0.95658 -3.10889,-0.87687 -4.2249,-1.35516 l 1.35515,-6.37721 q 1.27545,0.47829 4.06548,1.43487 2.79002,0.95659 7.4135,0.95659 z" />
-      <path
-         id="path929"
-         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;fill:#009688;fill-opacity:1;stroke-width:1.99287772"
-         d="m 181.26388,73.46029 h 15.70387 v 6.217779 h -15.70387 v 19.131626 q 0,3.108885 0.47829,5.181485 0.47829,1.99288 1.43487,3.1886 0.95658,1.11601 2.39145,1.5943 1.43488,0.47829 3.34804,0.47829 3.34803,0 5.34091,-0.71743 2.07259,-0.79715 2.86974,-1.11601 l 1.43488,6.13806 q -1.11601,0.55801 -3.90604,1.35516 -2.79003,0.87686 -6.37721,0.87686 -4.2249,0 -7.01493,-1.03629 -2.71032,-1.11601 -4.38433,-3.26832 -1.67402,-2.15231 -2.39146,-5.2612 -0.63772,-3.1886 -0.63772,-7.33379 V 61.901599 l 7.41351,-1.275442 z" />
-      <path
-         id="path931"
-         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;fill:#009688;fill-opacity:1;stroke-width:1.99287772"
-         d="m 243.78793,114.91215 q -1.35515,-3.58718 -2.55088,-7.01493 -1.19573,-3.50747 -2.47117,-7.09465 h -25.03054 l -5.02206,14.10958 h -8.05122 q 3.1886,-8.76866 5.97863,-16.18217 2.79003,-7.49322 5.42063,-14.18929 2.71031,-6.696069 5.34091,-12.754417 2.6306,-6.138064 5.50034,-12.116697 h 7.09465 q 2.86974,5.978633 5.50034,12.116697 2.6306,6.058348 5.2612,12.754417 2.71031,6.69607 5.50034,14.18929 2.79003,7.41351 5.97864,16.18217 z m -7.25407,-20.486786 q -2.55089,-6.935215 -5.10177,-13.392139 -2.47117,-6.536639 -5.18148,-12.515272 -2.79003,5.978633 -5.34091,12.515272 -2.47117,6.456924 -4.94234,13.392139 z" />
-      <path
-         id="path933"
-         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;fill:#009688;fill-opacity:1;stroke-width:1.99287772"
-         d="m 274.32754,59.11157 q 11.6384,0 17.85618,4.464046 6.2975,4.384331 6.2975,13.152993 0,4.782907 -1.75374,8.210657 -1.67401,3.348035 -4.94233,5.500343 -3.18861,2.072592 -7.81208,3.029174 -4.62348,0.956581 -10.44268,0.956581 h -6.13807 v 20.486786 h -7.73236 V 60.466727 q 3.26832,-0.797151 7.25407,-1.036297 4.06547,-0.31886 7.41351,-0.31886 z m 0.63772,6.775784 q -4.94234,0 -7.57294,0.239146 v 21.68251 h 5.81921 q 3.98575,0 7.17436,-0.478291 3.1886,-0.558006 5.34091,-1.753732 2.23202,-1.275442 3.42775,-3.42775 1.19573,-2.152308 1.19573,-5.500343 0,-3.188604 -1.27545,-5.261197 -1.19572,-2.072593 -3.34803,-3.26832 -2.07259,-1.275441 -4.86262,-1.753732 -2.79003,-0.478291 -5.89892,-0.478291 z" />
-      <path
-         id="path935"
-         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;fill:#009688;fill-opacity:1;stroke-width:1.99287772"
-         d="m 308.08066,59.669576 h 7.73236 v 55.242574 h -7.73236 z" />
+         style="font-size:79.7151px;line-height:1.25;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;letter-spacing:0px;word-spacing:0px;fill:#009688;stroke-width:1.99288"
+         d="M 89.523017,59.410606 V 4.1680399 H 122.84393 V 10.784393 H 97.255382 V 27.44485 h 22.718808 v 6.536638 H 97.255382 v 25.429118 z m 52.292963,-5.340912 q 2.6306,0 4.62348,-0.07972 2.07259,-0.15943 3.42774,-0.47829 V 41.155848 q -0.79715,-0.398576 -2.63059,-0.637721 -1.75374,-0.31886 -4.30462,-0.31886 -1.67402,0 -3.58718,0.239145 -1.83345,0.239145 -3.42775,1.036296 -1.51459,0.717436 -2.55088,2.072593 -1.0363,1.275442 -1.0363,3.427749 0,3.985755 2.55089,5.580058 2.55088,1.514586 6.93521,1.514586 z m -0.63772,-37.147238 q 4.46404,0 7.49322,1.195727 3.10889,1.116011 4.94233,3.268319 1.91317,2.072593 2.71032,5.022052 0.79715,2.869743 0.79715,6.377208 V 58.69317 q -0.95658,0.159431 -2.71031,0.478291 -1.67402,0.239145 -3.82633,0.478291 -2.15231,0.239145 -4.70319,0.398575 -2.47117,0.239146 -4.94234,0.239146 -3.50746,0 -6.45692,-0.717436 -2.94946,-0.717436 -5.10177,-2.232023 -2.1523,-1.594302 -3.34803,-4.145186 -1.19573,-2.550883 -1.19573,-6.138063 0,-3.427749 1.35516,-5.898917 1.43487,-2.471168 3.82632,-3.985755 2.39146,-1.514587 5.58006,-2.232023 3.18861,-0.717436 6.69607,-0.717436 1.11601,0 2.31174,0.15943 1.19572,0.07972 2.23202,0.31886 1.11601,0.159431 1.91316,0.318861 0.79715,0.15943 1.11601,0.239145 v -2.072593 q 0,-1.833447 -0.39857,-3.587179 -0.39858,-1.833448 -1.43487,-3.188604 -1.0363,-1.434872 -2.86975,-2.232023 -1.75373,-0.876866 -4.62347,-0.876866 -3.6669,0 -6.45693,0.558005 -2.71031,0.478291 -4.06547,1.036297 l -0.87686,-6.138063 q 1.43487,-0.637721 4.7829,-1.195727 3.34804,-0.637721 7.25408,-0.637721 z m 37.86462,37.147238 q 4.54377,0 6.69607,-1.195726 2.23203,-1.195727 2.23203,-3.826325 0,-2.710314 -2.15231,-4.304616 -2.15231,-1.594302 -7.09465,-3.587179 -2.39145,-0.956581 -4.62347,-1.913163 -2.15231,-1.036296 -3.74661,-2.391453 -1.5943,-1.355157 -2.55088,-3.268319 -0.95659,-1.913163 -0.95659,-4.703191 0,-5.500342 4.06547,-8.688946 4.06547,-3.26832 11.0804,-3.26832 1.75374,0 3.50747,0.239146 1.75373,0.15943 3.26832,0.47829 1.51458,0.239146 2.6306,0.558006 1.19572,0.31886 1.83344,0.558006 l -1.35515,6.377208 q -1.19573,-0.637721 -3.74661,-1.275442 -2.55089,-0.717436 -6.13807,-0.717436 -3.10889,0 -5.42062,1.275442 -2.31174,1.195727 -2.31174,3.826325 0,1.355157 0.47829,2.391453 0.55801,1.036296 1.5943,1.913163 1.11601,0.797151 2.71031,1.514587 1.59431,0.717436 3.82633,1.514587 2.94946,1.116011 5.2612,2.232022 2.31173,1.036297 3.90604,2.471169 1.67401,1.434871 2.55088,3.507464 0.87687,1.992878 0.87687,4.942337 0,5.739487 -4.30462,8.688946 -4.2249,2.949459 -12.1167,2.949459 -5.50034,0 -8.60923,-0.956582 -3.10889,-0.876866 -4.2249,-1.355156 l 1.35516,-6.377209 q 1.27544,0.478291 4.06547,1.434872 2.79003,0.956581 7.4135,0.956581 z m 32.84256,-36.110941 h 15.70387 v 6.217778 h -15.70387 v 19.131625 q 0,3.108889 0.47829,5.181481 0.47829,1.992878 1.43487,3.188604 0.95658,1.116012 2.39145,1.594302 1.43487,0.478291 3.34804,0.478291 3.34803,0 5.34091,-0.717436 2.07259,-0.797151 2.86974,-1.116011 l 1.43487,6.138063 q -1.11601,0.558005 -3.90604,1.355156 -2.79003,0.876867 -6.37721,0.876867 -4.2249,0 -7.01492,-1.036297 -2.71032,-1.116011 -4.38434,-3.268319 -1.67401,-2.152308 -2.39145,-5.261197 -0.63772,-3.188604 -0.63772,-7.333789 V 6.4000628 l 7.41351,-1.2754417 z m 62.49652,41.451853 q -1.35516,-3.587179 -2.55088,-7.014929 -1.19573,-3.507464 -2.47117,-7.094644 h -25.03054 l -5.02205,14.109573 h -8.05123 q 3.18861,-8.768661 5.97863,-16.182166 2.79003,-7.493219 5.42063,-14.189288 2.71031,-6.696069 5.34091,-12.754416 2.6306,-6.138063 5.50034,-12.1166961 h 7.09465 q 2.86974,5.9786331 5.50034,12.1166961 2.6306,6.058347 5.2612,12.754416 2.71031,6.696069 5.50034,14.189288 2.79003,7.413505 5.97863,16.182166 z m -7.25407,-20.486781 q -2.55089,-6.935214 -5.10177,-13.392137 -2.47117,-6.536639 -5.18148,-12.515272 -2.79003,5.978633 -5.34091,12.515272 -2.47117,6.456923 -4.94234,13.392137 z M 304.99242,3.6100342 q 11.6384,0 17.85618,4.4640458 6.29749,4.384331 6.29749,13.152992 0,4.782906 -1.75373,8.210656 -1.67402,3.348034 -4.94234,5.500342 -3.1886,2.072592 -7.81208,3.029174 -4.62347,0.956581 -10.44268,0.956581 h -6.13806 v 20.486781 h -7.73236 V 4.9651909 q 3.26832,-0.797151 7.25407,-1.0362963 4.06547,-0.3188604 7.41351,-0.3188604 z m 0.63772,6.7757838 q -4.94234,0 -7.57294,0.239145 v 21.682508 h 5.8192 q 3.98576,0 7.17436,-0.47829 3.18861,-0.558006 5.34092,-1.753733 2.23202,-1.275441 3.42774,-3.427749 1.19573,-2.152308 1.19573,-5.500342 0,-3.188604 -1.27544,-5.261197 -1.19573,-2.072593 -3.34803,-3.268319 -2.0726,-1.275442 -4.86263,-1.753732 -2.79002,-0.478291 -5.89891,-0.478291 z M 338.7916,4.1680399 h 7.73237 V 59.410606 h -7.73237 z"
+         id="text979"
+         aria-label="FastAPI" />
     </g>
   </g>
 </svg>
diff --git a/docs/en/docs/img/logo-teal.svg b/docs/en/docs/img/logo-teal.svg
index 0d1136eb4..bc699860f 100644
--- a/docs/en/docs/img/logo-teal.svg
+++ b/docs/en/docs/img/logo-teal.svg
@@ -1,15 +1,15 @@
 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
    id="svg8"
    version="1.1"
-   viewBox="0 0 346.36511 63.977134"
+   viewBox="0 0 346.52395 63.977134"
    height="63.977139mm"
-   width="346.36511mm">
+   width="346.52396mm"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:dc="http://purl.org/dc/elements/1.1/">
   <defs
      id="defs2" />
   <metadata
@@ -20,26 +20,37 @@
         <dc:format>image/svg+xml</dc:format>
         <dc:type
            rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
       </cc:Work>
     </rdf:RDF>
   </metadata>
   <g
-     transform="translate(30.552089,-55.50154)"
-     id="layer1">
-    <path
-       style="opacity:0.98000004;fill:#009688;fill-opacity:1;stroke-width:3.20526505"
-       id="path817"
-       d="m 1.4365174,55.50154 c -17.6610514,0 -31.9886064,14.327532 -31.9886064,31.988554 0,17.661036 14.327555,31.988586 31.9886064,31.988586 17.6609756,0 31.9885196,-14.32755 31.9885196,-31.988586 0,-17.661022 -14.327544,-31.988554 -31.9885196,-31.988554 z m -1.66678692,57.63069 V 93.067264 H -11.384533 L 4.6417437,61.847974 V 81.912929 H 15.379405 Z" />
-    <text
-       id="text979"
-       y="114.91215"
-       x="52.115433"
-       style="font-style:normal;font-weight:normal;font-size:79.71511078px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#009688;fill-opacity:1;stroke:none;stroke-width:1.99287772;"
-       xml:space="preserve"><tspan
-         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;fill:#009688;fill-opacity:1;stroke-width:1.99287772;"
-         y="114.91215"
-         x="52.115433"
-         id="tspan977">FastAPI</tspan></text>
+     id="g2149">
+    <g
+       id="g2141">
+      <g
+         id="g2106"
+         transform="matrix(0.96564264,0,0,0.96251987,-899.3295,194.86874)">
+        <circle
+           style="fill:#009688;fill-opacity:0.980392;stroke:none;stroke-width:0.141404;stop-color:#000000"
+           id="path875-5-9-7-3-2-3-9-9-8-0-0-5-87-7"
+           cx="964.56165"
+           cy="-169.22266"
+           r="33.234192" />
+        <path
+           id="rect1249-6-3-4-4-3-6-6-1-2"
+           style="fill:#ffffff;fill-opacity:0.980392;stroke:none;stroke-width:0.146895;stop-color:#000000"
+           d="m 962.2685,-187.40837 -6.64403,14.80375 -3.03599,6.76393 -6.64456,14.80375 30.59142,-21.56768 h -14.35312 l 20.99715,-14.80375 z" />
+      </g>
+      <text
+         id="text979"
+         y="59.410606"
+         x="82.667519"
+         style="font-style:normal;font-weight:normal;font-size:79.7151px;line-height:1.25;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#009688;fill-opacity:1;stroke:none;stroke-width:1.99288"
+         xml:space="preserve"><tspan
+           style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:Ubuntu;-inkscape-font-specification:Ubuntu;fill:#009688;fill-opacity:1;stroke-width:1.99288"
+           y="59.410606"
+           x="82.667519"
+           id="tspan977">FastAPI</tspan></text>
+    </g>
   </g>
 </svg>
diff --git a/docs/en/overrides/partials/copyright.html b/docs/en/overrides/partials/copyright.html
new file mode 100644
index 000000000..dcca89abe
--- /dev/null
+++ b/docs/en/overrides/partials/copyright.html
@@ -0,0 +1,11 @@
+<div class="md-copyright">
+    <div class="md-copyright__highlight">
+        The FastAPI trademark is owned by <a href="https://tiangolo.com" target="_blank">@tiangolo</a> and is registered in the US and across other regions
+    </div>
+    {% if not config.extra.generator == false %}
+    Made with
+    <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
+        Material for MkDocs
+    </a>
+    {% endif %}
+</div>

From 43f9cbc0fced5be44ac469e1c543620ac42df880 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 4 Feb 2024 20:57:18 +0000
Subject: [PATCH 04/70] =?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 2dcfac473..6e42281cf 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -11,6 +11,10 @@ hide:
 
 * :globe_with_meridians: Update Turkish translation for `docs/tr/docs/fastapi-people.md`. PR [#10547](https://github.com/tiangolo/fastapi/pull/10547) by [@alperiox](https://github.com/alperiox).
 
+### Internal
+
+* 🍱 Add new FastAPI logo. PR [#11090](https://github.com/tiangolo/fastapi/pull/11090) by [@tiangolo](https://github.com/tiangolo).
+
 ## 0.109.1
 
 ### Security fixes

From 4a2be2abff43260fdd49ecf72cde2425adffdfe3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sun, 4 Feb 2024 22:14:53 +0100
Subject: [PATCH 05/70] =?UTF-8?q?=E2=AC=86=EF=B8=8F=20Upgrade=20version=20?=
 =?UTF-8?q?of=20Starlette=20to=20`>=3D=200.36.3`=20(#11086)?=
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 31d9c59b3..c23e82ef4 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -41,7 +41,7 @@ classifiers = [
     "Topic :: Internet :: WWW/HTTP",
 ]
 dependencies = [
-    "starlette>=0.35.0,<0.36.0",
+    "starlette>=0.36.3,<0.37.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",
 ]

From 50e558e944860fb237cb5934e899ce3c5ecc37f9 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 4 Feb 2024 21:15:15 +0000
Subject: [PATCH 06/70] =?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 6e42281cf..490952466 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Upgrades
+
+* ⬆️ Upgrade version of Starlette to `>= 0.36.3`. PR [#11086](https://github.com/tiangolo/fastapi/pull/11086) by [@tiangolo](https://github.com/tiangolo).
+
 ### Translations
 
 * :globe_with_meridians: Update Turkish translation for `docs/tr/docs/fastapi-people.md`. PR [#10547](https://github.com/tiangolo/fastapi/pull/10547) by [@alperiox](https://github.com/alperiox).

From 57b0983948617c6ac051f9c29947bd9db6547e3b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sun, 4 Feb 2024 22:21:53 +0100
Subject: [PATCH 07/70] =?UTF-8?q?=F0=9F=94=96=20Release=20FastAPI=20versio?=
 =?UTF-8?q?n=200.109.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 490952466..71b79bccc 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
 
 ## Latest Changes
 
+## 0.109.2
+
 ### Upgrades
 
 * ⬆️ Upgrade version of Starlette to `>= 0.36.3`. PR [#11086](https://github.com/tiangolo/fastapi/pull/11086) by [@tiangolo](https://github.com/tiangolo).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index fedd8b419..3458b9e5b 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.109.1"
+__version__ = "0.109.2"
 
 from starlette import status as status
 

From 141e34f281ed746431766d712d56d357e306a689 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sun, 4 Feb 2024 22:24:21 +0100
Subject: [PATCH 08/70] =?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 71b79bccc..c0e47b9f5 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -15,7 +15,7 @@ hide:
 
 ### Translations
 
-* :globe_with_meridians: Update Turkish translation for `docs/tr/docs/fastapi-people.md`. PR [#10547](https://github.com/tiangolo/fastapi/pull/10547) by [@alperiox](https://github.com/alperiox).
+* 🌐 Update Turkish translation for `docs/tr/docs/fastapi-people.md`. PR [#10547](https://github.com/tiangolo/fastapi/pull/10547) by [@alperiox](https://github.com/alperiox).
 
 ### Internal
 

From 0880a5c6a0d2702b057cef8064690f63ff1afc78 Mon Sep 17 00:00:00 2001
From: Jacob Hayes <jacob.r.hayes@gmail.com>
Date: Tue, 6 Feb 2024 12:21:29 -0500
Subject: [PATCH 09/70] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20minor=20typo?=
 =?UTF-8?q?=20in=20`fastapi/applications.py`=20(#11099)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

diff --git a/fastapi/applications.py b/fastapi/applications.py
index 597c60a56..ffe9da358 100644
--- a/fastapi/applications.py
+++ b/fastapi/applications.py
@@ -297,7 +297,7 @@ class FastAPI(Starlette):
                 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 `/`.
+                default value would be a `dict` with a `url` value of `/`.
 
                 Each item in the `list` is a `dict` containing:
 

From d9cacacf7f786e43eb30ec430ca20ca0d9960171 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 6 Feb 2024 17:21:53 +0000
Subject: [PATCH 10/70] =?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 c0e47b9f5..1f0a9a7d2 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Docs
+
+* ✏️ Fix minor typo in `fastapi/applications.py`. PR [#11099](https://github.com/tiangolo/fastapi/pull/11099) by [@JacobHayes](https://github.com/JacobHayes).
+
 ## 0.109.2
 
 ### Upgrades

From b9766d7ee9af21daf0eaa6caac9634feff487afb Mon Sep 17 00:00:00 2001
From: Alejandra <90076947+alejsdev@users.noreply.github.com>
Date: Tue, 6 Feb 2024 14:56:23 -0500
Subject: [PATCH 11/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20Spanish=20translatio?=
 =?UTF-8?q?n=20for=20`docs/es/docs/advanced/response-change-status-code.md?=
 =?UTF-8?q?`=20(#11100)?=
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>
---
 .../advanced/response-change-status-code.md   | 33 +++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 docs/es/docs/advanced/response-change-status-code.md

diff --git a/docs/es/docs/advanced/response-change-status-code.md b/docs/es/docs/advanced/response-change-status-code.md
new file mode 100644
index 000000000..ecd9fad41
--- /dev/null
+++ b/docs/es/docs/advanced/response-change-status-code.md
@@ -0,0 +1,33 @@
+# Response - Cambiar el Status Code
+
+Probablemente ya has leído con anterioridad que puedes establecer un [Response Status Code](../tutorial/response-status-code.md){.internal-link target=_blank} por defecto.
+
+Pero en algunos casos necesitas retornar un status code diferente al predeterminado.
+
+## Casos de uso
+
+Por ejemplo, imagina que quieres retornar un HTTP status code de "OK" `200` por defecto.
+
+Pero si los datos no existen, quieres crearlos y retornar un HTTP status code de "CREATED" `201`.
+
+Pero aún quieres poder filtrar y convertir los datos que retornas con un `response_model`.
+
+Para esos casos, puedes usar un parámetro `Response`.
+
+## Usar un parámetro `Response`
+
+Puedes declarar un parámetro de tipo `Response` en tu *función de la operación de path* (como puedes hacer para cookies y headers).
+
+Y luego puedes establecer el `status_code` en ese objeto de respuesta *temporal*.
+
+```Python hl_lines="1  9  12"
+{!../../../docs_src/response_change_status_code/tutorial001.py!}
+```
+
+Y luego puedes retornar cualquier objeto que necesites, como normalmente lo harías (un `dict`, un modelo de base de datos, etc).
+
+Y si declaraste un `response_model`, aún se usará para filtrar y convertir el objeto que retornaste.
+
+**FastAPI** usará esa respuesta *temporal* para extraer el código de estado (también cookies y headers), y los pondrá en la respuesta final que contiene el valor que retornaste, filtrado por cualquier `response_model`.
+
+También puedes declarar la dependencia del parámetro `Response`, y establecer el código de estado en ellos. Pero ten en cuenta que el último en establecerse será el que gane.

From e79bd168a441b931eb6a9762966e63b40ab3575b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Tue, 6 Feb 2024 19:56:42 +0000
Subject: [PATCH 12/70] =?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 1f0a9a7d2..5ce56a3ac 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -11,6 +11,10 @@ hide:
 
 * ✏️ Fix minor typo in `fastapi/applications.py`. PR [#11099](https://github.com/tiangolo/fastapi/pull/11099) by [@JacobHayes](https://github.com/JacobHayes).
 
+### Translations
+
+* 🌐 Add Spanish translation for `docs/es/docs/advanced/response-change-status-code.md`. PR [#11100](https://github.com/tiangolo/fastapi/pull/11100) by [@alejsdev](https://github.com/alejsdev).
+
 ## 0.109.2
 
 ### Upgrades

From f48912633a586b726559eefcadea29ab30dc994e Mon Sep 17 00:00:00 2001
From: pablocm83 <pablocm83@gmail.com>
Date: Wed, 7 Feb 2024 06:39:50 -0500
Subject: [PATCH 13/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20Spanish=20translatio?=
 =?UTF-8?q?n=20for=20`docs/es/docs/benchmarks.md`=20(#10928)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Alejandra <90076947+alejsdev@users.noreply.github.com>
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
---
 docs/es/docs/benchmarks.md | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 docs/es/docs/benchmarks.md

diff --git a/docs/es/docs/benchmarks.md b/docs/es/docs/benchmarks.md
new file mode 100644
index 000000000..3e02d4e9f
--- /dev/null
+++ b/docs/es/docs/benchmarks.md
@@ -0,0 +1,33 @@
+# Benchmarks
+
+Los benchmarks independientes de TechEmpower muestran aplicaciones de **FastAPI** que se ejecutan en Uvicorn como <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">uno de los frameworks de Python más rápidos disponibles</a>, solo por debajo de Starlette y Uvicorn (utilizados internamente por FastAPI). (*)
+
+Pero al comprobar benchmarks y comparaciones debes tener en cuenta lo siguiente.
+
+## Benchmarks y velocidad
+
+Cuando revisas los benchmarks, es común ver varias herramientas de diferentes tipos comparadas como equivalentes.
+
+Específicamente, para ver Uvicorn, Starlette y FastAPI comparadas entre sí (entre muchas otras herramientas).
+
+Cuanto más sencillo sea el problema resuelto por la herramienta, mejor rendimiento obtendrá. Y la mayoría de los benchmarks no prueban las funciones adicionales proporcionadas por la herramienta.
+
+La jerarquía sería:
+
+* **Uvicorn**: como servidor ASGI
+    * **Starlette**: (usa Uvicorn) un microframework web
+         * **FastAPI**: (usa Starlette) un microframework API con varias características adicionales para construir APIs, con validación de datos, etc.
+* **Uvicorn**:
+    * Tendrá el mejor rendimiento, ya que no tiene mucho código extra aparte del propio servidor.
+    * No escribirías una aplicación directamente en Uvicorn. Eso significaría que tu código tendría que incluir más o menos, al menos, todo el código proporcionado por Starlette (o **FastAPI**). Y si hicieras eso, tu aplicación final tendría la misma sobrecarga que si hubieras usado un framework y minimizado el código de tu aplicación y los errores.
+    * Si estás comparando Uvicorn, compáralo con los servidores de aplicaciones Daphne, Hypercorn, uWSGI, etc.
+* **Starlette**:
+    * Tendrá el siguiente mejor desempeño, después de Uvicorn. De hecho, Starlette usa Uvicorn para correr. Por lo tanto, probablemente sólo pueda volverse "más lento" que Uvicorn al tener que ejecutar más código.
+    * Pero te proporciona las herramientas para crear aplicaciones web simples, con <abbr title="también conocido en español como: enrutamiento">routing</abbr> basado en <abbr title="tambien conocido en español como: rutas">paths</abbr>, etc.
+    * Si estás comparando Starlette, compáralo con Sanic, Flask, Django, etc. Frameworks web (o microframeworks).
+* **FastAPI**:
+    * De la misma manera que Starlette usa Uvicorn y no puede ser más rápido que él, **FastAPI** usa Starlette, por lo que no puede ser más rápido que él.
+    * * FastAPI ofrece más características además de las de Starlette. Funciones que casi siempre necesitas al crear una API, como validación y serialización de datos. Y al usarlo, obtienes documentación automática de forma gratuita (la documentación automática ni siquiera agrega gastos generales a las aplicaciones en ejecución, se genera al iniciar).
+    * Si no usaras FastAPI y usaras Starlette directamente (u otra herramienta, como Sanic, Flask, Responder, etc.), tendrías que implementar toda la validación y serialización de datos tu mismo. Por lo tanto, tu aplicación final seguirá teniendo la misma sobrecarga que si se hubiera creado con FastAPI. Y en muchos casos, esta validación y serialización de datos constituye la mayor cantidad de código escrito en las aplicaciones.
+    * Entonces, al usar FastAPI estás ahorrando tiempo de desarrollo, errores, líneas de código y probablemente obtendrías el mismo rendimiento (o mejor) que obtendrías si no lo usaras (ya que tendrías que implementarlo todo en tu código).
+    * Si estás comparando FastAPI, compáralo con un framework de aplicaciones web (o conjunto de herramientas) que proporciona validación, serialización y documentación de datos, como Flask-apispec, NestJS, Molten, etc. Frameworks con validación, serialización y documentación automáticas integradas.

From 2a60a055f0cf543f463c0b07d3ed53aa7c4ee74a Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 7 Feb 2024 11:40:11 +0000
Subject: [PATCH 14/70] =?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 5ce56a3ac..a37ad3e33 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Spanish translation for `docs/es/docs/benchmarks.md`. PR [#10928](https://github.com/tiangolo/fastapi/pull/10928) by [@pablocm83](https://github.com/pablocm83).
 * 🌐 Add Spanish translation for `docs/es/docs/advanced/response-change-status-code.md`. PR [#11100](https://github.com/tiangolo/fastapi/pull/11100) by [@alejsdev](https://github.com/alejsdev).
 
 ## 0.109.2

From 957e6600a77516736141900184786ed0cdaa870f Mon Sep 17 00:00:00 2001
From: Pablo <ppmoya08@gmail.com>
Date: Wed, 7 Feb 2024 08:55:38 -0300
Subject: [PATCH 15/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20Spanish=20translatio?=
 =?UTF-8?q?n=20for=20`docs/es/docs/deployment/index.md`=20and=20`~/deploym?=
 =?UTF-8?q?ent/versions.md`=20(#9669)?=
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: Alejandra <90076947+alejsdev@users.noreply.github.com>
Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
---
 docs/es/docs/deployment/index.md    | 21 +++++++
 docs/es/docs/deployment/versions.md | 87 +++++++++++++++++++++++++++++
 2 files changed, 108 insertions(+)
 create mode 100644 docs/es/docs/deployment/index.md
 create mode 100644 docs/es/docs/deployment/versions.md

diff --git a/docs/es/docs/deployment/index.md b/docs/es/docs/deployment/index.md
new file mode 100644
index 000000000..74b0e22f0
--- /dev/null
+++ b/docs/es/docs/deployment/index.md
@@ -0,0 +1,21 @@
+# Despliegue - Introducción
+
+Desplegar una aplicación hecha con **FastAPI** es relativamente fácil.
+
+## ¿Qué significa desplegar una aplicación?
+
+**Desplegar** una aplicación significa realizar una serie de pasos para hacerla **disponible para los usuarios**.
+
+Para una **API web**, normalmente implica ponerla en una **máquina remota**, con un **programa de servidor** que proporcione un buen rendimiento, estabilidad, etc, para que sus **usuarios** puedan **acceder** a la aplicación de manera eficiente y sin interrupciones o problemas.
+
+Esto difiere en las fases de **desarrollo**, donde estás constantemente cambiando el código, rompiéndolo y arreglándolo, deteniendo y reiniciando el servidor de desarrollo, etc.
+
+## Estrategias de despliegue
+
+Existen varias formas de hacerlo dependiendo de tu caso de uso específico y las herramientas que uses.
+
+Puedes **desplegar un servidor** tú mismo usando un conjunto de herramientas, puedes usar **servicios en la nube** que haga parte del trabajo por ti, o usar otras posibles opciones.
+
+Te enseñaré algunos de los conceptos principales que debes tener en cuenta al desplegar aplicaciones hechas con **FastAPI** (aunque la mayoría de estos conceptos aplican para cualquier otro tipo de aplicación web).
+
+Podrás ver más detalles para tener en cuenta y algunas de las técnicas para hacerlo en las próximas secciones.✨
diff --git a/docs/es/docs/deployment/versions.md b/docs/es/docs/deployment/versions.md
new file mode 100644
index 000000000..d8719d6bd
--- /dev/null
+++ b/docs/es/docs/deployment/versions.md
@@ -0,0 +1,87 @@
+# Acerca de las versiones de FastAPI
+
+**FastAPI** está siendo utilizado en producción en muchas aplicaciones y sistemas. La cobertura de los tests se mantiene al 100%. Sin embargo, su desarrollo sigue siendo rápido.
+
+Se agregan nuevas características frecuentemente, se corrigen errores continuamente y el código está constantemente mejorando.
+
+Por eso las versiones actuales siguen siendo `0.x.x`, esto significa que cada versión puede potencialmente tener <abbr title="cambios que rompen funcionalidades o compatibilidad">*breaking changes*</abbr>. Las versiones siguen las convenciones de <a href="https://semver.org/" class="external-link" target="_blank"><abbr title="versionado semántico">*Semantic Versioning*</abbr></a>.
+
+Puedes crear aplicaciones listas para producción con **FastAPI** ahora mismo (y probablemente lo has estado haciendo por algún tiempo), solo tienes que asegurarte de usar la versión que funciona correctamente con el resto de tu código.
+
+## Fijar la versión de `fastapi`
+
+Lo primero que debes hacer en tu proyecto es "fijar" la última versión específica de **FastAPI** que sabes que funciona bien con tu aplicación.
+
+Por ejemplo, digamos que estás usando la versión `0.45.0` en tu aplicación.
+
+Si usas el archivo `requirements.txt` puedes especificar la versión con:
+
+```txt
+fastapi==0.45.0
+```
+
+esto significa que usarás específicamente la versión `0.45.0`.
+
+También puedes fijar las versiones de esta forma:
+
+```txt
+fastapi>=0.45.0,<0.46.0
+```
+
+esto significa que usarás la versión `0.45.0` o superiores, pero menores a la versión `0.46.0`, por ejemplo, la versión `0.45.2` sería aceptada.
+
+Si usas cualquier otra herramienta para manejar tus instalaciones, como Poetry, Pipenv, u otras, todas tienen una forma que puedes usar para definir versiones específicas para tus paquetes.
+
+## Versiones disponibles
+
+Puedes ver las versiones disponibles (por ejemplo, para revisar cuál es la actual) en las [Release Notes](../release-notes.md){.internal-link target=_blank}.
+
+## Acerca de las versiones
+
+Siguiendo las convenciones de *Semantic Versioning*, cualquier versión por debajo de `1.0.0` puede potencialmente tener <abbr title="cambios que rompen funcionalidades o compatibilidad">*breaking changes*</abbr>.
+
+FastAPI también sigue la convención de que cualquier cambio hecho en una <abbr title="versiones de parche">"PATCH" version</abbr> es para solucionar errores y <abbr title="cambios que no rompan funcionalidades o compatibilidad">*non-breaking changes*</abbr>.
+
+!!! tip
+    El <abbr title="parche">"PATCH"</abbr> es el último número, por ejemplo, en `0.2.3`, la <abbr title="versiones de parche">PATCH version</abbr> es `3`.
+
+Entonces, deberías fijar la versión así:
+
+```txt
+fastapi>=0.45.0,<0.46.0
+```
+
+En versiones <abbr title="versiones menores">"MINOR"</abbr> son añadidas nuevas características y posibles <abbr title="Cambios que rompen posibles funcionalidades o compatibilidad">breaking changes</abbr>.
+
+!!! tip
+    La versión "MINOR" es el número en el medio, por ejemplo, en `0.2.3`, la <abbr title="versión menor">"MINOR" version</abbr> es `2`.
+
+## Actualizando las versiones de FastAPI
+
+Para esto es recomendable primero añadir tests a tu aplicación.
+
+Con **FastAPI** es muy fácil (gracias a Starlette), revisa la documentación [Testing](../tutorial/testing.md){.internal-link target=_blank}
+
+Luego de tener los tests, puedes actualizar la versión de **FastAPI** a una más reciente y asegurarte de que tu código funciona correctamente ejecutando los tests.
+
+Si todo funciona correctamente, o haces los cambios necesarios para que esto suceda, y todos tus tests pasan, entonces puedes fijar tu versión de `fastapi` a la más reciente.
+
+## Acerca de Starlette
+
+No deberías fijar la versión de `starlette`.
+
+Diferentes versiones de **FastAPI** pueden usar una versión específica de Starlette.
+
+Entonces, puedes dejar que **FastAPI** se asegure por sí mismo de qué versión de Starlette usar.
+
+## Acerca de Pydantic
+
+Pydantic incluye los tests para **FastAPI** dentro de sus propios tests, esto significa que las versiones de Pydantic (superiores a `1.0.0`) son compatibles con FastAPI.
+
+Puedes fijar Pydantic a cualquier versión superior a `1.0.0` e inferior a `2.0.0` que funcione para ti.
+
+Por ejemplo:
+
+```txt
+pydantic>=1.2.0,<2.0.0
+```

From 712eee66ca88035adf51a35a4a6a187f532740d9 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 7 Feb 2024 11:55:58 +0000
Subject: [PATCH 16/70] =?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 a37ad3e33..250316242 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Spanish translation for `docs/es/docs/deployment/index.md` and `~/deployment/versions.md`. PR [#9669](https://github.com/tiangolo/fastapi/pull/9669) by [@pabloperezmoya](https://github.com/pabloperezmoya).
 * 🌐 Add Spanish translation for `docs/es/docs/benchmarks.md`. PR [#10928](https://github.com/tiangolo/fastapi/pull/10928) by [@pablocm83](https://github.com/pablocm83).
 * 🌐 Add Spanish translation for `docs/es/docs/advanced/response-change-status-code.md`. PR [#11100](https://github.com/tiangolo/fastapi/pull/11100) by [@alejsdev](https://github.com/alejsdev).
 

From 1926ade7a8ead911bc48b368917c935a310a1750 Mon Sep 17 00:00:00 2001
From: "Ich bin Xaraxx! :P" <sakura-lienzo@hotmail.com>
Date: Wed, 7 Feb 2024 07:51:12 -0500
Subject: [PATCH 17/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20Spanish=20translatio?=
 =?UTF-8?q?n=20for=20`docs/es/docs/advanced/response-headers.md`=20(#2276)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Xaraxx <sara.galvan.o91@gmail.com>
Co-authored-by: Alejandra <90076947+alejsdev@users.noreply.github.com>
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/es/docs/advanced/response-headers.md | 44 +++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 docs/es/docs/advanced/response-headers.md

diff --git a/docs/es/docs/advanced/response-headers.md b/docs/es/docs/advanced/response-headers.md
new file mode 100644
index 000000000..aec88a584
--- /dev/null
+++ b/docs/es/docs/advanced/response-headers.md
@@ -0,0 +1,44 @@
+# Headers de Respuesta
+
+## Usar un parámetro `Response`
+
+Puedes declarar un parámetro de tipo `Response` en tu *función de operación de path* (de manera similar como se hace con las cookies).
+
+Y entonces, podrás configurar las cookies en ese objeto de response *temporal*.
+
+```Python hl_lines="1  7-8"
+{!../../../docs_src/response_headers/tutorial002.py!}
+```
+
+Posteriormente, puedes devolver cualquier objeto que necesites, como normalmente harías (un `dict`, un modelo de base de datos, etc).
+
+Si declaraste un `response_model`, este se continuará usando para filtrar y convertir el objeto que devolviste.
+
+**FastAPI** usará ese response *temporal* para extraer los headers (al igual que las cookies y el status code), además las pondrá en el response final que contendrá el valor retornado y filtrado por algún `response_model`.
+
+También puedes declarar el parámetro `Response` en dependencias, así como configurar los headers (y las cookies) en ellas.
+
+
+## Retornar una `Response` directamente
+
+Adicionalmente, puedes añadir headers cuando se retorne una `Response` directamente.
+
+Crea un response tal como se describe en [Retornar una respuesta directamente](response-directly.md){.internal-link target=_blank} y pasa los headers como un parámetro adicional:
+
+```Python hl_lines="10-12"
+{!../../../docs_src/response_headers/tutorial001.py!}
+```
+
+!!! note "Detalles Técnicos"
+    También podrías utilizar `from starlette.responses import Response` o `from starlette.responses import JSONResponse`.
+
+    **FastAPI** proporciona las mismas `starlette.responses` en `fastapi.responses` sólo que de una manera más conveniente para ti, el desarrollador. En otras palabras, muchas de las responses disponibles provienen directamente de Starlette.
+
+
+    Y como la `Response` puede ser usada frecuentemente para configurar headers y cookies, **FastAPI** también la provee en `fastapi.Response`.
+
+## Headers Personalizados
+
+Ten en cuenta que se pueden añadir headers propietarios personalizados <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers" class="external-link" target="_blank">usando el prefijo 'X-'</a>.
+
+Si tienes headers personalizados y deseas que un cliente pueda verlos en el navegador, es necesario que los añadas a tus configuraciones de CORS (puedes leer más en [CORS (Cross-Origin Resource Sharing)](../tutorial/cors.md){.internal-link target=_blank}), usando el parámetro `expose_headers` documentado en <a href="https://www.starlette.io/middleware/#corsmiddleware" class="external-link" target="_blank">Starlette's CORS docs</a>.

From d442afa1752dedb04c918ca2bc51a27d118e3dd9 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 7 Feb 2024 12:51:31 +0000
Subject: [PATCH 18/70] =?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 250316242..754b386d3 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Spanish translation for `docs/es/docs/advanced/response-headers.md`. PR [#2276](https://github.com/tiangolo/fastapi/pull/2276) by [@Xaraxx](https://github.com/Xaraxx).
 * 🌐 Add Spanish translation for `docs/es/docs/deployment/index.md` and `~/deployment/versions.md`. PR [#9669](https://github.com/tiangolo/fastapi/pull/9669) by [@pabloperezmoya](https://github.com/pabloperezmoya).
 * 🌐 Add Spanish translation for `docs/es/docs/benchmarks.md`. PR [#10928](https://github.com/tiangolo/fastapi/pull/10928) by [@pablocm83](https://github.com/pablocm83).
 * 🌐 Add Spanish translation for `docs/es/docs/advanced/response-change-status-code.md`. PR [#11100](https://github.com/tiangolo/fastapi/pull/11100) by [@alejsdev](https://github.com/alejsdev).

From fe4bed62ff28b9f7c55c4fb0266e80245be401bf Mon Sep 17 00:00:00 2001
From: "Ich bin Xaraxx! :P" <sakura-lienzo@hotmail.com>
Date: Wed, 7 Feb 2024 08:02:32 -0500
Subject: [PATCH 19/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20Spanish=20translatio?=
 =?UTF-8?q?n=20for=20`docs/es/docs/advanced/security/index.md`=20(#2278)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Xaraxx <sara.galvan.o91@gmail.com>
Co-authored-by: Alejandra <90076947+alejsdev@users.noreply.github.com>
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/es/docs/advanced/security/index.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)
 create mode 100644 docs/es/docs/advanced/security/index.md

diff --git a/docs/es/docs/advanced/security/index.md b/docs/es/docs/advanced/security/index.md
new file mode 100644
index 000000000..e393fde4e
--- /dev/null
+++ b/docs/es/docs/advanced/security/index.md
@@ -0,0 +1,16 @@
+# Seguridad Avanzada
+
+## Características Adicionales
+
+Hay algunas características adicionales para manejar la seguridad además de las que se tratan en el [Tutorial - Guía de Usuario: Seguridad](../../tutorial/security/){.internal-link target=_blank}.
+
+!!! tip
+    Las siguientes secciones **no necesariamente son "avanzadas"**.
+
+    Y es posible que para tu caso de uso, la solución esté en alguna de ellas.
+
+## Leer primero el Tutorial
+
+En las siguientes secciones asumimos que ya has leído el principal [Tutorial - Guía de Usuario: Seguridad](../../tutorial/security/){.internal-link target=_blank}.
+
+Están basadas en los mismos conceptos, pero permiten algunas funcionalidades adicionales.

From 2db35873ecb02a5a7c7ac56462f6c45f358d8ee5 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 7 Feb 2024 13:02:52 +0000
Subject: [PATCH 20/70] =?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 754b386d3..bfb6a6fe3 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Spanish translation for `docs/es/docs/advanced/security/index.md`. PR [#2278](https://github.com/tiangolo/fastapi/pull/2278) by [@Xaraxx](https://github.com/Xaraxx).
 * 🌐 Add Spanish translation for `docs/es/docs/advanced/response-headers.md`. PR [#2276](https://github.com/tiangolo/fastapi/pull/2276) by [@Xaraxx](https://github.com/Xaraxx).
 * 🌐 Add Spanish translation for `docs/es/docs/deployment/index.md` and `~/deployment/versions.md`. PR [#9669](https://github.com/tiangolo/fastapi/pull/9669) by [@pabloperezmoya](https://github.com/pabloperezmoya).
 * 🌐 Add Spanish translation for `docs/es/docs/benchmarks.md`. PR [#10928](https://github.com/tiangolo/fastapi/pull/10928) by [@pablocm83](https://github.com/pablocm83).

From 572a47cd1e6ea96e8b3d1c15b383bcfb1e8ee225 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Emirhan=20Soyta=C5=9F?= <emrhns61@hotmail.com>
Date: Thu, 8 Feb 2024 16:10:29 +0300
Subject: [PATCH 21/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20Turkish=20translatio?=
 =?UTF-8?q?n=20for=20`docs/tr/docs/tutorial/path-params.md`=20(#11073)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/tr/docs/tutorial/path-params.md | 254 +++++++++++++++++++++++++++
 1 file changed, 254 insertions(+)
 create mode 100644 docs/tr/docs/tutorial/path-params.md

diff --git a/docs/tr/docs/tutorial/path-params.md b/docs/tr/docs/tutorial/path-params.md
new file mode 100644
index 000000000..cfcf881fd
--- /dev/null
+++ b/docs/tr/docs/tutorial/path-params.md
@@ -0,0 +1,254 @@
+# Yol Parametreleri
+
+Yol "parametrelerini" veya "değişkenlerini" Python <abbr title="String Biçimleme: Format String">string biçimlemede</abbr> kullanılan sözdizimi ile tanımlayabilirsiniz.
+
+```Python hl_lines="6-7"
+{!../../../docs_src/path_params/tutorial001.py!}
+```
+
+Yol parametresi olan `item_id`'nin değeri, fonksiyonunuza `item_id` argümanı olarak aktarılacaktır.
+
+Eğer bu örneği çalıştırıp <a href="http://127.0.0.1:8000/items/foo" class="external-link" target="_blank">http://127.0.0.1:8000/items/foo</a> sayfasına giderseniz, şöyle bir çıktı ile karşılaşırsınız:
+
+```JSON
+{"item_id":"foo"}
+```
+
+## Tip İçeren Yol Parametreleri
+
+Standart Python tip belirteçlerini kullanarak yol parametresinin tipini fonksiyonun içerisinde tanımlayabilirsiniz.
+
+```Python hl_lines="7"
+{!../../../docs_src/path_params/tutorial002.py!}
+```
+
+Bu durumda, `item_id` bir `int` olarak tanımlanacaktır.
+
+!!! check "Ek bilgi"
+    Bu sayede, fonksiyon içerisinde hata denetimi, kod tamamlama gibi konularda editör desteğine kavuşacaksınız.
+
+## Veri <abbr title="Dönüşüm: serialization, parsing ve marshalling olarak da biliniyor">Dönüşümü</abbr>
+
+Eğer bu örneği çalıştırıp tarayıcınızda <a href="http://127.0.0.1:8000/items/3" class="external-link" target="_blank">http://127.0.0.1:8000/items/3</a> sayfasını açarsanız, şöyle bir yanıt ile karşılaşırsınız:
+
+```JSON
+{"item_id":3}
+```
+
+!!! check "Ek bilgi"
+    Dikkatinizi çekerim ki, fonksiyonunuzun aldığı (ve döndürdüğü) değer olan `3` bir string `"3"` değil aksine bir Python `int`'idir.
+
+    Bu tanımlamayla birlikte, **FastAPI** size otomatik istek <abbr title="HTTP isteği ile birlikte gelen string'i Python verisine dönüştürme">"ayrıştırma"</abbr> özelliği sağlar.
+
+## Veri Doğrulama
+
+Eğer tarayıcınızda <a href="http://127.0.0.1:8000/items/foo" class="external-link" target="_blank">http://127.0.0.1:8000/items/foo</a> sayfasını açarsanız, şuna benzer güzel bir HTTP hatası ile karşılaşırsınız:
+
+```JSON
+{
+  "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"
+    }
+  ]
+}
+```
+
+Çünkü burada `item_id` yol parametresi `int` tipinde bir değer beklerken `"foo"` yani `string` tipinde bir değer almıştı.
+
+Aynı hata <a href="http://127.0.0.1:8000/items/4.2" class="external-link" target="_blank">http://127.0.0.1:8000/items/4.2</a> sayfasında olduğu gibi `int` yerine `float` bir değer verseydik de ortaya çıkardı.
+
+!!! check "Ek bilgi"
+    Böylece, aynı Python tip tanımlaması ile birlikte, **FastAPI** veri doğrulama özelliği sağlar.
+
+    Dikkatinizi çekerim ki, karşılaştığınız hata, doğrulamanın geçersiz olduğu mutlak noktayı da açık bir şekilde belirtiyor.
+
+    Bu özellik, API'ınızla iletişime geçen kodu geliştirirken ve ayıklarken inanılmaz derecede yararlı olacaktır.
+
+## Dokümantasyon
+
+Ayrıca, tarayıcınızı <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a> adresinde açarsanız, aşağıdaki gibi otomatik ve interaktif bir API dökümantasyonu ile karşılaşırsınız:
+
+<img src="/img/tutorial/path-params/image01.png">
+
+!!! check "Ek bilgi"
+    Üstelik, sadece aynı Python tip tanımlaması ile, **FastAPI** size otomatik ve interaktif (Swagger UI ile entegre) bir dokümantasyon sağlar.
+
+    Dikkatinizi çekerim ki, yol parametresi integer olarak tanımlanmıştır.
+
+## Standartlara Dayalı Avantajlar, Alternatif Dokümantasyon
+
+Oluşturulan şema <a href="https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md" class="external-link" target="_blank">OpenAPI</a> standardına uygun olduğu için birçok uyumlu araç mevcuttur.
+
+Bu sayede, **FastAPI**'ın bizzat kendisi <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a> sayfasından erişebileceğiniz alternatif (ReDoc kullanan) bir API dokümantasyonu sağlar:
+
+<img src="/img/tutorial/path-params/image02.png">
+
+Aynı şekilde, farklı diller için kod türetme araçları da dahil olmak üzere çok sayıda uyumlu araç bulunur.
+
+## Pydantic
+
+Tüm veri doğrulamaları <a href="https://pydantic-docs.helpmanual.io/" class="external-link" target="_blank">Pydantic</a> tarafından arka planda gerçekleştirilir, bu sayede tüm avantajlardan faydalanabilirsiniz. Böylece, emin ellerde olduğunuzu hissedebilirsiniz.
+
+Aynı tip tanımlamalarını `str`, `float`, `bool` ve diğer karmaşık veri tipleri ile kullanma imkanınız vardır.
+
+Bunlardan birkaçı, bu eğitimin ileriki bölümlerinde irdelenmiştir.
+
+## Sıralama Önem Arz Eder
+
+*Yol operasyonları* tasarlarken sabit yol barındıran durumlar ile karşılaşabilirsiniz.
+
+Farz edelim ki `/users/me` yolu geçerli kullanıcı hakkında bilgi almak için kullanılıyor olsun.
+
+Benzer şekilde `/users/{user_id}` gibi tanımlanmış ve belirli bir kullanıcı hakkında veri almak için kullanıcının ID bilgisini kullanan bir yolunuz da mevcut olabilir.
+
+*Yol operasyonları* sıralı bir şekilde gözden geçirildiğinden dolayı `/users/me` yolunun `/users/{user_id}` yolundan önce tanımlanmış olmasından emin olmanız gerekmektedir:
+
+```Python hl_lines="6  11"
+{!../../../docs_src/path_params/tutorial003.py!}
+```
+
+Aksi halde, `/users/{user_id}` yolu `"me"` değerinin `user_id` parametresi için gönderildiğini "düşünerek" `/users/me` ile de eşleşir.
+
+Benzer şekilde, bir yol operasyonunu yeniden tanımlamanız mümkün değildir:
+
+```Python hl_lines="6  11"
+{!../../../docs_src/path_params/tutorial003b.py!}
+```
+
+Yol, ilk kısım ile eşleştiğinden dolayı her koşulda ilk yol operasyonu kullanılacaktır.
+
+## Ön Tanımlı Değerler
+
+Eğer *yol parametresi* alan bir *yol operasyonunuz* varsa ve alabileceği *yol parametresi* değerlerinin ön tanımlı olmasını istiyorsanız, standart Python <abbr title="Enumeration">`Enum`</abbr> tipini kullanabilirsiniz.
+
+### Bir `Enum` Sınıfı Oluşturalım
+
+`Enum` sınıfını projemize dahil edip `str` ile `Enum` sınıflarını miras alan bir alt sınıf yaratalım.
+
+`str` sınıfı miras alındığından dolayı, API dokümanı, değerlerin `string` tipinde olması gerektiğini anlayabilecek ve doğru bir şekilde işlenecektir.
+
+Sonrasında, sınıf içerisinde, mevcut ve geçerli değerler olacak olan sabit değerli özelliklerini oluşturalım:
+
+```Python hl_lines="1  6-9"
+{!../../../docs_src/path_params/tutorial005.py!}
+```
+
+!!! info "Bilgi"
+    3.4 sürümünden beri <a href="https://docs.python.org/3/library/enum.html" class="external-link" target="_blank">enumerationlar (ya da enumlar) Python'da mevcuttur</a>.
+
+!!! tip "İpucu"
+    Merak ediyorsanız söyleyeyim, "AlexNet", "ResNet" ve "LeNet" isimleri Makine Öğrenmesi <abbr title="Teknik olarak, Derin Öğrenme model mimarileri">modellerini</abbr> temsil eder.
+
+### Bir *Yol Parametresi* Tanımlayalım
+
+Sonrasında, yarattığımız enum sınıfını (`ModelName`) kullanarak tip belirteci aracılığıyla bir *yol parametresi* oluşturalım:
+
+```Python hl_lines="16"
+{!../../../docs_src/path_params/tutorial005.py!}
+```
+
+### Dokümana Göz Atalım
+
+*Yol parametresi* için mevcut değerler ön tanımlı olduğundan dolayı, interaktif döküman onları güzel bir şekilde gösterebilir:
+
+<img src="/img/tutorial/path-params/image03.png">
+
+### Python *Enumerationları* ile Çalışmak
+
+*Yol parametresinin* değeri bir *enumeration üyesi* olacaktır.
+
+#### *Enumeration Üyelerini* Karşılaştıralım
+
+Parametreyi, yarattığınız enum olan `ModelName` içerisindeki *enumeration üyesi* ile karşılaştırabilirsiniz:
+
+```Python hl_lines="17"
+{!../../../docs_src/path_params/tutorial005.py!}
+```
+
+#### *Enumeration Değerini* Edinelim
+
+`model_name.value` veya genel olarak `your_enum_member.value` tanımlarını kullanarak (bu durumda bir `str` olan) gerçek değere ulaşabilirsiniz:
+
+```Python hl_lines="20"
+{!../../../docs_src/path_params/tutorial005.py!}
+```
+
+!!! tip "İpucu"
+    `"lenet"` değerine `ModelName.lenet.value` tanımı ile de ulaşabilirsiniz.
+
+#### *Enumeration Üyelerini* Döndürelim
+
+JSON gövdesine (örneğin bir `dict`) gömülü olsalar bile *yol operasyonundaki* *enum üyelerini* döndürebilirsiniz.
+
+Bu üyeler istemciye iletilmeden önce kendilerine karşılık gelen değerlerine (bu durumda string) dönüştürüleceklerdir:
+
+```Python hl_lines="18  21  23"
+{!../../../docs_src/path_params/tutorial005.py!}
+```
+
+İstemci tarafında şuna benzer bir JSON yanıtı ile karşılaşırsınız:
+
+```JSON
+{
+  "model_name": "alexnet",
+  "message": "Deep Learning FTW!"
+}
+```
+
+## Yol İçeren Yol Parametreleri
+
+Farz edelim ki elinizde `/files/{file_path}` isminde bir *yol operasyonu* var.
+
+Fakat `file_path` değerinin `home/johndoe/myfile.txt` gibi bir *yol* barındırmasını istiyorsunuz.
+
+Sonuç olarak, oluşturmak istediğin URL `/files/home/johndoe/myfile.txt` gibi bir şey olacaktır.
+
+### OpenAPI Desteği
+
+Test etmesi ve tanımlaması zor senaryolara sebebiyet vereceğinden dolayı OpenAPI, *yol* barındıran *yol parametrelerini* tanımlayacak bir çözüm sunmuyor.
+
+Ancak bunu, Starlette kütüphanesinin dahili araçlarından birini kullanarak **FastAPI**'da gerçekleştirebilirsiniz.
+
+Parametrenin bir yol içermesi gerektiğini belirten herhangi bir doküman eklemememize rağmen dokümanlar yine de çalışacaktır.
+
+### Yol Dönüştürücü
+
+Direkt olarak Starlette kütüphanesinden gelen bir opsiyon sayesinde aşağıdaki gibi *yol* içeren bir *yol parametresi* bağlantısı tanımlayabilirsiniz:
+
+```
+/files/{file_path:path}
+```
+
+Bu durumda, parametrenin adı `file_path` olacaktır ve son kısım olan `:path` kısmı, parametrenin herhangi bir *yol* ile eşleşmesi gerektiğini belirtecektir.
+
+Böylece şunun gibi bir kullanım yapabilirsiniz:
+
+```Python hl_lines="6"
+{!../../../docs_src/path_params/tutorial004.py!}
+```
+
+!!! tip "İpucu"
+    Parametrenin başında `/home/johndoe/myfile.txt` yolunda olduğu gibi (`/`) işareti ile birlikte kullanmanız gerektiği durumlar olabilir.
+
+    Bu durumda, URL, `files` ile `home` arasında iki eğik çizgiye (`//`) sahip olup `/files//home/johndoe/myfile.txt` gibi gözükecektir.
+
+## Özet
+
+**FastAPI** ile kısa, sezgisel ve standart Python tip tanımlamaları kullanarak şunları elde edersiniz:
+
+* Editör desteği: hata denetimi, otomatik tamamlama, vb.
+* Veri "<abbr title="HTTP isteği ile birlikte gelen string'i Python verisine dönüştürme">dönüştürme</abbr>"
+* Veri doğrulama
+* API tanımlamaları ve otomatik dokümantasyon
+
+Ve sadece, bunları bir kez tanımlamanız yeterli.
+
+Diğer frameworkler ile karşılaştırıldığında (ham performans dışında), üstte anlatılan durum muhtemelen **FastAPI**'ın göze çarpan başlıca avantajıdır.

From 0c13911af894eeb2374ee8c37f8a41fdf0720cd3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Hasan=20Sezer=20Ta=C5=9Fan?=
 <13135006+hasansezertasan@users.noreply.github.com>
Date: Thu, 8 Feb 2024 16:10:55 +0300
Subject: [PATCH 22/70] =?UTF-8?q?=F0=9F=8C=90=20Update=20Turkish=20transla?=
 =?UTF-8?q?tion=20for=20`docs/tr/docs/tutorial/first-steps.md`=20(#11094)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/tr/docs/tutorial/first-steps.md | 333 ++++++++++++++++++++++++++
 docs/tr/docs/tutorial/first_steps.md | 336 ---------------------------
 2 files changed, 333 insertions(+), 336 deletions(-)
 create mode 100644 docs/tr/docs/tutorial/first-steps.md
 delete mode 100644 docs/tr/docs/tutorial/first_steps.md

diff --git a/docs/tr/docs/tutorial/first-steps.md b/docs/tr/docs/tutorial/first-steps.md
new file mode 100644
index 000000000..e66f73034
--- /dev/null
+++ b/docs/tr/docs/tutorial/first-steps.md
@@ -0,0 +1,333 @@
+# İlk Adımlar
+
+En sade FastAPI dosyası şu şekilde görünür:
+
+```Python
+{!../../../docs_src/first_steps/tutorial001.py!}
+```
+
+Yukarıdaki içeriği bir `main.py` dosyasına kopyalayalım.
+
+Uygulamayı çalıştıralım:
+
+<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 "Not"
+    `uvicorn main:app` komutunu şu şekilde açıklayabiliriz:
+
+    * `main`: dosya olan `main.py` (yani Python "modülü").
+    * `app`: ise `main.py` dosyasının içerisinde `app = FastAPI()` satırında oluşturduğumuz `FastAPI` nesnesi.
+    * `--reload`: kod değişikliklerinin ardından sunucuyu otomatik olarak yeniden başlatır. Bu parameteyi sadece geliştirme aşamasında kullanmalıyız.
+
+Çıktı olarak şöyle bir satır ile karşılaşacaksınız:
+
+```hl_lines="4"
+INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
+```
+
+Bu satır, yerel makinenizde uygulamanızın çalıştığı bağlantıyı gösterir.
+
+### Kontrol Edelim
+
+Tarayıcınızı açıp <a href="http://127.0.0.1:8000" class="external-link" target="_blank">http://127.0.0.1:8000</a> bağlantısına gidin.
+
+Şu şekilde bir JSON yanıtı ile karşılaşacağız:
+
+```JSON
+{"message": "Hello World"}
+```
+
+### Etkileşimli API Dokümantasyonu
+
+Şimdi <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a> bağlantısını açalım.
+
+<a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Swagger UI</a> tarafından sağlanan otomatik etkileşimli bir API dokümantasyonu göreceğiz:
+
+![Swagger UI](https://fastapi.tiangolo.com/img/index/index-01-swagger-ui-simple.png)
+
+### Alternatif API Dokümantasyonu
+
+Şimdi <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a> bağlantısını açalım.
+
+<a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a> tarafından sağlanan otomatik dokümantasyonu göreceğiz:
+
+![ReDoc](https://fastapi.tiangolo.com/img/index/index-02-redoc-simple.png)
+
+### OpenAPI
+
+**FastAPI**, **OpenAPI** standardını kullanarak tüm API'ınızın tamamını tanımlayan bir "şema" oluşturur.
+
+#### "Şema"
+
+"Şema", bir şeyin tanımı veya açıklamasıdır. Geliştirilen koddan ziyade soyut bir açıklamadır.
+
+#### API "Şeması"
+
+Bu durumda, <a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank">OpenAPI</a>, API şemasını nasıl tanımlayacağınızı belirten bir şartnamedir.
+
+Bu şema tanımı, API yollarınızla birlikte yollarınızın aldığı olası parametreler gibi tanımlamaları içerir.
+
+#### Veri "Şeması"
+
+"Şema" terimi, JSON içeriği gibi bazı verilerin şeklini de ifade edebilir.
+
+Bu durumda, JSON özellikleri ve sahip oldukları veri türleri gibi anlamlarına gelir.
+
+#### OpenAPI ve JSON Şema
+
+OpenAPI, API'niz için bir API şeması tanımlar. Ve bu şema, JSON veri şemaları standardı olan **JSON Şema** kullanılarak API'niz tarafından gönderilen ve alınan verilerin tanımlarını (veya "şemalarını") içerir.
+
+#### `openapi.json` Dosyasına Göz At
+
+Ham OpenAPI şemasının nasıl göründüğünü merak ediyorsanız, FastAPI otomatik olarak tüm API'ınızın tanımlamalarını içeren bir JSON (şeması) oluşturur.
+
+Bu şemayı direkt olarak <a href="http://127.0.0.1:8000/openapi.json" class="external-link" target="_blank">http://127.0.0.1:8000/openapi.json</a> bağlantısından görüntüleyebilirsiniz.
+
+Aşağıdaki gibi başlayan bir JSON ile karşılaşacaksınız:
+
+```JSON
+{
+    "openapi": "3.1.0",
+    "info": {
+        "title": "FastAPI",
+        "version": "0.1.0"
+    },
+    "paths": {
+        "/items/": {
+            "get": {
+                "responses": {
+                    "200": {
+                        "description": "Successful Response",
+                        "content": {
+                            "application/json": {
+
+
+
+...
+```
+
+#### OpenAPI Ne İşe Yarar?
+
+OpenAPI şeması, FastAPI projesinde bulunan iki etkileşimli dokümantasyon sistemine güç veren şeydir.
+
+OpenAPI'ya dayalı düzinelerce alternatif etkileşimli dokümantasyon aracı mevcuttur. **FastAPI** ile oluşturulmuş uygulamanıza bu alternatiflerden herhangi birini kolayca ekleyebilirsiniz.
+
+Ayrıca, API'ınızla iletişim kuracak önyüz, mobil veya IoT uygulamaları gibi istemciler için otomatik olarak kod oluşturabilirsiniz.
+
+## Adım Adım Özetleyelim
+
+### Adım 1: `FastAPI`yı Projemize Dahil Edelim
+
+```Python hl_lines="1"
+{!../../../docs_src/first_steps/tutorial001.py!}
+```
+
+`FastAPI`, API'niz için tüm işlevselliği sağlayan bir Python sınıfıdır.
+
+!!! note "Teknik Detaylar"
+    `FastAPI` doğrudan `Starlette`'i miras alan bir sınıftır.
+
+    <a href="https://www.starlette.io/" class="external-link" target="_blank">Starlette</a>'in tüm işlevselliğini `FastAPI` ile de kullanabilirsiniz.
+
+### Adım 2: Bir `FastAPI` "Örneği" Oluşturalım
+
+```Python hl_lines="3"
+{!../../../docs_src/first_steps/tutorial001.py!}
+```
+
+Burada `app` değişkeni `FastAPI` sınıfının bir örneği olacaktır.
+
+Bu, tüm API'yı oluşturmak için ana etkileşim noktası olacaktır.
+
+Bu `app` değişkeni, `uvicorn` komutunda atıfta bulunulan değişkenin ta kendisidir.
+
+<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>
+
+Uygulamanızı aşağıdaki gibi oluşturursanız:
+
+```Python hl_lines="3"
+{!../../../docs_src/first_steps/tutorial002.py!}
+```
+
+Ve bunu `main.py` dosyasına yerleştirirseniz eğer `uvicorn` komutunu şu şekilde çalıştırabilirsiniz:
+
+<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>
+
+### Adım 3: Bir *Yol Operasyonu* Oluşturalım
+
+#### <abbr title="Yol: Path">Yol</abbr>
+
+Burada "yol" bağlantıda bulunan ilk `/` ile başlayan ve sonrasında gelen kısmı ifade eder.
+
+Yani, şu şekilde bir bağlantıda:
+
+```
+https://example.com/items/foo
+```
+
+... yol şöyle olur:
+
+```
+/items/foo
+```
+
+!!! info "Bilgi"
+    "Yol" genellikle "<abbr title="Endpoint: Bitim Noktası">endpoint</abbr>" veya "<abbr title="Route: Yönlendirme/Yön">route</abbr>" olarak adlandırılır.
+
+Bir API oluştururken, "yol", "kaynaklar" ile "endişeleri" ayırmanın ana yöntemidir.
+
+#### Operasyonlar
+
+Burada "operasyon" HTTP "metodlarından" birini ifade eder.
+
+Bunlardan biri:
+
+* `POST`
+* `GET`
+* `PUT`
+* `DELETE`
+
+...veya daha az kullanılan diğerleri:
+
+* `OPTIONS`
+* `HEAD`
+* `PATCH`
+* `TRACE`
+
+HTTP protokolünde, bu "metodlardan" birini (veya daha fazlasını) kullanarak her bir yol ile iletişim kurabilirsiniz.
+
+---
+
+API oluştururkan, belirli bir amaca hizmet eden belirli HTTP metodlarını kullanırsınız.
+
+Normalde kullanılan:
+
+* `POST`: veri oluşturmak.
+* `GET`: veri okumak.
+* `PUT`: veriyi güncellemek.
+* `DELETE`: veriyi silmek.
+
+Bu nedenle, OpenAPI'da HTTP metodlarından her birine "operasyon" denir.
+
+Biz de onları "**operasyonlar**" olarak adlandıracağız.
+
+#### Bir *Yol Operasyonu Dekoratörü* Tanımlayalım
+
+```Python hl_lines="6"
+{!../../../docs_src/first_steps/tutorial001.py!}
+```
+
+`@app.get("/")` dekoratörü, **FastAPI**'a hemen altındaki fonksiyonun aşağıdaki durumlardan sorumlu olduğunu söyler:
+
+* <abbr title="Bir HTTP GET metodu"><code>get</code> operasyonu</abbr> ile
+* `/` yoluna gelen istekler
+
+!!! info "`@decorator` Bilgisi"
+    Python'da `@something` sözdizimi "<abbr title="Decorator">dekoratör</abbr>" olarak adlandırılır.
+
+    Dekoratörler, dekoratif bir şapka gibi (sanırım terim buradan geliyor) fonksiyonların üzerlerine yerleştirilirler.
+
+    Bir "dekoratör" hemen altında bulunan fonksiyonu alır ve o fonksiyon ile bazı işlemler gerçekleştirir.
+
+    Bizim durumumuzda, kullandığımız dekoratör, **FastAPI**'a altındaki fonksiyonun `/` yoluna gelen `get` metodlu isteklerden sorumlu olduğunu söyler.
+
+    Bu bir **yol operasyonu dekoratörüdür**.
+
+Ayrıca diğer operasyonları da kullanabilirsiniz:
+
+* `@app.post()`
+* `@app.put()`
+* `@app.delete()`
+
+Daha az kullanılanları da kullanabilirsiniz:
+
+* `@app.options()`
+* `@app.head()`
+* `@app.patch()`
+* `@app.trace()`
+
+!!! tip "İpucu"
+    Her işlemi (HTTP metod) istediğiniz gibi kullanmakta özgürsünüz.
+
+    **FastAPI** herhangi bir özel amacı veya anlamı olması konusunda ısrarcı olmaz.
+
+    Buradaki bilgiler bir gereklilik değil, bir kılavuz olarak sunulmaktadır.
+
+    Mesela GraphQL kullanırkan genelde tüm işlemleri yalnızca `POST` operasyonunu kullanarak gerçekleştirirsiniz.
+
+### Adım 4: **Yol Operasyonu Fonksiyonunu** Tanımlayın
+
+Aşağıdaki, bizim **yol operasyonu fonksiyonumuzdur**:
+
+* **yol**: `/`
+* **operasyon**: `get`
+* **fonksiyon**: "dekoratör"ün (`@app.get("/")`'in) altındaki fonksiyondur.
+
+```Python hl_lines="7"
+{!../../../docs_src/first_steps/tutorial001.py!}
+```
+
+Bu bir Python fonksiyonudur.
+
+Bu fonksiyon bir `GET` işlemi kullanılarak "`/`" bağlantısına bir istek geldiğinde **FastAPI** tarafından çağrılır.
+
+Bu durumda bu fonksiyon bir `async` fonksiyondur.
+
+---
+
+Bu fonksiyonu `async def` yerine normal bir fonksiyon olarak da tanımlayabilirsiniz.
+
+```Python hl_lines="7"
+{!../../../docs_src/first_steps/tutorial003.py!}
+```
+
+!!! note "Not"
+    Eğer farkı bilmiyorsanız, [Async: *"Aceleniz mi var?"*](../async.md#in-a-hurry){.internal-link target=_blank} sayfasını kontrol edebilirsiniz.
+
+### Adım 5: İçeriği Geri Döndürün
+
+```Python hl_lines="8"
+{!../../../docs_src/first_steps/tutorial001.py!}
+```
+
+Bir `dict`, `list` veya `str`, `int` gibi tekil değerler döndürebilirsiniz.
+
+Ayrıca, Pydantic modelleri de döndürebilirsiniz (bu konu ileriki aşamalarda irdelenecektir).
+
+Otomatik olarak JSON'a dönüştürülecek (ORM'ler vb. dahil) başka birçok nesne ve model vardır. En beğendiklerinizi kullanmayı deneyin, yüksek ihtimalle destekleniyordur.
+
+## Özet
+
+* `FastAPI`'yı projemize dahil ettik.
+* Bir `app` örneği oluşturduk.
+* Bir **yol operasyonu dekoratörü** (`@app.get("/")` gibi) yazdık.
+* Bir **yol operasyonu fonksiyonu** (`def root(): ...` gibi) yazdık.
+* Geliştirme sunucumuzu (`uvicorn main:app --reload` gibi) çalıştırdık.
diff --git a/docs/tr/docs/tutorial/first_steps.md b/docs/tr/docs/tutorial/first_steps.md
deleted file mode 100644
index b39802f5d..000000000
--- a/docs/tr/docs/tutorial/first_steps.md
+++ /dev/null
@@ -1,336 +0,0 @@
-# İlk Adımlar
-
-En basit FastAPI dosyası şu şekildedir:
-
-```Python
-{!../../../docs_src/first_steps/tutorial001.py!}
-```
-
-Bunu bir `main.py` dosyasına kopyalayın.
-
-Projeyi çalıştırın:
-
-<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
-    `uvicorn main:app` komutu şunu ifade eder:
-
-    * `main`: `main.py` dosyası (the Python "module").
-    * `app`: `main.py` dosyası içerisinde `app = FastAPI()` satırıyla oluşturulan nesne.
-    * `--reload`: Kod değişikliği sonrasında sunucunun yeniden başlatılmasını sağlar. Yalnızca geliştirme için kullanın.
-
-Çıktıda şu şekilde bir satır vardır:
-
-```hl_lines="4"
-INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
-```
-
-Bu satır, yerel makinenizde uygulamanızın sunulduğu URL'yi gösterir.
-
-### Kontrol Et
-
-Tarayıcınızda <a href="http://127.0.0.1:8000" class="external-link" target="_blank">http://127.0.0.1:8000</a> adresini açın.
-
-Bir JSON yanıtı göreceksiniz:
-
-```JSON
-{"message": "Hello World"}
-```
-
-### İnteraktif API dokümantasyonu
-
-<a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a> adresine gidin.
-
-Otomatik oluşturulmuş( <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Swagger UI</a> tarafından sağlanan) interaktif bir API dokümanı göreceksiniz:
-
-![Swagger UI](https://fastapi.tiangolo.com/img/index/index-01-swagger-ui-simple.png)
-
-### Alternatif API dokümantasyonu
-
-Şimdi, <a href="http://127.0.0.1:8000/redoc" class="external-link" target="_blank">http://127.0.0.1:8000/redoc</a> adresine gidin.
-
-Otomatik oluşturulmuş(<a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a> tarafından sağlanan) bir API dokümanı göreceksiniz:
-
-![ReDoc](https://fastapi.tiangolo.com/img/index/index-02-redoc-simple.png)
-
-### OpenAPI
-
-**FastAPI**, **OpenAPI** standardını kullanarak tüm API'lerinizi açıklayan bir "şema" oluşturur.
-
-#### "Şema"
-
-Bir "şema", bir şeyin tanımı veya açıklamasıdır. Soyut bir açıklamadır, uygulayan kod değildir.
-
-#### API "şemaları"
-
-Bu durumda, <a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank">OpenAPI</a>, API şemasını nasıl tanımlayacağınızı belirten şartnamelerdir.
-
-Bu şema tanımı, API yollarınızı, aldıkları olası parametreleri vb. içerir.
-
-#### Data "şema"
-
-"Şema" terimi, JSON içeriği gibi bazı verilerin şeklini de ifade edebilir.
-
-Bu durumda, JSON öznitelikleri ve sahip oldukları veri türleri vb. anlamına gelir.
-
-#### OpenAPI and JSON Şema
-
-OpenAPI, API'niz için bir API şeması tanımlar. Ve bu şema, JSON veri şemaları standardı olan **JSON Şema** kullanılarak API'niz tarafından gönderilen ve alınan verilerin tanımlarını (veya "şemalarını") içerir.
-
-#### `openapi.json` kontrol et
-
-OpenAPI şemasının nasıl göründüğünü merak ediyorsanız, FastAPI otomatik olarak tüm API'nizin açıklamalarını içeren bir JSON (şema) oluşturur.
-
-Doğrudan şu adreste görebilirsiniz: <a href="http://127.0.0.1:8000/openapi.json" class="external-link" target="_blank">http://127.0.0.1:8000/openapi.json</a>.
-
-Aşağıdaki gibi bir şeyle başlayan bir JSON gösterecektir:
-
-```JSON
-{
-    "openapi": "3.0.2",
-    "info": {
-        "title": "FastAPI",
-        "version": "0.1.0"
-    },
-    "paths": {
-        "/items/": {
-            "get": {
-                "responses": {
-                    "200": {
-                        "description": "Successful Response",
-                        "content": {
-                            "application/json": {
-
-
-
-...
-```
-
-#### OpenAPI ne içindir?
-
-OpenAPI şeması, dahili olarak bulunan iki etkileşimli dokümantasyon sistemine güç veren şeydir.
-
-Ve tamamen OpenAPI'ye dayalı düzinelerce alternatif vardır. **FastAPI** ile oluşturulmuş uygulamanıza bu alternatiflerden herhangi birini kolayca ekleyebilirsiniz.
-
-API'nizle iletişim kuran istemciler için otomatik olarak kod oluşturmak için de kullanabilirsiniz. Örneğin, frontend, mobil veya IoT uygulamaları.
-
-## Adım adım özet
-
-### Adım 1: `FastAPI`yi içe aktarın
-
-```Python hl_lines="1"
-{!../../../docs_src/first_steps/tutorial001.py!}
-```
-
-`FastAPI`, API'niz için tüm fonksiyonları sağlayan bir Python sınıfıdır.
-
-!!! note "Teknik Detaylar"
-    `FastAPI` doğrudan `Starlette` kalıtım alan bir sınıftır.
-
-    Tüm <a href="https://www.starlette.io/" class="external-link" target="_blank">Starlette</a> fonksiyonlarını `FastAPI` ile de kullanabilirsiniz.
-
-### Adım 2: Bir `FastAPI` örneği oluşturun
-
-```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial001.py!}
-```
-
-Burada `app` değişkeni `FastAPI` sınıfının bir örneği olacaktır.
-
-Bu tüm API'yi oluşturmak için ana etkileşim noktası olacaktır.
-
-`uvicorn` komutunda atıfta bulunulan `app` ile aynıdır.
-
-<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>
-
-Uygulamanızı aşağıdaki gibi oluşturursanız:
-
-```Python hl_lines="3"
-{!../../../docs_src/first_steps/tutorial002.py!}
-```
-
-Ve bunu `main.py` dosyasına koyduktan sonra `uvicorn` komutunu şu şekilde çağırabilirsiniz:
-
-<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>
-
-### Adım 3: *Path işlemleri* oluşturmak
-
-#### Path
-
-Burada "Path" URL'de ilk "\" ile başlayan son bölümü ifade eder.
-
-Yani, şu şekilde bir URL'de:
-
-```
-https://example.com/items/foo
-```
-
-... path şöyle olabilir:
-
-```
-/items/foo
-```
-
-!!! info
-    Genellikle bir "path", "endpoint" veya "route" olarak adlandırılabilir.
-
-Bir API oluştururken, "path", "resource" ile "concern" ayırmanın ana yoludur.
-
-#### İşlemler
-
-Burada "işlem" HTTP methodlarından birini ifade eder.
-
-Onlardan biri:
-
-* `POST`
-* `GET`
-* `PUT`
-* `DELETE`
-
-... ve daha egzotik olanları:
-
-* `OPTIONS`
-* `HEAD`
-* `PATCH`
-* `TRACE`
-
-HTTP protokolünde, bu "methodlardan" birini (veya daha fazlasını) kullanarak her path ile iletişim kurabilirsiniz.
-
----
-
-API'lerinizi oluştururkan, belirli bir işlemi gerçekleştirirken belirli HTTP methodlarını kullanırsınız.
-
-Normalde kullanılan:
-
-* `POST`: veri oluşturmak.
-* `GET`: veri okumak.
-* `PUT`: veriyi güncellemek.
-* `DELETE`: veriyi silmek.
-
-Bu nedenle, OpenAPI'de HTTP methodlarından her birine "işlem" denir.
-
-Bizde onlara "**işlemler**" diyeceğiz.
-
-#### Bir *Path işlem decoratorleri* tanımlanmak
-
-```Python hl_lines="6"
-{!../../../docs_src/first_steps/tutorial001.py!}
-```
-
-`@app.get("/")` **FastAPI'ye** aşağıdaki fonksiyonun adresine giden istekleri işlemekten sorumlu olduğunu söyler:
-
-* path `/`
-* <abbr title="an HTTP GET method"><code>get</code> işlemi</abbr> kullanılarak
-
-
-!!! info "`@decorator` Bilgisi"
-    Python `@something` şeklinde ifadeleri "decorator" olarak adlandırır.
-
-    Decoratoru bir fonksiyonun üzerine koyarsınız. Dekoratif bir şapka gibi (Sanırım terim buradan gelmektedir).
-
-    Bir "decorator" fonksiyonu alır ve bazı işlemler gerçekleştir.
-
-    Bizim durumumzda decarator **FastAPI'ye** fonksiyonun bir `get` işlemi ile `/` pathine geldiğini söyler.
-
-    Bu **path işlem decoratordür**
-
-Ayrıca diğer işlemleri de kullanabilirsiniz:
-
-* `@app.post()`
-* `@app.put()`
-* `@app.delete()`
-
-Ve daha egzotik olanları:
-
-* `@app.options()`
-* `@app.head()`
-* `@app.patch()`
-* `@app.trace()`
-
-!!! tip
-    Her işlemi (HTTP method) istediğiniz gibi kullanmakta özgürsünüz.
-
-    **FastAPI** herhangi bir özel anlamı zorlamaz.
-
-    Buradaki bilgiler bir gereklilik değil, bir kılavuz olarak sunulmaktadır.
-
-    Örneğin, GraphQL kullanırkan normalde tüm işlemleri yalnızca `POST` işlemini kullanarak gerçekleştirirsiniz.
-
-### Adım 4: **path işlem fonksiyonunu** tanımlayın
-
-Aşağıdakiler bizim **path işlem fonksiyonlarımızdır**:
-
-* **path**: `/`
-* **işlem**: `get`
-* **function**: "decorator"ün altındaki fonksiyondur (`@app.get("/")` altında).
-
-```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial001.py!}
-```
-
-Bu bir Python fonksiyonudur.
-
-Bir `GET` işlemi kullanarak "`/`" URL'sine bir istek geldiğinde **FastAPI** tarafından çağrılır.
-
-Bu durumda bir `async` fonksiyonudur.
-
----
-
-Bunu `async def` yerine normal bir fonksiyon olarakta tanımlayabilirsiniz.
-
-```Python hl_lines="7"
-{!../../../docs_src/first_steps/tutorial003.py!}
-```
-
-!!! note
-
-    Eğer farkı bilmiyorsanız, [Async: *"Acelesi var?"*](../async.md#in-a-hurry){.internal-link target=_blank} kontrol edebilirsiniz.
-
-### Adım 5: İçeriği geri döndürün
-
-
-```Python hl_lines="8"
-{!../../../docs_src/first_steps/tutorial001.py!}
-```
-
-Bir `dict`, `list` döndürebilir veya `str`, `int` gibi tekil değerler döndürebilirsiniz.
-
-Ayrıca, Pydantic modellerini de döndürebilirsiniz. (Bununla ilgili daha sonra ayrıntılı bilgi göreceksiniz.)
-
-Otomatik olarak JSON'a dönüştürülecek(ORM'ler vb. dahil) başka birçok nesne ve model vardır. En beğendiklerinizi kullanmayı deneyin, yüksek ihtimalle destekleniyordur.
-
-## Özet
-
-* `FastAPI`'yi içe aktarın.
-* Bir `app` örneği oluşturun.
-* **path işlem decorator** yazın. (`@app.get("/")` gibi)
-* **path işlem fonksiyonu** yazın. (`def root(): ...` gibi)
-* Development sunucunuzu çalıştırın. (`uvicorn main:app --reload` gibi)

From 1f6a33ce729c1b7040c276cb1ff37a0effed3bb1 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Thu, 8 Feb 2024 13:11:17 +0000
Subject: [PATCH 23/70] =?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 bfb6a6fe3..e8e9166aa 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
 
 ### Translations
 
+* 🌐 Update Turkish translation for `docs/tr/docs/tutorial/first-steps.md`. PR [#11094](https://github.com/tiangolo/fastapi/pull/11094) by [@hasansezertasan](https://github.com/hasansezertasan).
 * 🌐 Add Spanish translation for `docs/es/docs/advanced/security/index.md`. PR [#2278](https://github.com/tiangolo/fastapi/pull/2278) by [@Xaraxx](https://github.com/Xaraxx).
 * 🌐 Add Spanish translation for `docs/es/docs/advanced/response-headers.md`. PR [#2276](https://github.com/tiangolo/fastapi/pull/2276) by [@Xaraxx](https://github.com/Xaraxx).
 * 🌐 Add Spanish translation for `docs/es/docs/deployment/index.md` and `~/deployment/versions.md`. PR [#9669](https://github.com/tiangolo/fastapi/pull/9669) by [@pabloperezmoya](https://github.com/pabloperezmoya).

From 378623294e936132edbe2c36be174feaf585ac24 Mon Sep 17 00:00:00 2001
From: Kani Kim <kkh5428@gmail.com>
Date: Fri, 9 Feb 2024 19:33:00 +0900
Subject: [PATCH 24/70] =?UTF-8?q?=F0=9F=8C=90=20Update=20Korean=20translat?=
 =?UTF-8?q?ion=20for=20`/docs/ko/docs/deployment/docker.md`=20(#11113)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/ko/docs/deployment/docker.md | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/docs/ko/docs/deployment/docker.md b/docs/ko/docs/deployment/docker.md
index 587b445fc..1c7bced2c 100644
--- a/docs/ko/docs/deployment/docker.md
+++ b/docs/ko/docs/deployment/docker.md
@@ -4,7 +4,7 @@ FastAPI 어플리케이션을 배포할 때 일반적인 접근 방법은 **리
 
 리눅스 컨테이너를 사용하는 데에는 **보안**, **반복 가능성**, **단순함** 등의 장점이 있습니다.
 
-!!! 팁
+!!! tip "팁"
     시간에 쫓기고 있고 이미 이런것들을 알고 있다면 [`Dockerfile`👇](#build-a-docker-image-for-fastapi)로 점프할 수 있습니다.
 
 <details>
@@ -130,7 +130,7 @@ Successfully installed fastapi pydantic uvicorn
 
 </div>
 
-!!! 정보
+!!! info "정보"
     패키지 종속성을 정의하고 설치하기 위한 방법과 도구는 다양합니다.
 
     나중에 아래 세션에서 Poetry를 사용한 예시를 보이겠습니다. 👇
@@ -222,7 +222,7 @@ CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
 
     프로그램이 `/code`에서 시작하고 그 속에 `./app` 디렉터리가 여러분의 코드와 함께 들어있기 때문에, **Uvicorn**은 이를 보고 `app`을 `app.main`으로부터 **불러 올** 것입니다.
 
-!!! 팁
+!!! tip "팁"
     각 코드 라인을 코드의 숫자 버블을 클릭하여 리뷰할 수 있습니다. 👆
 
 이제 여러분은 다음과 같은 디렉터리 구조를 가지고 있을 것입니다:
@@ -293,7 +293,7 @@ $ docker build -t myimage .
 
 </div>
 
-!!! 팁
+!!! tip "팁"
     맨 끝에 있는 `.` 에 주목합시다. 이는 `./`와 동등하며, 도커에게 컨테이너 이미지를 빌드하기 위한 디렉터리를 알려줍니다.
 
     이 경우에는 현재 디렉터리(`.`)와 같습니다.
@@ -394,7 +394,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 
 **HTTPS**와 **인증서**의 **자동** 취득을 다루는 것은 다른 컨테이너가 될 수 있는데, 예를 들어 <a href="https://traefik.io/" class="external-link" target="_blank">Traefik</a>을 사용하는 것입니다.
 
-!!! 팁
+!!! tip "팁"
     Traefik은 도커, 쿠버네티스, 그리고 다른 도구와 통합되어 있어 여러분의 컨테이너를 포함하는 HTTPS를 셋업하고 설정하는 것이 매우 쉽습니다.
 
 대안적으로, HTTPS는 클라우드 제공자에 의해 서비스의 일환으로 다루어질 수도 있습니다 (이때도 어플리케이션은 여전히 컨테이너에서 실행될 것입니다).
@@ -423,7 +423,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 
 이 요소가 요청들의 **로드**를 읽어들이고 각 워커에게 (바라건대) **균형적으로** 분배한다면, 이 요소는 일반적으로 **로드 밸런서**라고 불립니다.
 
-!!! 팁
+!!! tip "팁"
     HTTPS를 위해 사용된 **TLS 종료 프록시** 요소 또한 **로드 밸런서**가 될 수 있습니다.
 
 또한 컨테이너로 작업할 때, 컨테이너를 시작하고 관리하기 위해 사용한 것과 동일한 시스템은 이미 해당 **로드 밸런서**로 부터 여러분의 앱에 해당하는 컨테이너로 **네트워크 통신**(예를 들어, HTTP 요청)을 전송하는 내부적인 도구를 가지고 있을 것입니다 (여기서도 로드 밸런서는 **TLS 종료 프록시**일 수 있습니다).
@@ -503,7 +503,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 
 만약 여러분이 **여러개의 컨테이너**를 가지고 있다면, 아마도 각각의 컨테이너는 **하나의 프로세스**를 가지고 있을 것입니다(예를 들어, **쿠버네티스** 클러스터에서). 그러면 여러분은 복제된 워커 컨테이너를 실행하기 **이전에**, 하나의 컨테이너에 있는 **이전의 단계들을** 수행하는 단일 프로세스를 가지는 **별도의 컨테이너들**을 가지고 싶을 것입니다.
 
-!!! 정보
+!!! info "정보"
     만약 여러분이 쿠버네티스를 사용하고 있다면, 아마도 이는 <a href="https://kubernetes.io/docs/concepts/workloads/pods/init-containers/" class="external-link" target="_blank">Init Container</a>일 것입니다.
 
 만약 여러분의 이용 사례에서 이전 단계들을 **병렬적으로 여러번** 수행하는데에 문제가 없다면 (예를 들어 데이터베이스 이전을 실행하지 않고 데이터베이스가 준비되었는지 확인만 하는 경우), 메인 프로세스를 시작하기 전에 이 단계들을 각 컨테이너에 넣을 수 있습니다.
@@ -520,7 +520,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 
 * <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
 
-!!! 경고
+!!! warning "경고"
     여러분이 이 베이스 이미지 또는 다른 유사한 이미지를 필요로 하지 **않을** 높은 가능성이 있으며, [위에서 설명된 것처럼: FastAPI를 위한 도커 이미지 빌드하기](#build-a-docker-image-for-fastapi) 처음부터 이미지를 빌드하는 것이 더 나을 수 있습니다.
 
 이 이미지는 가능한 CPU 코어에 기반한 **몇개의 워커 프로세스**를 설정하는 **자동-튜닝** 메커니즘을 포함하고 있습니다.
@@ -529,7 +529,7 @@ CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80"]
 
 또한 스크립트를 통해 <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker#pre_start_path" class="external-link" target="_blank">**시작하기 전 사전 단계**</a>를 실행하는 것을 지원합니다.
 
-!!! 팁
+!!! tip "팁"
     모든 설정과 옵션을 보려면, 도커 이미지 페이지로 이동합니다: <a href="https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker" class="external-link" target="_blank">tiangolo/uvicorn-gunicorn-fastapi</a>.
 
 ### 공식 도커 이미지에 있는 프로세스 개수
@@ -657,7 +657,7 @@ CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
 
 11. `uvicorn` 커맨드를 실행하여, `app.main`에서 불러온 `app` 객체를 사용하도록 합니다.
 
-!!! 팁
+!!! tip "팁"
     버블 숫자를 클릭해 각 줄이 하는 일을 알아볼 수 있습니다.
 
 **도커 스테이지**란 `Dockefile`의 일부로서 나중에 사용하기 위한 파일들을 생성하기 위한 **일시적인 컨테이너 이미지**로 작동합니다.

From d2f69cf311bc2a628b3c4283b95e66828c8f9518 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 9 Feb 2024 10:33:22 +0000
Subject: [PATCH 25/70] =?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 e8e9166aa..246b0d0c0 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
 
 ### Translations
 
+* 🌐 Update Korean translation for `/docs/ko/docs/deployment/docker.md`. PR [#11113](https://github.com/tiangolo/fastapi/pull/11113) by [@KaniKim](https://github.com/KaniKim).
 * 🌐 Update Turkish translation for `docs/tr/docs/tutorial/first-steps.md`. PR [#11094](https://github.com/tiangolo/fastapi/pull/11094) by [@hasansezertasan](https://github.com/hasansezertasan).
 * 🌐 Add Spanish translation for `docs/es/docs/advanced/security/index.md`. PR [#2278](https://github.com/tiangolo/fastapi/pull/2278) by [@Xaraxx](https://github.com/Xaraxx).
 * 🌐 Add Spanish translation for `docs/es/docs/advanced/response-headers.md`. PR [#2276](https://github.com/tiangolo/fastapi/pull/2276) by [@Xaraxx](https://github.com/Xaraxx).

From b7e15512861612214f01a196c162d107d6d9515e Mon Sep 17 00:00:00 2001
From: Kani Kim <kkh5428@gmail.com>
Date: Fri, 9 Feb 2024 19:34:13 +0900
Subject: [PATCH 26/70] =?UTF-8?q?=F0=9F=8C=90=20Update=20Korean=20translat?=
 =?UTF-8?q?ion=20for=20`/docs/ko/docs/dependencies/index.md`=20(#11114)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/ko/docs/tutorial/dependencies/index.md | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/docs/ko/docs/tutorial/dependencies/index.md b/docs/ko/docs/tutorial/dependencies/index.md
index d5d113860..cde88eb6c 100644
--- a/docs/ko/docs/tutorial/dependencies/index.md
+++ b/docs/ko/docs/tutorial/dependencies/index.md
@@ -51,7 +51,7 @@
 
 === "Python 3.10+ Annotated가 없는 경우"
 
-    !!! 팁
+    !!! tip "팁"
         가능하다면 `Annotated`가 달린 버전을 권장합니다.
 
     ```Python hl_lines="6-7"
@@ -60,7 +60,7 @@
 
 === "Python 3.8+ Annotated가 없는 경우"
 
-    !!! 팁
+    !!! tip "팁"
         가능하다면 `Annotated`가 달린 버전을 권장합니다.
 
     ```Python hl_lines="8-11"
@@ -114,7 +114,7 @@
 
 === "Python 3.10+ Annotated가 없는 경우"
 
-    !!! 팁
+    !!! tip "팁"
         가능하다면 `Annotated`가 달린 버전을 권장합니다.
 
     ```Python hl_lines="1"
@@ -123,7 +123,7 @@
 
 === "Python 3.8+ Annotated가 없는 경우"
 
-    !!! 팁
+    !!! tip "팁"
         가능하다면 `Annotated`가 달린 버전을 권장합니다.
 
     ```Python hl_lines="3"
@@ -154,7 +154,7 @@
 
 === "Python 3.10+ Annotated가 없는 경우"
 
-    !!! 팁
+    !!! tip "팁"
         가능하다면 `Annotated`가 달린 버전을 권장합니다.
 
     ```Python hl_lines="11  16"
@@ -163,7 +163,7 @@
 
 === "Python 3.8+ Annotated가 없는 경우"
 
-    !!! 팁
+    !!! tip "팁"
         가능하다면 `Annotated`가 달린 버전을 권장합니다.
 
     ```Python hl_lines="15  20"
@@ -180,7 +180,7 @@
 
 그리고 그 함수는 *경로 작동 함수*가 작동하는 것과 같은 방식으로 매개변수를 받습니다.
 
-!!! 팁
+!!! tip "팁"
     여러분은 다음 장에서 함수를 제외하고서, "다른 것들"이 어떻게 의존성으로 사용되는지 알게 될 것입니다.
 
 새로운 요청이 도착할 때마다, **FastAPI**는 다음을 처리합니다:
@@ -202,7 +202,7 @@ common_parameters --> read_users
 
 이렇게 하면 공용 코드를 한번만 적어도 되며, **FastAPI**는 *경로 작동*을 위해 이에 대한 호출을 처리합니다.
 
-!!! 확인
+!!! check "확인"
     특별한 클래스를 만들지 않아도 되며, 이러한 것 혹은 비슷한 종류를 **FastAPI**에 "등록"하기 위해 어떤 곳에 넘겨주지 않아도 됩니다.
 
     단순히 `Depends`에 넘겨주기만 하면 되며, **FastAPI**는 나머지를 어찌할지 알고 있습니다.
@@ -237,7 +237,7 @@ commons: Annotated[dict, Depends(common_parameters)]
     {!> ../../../docs_src/dependencies/tutorial001_02_an.py!}
     ```
 
-!!! 팁
+!!! tip "팁"
     이는 그저 표준 파이썬이고 "type alias"라고 부르며 사실 **FastAPI**에 국한되는 것은 아닙니다.
 
     하지만, `Annotated`를 포함하여, **FastAPI**가 파이썬 표준을 기반으로 하고 있기에, 이를 여러분의 코드 트릭으로 사용할 수 있습니다. 😎
@@ -256,7 +256,7 @@ commons: Annotated[dict, Depends(common_parameters)]
 
 아무 문제 없습니다. **FastAPI**는 무엇을 할지 알고 있습니다.
 
-!!! 참고
+!!! note "참고"
     잘 모르시겠다면, [Async: *"In a hurry?"*](../../async.md){.internal-link target=_blank} 문서에서 `async`와 `await`에 대해 확인할 수 있습니다.
 
 ## OpenAPI와 통합

From d048b485cdfa718c5ce0ef9257291ff71af2e6c9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B9=80=EB=AA=85=EA=B8=B0?= <riroan@naver.com>
Date: Fri, 9 Feb 2024 19:34:57 +0900
Subject: [PATCH 27/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translation?=
 =?UTF-8?q?=20for=20`/docs/ko/docs/tutorial/cookie-params.md`=20(#11118)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

diff --git a/docs/ko/docs/tutorial/cookie-params.md b/docs/ko/docs/tutorial/cookie-params.md
new file mode 100644
index 000000000..d4f3d57a3
--- /dev/null
+++ b/docs/ko/docs/tutorial/cookie-params.md
@@ -0,0 +1,97 @@
+# 쿠키 매개변수
+
+쿠키 매개변수를 `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.8+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ Annotated가 없는 경우"
+
+    !!! tip "팁"
+        가능하다면 `Annotated`가 달린 버전을 권장합니다.
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ Annotated가 없는 경우"
+
+    !!! tip "팁"
+        가능하다면 `Annotated`가 달린 버전을 권장합니다.
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001.py!}
+    ```
+
+## `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.8+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ Annotated가 없는 경우"
+
+    !!! tip "팁"
+        가능하다면 `Annotated`가 달린 버전을 권장합니다.
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ Annotated가 없는 경우"
+
+    !!! tip "팁"
+        가능하다면 `Annotated`가 달린 버전을 권장합니다.
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/cookie_params/tutorial001.py!}
+    ```
+
+!!! note "기술 세부사항"
+    `Cookie`는 `Path` 및 `Query`의 "자매"클래스입니다. 이 역시 동일한 공통 `Param` 클래스를 상속합니다.
+
+    `Query`, `Path`, `Cookie` 그리고 다른 것들은 `fastapi`에서 임포트 할 때, 실제로는 특별한 클래스를 반환하는 함수임을 기억하세요.
+
+!!! info "정보"
+    쿠키를 선언하기 위해서는 `Cookie`를 사용해야 합니다. 그렇지 않으면 해당 매개변수를 쿼리 매개변수로 해석하기 때문입니다.
+
+## 요약
+
+`Cookie`는 `Query`, `Path`와 동일한 패턴을 사용하여 선언합니다.

From 75e3aac8d3bd2bc080bf43bd85b85530e3aded1c Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 9 Feb 2024 10:35:36 +0000
Subject: [PATCH 28/70] =?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 246b0d0c0..17c13fbec 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
 
 ### Translations
 
+* 🌐 Update Korean translation for `/docs/ko/docs/dependencies/index.md`. PR [#11114](https://github.com/tiangolo/fastapi/pull/11114) by [@KaniKim](https://github.com/KaniKim).
 * 🌐 Update Korean translation for `/docs/ko/docs/deployment/docker.md`. PR [#11113](https://github.com/tiangolo/fastapi/pull/11113) by [@KaniKim](https://github.com/KaniKim).
 * 🌐 Update Turkish translation for `docs/tr/docs/tutorial/first-steps.md`. PR [#11094](https://github.com/tiangolo/fastapi/pull/11094) by [@hasansezertasan](https://github.com/hasansezertasan).
 * 🌐 Add Spanish translation for `docs/es/docs/advanced/security/index.md`. PR [#2278](https://github.com/tiangolo/fastapi/pull/2278) by [@Xaraxx](https://github.com/Xaraxx).

From a5edc3f85b4a85a9fdd8f9f6fe7991abd5350656 Mon Sep 17 00:00:00 2001
From: Kani Kim <kkh5428@gmail.com>
Date: Fri, 9 Feb 2024 19:36:26 +0900
Subject: [PATCH 29/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translation?=
 =?UTF-8?q?=20for=20`/docs/ko/docs/tutorial/body-fields.md`=20(#11112)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/ko/docs/tutorial/body-fields.md | 116 +++++++++++++++++++++++++++
 1 file changed, 116 insertions(+)
 create mode 100644 docs/ko/docs/tutorial/body-fields.md

diff --git a/docs/ko/docs/tutorial/body-fields.md b/docs/ko/docs/tutorial/body-fields.md
new file mode 100644
index 000000000..a739756bd
--- /dev/null
+++ b/docs/ko/docs/tutorial/body-fields.md
@@ -0,0 +1,116 @@
+# 본문 - 필드
+
+`Query`, `Path`와 `Body`를 사용해 *경로 동작 함수* 매개변수 내에서 추가적인 검증이나 메타데이터를 선언한 것처럼 Pydantic의 `Field`를 사용하여 모델 내에서 검증과 메타데이터를 선언할 수 있습니다.
+
+## `Field` 임포트
+
+먼저 이를 임포트해야 합니다:
+
+=== "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.8+"
+
+    ```Python hl_lines="4"
+    {!> ../../../docs_src/body_fields/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ Annotated가 없는 경우"
+
+    !!! 팁
+        가능하다면 `Annotated`가 달린 버전을 권장합니다.
+
+    ```Python hl_lines="2"
+    {!> ../../../docs_src/body_fields/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ Annotated가 없는 경우"
+
+    !!! tip "팁"
+        가능하다면 `Annotated`가 달린 버전을 권장합니다.
+
+    ```Python hl_lines="4"
+    {!> ../../../docs_src/body_fields/tutorial001.py!}
+    ```
+
+!!! warning "경고"
+    `Field`는 다른 것들처럼 (`Query`, `Path`, `Body` 등) `fastapi`에서가 아닌 `pydantic`에서 바로 임포트 되는 점에 주의하세요.
+
+## 모델 어트리뷰트 선언
+
+그 다음 모델 어트리뷰트와 함께 `Field`를 사용할 수 있습니다:
+
+=== "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.8+"
+
+    ```Python hl_lines="12-15"
+    {!> ../../../docs_src/body_fields/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ Annotated가 없는 경우"
+
+    !!! tip "팁"
+        가능하다면 `Annotated`가 달린 버전을 권장합니다.
+
+    ```Python hl_lines="9-12"
+    {!> ../../../docs_src/body_fields/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ Annotated가 없는 경우"
+
+    !!! tip "팁"
+        가능하다면 `Annotated`가 달린 버전을 권장합니다.
+
+    ```Python hl_lines="11-14"
+    {!> ../../../docs_src/body_fields/tutorial001.py!}
+    ```
+
+`Field`는 `Query`, `Path`와 `Body`와 같은 방식으로 동작하며, 모두 같은 매개변수들 등을 가집니다.
+
+!!! note "기술적 세부사항"
+    실제로 `Query`, `Path`등, 여러분이 앞으로 볼 다른 것들은 공통 클래스인 `Param` 클래스의 서브클래스 객체를 만드는데, 그 자체로 Pydantic의 `FieldInfo` 클래스의 서브클래스입니다.
+
+    그리고 Pydantic의 `Field` 또한 `FieldInfo`의 인스턴스를 반환합니다.
+
+    `Body` 또한 `FieldInfo`의 서브클래스 객체를 직접적으로 반환합니다. 그리고 `Body` 클래스의 서브클래스인 것들도 여러분이 나중에 보게될 것입니다.
+
+     `Query`, `Path`와 그 외 것들을 `fastapi`에서 임포트할 때, 이는 실제로 특별한 클래스를 반환하는 함수인 것을 기억해 주세요.
+
+!!! tip "팁"
+    주목할 점은 타입, 기본 값 및 `Field`로 이루어진 각 모델 어트리뷰트가  `Path`, `Query`와 `Body`대신 `Field`를 사용하는 *경로 작동 함수*의 매개변수와 같은 구조를 가진다는 점 입니다.
+
+## 별도 정보 추가
+
+`Field`, `Query`, `Body`, 그 외 안에 별도 정보를 선언할 수 있습니다. 이는 생성된 JSON 스키마에 포함됩니다.
+
+여러분이 예제를 선언할 때 나중에 이 공식 문서에서 별도 정보를 추가하는 방법을 배울 것입니다.
+
+!!! warning "경고"
+    별도 키가 전달된 `Field` 또한 여러분의 어플리케이션의 OpenAPI 스키마에 나타날 것입니다.
+    이런 키가 OpenAPI 명세서, [the OpenAPI validator](https://validator.swagger.io/)같은 몇몇 OpenAPI 도구들에 포함되지 못할 수 있으며, 여러분이 생성한 스키마와 호환되지 않을 수 있습니다.
+
+## 요약
+
+모델 어트리뷰트를 위한 추가 검증과 메타데이터 선언하기 위해 Pydantic의 `Field` 를 사용할 수 있습니다.
+
+또한 추가적인 JSON 스키마 메타데이터를 전달하기 위한 별도의 키워드 인자를 사용할 수 있습니다.

From 564d5591ad3f56094e9b74ff8620f7af240c88f4 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 9 Feb 2024 10:36:41 +0000
Subject: [PATCH 30/70] =?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 17c13fbec..eaca64f11 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Korean translation for `/docs/ko/docs/tutorial/cookie-params.md`. PR [#11118](https://github.com/tiangolo/fastapi/pull/11118) by [@riroan](https://github.com/riroan).
 * 🌐 Update Korean translation for `/docs/ko/docs/dependencies/index.md`. PR [#11114](https://github.com/tiangolo/fastapi/pull/11114) by [@KaniKim](https://github.com/KaniKim).
 * 🌐 Update Korean translation for `/docs/ko/docs/deployment/docker.md`. PR [#11113](https://github.com/tiangolo/fastapi/pull/11113) by [@KaniKim](https://github.com/KaniKim).
 * 🌐 Update Turkish translation for `docs/tr/docs/tutorial/first-steps.md`. PR [#11094](https://github.com/tiangolo/fastapi/pull/11094) by [@hasansezertasan](https://github.com/hasansezertasan).

From 76e14214bd5c11974d88a4bcb43388750863e5d9 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 9 Feb 2024 10:39:15 +0000
Subject: [PATCH 31/70] =?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 eaca64f11..0e66f5ca4 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Korean translation for `/docs/ko/docs/tutorial/body-fields.md`. PR [#11112](https://github.com/tiangolo/fastapi/pull/11112) by [@KaniKim](https://github.com/KaniKim).
 * 🌐 Add Korean translation for `/docs/ko/docs/tutorial/cookie-params.md`. PR [#11118](https://github.com/tiangolo/fastapi/pull/11118) by [@riroan](https://github.com/riroan).
 * 🌐 Update Korean translation for `/docs/ko/docs/dependencies/index.md`. PR [#11114](https://github.com/tiangolo/fastapi/pull/11114) by [@KaniKim](https://github.com/KaniKim).
 * 🌐 Update Korean translation for `/docs/ko/docs/deployment/docker.md`. PR [#11113](https://github.com/tiangolo/fastapi/pull/11113) by [@KaniKim](https://github.com/KaniKim).

From 383870a2751b82bec24eff46afd13eee655a5202 Mon Sep 17 00:00:00 2001
From: Kani Kim <kkh5428@gmail.com>
Date: Fri, 9 Feb 2024 21:35:46 +0900
Subject: [PATCH 32/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translation?=
 =?UTF-8?q?=20for=20`/docs/ko/docs/tutorial/schema-extra-example.md`=20(#1?=
 =?UTF-8?q?1121)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/ko/docs/tutorial/schema-extra-example.md | 326 ++++++++++++++++++
 1 file changed, 326 insertions(+)
 create mode 100644 docs/ko/docs/tutorial/schema-extra-example.md

diff --git a/docs/ko/docs/tutorial/schema-extra-example.md b/docs/ko/docs/tutorial/schema-extra-example.md
new file mode 100644
index 000000000..4e319e075
--- /dev/null
+++ b/docs/ko/docs/tutorial/schema-extra-example.md
@@ -0,0 +1,326 @@
+# 요청 예제 데이터 선언
+
+여러분의 앱이 받을 수 있는 데이터 예제를 선언할 수 있습니다.
+
+여기 이를 위한 몇가지 방식이 있습니다.
+
+## Pydantic 모델 속 추가 JSON 스키마 데이터
+
+생성된 JSON 스키마에 추가될 Pydantic 모델을 위한 `examples`을 선언할 수 있습니다.
+
+=== "Python 3.10+ Pydantic v2"
+
+    ```Python hl_lines="13-24"
+    {!> ../../../docs_src/schema_extra_example/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.10+ Pydantic v1"
+
+    ```Python hl_lines="13-23"
+    {!> ../../../docs_src/schema_extra_example/tutorial001_py310_pv1.py!}
+    ```
+
+=== "Python 3.8+ Pydantic v2"
+
+    ```Python hl_lines="15-26"
+    {!> ../../../docs_src/schema_extra_example/tutorial001.py!}
+    ```
+
+=== "Python 3.8+ Pydantic v1"
+
+    ```Python hl_lines="15-25"
+    {!> ../../../docs_src/schema_extra_example/tutorial001_pv1.py!}
+    ```
+
+추가 정보는 있는 그대로 해당 모델의 **JSON 스키마** 결과에 추가되고, API 문서에서 사용합니다.
+
+=== "Pydantic v2"
+
+    Pydantic 버전 2에서 <a href="https://docs.pydantic.dev/latest/usage/model_config/" class="external-link" target="_blank">Pydantic 공식 문서: Model Config</a>에 나와 있는 것처럼 `dict`를 받는 `model_config` 어트리뷰트를 사용할 것입니다.
+
+    `"json_schema_extra"`를 생성된 JSON 스키마에서 보여주고 싶은 별도의 데이터와 `examples`를 포함하는 `dict`으로 설정할 수 있습니다.
+
+=== "Pydantic v1"
+
+    Pydantic v1에서 <a href="https://docs.pydantic.dev/1.10/usage/schema/#schema-customization" class="external-link" target="_blank">Pydantic 공식 문서: Schema customization</a>에서 설명하는 것처럼, 내부 클래스인 `Config`와 `schema_extra`를 사용할 것입니다.
+
+    `schema_extra`를 생성된 JSON 스키마에서 보여주고 싶은 별도의 데이터와 `examples`를 포함하는 `dict`으로 설정할 수 있습니다.
+
+!!! tip "팁"
+    JSON 스키마를 확장하고 여러분의 별도의 자체 데이터를 추가하기 위해 같은 기술을 사용할 수 있습니다.
+
+    예를 들면, 프론트엔드 사용자 인터페이스에 메타데이터를 추가하는 등에 사용할 수 있습니다.
+
+!!! info "정보"
+    (FastAPI 0.99.0부터 쓰이기 시작한) OpenAPI 3.1.0은 **JSON 스키마** 표준의 일부인 `examples`에 대한 지원을 추가했습니다.
+
+    그 전에는, 하나의 예제만 가능한 `example` 키워드만 지원했습니다. 이는 아직 OpenAPI 3.1.0에서 지원하지만, 지원이 종료될 것이며 JSON 스키마 표준에 포함되지 않습니다. 그렇기에 `example`을 `examples`으로 이전하는 것을 추천합니다. 🤓
+
+    이 문서 끝에 더 많은 읽을거리가 있습니다.
+
+## `Field` 추가 인자
+
+Pydantic 모델과 같이 `Field()`를 사용할 때 추가적인 `examples`를 선언할 수 있습니다:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="2  8-11"
+    {!> ../../../docs_src/schema_extra_example/tutorial002_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="4  10-13"
+    {!> ../../../docs_src/schema_extra_example/tutorial002.py!}
+    ```
+
+## JSON Schema에서의 `examples` - OpenAPI
+
+이들 중에서 사용합니다:
+
+* `Path()`
+* `Query()`
+* `Header()`
+* `Cookie()`
+* `Body()`
+* `Form()`
+* `File()`
+
+**OpenAPI**의 **JSON 스키마**에 추가될 부가적인 정보를 포함한 `examples` 모음을 선언할 수 있습니다.
+
+### `examples`를 포함한 `Body`
+
+여기, `Body()`에 예상되는 예제 데이터 하나를 포함한 `examples`를 넘겼습니다:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="22-29"
+    {!> ../../../docs_src/schema_extra_example/tutorial003_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="22-29"
+    {!> ../../../docs_src/schema_extra_example/tutorial003_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="23-30"
+    {!> ../../../docs_src/schema_extra_example/tutorial003_an.py!}
+    ```
+
+=== "Python 3.10+ Annotated가 없는 경우"
+
+    !!! tip "팁"
+        가능하다면 `Annotated`가 달린 버전을 권장합니다.
+
+    ```Python hl_lines="18-25"
+    {!> ../../../docs_src/schema_extra_example/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.8+ Annotated가 없는 경우"
+
+    !!! tip "팁"
+        가능하다면 `Annotated`가 달린 버전을 권장합니다.
+
+    ```Python hl_lines="20-27"
+    {!> ../../../docs_src/schema_extra_example/tutorial003.py!}
+    ```
+
+### 문서 UI 예시
+
+위의 어느 방법과 함께라면 `/docs`에서 다음과 같이 보일 것입니다:
+
+<img src="/img/tutorial/body-fields/image01.png">
+
+### 다중 `examples`를 포함한 `Body`
+
+물론 여러 `examples`를 넘길 수 있습니다:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="23-38"
+    {!> ../../../docs_src/schema_extra_example/tutorial004_an_py310.py!}
+    ```
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="23-38"
+    {!> ../../../docs_src/schema_extra_example/tutorial004_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="24-39"
+    {!> ../../../docs_src/schema_extra_example/tutorial004_an.py!}
+    ```
+
+=== "Python 3.10+ Annotated가 없는 경우"
+
+    !!! tip "팁"
+        가능하다면 `Annotated`가 달린 버전을 권장합니다.
+
+    ```Python hl_lines="19-34"
+    {!> ../../../docs_src/schema_extra_example/tutorial004_py310.py!}
+    ```
+
+=== "Python 3.8+ Annotated가 없는 경우"
+
+    !!! tip "팁"
+        가능하다면 `Annotated`가 달린 버전을 권장합니다.
+
+    ```Python hl_lines="21-36"
+    {!> ../../../docs_src/schema_extra_example/tutorial004.py!}
+    ```
+
+이와 같이 하면 이 예제는 그 본문 데이터를 위한 내부 **JSON 스키마**의 일부가 될 것입니다.
+
+그럼에도 불구하고, 지금 <abbr title="2023-08-26">이 문서를 작성하는 시간</abbr>에, 문서 UI를 보여주는 역할을 맡은 Swagger UI는 **JSON 스키마** 속 데이터를 위한 여러 예제의 표현을 지원하지 않습니다. 하지만 해결 방안을 밑에서 읽어보세요.
+
+### OpenAPI-특화 `examples`
+
+**JSON 스키마**가 `examples`를 지원하기 전 부터, OpenAPI는 `examples`이라 불리는 다른 필드를 지원해 왔습니다.
+
+이 **OpenAPI-특화** `examples`는 OpenAPI 명세서의 다른 구역으로 들어갑니다. 각 JSON 스키마 내부가 아니라 **각 *경로 작동* 세부 정보**에 포함됩니다.
+
+그리고 Swagger UI는 이 특정한 `examples` 필드를 한동안 지원했습니다. 그래서, 이를 다른 **문서 UI에 있는 예제**를 **표시**하기 위해 사용할 수 있습니다.
+
+이 OpenAPI-특화 필드인 `examples`의 형태는 (`list`대신에) **다중 예제**가 포함된 `dict`이며, 각각의 별도 정보 또한 **OpenAPI**에 추가될 것입니다.
+
+이는 OpenAPI에 포함된 JSON 스키마 안으로 포함되지 않으며, *경로 작동*에 직접적으로 포함됩니다.
+
+### `openapi_examples` 매개변수 사용하기
+
+다음 예시 속에 OpenAPI-특화 `examples`를 FastAPI 안에서 매개변수 `openapi_examples` 매개변수와 함께 선언할 수 있습니다:
+
+* `Path()`
+* `Query()`
+* `Header()`
+* `Cookie()`
+* `Body()`
+* `Form()`
+* `File()`
+
+`dict`의 키가 또 다른 `dict`인 각 예제와 값을 구별합니다.
+
+각각의 특정 `examples` 속 `dict` 예제는 다음을 포함할 수 있습니다:
+
+* `summary`: 예제에 대한 짧은 설명문.
+* `description`: 마크다운 텍스트를 포함할 수 있는 긴 설명문.
+* `value`: 실제로 보여지는 예시, 예를 들면 `dict`.
+* `externalValue`: `value`의 대안이며 예제를 가르키는 URL. 비록 `value`처럼 많은 도구를 지원하지 못할 수 있습니다.
+
+이를 다음과 같이 사용할 수 있습니다:
+
+=== "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.8+"
+
+    ```Python hl_lines="24-50"
+    {!> ../../../docs_src/schema_extra_example/tutorial005_an.py!}
+    ```
+
+=== "Python 3.10+ Annotated가 없는 경우"
+
+    !!! tip "팁"
+        가능하다면 `Annotated`가 달린 버전을 권장합니다.
+
+    ```Python hl_lines="19-45"
+    {!> ../../../docs_src/schema_extra_example/tutorial005_py310.py!}
+    ```
+
+=== "Python 3.8+ Annotated가 없는 경우"
+
+    !!! tip "팁"
+        가능하다면 `Annotated`가 달린 버전을 권장합니다.
+
+    ```Python hl_lines="21-47"
+    {!> ../../../docs_src/schema_extra_example/tutorial005.py!}
+    ```
+
+### 문서 UI에서의 OpenAPI 예시
+
+`Body()`에 추가된 `openapi_examples`를 포함한 `/docs`는 다음과 같이 보일 것입니다:
+
+<img src="/img/tutorial/body-fields/image02.png">
+
+## 기술적 세부 사항
+
+!!! tip "팁"
+    이미 **FastAPI**의 **0.99.0 혹은 그 이상** 버전을 사용하고 있다면, 이 세부 사항을 **스킵**해도 상관 없을 것입니다.
+
+    세부 사항은 OpenAPI 3.1.0이 사용가능하기 전, 예전 버전과 더 관련있습니다.
+
+    간략한 OpenAPI와 JSON 스키마 **역사 강의**로 생각할 수 있습니다. 🤓
+
+!!! warning "경고"
+    표준 **JSON 스키마**와 **OpenAPI**에 대한 아주 기술적인 세부사항입니다.
+
+    만약 위의 생각이 작동한다면, 그것으로 충분하며 이 세부 사항은 필요없을 것이니, 마음 편하게 스킵하셔도 됩니다.
+
+OpenAPI 3.1.0 전에 OpenAPI는 오래된 **JSON 스키마**의 수정된 버전을 사용했습니다.
+
+JSON 스키마는 `examples`를 가지고 있지 않았고, 따라서 OpenAPI는 그들만의 `example` 필드를 수정된 버전에 추가했습니다.
+
+OpenAPI는 또한 `example`과 `examples` 필드를 명세서의 다른 부분에 추가했습니다:
+
+* <a href="https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#parameter-object" class="external-link" target="_blank">`(명세서에 있는) Parameter Object`</a>는 FastAPI의 다음 기능에서 쓰였습니다:
+    * `Path()`
+    * `Query()`
+    * `Header()`
+    * `Cookie()`
+* <a href="https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#media-type-object" class="external-link" target="_blank">(명세서에 있는)`Media Type Object`속 `content`에 있는 `Request Body Object`</a>는 FastAPI의 다음 기능에서 쓰였습니다:
+    * `Body()`
+    * `File()`
+    * `Form()`
+
+!!! info "정보"
+    이 예전 OpenAPI-특화 `examples` 매개변수는 이제 FastAPI `0.103.0`부터 `openapi_examples`입니다.
+
+### JSON 스키마의 `examples` 필드
+
+하지만, 후에 JSON 스키마는 <a href="https://json-schema.org/draft/2019-09/json-schema-validation.html#rfc.section.9.5" class="external-link" target="_blank">`examples`</a>필드를 명세서의 새 버전에 추가했습니다.
+
+그리고 새로운 OpenAPI 3.1.0은 이 새로운 `examples` 필드가 포함된 최신 버전 (JSON 스키마 2020-12)을 기반으로 했습니다.
+
+이제 새로운 `examples` 필드는 이전의 단일 (그리고 커스텀) `example` 필드보다 우선되며, `example`은 사용하지 않는 것이 좋습니다.
+
+JSON 스키마의 새로운 `examples` 필드는 예제 속 **단순한 `list`**이며, (위에서 상술한 것처럼) OpenAPI의 다른 곳에 존재하는 dict으로 된 추가적인 메타데이터가 아닙니다.
+
+!!! info "정보"
+    더 쉽고 새로운 JSON 스키마와의 통합과 함께 OpenAPI 3.1.0가 배포되었지만, 잠시동안 자동 문서 생성을 제공하는 도구인 Swagger UI는 OpenAPI 3.1.0을 지원하지 않았습니다 (5.0.0 버전부터 지원합니다 🎉).
+
+    이로인해, FastAPI 0.99.0 이전 버전은 아직 OpenAPI 3.1.0 보다 낮은 버전을 사용했습니다.
+
+### Pydantic과 FastAPI `examples`
+
+`examples`를 Pydantic 모델 속에 추가할 때, `schema_extra` 혹은 `Field(examples=["something"])`를 사용하면 Pydantic 모델의 **JSON 스키마**에 해당 예시가 추가됩니다.
+
+그리고 Pydantic 모델의 **JSON 스키마**는 API의 **OpenAPI**에 포함되고, 그 후 문서 UI 속에서 사용됩니다.
+
+FastAPI 0.99.0 이전 버전에서 (0.99.0 이상 버전은 새로운 OpenAPI 3.1.0을 사용합니다), `example` 혹은 `examples`를 다른 유틸리티(`Query()`, `Body()` 등)와 함께 사용했을 때, 저러한 예시는 데이터를 설명하는 JSON 스키마에 추가되지 않으며 (심지어 OpenAPI의 자체 JSON 스키마에도 포함되지 않습니다), OpenAPI의 *경로 작동* 선언에 직접적으로 추가됩니다 (JSON 스키마를 사용하는 OpenAPI 부분 외에도).
+
+하지만 지금은 FastAPI 0.99.0 및 이후 버전에서는 JSON 스키마 2020-12를 사용하는 OpenAPI 3.1.0과 Swagger UI 5.0.0 및 이후 버전을 사용하며, 모든 것이 더 일관성을 띄고 예시는 JSON 스키마에 포함됩니다.
+
+### Swagger UI와 OpenAPI-특화 `examples`
+
+현재 (2023-08-26), Swagger UI가 다중 JSON 스키마 예시를 지원하지 않으며, 사용자는 다중 예시를 문서에 표시하는 방법이 없었습니다.
+
+이를 해결하기 위해, FastAPI `0.103.0`은 새로운 매개변수인 `openapi_examples`를 포함하는 예전 **OpenAPI-특화** `examples` 필드를 선언하기 위한 **지원을 추가**했습니다. 🤓
+
+### 요약
+
+저는 역사를 그다지 좋아하는 편이 아니라고 말하고는 했지만... "기술 역사" 강의를 가르치는 지금의 저를 보세요.
+
+요약하자면 **FastAPI 0.99.0 혹은 그 이상의 버전**으로 업그레이드하는 것은 많은 것들이 더 **쉽고, 일관적이며 직관적이게** 되며, 여러분은 이 모든 역사적 세부 사항을 알 필요가 없습니다. 😎

From 9f4db6d6d39f13cd80f2833ecf31ea5b17c43e07 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 9 Feb 2024 12:36:07 +0000
Subject: [PATCH 33/70] =?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 0e66f5ca4..0ee96b453 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -13,6 +13,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Korean translation for `/docs/ko/docs/tutorial/schema-extra-example.md`. PR [#11121](https://github.com/tiangolo/fastapi/pull/11121) by [@KaniKim](https://github.com/KaniKim).
 * 🌐 Add Korean translation for `/docs/ko/docs/tutorial/body-fields.md`. PR [#11112](https://github.com/tiangolo/fastapi/pull/11112) by [@KaniKim](https://github.com/KaniKim).
 * 🌐 Add Korean translation for `/docs/ko/docs/tutorial/cookie-params.md`. PR [#11118](https://github.com/tiangolo/fastapi/pull/11118) by [@riroan](https://github.com/riroan).
 * 🌐 Update Korean translation for `/docs/ko/docs/dependencies/index.md`. PR [#11114](https://github.com/tiangolo/fastapi/pull/11114) by [@KaniKim](https://github.com/KaniKim).

From c0df02355746b232fda33506161458bdfe233a7b Mon Sep 17 00:00:00 2001
From: Kani Kim <kkh5428@gmail.com>
Date: Sun, 11 Feb 2024 22:48:31 +0900
Subject: [PATCH 34/70] =?UTF-8?q?=E2=9C=8F=EF=B8=8F=20Fix=20minor=20typos?=
 =?UTF-8?q?=20in=20`docs/ko/docs/`=20(#11126)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/ko/docs/tutorial/background-tasks.md      | 12 ++++++------
 docs/ko/docs/tutorial/body-fields.md           |  2 +-
 docs/ko/docs/tutorial/body-multiple-params.md  |  6 +++---
 .../dependencies/classes-as-dependencies.md    |  4 ++--
 docs/ko/docs/tutorial/dependencies/index.md    |  2 +-
 docs/ko/docs/tutorial/first-steps.md           |  2 +-
 .../tutorial/path-operation-configuration.md   |  2 +-
 .../tutorial/query-params-str-validations.md   |  2 +-
 docs/ko/docs/tutorial/request-files.md         |  2 +-
 .../docs/tutorial/request-forms-and-files.md   |  2 +-
 docs/ko/docs/tutorial/response-model.md        | 18 +++++++++---------
 .../docs/tutorial/security/get-current-user.md |  2 +-
 12 files changed, 28 insertions(+), 28 deletions(-)

diff --git a/docs/ko/docs/tutorial/background-tasks.md b/docs/ko/docs/tutorial/background-tasks.md
index a951ead16..ee83d6570 100644
--- a/docs/ko/docs/tutorial/background-tasks.md
+++ b/docs/ko/docs/tutorial/background-tasks.md
@@ -13,7 +13,7 @@ FastAPI에서는 응답을 반환한 후에 실행할 백그라운드 작업을
 
 ## `백그라운드 작업` 사용
 
-먼저 아래와 같이 `BackgroundTasks`를 임포트하고, `BackgroundTasks`를 _경로 동작 함수_ 에서 매개변수로 가져오고 정의합니다.
+먼저 아래와 같이 `BackgroundTasks`를 임포트하고, `BackgroundTasks`를 _경로 작동 함수_ 에서 매개변수로 가져오고 정의합니다.
 
 ```Python hl_lines="1  13"
 {!../../../docs_src/background_tasks/tutorial001.py!}
@@ -39,7 +39,7 @@ FastAPI에서는 응답을 반환한 후에 실행할 백그라운드 작업을
 
 ## 백그라운드 작업 추가
 
-_경로 동작 함수_ 내에서 작업 함수를 `.add_task()` 함수 통해 _백그라운드 작업_ 개체에 전달합니다.
+_경로 작동 함수_ 내에서 작업 함수를 `.add_task()` 함수 통해 _백그라운드 작업_ 개체에 전달합니다.
 
 ```Python hl_lines="14"
 {!../../../docs_src/background_tasks/tutorial001.py!}
@@ -53,7 +53,7 @@ _경로 동작 함수_ 내에서 작업 함수를 `.add_task()` 함수 통해 _
 
 ## 의존성 주입
 
-`BackgroundTasks`를 의존성 주입 시스템과 함께 사용하면 _경로 동작 함수_, 종속성, 하위 종속성 등 여러 수준에서 BackgroundTasks 유형의 매개변수를 선언할 수 있습니다.
+`BackgroundTasks`를 의존성 주입 시스템과 함께 사용하면 _경로 작동 함수_, 종속성, 하위 종속성 등 여러 수준에서 BackgroundTasks 유형의 매개변수를 선언할 수 있습니다.
 
 **FastAPI**는 각 경우에 수행할 작업과 동일한 개체를 내부적으로 재사용하기에, 모든 백그라운드 작업이 함께 병합되고 나중에 백그라운드에서 실행됩니다.
 
@@ -73,7 +73,7 @@ _경로 동작 함수_ 내에서 작업 함수를 `.add_task()` 함수 통해 _
 
 요청에 쿼리가 있는 경우 백그라운드 작업의 로그에 기록됩니다.
 
-그리고 _경로 동작 함수_ 에서 생성된 또 다른 백그라운드 작업은 경로 매개 변수를 활용하여 사용하여 메시지를 작성합니다.
+그리고 _경로 작동 함수_ 에서 생성된 또 다른 백그라운드 작업은 경로 매개 변수를 활용하여 사용하여 메시지를 작성합니다.
 
 ## 기술적 세부사항
 
@@ -81,7 +81,7 @@ _경로 동작 함수_ 내에서 작업 함수를 `.add_task()` 함수 통해 _
 
 `BackgroundTasks` 클래스는 FastAPI에서 직접 임포트하거나 포함하기 때문에 실수로 `BackgroundTask` (끝에 `s`가 없음)을 임포트하더라도 starlette.background에서 `BackgroundTask`를 가져오는 것을 방지할 수 있습니다.
 
-(`BackgroundTask`가 아닌) `BackgroundTasks`를 사용하면, _경로 동작 함수_ 매개변수로 사용할 수 있게 되고 나머지는 **FastAPI**가 대신 처리하도록 할 수 있습니다. 이것은 `Request` 객체를 직접 사용하는 것과 같은 방식입니다.
+(`BackgroundTask`가 아닌) `BackgroundTasks`를 사용하면, _경로 작동 함수_ 매개변수로 사용할 수 있게 되고 나머지는 **FastAPI**가 대신 처리하도록 할 수 있습니다. 이것은 `Request` 객체를 직접 사용하는 것과 같은 방식입니다.
 
 FastAPI에서 `BackgroundTask`를 단독으로 사용하는 것은 여전히 가능합니다. 하지만 객체를 코드에서 생성하고, 이 객체를 포함하는 Starlette `Response`를 반환해야 합니다.
 
@@ -99,4 +99,4 @@ RabbitMQ 또는 Redis와 같은 메시지/작업 큐 시스템 보다 복잡한
 
 ## 요약
 
-백그라운드 작업을 추가하기 위해 _경로 동작 함수_ 에 매개변수로 `BackgroundTasks`를 가져오고 사용합니다.
+백그라운드 작업을 추가하기 위해 _경로 작동 함수_ 에 매개변수로 `BackgroundTasks`를 가져오고 사용합니다.
diff --git a/docs/ko/docs/tutorial/body-fields.md b/docs/ko/docs/tutorial/body-fields.md
index a739756bd..fc7209726 100644
--- a/docs/ko/docs/tutorial/body-fields.md
+++ b/docs/ko/docs/tutorial/body-fields.md
@@ -1,6 +1,6 @@
 # 본문 - 필드
 
-`Query`, `Path`와 `Body`를 사용해 *경로 동작 함수* 매개변수 내에서 추가적인 검증이나 메타데이터를 선언한 것처럼 Pydantic의 `Field`를 사용하여 모델 내에서 검증과 메타데이터를 선언할 수 있습니다.
+`Query`, `Path`와 `Body`를 사용해 *경로 작동 함수* 매개변수 내에서 추가적인 검증이나 메타데이터를 선언한 것처럼 Pydantic의 `Field`를 사용하여 모델 내에서 검증과 메타데이터를 선언할 수 있습니다.
 
 ## `Field` 임포트
 
diff --git a/docs/ko/docs/tutorial/body-multiple-params.md b/docs/ko/docs/tutorial/body-multiple-params.md
index 034c2e84c..2cf5df7f3 100644
--- a/docs/ko/docs/tutorial/body-multiple-params.md
+++ b/docs/ko/docs/tutorial/body-multiple-params.md
@@ -19,7 +19,7 @@
 
 ## 다중 본문 매개변수
 
-이전 예제에서 보듯이, *경로 동작*은 아래와 같이 `Item` 속성을 가진 JSON 본문을 예상합니다:
+이전 예제에서 보듯이, *경로 작동*은 아래와 같이 `Item` 속성을 가진 JSON 본문을 예상합니다:
 
 ```JSON
 {
@@ -161,9 +161,9 @@ item: Item = Body(..., embed=True)
 
 ## 정리
 
-요청이 단 한개의 본문을 가지고 있더라도, *경로 동작 함수*로 다중 본문 매개변수를 추가할 수 있습니다.
+요청이 단 한개의 본문을 가지고 있더라도, *경로 작동 함수*로 다중 본문 매개변수를 추가할 수 있습니다.
 
-하지만, **FastAPI**는 이를 처리하고, 함수에 올바른 데이터를 제공하며, *경로 동작*으로 올바른 스키마를 검증하고 문서화 합니다.
+하지만, **FastAPI**는 이를 처리하고, 함수에 올바른 데이터를 제공하며, *경로 작동*으로 올바른 스키마를 검증하고 문서화 합니다.
 
 또한, 단일 값을 본문의 일부로 받도록 선언할 수 있습니다.
 
diff --git a/docs/ko/docs/tutorial/dependencies/classes-as-dependencies.md b/docs/ko/docs/tutorial/dependencies/classes-as-dependencies.md
index bbf3a8283..38cdc2e1a 100644
--- a/docs/ko/docs/tutorial/dependencies/classes-as-dependencies.md
+++ b/docs/ko/docs/tutorial/dependencies/classes-as-dependencies.md
@@ -71,9 +71,9 @@ fluffy = Cat(name="Mr Fluffy")
 
 FastAPI가 실질적으로 확인하는 것은 "호출 가능성"(함수, 클래스 또는 다른 모든 것)과 정의된 매개변수들입니다.
 
-"호출 가능"한 것을 의존성으로서 **FastAPI**에 전달하면, 그 "호출 가능"한 것의 매개변수들을 분석한 후 이를 *경로 동작 함수*를 위한 매개변수와 동일한 방식으로 처리합니다. 하위-의존성 또한 같은 방식으로 처리합니다.
+"호출 가능"한 것을 의존성으로서 **FastAPI**에 전달하면, 그 "호출 가능"한 것의 매개변수들을 분석한 후 이를 *경로 작동 함수*를 위한 매개변수와 동일한 방식으로 처리합니다. 하위-의존성 또한 같은 방식으로 처리합니다.
 
-매개변수가 없는 "호출 가능"한 것 역시 매개변수가 없는 *경로 동작 함수*와 동일한 방식으로 적용됩니다.
+매개변수가 없는 "호출 가능"한 것 역시 매개변수가 없는 *경로 작동 함수*와 동일한 방식으로 적용됩니다.
 
 그래서, 우리는 위 예제에서의 `common_paramenters` 의존성을 클래스 `CommonQueryParams`로 바꿀 수 있습니다.
 
diff --git a/docs/ko/docs/tutorial/dependencies/index.md b/docs/ko/docs/tutorial/dependencies/index.md
index cde88eb6c..c56dddae3 100644
--- a/docs/ko/docs/tutorial/dependencies/index.md
+++ b/docs/ko/docs/tutorial/dependencies/index.md
@@ -6,7 +6,7 @@
 
 ## "의존성 주입"은 무엇입니까?
 
-**"의존성 주입"**은 프로그래밍에서 여러분의 코드(이 경우, 경로 동작 함수)가 작동하고 사용하는 데 필요로 하는 것, 즉 "의존성"을 선언할 수 있는 방법을 의미합니다.
+**"의존성 주입"**은 프로그래밍에서 여러분의 코드(이 경우, 경로 작동 함수)가 작동하고 사용하는 데 필요로 하는 것, 즉 "의존성"을 선언할 수 있는 방법을 의미합니다.
 
 그 후에, 시스템(이 경우 FastAPI)은 여러분의 코드가 요구하는 의존성을 제공하기 위해 필요한 모든 작업을 처리합니다.(의존성을 "주입"합니다)
 
diff --git a/docs/ko/docs/tutorial/first-steps.md b/docs/ko/docs/tutorial/first-steps.md
index 0eb4d6bd5..e3b42bce7 100644
--- a/docs/ko/docs/tutorial/first-steps.md
+++ b/docs/ko/docs/tutorial/first-steps.md
@@ -309,7 +309,7 @@ URL "`/`"에 대한 `GET` 작동을 사용하는 요청을 받을 때마다 **Fa
 {!../../../docs_src/first_steps/tutorial003.py!}
 ```
 
-!!! note 참고
+!!! note "참고"
     차이점을 모르겠다면 [Async: *"In a hurry?"*](../async.md#in-a-hurry){.internal-link target=_blank}을 확인하세요.
 
 ### 5 단계: 콘텐츠 반환
diff --git a/docs/ko/docs/tutorial/path-operation-configuration.md b/docs/ko/docs/tutorial/path-operation-configuration.md
index 22aad0421..411c43493 100644
--- a/docs/ko/docs/tutorial/path-operation-configuration.md
+++ b/docs/ko/docs/tutorial/path-operation-configuration.md
@@ -1,4 +1,4 @@
-# 경로 동작 설정
+# 경로 작동 설정
 
 *경로 작동 데코레이터*를 설정하기 위해서 전달할수 있는 몇 가지 매개변수가 있습니다.
 
diff --git a/docs/ko/docs/tutorial/query-params-str-validations.md b/docs/ko/docs/tutorial/query-params-str-validations.md
index 7ae100dcc..2e6396ccc 100644
--- a/docs/ko/docs/tutorial/query-params-str-validations.md
+++ b/docs/ko/docs/tutorial/query-params-str-validations.md
@@ -74,7 +74,7 @@ q: Optional[str] = None
 q: str = Query(None, max_length=50)
 ```
 
-이는 데이터를 검증할 것이고, 데이터가 유효하지 않다면 명백한 오류를 보여주며, OpenAPI 스키마 *경로 동작*에 매개변수를 문서화 합니다.
+이는 데이터를 검증할 것이고, 데이터가 유효하지 않다면 명백한 오류를 보여주며, OpenAPI 스키마 *경로 작동*에 매개변수를 문서화 합니다.
 
 ## 검증 추가
 
diff --git a/docs/ko/docs/tutorial/request-files.md b/docs/ko/docs/tutorial/request-files.md
index decefe981..03a6d593a 100644
--- a/docs/ko/docs/tutorial/request-files.md
+++ b/docs/ko/docs/tutorial/request-files.md
@@ -108,7 +108,7 @@ HTML의 폼들(`<form></form>`)이 서버에 데이터를 전송하는 방식은
 
     인코딩과 폼 필드에 대해 더 알고싶다면, <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST" class="external-link" target="_blank"><code>POST</code>에 관한<abbr title="Mozilla Developer Network">MDN</abbr>웹 문서</a> 를 참고하기 바랍니다,.
 
-!!! warning "주의"
+!!! warning "경고"
     다수의 `File` 과 `Form` 매개변수를 한 *경로 작동*에 선언하는 것이 가능하지만, 요청의 본문이 `application/json` 가 아닌 `multipart/form-data` 로 인코딩 되기 때문에 JSON으로 받아야하는 `Body` 필드를 함께 선언할 수는 없습니다.
 
     이는 **FastAPI**의 한계가 아니라, HTTP 프로토콜에 의한 것입니다.
diff --git a/docs/ko/docs/tutorial/request-forms-and-files.md b/docs/ko/docs/tutorial/request-forms-and-files.md
index ddf232e7f..fdf8dbad0 100644
--- a/docs/ko/docs/tutorial/request-forms-and-files.md
+++ b/docs/ko/docs/tutorial/request-forms-and-files.md
@@ -25,7 +25,7 @@
 
 어떤 파일들은 `bytes`로, 또 어떤 파일들은 `UploadFile`로 선언할 수 있습니다.
 
-!!! warning "주의"
+!!! warning "경고"
     다수의 `File`과 `Form` 매개변수를 한 *경로 작동*에 선언하는 것이 가능하지만, 요청의 본문이 `application/json`가 아닌 `multipart/form-data`로 인코딩 되기 때문에 JSON으로 받아야하는 `Body` 필드를 함께 선언할 수는 없습니다.
 
     이는 **FastAPI**의 한계가 아니라, HTTP 프로토콜에 의한 것입니다.
diff --git a/docs/ko/docs/tutorial/response-model.md b/docs/ko/docs/tutorial/response-model.md
index fa90c10ae..0c9d5c16e 100644
--- a/docs/ko/docs/tutorial/response-model.md
+++ b/docs/ko/docs/tutorial/response-model.md
@@ -1,6 +1,6 @@
 # 응답 모델
 
-어떤 *경로 동작*이든 매개변수 `response_model`를 사용하여 응답을 위한 모델을 선언할 수 있습니다:
+어떤 *경로 작동*이든 매개변수 `response_model`를 사용하여 응답을 위한 모델을 선언할 수 있습니다:
 
 * `@app.get()`
 * `@app.post()`
@@ -13,7 +13,7 @@
 ```
 
 !!! note "참고"
-    `response_model`은 "데코레이터" 메소드(`get`, `post`, 등)의 매개변수입니다. 모든 매개변수들과 본문(body)처럼 *경로 동작 함수*가 아닙니다.
+    `response_model`은 "데코레이터" 메소드(`get`, `post`, 등)의 매개변수입니다. 모든 매개변수들과 본문(body)처럼 *경로 작동 함수*가 아닙니다.
 
 Pydantic 모델 어트리뷰트를 선언한 것과 동일한 타입을 수신하므로 Pydantic 모델이 될 수 있지만, `List[Item]`과 같이 Pydantic 모델들의 `list`일 수도 있습니다.
 
@@ -21,7 +21,7 @@ FastAPI는 이 `response_model`를 사용하여:
 
 * 출력 데이터를 타입 선언으로 변환.
 * 데이터 검증.
-* OpenAPI *경로 동작*의 응답에 JSON 스키마 추가.
+* OpenAPI *경로 작동*의 응답에 JSON 스키마 추가.
 * 자동 생성 문서 시스템에 사용.
 
 하지만 가장 중요한 것은:
@@ -49,7 +49,7 @@ FastAPI는 이 `response_model`를 사용하여:
 
 이 경우, 사용자가 스스로 비밀번호를 발신했기 때문에 문제가 되지 않을 수 있습니다.
 
-그러나 동일한 모델을 다른 *경로 동작*에서 사용할 경우, 모든 클라이언트에게 사용자의 비밀번호를 발신할 수 있습니다.
+그러나 동일한 모델을 다른 *경로 작동*에서 사용할 경우, 모든 클라이언트에게 사용자의 비밀번호를 발신할 수 있습니다.
 
 !!! danger "위험"
     절대로 사용자의 평문 비밀번호를 저장하거나 응답으로 발신하지 마십시오.
@@ -62,7 +62,7 @@ FastAPI는 이 `response_model`를 사용하여:
 {!../../../docs_src/response_model/tutorial003.py!}
 ```
 
-여기서 *경로 동작 함수*가 비밀번호를 포함하는 동일한 입력 사용자를 반환할지라도:
+여기서 *경로 작동 함수*가 비밀번호를 포함하는 동일한 입력 사용자를 반환할지라도:
 
 ```Python hl_lines="24"
 {!../../../docs_src/response_model/tutorial003.py!}
@@ -104,7 +104,7 @@ FastAPI는 이 `response_model`를 사용하여:
 
 ### `response_model_exclude_unset` 매개변수 사용
 
-*경로 동작 데코레이터* 매개변수를 `response_model_exclude_unset=True`로 설정 할 수 있습니다:
+*경로 작동 데코레이터* 매개변수를 `response_model_exclude_unset=True`로 설정 할 수 있습니다:
 
 ```Python hl_lines="24"
 {!../../../docs_src/response_model/tutorial004.py!}
@@ -112,7 +112,7 @@ FastAPI는 이 `response_model`를 사용하여:
 
 이러한 기본값은 응답에 포함되지 않고 실제로 설정된 값만 포함됩니다.
 
-따라서 해당 *경로 동작*에 ID가 `foo`인 항목(items)을 요청으로 보내면 (기본값을 제외한) 응답은 다음과 같습니다:
+따라서 해당 *경로 작동*에 ID가 `foo`인 항목(items)을 요청으로 보내면 (기본값을 제외한) 응답은 다음과 같습니다:
 
 ```JSON
 {
@@ -173,7 +173,7 @@ ID가 `baz`인 항목(items)처럼 기본값과 동일한 값을 갖는다면:
 
 ### `response_model_include` 및 `response_model_exclude`
 
-*경로 동작 데코레이터* 매개변수 `response_model_include` 및 `response_model_exclude`를 사용할 수 있습니다.
+*경로 작동 데코레이터* 매개변수 `response_model_include` 및 `response_model_exclude`를 사용할 수 있습니다.
 
 이들은 포함(나머지 생략)하거나 제외(나머지 포함) 할 어트리뷰트의 이름과 `str`의 `set`을 받습니다.
 
@@ -205,6 +205,6 @@ Pydantic 모델이 하나만 있고 출력에서 ​​일부 데이터를 제
 
 ## 요약
 
-응답 모델을 정의하고 개인정보가 필터되는 것을 보장하기 위해 *경로 동작 데코레이터*의 매개변수 `response_model`을 사용하세요.
+응답 모델을 정의하고 개인정보가 필터되는 것을 보장하기 위해 *경로 작동 데코레이터*의 매개변수 `response_model`을 사용하세요.
 
 명시적으로 설정된 값만 반환하려면 `response_model_exclude_unset`을 사용하세요.
diff --git a/docs/ko/docs/tutorial/security/get-current-user.md b/docs/ko/docs/tutorial/security/get-current-user.md
index ce944b16d..5bc2cee7a 100644
--- a/docs/ko/docs/tutorial/security/get-current-user.md
+++ b/docs/ko/docs/tutorial/security/get-current-user.md
@@ -36,7 +36,7 @@ Pydantic을 사용하여 본문을 선언하는 것과 같은 방식으로 다
 
 `get_current_user`는 이전에 생성한 것과 동일한 `oauth2_scheme`과 종속성을 갖게 됩니다.
 
-이전에 *경로 동작*에서 직접 수행했던 것과 동일하게 새 종속성 `get_current_user`는 하위 종속성 `oauth2_scheme`에서 `str`로 `token`을 수신합니다.
+이전에 *경로 작동*에서 직접 수행했던 것과 동일하게 새 종속성 `get_current_user`는 하위 종속성 `oauth2_scheme`에서 `str`로 `token`을 수신합니다.
 
 === "파이썬 3.7 이상"
 

From 44c4cdd73b77d3ca8e45f381f7201bcd6d627986 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 11 Feb 2024 13:48:54 +0000
Subject: [PATCH 35/70] =?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 0ee96b453..8536742c5 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -9,6 +9,7 @@ hide:
 
 ### Docs
 
+* ✏️ Fix minor typos in `docs/ko/docs/`. PR [#11126](https://github.com/tiangolo/fastapi/pull/11126) by [@KaniKim](https://github.com/KaniKim).
 * ✏️ Fix minor typo in `fastapi/applications.py`. PR [#11099](https://github.com/tiangolo/fastapi/pull/11099) by [@JacobHayes](https://github.com/JacobHayes).
 
 ### Translations

From b1fa0f262e6bdf683a99d6ae7ccafef5448a2b97 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B9=80=EB=AA=85=EA=B8=B0?= <riroan@naver.com>
Date: Sun, 11 Feb 2024 22:49:45 +0900
Subject: [PATCH 36/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translation?=
 =?UTF-8?q?=20for=20`/docs/ko/docs/tutorial/dependencies/dependencies-in-p?=
 =?UTF-8?q?ath-operation-decorators.md`=20(#11124)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...pendencies-in-path-operation-decorators.md | 139 ++++++++++++++++++
 1 file changed, 139 insertions(+)
 create mode 100644 docs/ko/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md

diff --git a/docs/ko/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md b/docs/ko/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
new file mode 100644
index 000000000..92b2c7d1c
--- /dev/null
+++ b/docs/ko/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md
@@ -0,0 +1,139 @@
+# 경로 작동 데코레이터에서의 의존성
+
+몇몇 경우에는, *경로 작동 함수* 안에서 의존성의 반환 값이 필요하지 않습니다.
+
+또는 의존성이 값을 반환하지 않습니다.
+
+그러나 여전히 실행/해결될 필요가 있습니다.
+
+그런 경우에, `Depends`를 사용하여 *경로 작동 함수*의 매개변수로 선언하는 것보다 *경로 작동 데코레이터*에 `dependencies`의 `list`를 추가할 수 있습니다.
+
+## *경로 작동 데코레이터*에 `dependencies` 추가하기
+
+*경로 작동 데코레이터*는 `dependencies`라는 선택적인 인자를 받습니다.
+
+`Depends()`로 된 `list`이어야합니다:
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="19"
+    {!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="18"
+    {!> ../../../docs_src/dependencies/tutorial006_an.py!}
+    ```
+
+=== "Python 3.8 Annotated가 없는 경우"
+
+    !!! tip "팁"
+        가능하다면 `Annotated`가 달린 버전을 권장합니다.
+
+    ```Python hl_lines="17"
+    {!> ../../../docs_src/dependencies/tutorial006.py!}
+    ```
+
+이러한 의존성들은 기존 의존성들과 같은 방식으로 실행/해결됩니다. 그러나 값은 (무엇이든 반환한다면) *경로 작동 함수*에 제공되지 않습니다.
+
+!!! tip "팁"
+    일부 편집기에서는 사용되지 않는 함수 매개변수를 검사하고 오류로 표시합니다.
+
+    *경로 작동 데코레이터*에서 `dependencies`를 사용하면 편집기/도구 오류를 피하며 실행되도록 할 수 있습니다.
+
+    또한 코드에서 사용되지 않는 매개변수를 보고 불필요하다고 생각할 수 있는 새로운 개발자의 혼란을 방지하는데 도움이 될 수 있습니다.
+
+!!! info "정보"
+    이 예시에서 `X-Key`와 `X-Token`이라는 커스텀 헤더를 만들어 사용했습니다.
+
+    그러나 실제로 보안을 구현할 때는 통합된 [보안 유틸리티 (다음 챕터)](../security/index.md){.internal-link target=_blank}를 사용하는 것이 더 많은 이점을 얻을 수 있습니다.
+
+## 의존성 오류와 값 반환하기
+
+평소에 사용하던대로 같은 의존성 *함수*를 사용할 수 있습니다.
+
+### 의존성 요구사항
+
+(헤더같은) 요청 요구사항이나 하위-의존성을 선언할 수 있습니다:
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="8  13"
+    {!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="7  12"
+    {!> ../../../docs_src/dependencies/tutorial006_an.py!}
+    ```
+
+=== "Python 3.8 Annotated가 없는 경우"
+
+    !!! tip "팁"
+        가능하다면 `Annotated`가 달린 버전을 권장합니다.
+
+    ```Python hl_lines="6  11"
+    {!> ../../../docs_src/dependencies/tutorial006.py!}
+    ```
+
+### 오류 발생시키기
+
+다음 의존성은 기존 의존성과 동일하게 예외를 `raise`를 일으킬 수 있습니다:
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="10  15"
+    {!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="9  14"
+    {!> ../../../docs_src/dependencies/tutorial006_an.py!}
+    ```
+
+=== "Python 3.8 Annotated가 없는 경우"
+
+    !!! tip "팁"
+        가능하다면 `Annotated`가 달린 버전을 권장합니다.
+
+    ```Python hl_lines="8  13"
+    {!> ../../../docs_src/dependencies/tutorial006.py!}
+    ```
+
+### 값 반환하기
+
+값을 반환하거나, 그러지 않을 수 있으며 값은 사용되지 않습니다.
+
+그래서 이미 다른 곳에서 사용된 (값을 반환하는) 일반적인 의존성을 재사용할 수 있고, 비록 값은 사용되지 않지만 의존성은 실행될 것입니다:
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="11  16"
+    {!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="10  15"
+    {!> ../../../docs_src/dependencies/tutorial006_an.py!}
+    ```
+
+=== "Python 3.8 Annotated가 없는 경우"
+
+    !!! tip "팁"
+        가능하다면 `Annotated`가 달린 버전을 권장합니다.
+
+    ```Python hl_lines="9  14"
+    {!> ../../../docs_src/dependencies/tutorial006.py!}
+    ```
+
+## *경로 작동* 모음에 대한 의존성
+
+나중에 여러 파일을 가지고 있을 수 있는 더 큰 애플리케이션을 구조화하는 법([더 큰 애플리케이션 - 여러 파일들](../../tutorial/bigger-applications.md){.internal-link target=_blank})을 읽을 때, *경로 작동* 모음에 대한 단일 `dependencies` 매개변수를 선언하는 법에 대해서 배우게 될 것입니다.
+
+## 전역 의존성
+
+다음으로 각 *경로 작동*에 적용되도록 `FastAPI` 애플리케이션 전체에 의존성을 추가하는 법을 볼 것입니다.

From a315048357dc6412348fa5a52f62ed46db90bd53 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 11 Feb 2024 13:52:06 +0000
Subject: [PATCH 37/70] =?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 8536742c5..9c3c309e8 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Korean translation for `/docs/ko/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md`. PR [#11124](https://github.com/tiangolo/fastapi/pull/11124) by [@riroan](https://github.com/riroan).
 * 🌐 Add Korean translation for `/docs/ko/docs/tutorial/schema-extra-example.md`. PR [#11121](https://github.com/tiangolo/fastapi/pull/11121) by [@KaniKim](https://github.com/KaniKim).
 * 🌐 Add Korean translation for `/docs/ko/docs/tutorial/body-fields.md`. PR [#11112](https://github.com/tiangolo/fastapi/pull/11112) by [@KaniKim](https://github.com/KaniKim).
 * 🌐 Add Korean translation for `/docs/ko/docs/tutorial/cookie-params.md`. PR [#11118](https://github.com/tiangolo/fastapi/pull/11118) by [@riroan](https://github.com/riroan).

From b8941c31eaf251e5e13cabaf998d7080bba3461b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B9=80=EB=AA=85=EA=B8=B0?= <riroan@naver.com>
Date: Thu, 15 Feb 2024 00:05:47 +0900
Subject: [PATCH 38/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20Korean=20translation?=
 =?UTF-8?q?=20for=20`/docs/ko/docs/tutorial/dependencies/global-dependenci?=
 =?UTF-8?q?es.md`=20(#11123)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../dependencies/global-dependencies.md       | 34 +++++++++++++++++++
 1 file changed, 34 insertions(+)
 create mode 100644 docs/ko/docs/tutorial/dependencies/global-dependencies.md

diff --git a/docs/ko/docs/tutorial/dependencies/global-dependencies.md b/docs/ko/docs/tutorial/dependencies/global-dependencies.md
new file mode 100644
index 000000000..930f6e678
--- /dev/null
+++ b/docs/ko/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.8+"
+
+    ```Python hl_lines="16"
+    {!> ../../../docs_src/dependencies/tutorial012_an.py!}
+    ```
+
+=== "Python 3.8 Annotated가 없는 경우"
+
+    !!! tip "팁"
+        가능하다면 `Annotated`가 달린 버전을 권장합니다.
+
+    ```Python hl_lines="15"
+    {!> ../../../docs_src/dependencies/tutorial012.py!}
+    ```
+
+그리고 [*경로 작동 데코레이터*에 `dependencies` 추가하기](dependencies-in-path-operation-decorators.md){.internal-link target=_blank}에 대한 아이디어는 여전히 적용되지만 여기에서는 앱에 있는 모든 *경로 작동*에 적용됩니다.
+
+## *경로 작동* 모음에 대한 의존성
+
+이후에 여러 파일들을 가지는 더 큰 애플리케이션을 구조화하는 법([더 큰 애플리케이션 - 여러 파일들](../../tutorial/bigger-applications.md){.internal-link target=_blank})을 읽을 때, *경로 작동* 모음에 대한 단일 `dependencies` 매개변수를 선언하는 법에 대해서 배우게 될 것입니다.

From 8ad6acfe6aeb7afb25218abbc65c1a97df072a8b Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 14 Feb 2024 15:06:07 +0000
Subject: [PATCH 39/70] =?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 9c3c309e8..920ae414d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Korean translation for `/docs/ko/docs/tutorial/dependencies/global-dependencies.md`. PR [#11123](https://github.com/tiangolo/fastapi/pull/11123) by [@riroan](https://github.com/riroan).
 * 🌐 Add Korean translation for `/docs/ko/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md`. PR [#11124](https://github.com/tiangolo/fastapi/pull/11124) by [@riroan](https://github.com/riroan).
 * 🌐 Add Korean translation for `/docs/ko/docs/tutorial/schema-extra-example.md`. PR [#11121](https://github.com/tiangolo/fastapi/pull/11121) by [@KaniKim](https://github.com/KaniKim).
 * 🌐 Add Korean translation for `/docs/ko/docs/tutorial/body-fields.md`. PR [#11112](https://github.com/tiangolo/fastapi/pull/11112) by [@KaniKim](https://github.com/KaniKim).

From 33f6026c6cdeb91ea17f7448962bc3bdadff3a59 Mon Sep 17 00:00:00 2001
From: Max Su <a0025071@gmail.com>
Date: Fri, 16 Feb 2024 20:06:22 +0800
Subject: [PATCH 40/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20Traditional=20Chines?=
 =?UTF-8?q?e=20translation=20for=20`docs/zh-hant/docs/learn/index.md`=20(#?=
 =?UTF-8?q?11142)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/zh-hant/docs/learn/index.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 docs/zh-hant/docs/learn/index.md

diff --git a/docs/zh-hant/docs/learn/index.md b/docs/zh-hant/docs/learn/index.md
new file mode 100644
index 000000000..eb7d7096a
--- /dev/null
+++ b/docs/zh-hant/docs/learn/index.md
@@ -0,0 +1,5 @@
+# 學習
+
+以下是學習 FastAPI 的入門介紹和教學。
+
+你可以將其視為一本**書籍**或一門**課程**，這是**官方**認可並推薦的 FastAPI 學習方式。 😎

From be876902554a0bd886167de144f0d593ed2e6ad7 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Fri, 16 Feb 2024 12:06:46 +0000
Subject: [PATCH 41/70] =?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 920ae414d..6a366b06c 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/learn/index.md`. PR [#11142](https://github.com/tiangolo/fastapi/pull/11142) by [@hsuanchi](https://github.com/hsuanchi).
 * 🌐 Add Korean translation for `/docs/ko/docs/tutorial/dependencies/global-dependencies.md`. PR [#11123](https://github.com/tiangolo/fastapi/pull/11123) by [@riroan](https://github.com/riroan).
 * 🌐 Add Korean translation for `/docs/ko/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md`. PR [#11124](https://github.com/tiangolo/fastapi/pull/11124) by [@riroan](https://github.com/riroan).
 * 🌐 Add Korean translation for `/docs/ko/docs/tutorial/schema-extra-example.md`. PR [#11121](https://github.com/tiangolo/fastapi/pull/11121) by [@KaniKim](https://github.com/KaniKim).

From ec464f0938a7c623d3acad1eb8ca0b069cf799d2 Mon Sep 17 00:00:00 2001
From: Nils Lindemann <nilslindemann@tutanota.com>
Date: Sun, 18 Feb 2024 13:18:33 +0100
Subject: [PATCH 42/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20German=20translation?=
 =?UTF-8?q?=20for=20`docs/de/docs/newsletter.md`=20(#10853)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/de/docs/newsletter.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 docs/de/docs/newsletter.md

diff --git a/docs/de/docs/newsletter.md b/docs/de/docs/newsletter.md
new file mode 100644
index 000000000..31995b164
--- /dev/null
+++ b/docs/de/docs/newsletter.md
@@ -0,0 +1,5 @@
+# FastAPI und Freunde Newsletter
+
+<iframe data-w-type="embedded" frameborder="0" scrolling="no" marginheight="0" marginwidth="0" src="https://xr4n4.mjt.lu/wgt/xr4n4/hj5/form?c=40a44fa4" width="100%" style="height: 0;"></iframe>
+
+<script type="text/javascript" src="https://app.mailjet.com/pas-nc-embedded-v1.js"></script>

From 122713b168f0538eba33f0ad4a921e9409ff5055 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 18 Feb 2024 12:18:59 +0000
Subject: [PATCH 43/70] =?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 6a366b06c..5ee0017a2 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add German translation for `docs/de/docs/newsletter.md`. PR [#10853](https://github.com/tiangolo/fastapi/pull/10853) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/learn/index.md`. PR [#11142](https://github.com/tiangolo/fastapi/pull/11142) by [@hsuanchi](https://github.com/hsuanchi).
 * 🌐 Add Korean translation for `/docs/ko/docs/tutorial/dependencies/global-dependencies.md`. PR [#11123](https://github.com/tiangolo/fastapi/pull/11123) by [@riroan](https://github.com/riroan).
 * 🌐 Add Korean translation for `/docs/ko/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md`. PR [#11124](https://github.com/tiangolo/fastapi/pull/11124) by [@riroan](https://github.com/riroan).

From 73ca60c273977e98a7632871653e3c0ad3dad4f8 Mon Sep 17 00:00:00 2001
From: Nils Lindemann <nilslindemann@tutanota.com>
Date: Sun, 18 Feb 2024 13:19:32 +0100
Subject: [PATCH 44/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20German=20translation?=
 =?UTF-8?q?=20for=20`docs/de/docs/reference/fastapi.md`=20(#10813)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/de/docs/reference/fastapi.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 docs/de/docs/reference/fastapi.md

diff --git a/docs/de/docs/reference/fastapi.md b/docs/de/docs/reference/fastapi.md
new file mode 100644
index 000000000..4e6a56971
--- /dev/null
+++ b/docs/de/docs/reference/fastapi.md
@@ -0,0 +1,31 @@
+# `FastAPI`-Klasse
+
+Hier sind die Referenzinformationen für die Klasse `FastAPI` mit all ihren Parametern, Attributen und Methoden.
+
+Sie können die `FastAPI`-Klasse direkt von `fastapi` importieren:
+
+```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

From 7ca6f1cd1aeb3f148df22af9375069cc82f3c06c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Emirhan=20Soyta=C5=9F?= <emrhns61@hotmail.com>
Date: Sun, 18 Feb 2024 15:20:41 +0300
Subject: [PATCH 45/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20Turkish=20translatio?=
 =?UTF-8?q?n=20for=20`docs/tr/docs/tutorial/query-params.md`=20(#11078)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/tr/docs/tutorial/query-params.md | 227 ++++++++++++++++++++++++++
 1 file changed, 227 insertions(+)
 create mode 100644 docs/tr/docs/tutorial/query-params.md

diff --git a/docs/tr/docs/tutorial/query-params.md b/docs/tr/docs/tutorial/query-params.md
new file mode 100644
index 000000000..61232d5b3
--- /dev/null
+++ b/docs/tr/docs/tutorial/query-params.md
@@ -0,0 +1,227 @@
+# Sorgu Parametreleri
+
+Fonksiyonda yol parametrelerinin parçası olmayan diğer tanımlamalar otomatik olarak "sorgu" parametresi olarak yorumlanır.
+
+```Python hl_lines="9"
+{!../../../docs_src/query_params/tutorial001.py!}
+```
+
+Sorgu, bağlantıdaki `?` kısmından sonra gelen ve `&` işareti ile ayrılan anahtar-değer çiftlerinin oluşturduğu bir kümedir.
+
+Örneğin, aşağıdaki bağlantıda:
+
+```
+http://127.0.0.1:8000/items/?skip=0&limit=10
+```
+
+...sorgu parametreleri şunlardır:
+
+* `skip`: değeri `0`'dır
+* `limit`: değeri `10`'dır
+
+Parametreler bağlantının bir parçası oldukları için doğal olarak string olarak değerlendirilirler.
+
+Fakat, Python tipleri ile tanımlandıkları zaman (yukarıdaki örnekte `int` oldukları gibi), parametreler o tiplere dönüştürülür ve o tipler çerçevesinde doğrulanırlar.
+
+Yol parametreleri için geçerli olan her türlü işlem aynı şekilde sorgu parametreleri için de geçerlidir:
+
+* Editör desteği (şüphesiz)
+* Veri "<abbr title="HTTP isteği ile birlikte gelen string'i Python verisine dönüştürme">ayrıştırma</abbr>"
+* Veri doğrulama
+* Otomatik dokümantasyon
+
+## Varsayılanlar
+
+Sorgu parametreleri, adres yolunun sabit bir parçası olmadıklarından dolayı isteğe bağlı ve varsayılan değere sahip olabilirler.
+
+Yukarıdaki örnekte `skip=0` ve `limit=10` varsayılan değere sahiplerdir.
+
+Yani, aşağıdaki bağlantıya gitmek:
+
+```
+http://127.0.0.1:8000/items/
+```
+
+şu adrese gitmek ile aynı etkiye sahiptir:
+
+```
+http://127.0.0.1:8000/items/?skip=0&limit=10
+```
+
+Ancak, mesela şöyle bir adresi ziyaret ederseniz:
+
+```
+http://127.0.0.1:8000/items/?skip=20
+```
+
+Fonksiyonunuzdaki parametre değerleri aşağıdaki gibi olacaktır:
+
+* `skip=20`: çünkü bağlantıda böyle tanımlandı.
+* `limit=10`: çünkü varsayılan değer buydu.
+
+## İsteğe Bağlı Parametreler
+
+Aynı şekilde, varsayılan değerlerini `None` olarak atayarak isteğe bağlı parametreler tanımlayabilirsiniz:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/query_params/tutorial002_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/query_params/tutorial002.py!}
+    ```
+
+Bu durumda, `q` fonksiyon parametresi isteğe bağlı olacak ve varsayılan değer olarak `None` alacaktır.
+
+!!! check "Ek bilgi"
+    Ayrıca, dikkatinizi çekerim ki; **FastAPI**, `item_id` parametresinin bir yol parametresi olduğunu ve `q` parametresinin yol değil bir sorgu parametresi olduğunu fark edecek kadar beceriklidir.
+
+## Sorgu Parametresi Tip Dönüşümü
+
+Aşağıda görüldüğü gibi dönüştürülmek üzere `bool` tipleri de tanımlayabilirsiniz:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/query_params/tutorial003_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/query_params/tutorial003.py!}
+    ```
+
+Bu durumda, eğer şu adrese giderseniz:
+
+```
+http://127.0.0.1:8000/items/foo?short=1
+```
+
+veya
+
+```
+http://127.0.0.1:8000/items/foo?short=True
+```
+
+veya
+
+```
+http://127.0.0.1:8000/items/foo?short=true
+```
+
+veya
+
+```
+http://127.0.0.1:8000/items/foo?short=on
+```
+
+veya
+
+```
+http://127.0.0.1:8000/items/foo?short=yes
+```
+
+veya adres, herhangi farklı bir harf varyasyonu içermesi durumuna rağmen (büyük harf, sadece baş harfi büyük kelime, vb.) fonksiyonunuz, `bool` tipli `short` parametresini `True` olarak algılayacaktır. Aksi halde `False` olarak algılanacaktır.
+
+
+## Çoklu Yol ve Sorgu Parametreleri
+
+**FastAPI** neyin ne olduğunu ayırt edebileceğinden dolayı aynı anda birden fazla yol ve sorgu parametresi tanımlayabilirsiniz.
+
+Ve parametreleri, herhangi bir sıraya koymanıza da gerek yoktur.
+
+İsimlerine göre belirleneceklerdir:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="6  8"
+    {!> ../../../docs_src/query_params/tutorial004_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="8  10"
+    {!> ../../../docs_src/query_params/tutorial004.py!}
+    ```
+
+## Zorunlu Sorgu Parametreleri
+
+Türü yol olmayan bir parametre (şu ana kadar sadece sorgu parametrelerini gördük) için varsayılan değer tanımlarsanız o parametre zorunlu olmayacaktır.
+
+Parametre için belirli bir değer atamak istemeyip parametrenin sadece isteğe bağlı olmasını istiyorsanız değerini `None` olarak atayabilirsiniz.
+
+Fakat, bir sorgu parametresini zorunlu yapmak istiyorsanız varsayılan bir değer atamamanız yeterli olacaktır:
+
+```Python hl_lines="6-7"
+{!../../../docs_src/query_params/tutorial005.py!}
+```
+
+Burada `needy` parametresi `str` tipinden oluşan zorunlu bir sorgu parametresidir.
+
+Eğer tarayıcınızda şu bağlantıyı:
+
+```
+http://127.0.0.1:8000/items/foo-item
+```
+
+...`needy` parametresini eklemeden açarsanız şuna benzer bir hata ile karşılaşırsınız:
+
+```JSON
+{
+  "detail": [
+    {
+      "type": "missing",
+      "loc": [
+        "query",
+        "needy"
+      ],
+      "msg": "Field required",
+      "input": null,
+      "url": "https://errors.pydantic.dev/2.1/v/missing"
+    }
+  ]
+}
+```
+
+`needy` zorunlu bir parametre olduğundan dolayı bağlantıda tanımlanması gerekir:
+
+```
+http://127.0.0.1:8000/items/foo-item?needy=sooooneedy
+```
+
+...bu iş görür:
+
+```JSON
+{
+    "item_id": "foo-item",
+    "needy": "sooooneedy"
+}
+```
+
+Ve elbette, bazı parametreleri zorunlu, bazılarını varsayılan değerli ve bazılarını tamamen opsiyonel olarak tanımlayabilirsiniz:
+
+=== "Python 3.10+"
+
+    ```Python hl_lines="8"
+    {!> ../../../docs_src/query_params/tutorial006_py310.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/query_params/tutorial006.py!}
+    ```
+
+Bu durumda, 3 tane sorgu parametresi var olacaktır:
+
+* `needy`, zorunlu bir `str`.
+* `skip`, varsayılan değeri `0` olan bir `int`.
+* `limit`, isteğe bağlı bir `int`.
+
+!!! tip "İpucu"
+        Ayrıca, [Yol Parametreleri](path-params.md#predefined-values){.internal-link target=_blank}nde de kullanıldığı şekilde `Enum` sınıfından faydalanabilirsiniz.

From f1ff930e6828088cd39b0045af0110bba410f73e Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 18 Feb 2024 12:20:55 +0000
Subject: [PATCH 46/70] =?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 5ee0017a2..b23e0c897 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add German translation for `docs/de/docs/reference/fastapi.md`. PR [#10813](https://github.com/tiangolo/fastapi/pull/10813) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Add German translation for `docs/de/docs/newsletter.md`. PR [#10853](https://github.com/tiangolo/fastapi/pull/10853) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/learn/index.md`. PR [#11142](https://github.com/tiangolo/fastapi/pull/11142) by [@hsuanchi](https://github.com/hsuanchi).
 * 🌐 Add Korean translation for `/docs/ko/docs/tutorial/dependencies/global-dependencies.md`. PR [#11123](https://github.com/tiangolo/fastapi/pull/11123) by [@riroan](https://github.com/riroan).

From 3808d618fdebdd54840e8b8ba5252d4c2edb4c64 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 18 Feb 2024 12:21:32 +0000
Subject: [PATCH 47/70] =?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 b23e0c897..98fea7bb4 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add Turkish translation for `docs/tr/docs/tutorial/query-params.md`. PR [#11078](https://github.com/tiangolo/fastapi/pull/11078) by [@emrhnsyts](https://github.com/emrhnsyts).
 * 🌐 Add German translation for `docs/de/docs/reference/fastapi.md`. PR [#10813](https://github.com/tiangolo/fastapi/pull/10813) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Add German translation for `docs/de/docs/newsletter.md`. PR [#10853](https://github.com/tiangolo/fastapi/pull/10853) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Add Traditional Chinese translation for `docs/zh-hant/docs/learn/index.md`. PR [#11142](https://github.com/tiangolo/fastapi/pull/11142) by [@hsuanchi](https://github.com/hsuanchi).

From 6062ec86f3039f044a9bafa637b2544947c12afc Mon Sep 17 00:00:00 2001
From: Nils Lindemann <nilslindemann@tutanota.com>
Date: Mon, 19 Feb 2024 16:53:18 +0100
Subject: [PATCH 48/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20German=20translation?=
 =?UTF-8?q?=20for=20`docs/de/docs/reference/request.md`=20(#10821)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/de/docs/reference/request.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)
 create mode 100644 docs/de/docs/reference/request.md

diff --git a/docs/de/docs/reference/request.md b/docs/de/docs/reference/request.md
new file mode 100644
index 000000000..b170c1e40
--- /dev/null
+++ b/docs/de/docs/reference/request.md
@@ -0,0 +1,14 @@
+# `Request`-Klasse
+
+Sie können einen Parameter in einer *Pfadoperation-Funktion* oder einer Abhängigkeit als vom Typ `Request` deklarieren und dann direkt auf das Requestobjekt zugreifen, ohne jegliche Validierung, usw.
+
+Sie können es direkt von `fastapi` importieren:
+
+```python
+from fastapi import Request
+```
+
+!!! tip "Tipp"
+    Wenn Sie Abhängigkeiten definieren möchten, die sowohl mit HTTP als auch mit WebSockets kompatibel sein sollen, können Sie einen Parameter definieren, der eine `HTTPConnection` anstelle eines `Request` oder eines `WebSocket` akzeptiert.
+
+::: fastapi.Request

From 646e7eb3c7cc28572fbf3183b8784077a652e2c6 Mon Sep 17 00:00:00 2001
From: Nils Lindemann <nilslindemann@tutanota.com>
Date: Mon, 19 Feb 2024 16:53:39 +0100
Subject: [PATCH 49/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20German=20translation?=
 =?UTF-8?q?=20for=20`docs/de/docs/reference/responses.md`=20(#10825)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/de/docs/reference/responses.md | 164 ++++++++++++++++++++++++++++
 1 file changed, 164 insertions(+)
 create mode 100644 docs/de/docs/reference/responses.md

diff --git a/docs/de/docs/reference/responses.md b/docs/de/docs/reference/responses.md
new file mode 100644
index 000000000..c0e9f07e7
--- /dev/null
+++ b/docs/de/docs/reference/responses.md
@@ -0,0 +1,164 @@
+# Benutzerdefinierte Responseklassen – File, HTML, Redirect, Streaming, usw.
+
+Es gibt mehrere benutzerdefinierte Responseklassen, von denen Sie eine Instanz erstellen und diese direkt von Ihren *Pfadoperationen* zurückgeben können.
+
+Lesen Sie mehr darüber in der [FastAPI-Dokumentation zu benutzerdefinierten Responses – HTML, Stream, Datei, andere](../advanced/custom-response.md).
+
+Sie können diese direkt von `fastapi.responses` importieren:
+
+```python
+from fastapi.responses import (
+    FileResponse,
+    HTMLResponse,
+    JSONResponse,
+    ORJSONResponse,
+    PlainTextResponse,
+    RedirectResponse,
+    Response,
+    StreamingResponse,
+    UJSONResponse,
+)
+```
+
+## FastAPI-Responses
+
+Es gibt einige benutzerdefinierte FastAPI-Responseklassen, welche Sie verwenden können, um die JSON-Performanz zu optimieren.
+
+::: 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

From ce1a358cbf2567012c7f85ab8b941752b1f95a39 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 19 Feb 2024 15:53:44 +0000
Subject: [PATCH 50/70] =?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 98fea7bb4..833dad61f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add German translation for `docs/de/docs/reference/request.md`. PR [#10821](https://github.com/tiangolo/fastapi/pull/10821) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Add Turkish translation for `docs/tr/docs/tutorial/query-params.md`. PR [#11078](https://github.com/tiangolo/fastapi/pull/11078) by [@emrhnsyts](https://github.com/emrhnsyts).
 * 🌐 Add German translation for `docs/de/docs/reference/fastapi.md`. PR [#10813](https://github.com/tiangolo/fastapi/pull/10813) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Add German translation for `docs/de/docs/newsletter.md`. PR [#10853](https://github.com/tiangolo/fastapi/pull/10853) by [@nilslindemann](https://github.com/nilslindemann).

From d0b143916ca1bb83e0cff25b7f36e7a0bf003ae3 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 19 Feb 2024 15:54:37 +0000
Subject: [PATCH 51/70] =?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 833dad61f..2c25f82ae 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add German translation for `docs/de/docs/reference/responses.md`. PR [#10825](https://github.com/tiangolo/fastapi/pull/10825) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Add German translation for `docs/de/docs/reference/request.md`. PR [#10821](https://github.com/tiangolo/fastapi/pull/10821) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Add Turkish translation for `docs/tr/docs/tutorial/query-params.md`. PR [#11078](https://github.com/tiangolo/fastapi/pull/11078) by [@emrhnsyts](https://github.com/emrhnsyts).
 * 🌐 Add German translation for `docs/de/docs/reference/fastapi.md`. PR [#10813](https://github.com/tiangolo/fastapi/pull/10813) by [@nilslindemann](https://github.com/nilslindemann).

From 073a05ebdd395bea1317c3a52e9a40c7fd45df64 Mon Sep 17 00:00:00 2001
From: Nils Lindemann <nilslindemann@tutanota.com>
Date: Mon, 19 Feb 2024 16:54:52 +0100
Subject: [PATCH 52/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20German=20translation?=
 =?UTF-8?q?=20for=20`docs/de/docs/reference/encoders.md`=20(#10840)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/de/docs/reference/encoders.md | 3 +++
 1 file changed, 3 insertions(+)
 create mode 100644 docs/de/docs/reference/encoders.md

diff --git a/docs/de/docs/reference/encoders.md b/docs/de/docs/reference/encoders.md
new file mode 100644
index 000000000..2489b8c60
--- /dev/null
+++ b/docs/de/docs/reference/encoders.md
@@ -0,0 +1,3 @@
+# Encoder – `jsonable_encoder`
+
+::: fastapi.encoders.jsonable_encoder

From e76977bb3575547f1229a8b319724593302cefb5 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 19 Feb 2024 15:57:07 +0000
Subject: [PATCH 53/70] =?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 2c25f82ae..a02bf2a1d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add German translation for `docs/de/docs/reference/encoders.md`. PR [#10840](https://github.com/tiangolo/fastapi/pull/10840) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Add German translation for `docs/de/docs/reference/responses.md`. PR [#10825](https://github.com/tiangolo/fastapi/pull/10825) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Add German translation for `docs/de/docs/reference/request.md`. PR [#10821](https://github.com/tiangolo/fastapi/pull/10821) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Add Turkish translation for `docs/tr/docs/tutorial/query-params.md`. PR [#11078](https://github.com/tiangolo/fastapi/pull/11078) by [@emrhnsyts](https://github.com/emrhnsyts).

From e52bf9628f270a7e7c6fba2a99925d6e53cb30b7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Hasan=20Sezer=20Ta=C5=9Fan?=
 <13135006+hasansezertasan@users.noreply.github.com>
Date: Mon, 19 Feb 2024 21:46:02 +0300
Subject: [PATCH 54/70] =?UTF-8?q?=F0=9F=8C=90=20Update=20Turkish=20transla?=
 =?UTF-8?q?tion=20for=20`docs/tr/docs/tutorial/query-params.md`=20(#11162)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

diff --git a/docs/tr/docs/tutorial/query-params.md b/docs/tr/docs/tutorial/query-params.md
index 61232d5b3..aa3915557 100644
--- a/docs/tr/docs/tutorial/query-params.md
+++ b/docs/tr/docs/tutorial/query-params.md
@@ -224,4 +224,4 @@ Bu durumda, 3 tane sorgu parametresi var olacaktır:
 * `limit`, isteğe bağlı bir `int`.
 
 !!! tip "İpucu"
-        Ayrıca, [Yol Parametreleri](path-params.md#predefined-values){.internal-link target=_blank}nde de kullanıldığı şekilde `Enum` sınıfından faydalanabilirsiniz.
+    Ayrıca, [Yol Parametrelerinde](path-params.md#predefined-values){.internal-link target=_blank} de kullanıldığı şekilde `Enum` sınıfından faydalanabilirsiniz.

From a6bc32a61a2f57645d5535d076e38b0b3eb4138d Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Mon, 19 Feb 2024 18:46:23 +0000
Subject: [PATCH 55/70] =?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 a02bf2a1d..d98faea4d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,7 @@ hide:
 
 ### Translations
 
+* 🌐 Update Turkish translation for `docs/tr/docs/tutorial/query-params.md`. PR [#11162](https://github.com/tiangolo/fastapi/pull/11162) by [@hasansezertasan](https://github.com/hasansezertasan).
 * 🌐 Add German translation for `docs/de/docs/reference/encoders.md`. PR [#10840](https://github.com/tiangolo/fastapi/pull/10840) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Add German translation for `docs/de/docs/reference/responses.md`. PR [#10825](https://github.com/tiangolo/fastapi/pull/10825) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Add German translation for `docs/de/docs/reference/request.md`. PR [#10821](https://github.com/tiangolo/fastapi/pull/10821) by [@nilslindemann](https://github.com/nilslindemann).

From 626b066e56e39162f328431395856c959d150bc4 Mon Sep 17 00:00:00 2001
From: Nils Lindemann <nilslindemann@tutanota.com>
Date: Wed, 21 Feb 2024 23:23:00 +0100
Subject: [PATCH 56/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20German=20translation?=
 =?UTF-8?q?=20for=20`docs/de/docs/external-links.md`=20(#10852)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/de/docs/external-links.md | 36 ++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 docs/de/docs/external-links.md

diff --git a/docs/de/docs/external-links.md b/docs/de/docs/external-links.md
new file mode 100644
index 000000000..d97f4d39c
--- /dev/null
+++ b/docs/de/docs/external-links.md
@@ -0,0 +1,36 @@
+# Externe Links und Artikel
+
+**FastAPI** hat eine großartige Community, die ständig wächst.
+
+Es gibt viele Beiträge, Artikel, Tools und Projekte zum Thema **FastAPI**.
+
+Hier ist eine unvollständige Liste einiger davon.
+
+!!! tip "Tipp"
+    Wenn Sie einen Artikel, ein Projekt, ein Tool oder irgendetwas im Zusammenhang mit **FastAPI** haben, was hier noch nicht aufgeführt ist, erstellen Sie einen <a href="https://github.com/tiangolo/fastapi/edit/master/docs/en/data/external_links.yml" class="external-link" target="_blank">Pull Request und fügen Sie es hinzu</a>.
+
+!!! note "Hinweis Deutsche Übersetzung"
+    Die folgenden Überschriften und Links werden aus einer <a href="https://github.com/tiangolo/fastapi/blob/master/docs/en/data/external_links.yml" class="external-link" target="_blank">anderen Datei</a> gelesen und sind daher nicht ins Deutsche übersetzt.
+
+{% for section_name, section_content in external_links.items() %}
+
+## {{ section_name }}
+
+{% for lang_name, lang_content in section_content.items() %}
+
+### {{ lang_name }}
+
+{% for item in lang_content %}
+
+* <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>.
+
+{% endfor %}
+{% endfor %}
+{% endfor %}
+
+## Projekte
+
+Die neuesten GitHub-Projekte zum Thema `fastapi`:
+
+<div class="github-topic-projects">
+</div>

From 5da35ff980a9477675929ddc0643e7eb27ea6208 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 21 Feb 2024 22:23:21 +0000
Subject: [PATCH 57/70] =?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 d98faea4d..d8d87ca46 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add German translation for `docs/de/docs/external-links.md`. PR [#10852](https://github.com/tiangolo/fastapi/pull/10852) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Update Turkish translation for `docs/tr/docs/tutorial/query-params.md`. PR [#11162](https://github.com/tiangolo/fastapi/pull/11162) by [@hasansezertasan](https://github.com/hasansezertasan).
 * 🌐 Add German translation for `docs/de/docs/reference/encoders.md`. PR [#10840](https://github.com/tiangolo/fastapi/pull/10840) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Add German translation for `docs/de/docs/reference/responses.md`. PR [#10825](https://github.com/tiangolo/fastapi/pull/10825) by [@nilslindemann](https://github.com/nilslindemann).

From dec45c534f97bb5635492cba78a93f1409ec6b2a Mon Sep 17 00:00:00 2001
From: Nils Lindemann <nilslindemann@tutanota.com>
Date: Wed, 21 Feb 2024 23:26:02 +0100
Subject: [PATCH 58/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20German=20translation?=
 =?UTF-8?q?=20for=20`docs/de/docs/reference/templating.md`=20(#10842)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/de/docs/reference/templating.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 docs/de/docs/reference/templating.md

diff --git a/docs/de/docs/reference/templating.md b/docs/de/docs/reference/templating.md
new file mode 100644
index 000000000..c367a0179
--- /dev/null
+++ b/docs/de/docs/reference/templating.md
@@ -0,0 +1,13 @@
+# Templating – `Jinja2Templates`
+
+Sie können die `Jinja2Templates`-Klasse verwenden, um Jinja-Templates zu rendern.
+
+Lesen Sie mehr darüber in der [FastAPI-Dokumentation zu Templates](../advanced/templates.md).
+
+Sie können die Klasse direkt von `fastapi.templating` importieren:
+
+```python
+from fastapi.templating import Jinja2Templates
+```
+
+::: fastapi.templating.Jinja2Templates

From 9210e6a330bc9639fcb3315a493e39aa2119d142 Mon Sep 17 00:00:00 2001
From: Nils Lindemann <nilslindemann@tutanota.com>
Date: Wed, 21 Feb 2024 23:26:48 +0100
Subject: [PATCH 59/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20German=20translation?=
 =?UTF-8?q?=20for=20`docs/de/docs/reference/background.md`=20(#10820)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/de/docs/reference/background.md | 11 +++++++++++
 1 file changed, 11 insertions(+)
 create mode 100644 docs/de/docs/reference/background.md

diff --git a/docs/de/docs/reference/background.md b/docs/de/docs/reference/background.md
new file mode 100644
index 000000000..0fd389325
--- /dev/null
+++ b/docs/de/docs/reference/background.md
@@ -0,0 +1,11 @@
+# Hintergrundtasks – `BackgroundTasks`
+
+Sie können einen Parameter in einer *Pfadoperation-Funktion* oder einer Abhängigkeitsfunktion mit dem Typ `BackgroundTasks` deklarieren und diesen danach verwenden, um die Ausführung von Hintergrundtasks nach dem Senden der Response zu definieren.
+
+Sie können `BackgroundTasks` direkt von `fastapi` importieren:
+
+```python
+from fastapi import BackgroundTasks
+```
+
+::: fastapi.BackgroundTasks

From cb938740145c5d0cea78a26bc0a7215aae4506b9 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 21 Feb 2024 22:27:17 +0000
Subject: [PATCH 60/70] =?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 d8d87ca46..7251a4f91 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add German translation for `docs/de/docs/reference/templating.md`. PR [#10842](https://github.com/tiangolo/fastapi/pull/10842) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Add German translation for `docs/de/docs/external-links.md`. PR [#10852](https://github.com/tiangolo/fastapi/pull/10852) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Update Turkish translation for `docs/tr/docs/tutorial/query-params.md`. PR [#11162](https://github.com/tiangolo/fastapi/pull/11162) by [@hasansezertasan](https://github.com/hasansezertasan).
 * 🌐 Add German translation for `docs/de/docs/reference/encoders.md`. PR [#10840](https://github.com/tiangolo/fastapi/pull/10840) by [@nilslindemann](https://github.com/nilslindemann).

From 6336604906d50e0aca978d15ef82236bac23fb15 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 21 Feb 2024 22:27:53 +0000
Subject: [PATCH 61/70] =?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 7251a4f91..e595ed927 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -14,6 +14,7 @@ hide:
 
 ### Translations
 
+* 🌐 Add German translation for `docs/de/docs/reference/background.md`. PR [#10820](https://github.com/tiangolo/fastapi/pull/10820) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Add German translation for `docs/de/docs/reference/templating.md`. PR [#10842](https://github.com/tiangolo/fastapi/pull/10842) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Add German translation for `docs/de/docs/external-links.md`. PR [#10852](https://github.com/tiangolo/fastapi/pull/10852) by [@nilslindemann](https://github.com/nilslindemann).
 * 🌐 Update Turkish translation for `docs/tr/docs/tutorial/query-params.md`. PR [#11162](https://github.com/tiangolo/fastapi/pull/11162) by [@hasansezertasan](https://github.com/hasansezertasan).

From bf771bd7817f8e8348f85836a21d1e96c0b4f7a2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sun, 25 Feb 2024 00:06:37 +0100
Subject: [PATCH 62/70] =?UTF-8?q?=F0=9F=90=9B=20Fix=20unhandled=20growing?=
 =?UTF-8?q?=20memory=20for=20internal=20server=20errors,=20refactor=20depe?=
 =?UTF-8?q?ndencies=20with=20`yield`=20and=20`except`=20to=20require=20rai?=
 =?UTF-8?q?sing=20again=20as=20in=20regular=20Python=20(#11191)?=
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>
---
 .../dependencies/dependencies-with-yield.md   |  70 +++++++++++-
 docs_src/dependencies/tutorial008c.py         |  27 +++++
 docs_src/dependencies/tutorial008c_an.py      |  28 +++++
 docs_src/dependencies/tutorial008c_an_py39.py |  29 +++++
 docs_src/dependencies/tutorial008d.py         |  28 +++++
 docs_src/dependencies/tutorial008d_an.py      |  29 +++++
 docs_src/dependencies/tutorial008d_an_py39.py |  30 +++++
 fastapi/routing.py                            | 108 ++++++++----------
 tests/test_dependency_contextmanager.py       |   2 +
 tests/test_dependency_normal_exceptions.py    |   1 +
 .../test_tutorial008b_an_py39.py              |  22 +++-
 .../test_dependencies/test_tutorial008c.py    |  38 ++++++
 .../test_dependencies/test_tutorial008c_an.py |  38 ++++++
 .../test_tutorial008c_an_py39.py              |  44 +++++++
 .../test_dependencies/test_tutorial008d.py    |  41 +++++++
 .../test_dependencies/test_tutorial008d_an.py |  41 +++++++
 .../test_tutorial008d_an_py39.py              |  47 ++++++++
 17 files changed, 554 insertions(+), 69 deletions(-)
 create mode 100644 docs_src/dependencies/tutorial008c.py
 create mode 100644 docs_src/dependencies/tutorial008c_an.py
 create mode 100644 docs_src/dependencies/tutorial008c_an_py39.py
 create mode 100644 docs_src/dependencies/tutorial008d.py
 create mode 100644 docs_src/dependencies/tutorial008d_an.py
 create mode 100644 docs_src/dependencies/tutorial008d_an_py39.py
 create mode 100644 tests/test_tutorial/test_dependencies/test_tutorial008c.py
 create mode 100644 tests/test_tutorial/test_dependencies/test_tutorial008c_an.py
 create mode 100644 tests/test_tutorial/test_dependencies/test_tutorial008c_an_py39.py
 create mode 100644 tests/test_tutorial/test_dependencies/test_tutorial008d.py
 create mode 100644 tests/test_tutorial/test_dependencies/test_tutorial008d_an.py
 create mode 100644 tests/test_tutorial/test_dependencies/test_tutorial008d_an_py39.py

diff --git a/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md b/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
index de87ba315..ad5aed932 100644
--- a/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
+++ b/docs/en/docs/tutorial/dependencies/dependencies-with-yield.md
@@ -162,6 +162,63 @@ The same way, you could raise an `HTTPException` or similar in the exit code, af
 
 An alternative you could use to catch exceptions (and possibly also raise another `HTTPException`) is to create a [Custom Exception Handler](../handling-errors.md#install-custom-exception-handlers){.internal-link target=_blank}.
 
+## Dependencies with `yield` and `except`
+
+If you catch an exception using `except` in a dependency with `yield` and you don't raise it again (or raise a new exception), FastAPI won't be able to notice there was an exception, the same way that would happen with regular Python:
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="15-16"
+    {!> ../../../docs_src/dependencies/tutorial008c_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="14-15"
+    {!> ../../../docs_src/dependencies/tutorial008c_an.py!}
+    ```
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        Prefer to use the `Annotated` version if possible.
+
+    ```Python hl_lines="13-14"
+    {!> ../../../docs_src/dependencies/tutorial008c.py!}
+    ```
+
+In this case, the client will see an *HTTP 500 Internal Server Error* response as it should, given that we are not raising an `HTTPException` or similar, but the server will **not have any logs** or any other indication of what was the error. 😱
+
+### Always `raise` in Dependencies with `yield` and `except`
+
+If you catch an exception in a dependency with `yield`, unless you are raising another `HTTPException` or similar, you should re-raise the original exception.
+
+You can re-raise the same exception using `raise`:
+
+=== "Python 3.9+"
+
+    ```Python hl_lines="17"
+    {!> ../../../docs_src/dependencies/tutorial008d_an_py39.py!}
+    ```
+
+=== "Python 3.8+"
+
+    ```Python hl_lines="16"
+    {!> ../../../docs_src/dependencies/tutorial008d_an.py!}
+    ```
+
+
+=== "Python 3.8+ non-Annotated"
+
+    !!! tip
+        Prefer to use the `Annotated` version if possible.
+
+    ```Python hl_lines="15"
+    {!> ../../../docs_src/dependencies/tutorial008d.py!}
+    ```
+
+Now the client will get the same *HTTP 500 Internal Server Error* response, but the server will have our custom `InternalError` in the logs. 😎
+
 ## 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.
@@ -187,7 +244,6 @@ participant tasks as Background tasks
         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
     end
@@ -210,15 +266,23 @@ participant tasks as Background tasks
 !!! tip
     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.
+    If you raise any exception, it will be passed to the dependencies with yield, including `HTTPException`. In most cases you will want to re-raise that same exception or a new one from the dependency with `yield` to make sure it's properly handled.
 
-## Dependencies with `yield`, `HTTPException` and Background Tasks
+## Dependencies with `yield`, `HTTPException`, `except` 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.
 
+### Dependencies with `yield` and `except`, Technical Details
+
+Before FastAPI 0.110.0, if you used a dependency with `yield`, and then you captured an exception with `except` in that dependency, and you didn't raise the exception again, the exception would be automatically raised/forwarded to any exception handlers or the internal server error handler.
+
+This was changed in version 0.110.0 to fix unhandled memory consumption from forwarded exceptions without a handler (internal server errors), and to make it consistent with the behavior of regular Python code.
+
+### Background Tasks and Dependencies with `yield`, Technical Details
+
 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.
diff --git a/docs_src/dependencies/tutorial008c.py b/docs_src/dependencies/tutorial008c.py
new file mode 100644
index 000000000..4b99a5a31
--- /dev/null
+++ b/docs_src/dependencies/tutorial008c.py
@@ -0,0 +1,27 @@
+from fastapi import Depends, FastAPI, HTTPException
+
+app = FastAPI()
+
+
+class InternalError(Exception):
+    pass
+
+
+def get_username():
+    try:
+        yield "Rick"
+    except InternalError:
+        print("Oops, we didn't raise again, Britney 😱")
+
+
+@app.get("/items/{item_id}")
+def get_item(item_id: str, username: str = Depends(get_username)):
+    if item_id == "portal-gun":
+        raise InternalError(
+            f"The portal gun is too dangerous to be owned by {username}"
+        )
+    if item_id != "plumbus":
+        raise HTTPException(
+            status_code=404, detail="Item not found, there's only a plumbus here"
+        )
+    return item_id
diff --git a/docs_src/dependencies/tutorial008c_an.py b/docs_src/dependencies/tutorial008c_an.py
new file mode 100644
index 000000000..94f59f9aa
--- /dev/null
+++ b/docs_src/dependencies/tutorial008c_an.py
@@ -0,0 +1,28 @@
+from fastapi import Depends, FastAPI, HTTPException
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class InternalError(Exception):
+    pass
+
+
+def get_username():
+    try:
+        yield "Rick"
+    except InternalError:
+        print("Oops, we didn't raise again, Britney 😱")
+
+
+@app.get("/items/{item_id}")
+def get_item(item_id: str, username: Annotated[str, Depends(get_username)]):
+    if item_id == "portal-gun":
+        raise InternalError(
+            f"The portal gun is too dangerous to be owned by {username}"
+        )
+    if item_id != "plumbus":
+        raise HTTPException(
+            status_code=404, detail="Item not found, there's only a plumbus here"
+        )
+    return item_id
diff --git a/docs_src/dependencies/tutorial008c_an_py39.py b/docs_src/dependencies/tutorial008c_an_py39.py
new file mode 100644
index 000000000..da92efa9c
--- /dev/null
+++ b/docs_src/dependencies/tutorial008c_an_py39.py
@@ -0,0 +1,29 @@
+from typing import Annotated
+
+from fastapi import Depends, FastAPI, HTTPException
+
+app = FastAPI()
+
+
+class InternalError(Exception):
+    pass
+
+
+def get_username():
+    try:
+        yield "Rick"
+    except InternalError:
+        print("Oops, we didn't raise again, Britney 😱")
+
+
+@app.get("/items/{item_id}")
+def get_item(item_id: str, username: Annotated[str, Depends(get_username)]):
+    if item_id == "portal-gun":
+        raise InternalError(
+            f"The portal gun is too dangerous to be owned by {username}"
+        )
+    if item_id != "plumbus":
+        raise HTTPException(
+            status_code=404, detail="Item not found, there's only a plumbus here"
+        )
+    return item_id
diff --git a/docs_src/dependencies/tutorial008d.py b/docs_src/dependencies/tutorial008d.py
new file mode 100644
index 000000000..93039343d
--- /dev/null
+++ b/docs_src/dependencies/tutorial008d.py
@@ -0,0 +1,28 @@
+from fastapi import Depends, FastAPI, HTTPException
+
+app = FastAPI()
+
+
+class InternalError(Exception):
+    pass
+
+
+def get_username():
+    try:
+        yield "Rick"
+    except InternalError:
+        print("We don't swallow the internal error here, we raise again 😎")
+        raise
+
+
+@app.get("/items/{item_id}")
+def get_item(item_id: str, username: str = Depends(get_username)):
+    if item_id == "portal-gun":
+        raise InternalError(
+            f"The portal gun is too dangerous to be owned by {username}"
+        )
+    if item_id != "plumbus":
+        raise HTTPException(
+            status_code=404, detail="Item not found, there's only a plumbus here"
+        )
+    return item_id
diff --git a/docs_src/dependencies/tutorial008d_an.py b/docs_src/dependencies/tutorial008d_an.py
new file mode 100644
index 000000000..c35424574
--- /dev/null
+++ b/docs_src/dependencies/tutorial008d_an.py
@@ -0,0 +1,29 @@
+from fastapi import Depends, FastAPI, HTTPException
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class InternalError(Exception):
+    pass
+
+
+def get_username():
+    try:
+        yield "Rick"
+    except InternalError:
+        print("We don't swallow the internal error here, we raise again 😎")
+        raise
+
+
+@app.get("/items/{item_id}")
+def get_item(item_id: str, username: Annotated[str, Depends(get_username)]):
+    if item_id == "portal-gun":
+        raise InternalError(
+            f"The portal gun is too dangerous to be owned by {username}"
+        )
+    if item_id != "plumbus":
+        raise HTTPException(
+            status_code=404, detail="Item not found, there's only a plumbus here"
+        )
+    return item_id
diff --git a/docs_src/dependencies/tutorial008d_an_py39.py b/docs_src/dependencies/tutorial008d_an_py39.py
new file mode 100644
index 000000000..99bd5cb91
--- /dev/null
+++ b/docs_src/dependencies/tutorial008d_an_py39.py
@@ -0,0 +1,30 @@
+from typing import Annotated
+
+from fastapi import Depends, FastAPI, HTTPException
+
+app = FastAPI()
+
+
+class InternalError(Exception):
+    pass
+
+
+def get_username():
+    try:
+        yield "Rick"
+    except InternalError:
+        print("We don't swallow the internal error here, we raise again 😎")
+        raise
+
+
+@app.get("/items/{item_id}")
+def get_item(item_id: str, username: Annotated[str, Depends(get_username)]):
+    if item_id == "portal-gun":
+        raise InternalError(
+            f"The portal gun is too dangerous to be owned by {username}"
+        )
+    if item_id != "plumbus":
+        raise HTTPException(
+            status_code=404, detail="Item not found, there's only a plumbus here"
+        )
+    return item_id
diff --git a/fastapi/routing.py b/fastapi/routing.py
index acebabfca..23a32d15f 100644
--- a/fastapi/routing.py
+++ b/fastapi/routing.py
@@ -216,19 +216,14 @@ def get_request_handler(
         actual_response_class = response_class
 
     async def app(request: Request) -> Response:
-        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
+        async with AsyncExitStack() as file_stack:
             try:
                 body: Any = None
                 if body_field:
                     if is_body_form:
                         body = await request.form()
-                        async_exit_stack.push_async_callback(body.close)
+                        file_stack.push_async_callback(body.close)
                     else:
                         body_bytes = await request.body()
                         if body_bytes:
@@ -260,18 +255,17 @@ def get_request_handler(
                     ],
                     body=e.doc,
                 )
-                exception_to_reraise = validation_error
                 raise validation_error from e
-            except HTTPException as e:
-                exception_to_reraise = e
+            except HTTPException:
+                # If a middleware raises an HTTPException, it should be raised again
                 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:
+            errors: List[Any] = []
+            async with AsyncExitStack() as async_exit_stack:
                 solved_result = await solve_dependencies(
                     request=request,
                     dependant=dependant,
@@ -280,59 +274,53 @@ def get_request_handler(
                     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 not errors:
+                    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
+                        response = raw_response
+                    else:
+                        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)
             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:
-                    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"
+        if response is None:
+            raise FastAPIError(
+                "No response object was returned. There's a high chance that the "
+                "application code is raising an exception and a dependency with yield "
+                "has a block with a bare except, or a block with except Exception, "
+                "and is not raising the exception again. Read more about it in the "
+                "docs: https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-with-yield/#dependencies-with-yield-and-except"
+            )
         return response
 
     return app
diff --git a/tests/test_dependency_contextmanager.py b/tests/test_dependency_contextmanager.py
index b07f9aa5b..008dab7bc 100644
--- a/tests/test_dependency_contextmanager.py
+++ b/tests/test_dependency_contextmanager.py
@@ -55,6 +55,7 @@ async def asyncgen_state_try(state: Dict[str, str] = Depends(get_state)):
         yield state["/async_raise"]
     except AsyncDependencyError:
         errors.append("/async_raise")
+        raise
     finally:
         state["/async_raise"] = "asyncgen raise finalized"
 
@@ -65,6 +66,7 @@ def generator_state_try(state: Dict[str, str] = Depends(get_state)):
         yield state["/sync_raise"]
     except SyncDependencyError:
         errors.append("/sync_raise")
+        raise
     finally:
         state["/sync_raise"] = "generator raise finalized"
 
diff --git a/tests/test_dependency_normal_exceptions.py b/tests/test_dependency_normal_exceptions.py
index 23c366d5d..326f8fd88 100644
--- a/tests/test_dependency_normal_exceptions.py
+++ b/tests/test_dependency_normal_exceptions.py
@@ -20,6 +20,7 @@ async def get_database():
         fake_database.update(temp_database)
     except HTTPException:
         state["except"] = True
+        raise
     finally:
         state["finally"] = True
 
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 7f51fc52a..7d24809a8 100644
--- a/tests/test_tutorial/test_dependencies/test_tutorial008b_an_py39.py
+++ b/tests/test_tutorial/test_dependencies/test_tutorial008b_an_py39.py
@@ -1,23 +1,33 @@
+import pytest
 from fastapi.testclient import TestClient
 
-from docs_src.dependencies.tutorial008b_an import app
-
-client = TestClient(app)
+from ...utils import needs_py39
 
 
-def test_get_no_item():
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.dependencies.tutorial008b_an_py39 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_py39
+def test_get_no_item(client: TestClient):
     response = client.get("/items/foo")
     assert response.status_code == 404, response.text
     assert response.json() == {"detail": "Item not found"}
 
 
-def test_owner_error():
+@needs_py39
+def test_owner_error(client: TestClient):
     response = client.get("/items/plumbus")
     assert response.status_code == 400, response.text
     assert response.json() == {"detail": "Owner error: Rick"}
 
 
-def test_get_item():
+@needs_py39
+def test_get_item(client: TestClient):
     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_tutorial008c.py b/tests/test_tutorial/test_dependencies/test_tutorial008c.py
new file mode 100644
index 000000000..27be8895a
--- /dev/null
+++ b/tests/test_tutorial/test_dependencies/test_tutorial008c.py
@@ -0,0 +1,38 @@
+import pytest
+from fastapi.exceptions import FastAPIError
+from fastapi.testclient import TestClient
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.dependencies.tutorial008c import app
+
+    client = TestClient(app)
+    return client
+
+
+def test_get_no_item(client: TestClient):
+    response = client.get("/items/foo")
+    assert response.status_code == 404, response.text
+    assert response.json() == {"detail": "Item not found, there's only a plumbus here"}
+
+
+def test_get(client: TestClient):
+    response = client.get("/items/plumbus")
+    assert response.status_code == 200, response.text
+    assert response.json() == "plumbus"
+
+
+def test_fastapi_error(client: TestClient):
+    with pytest.raises(FastAPIError) as exc_info:
+        client.get("/items/portal-gun")
+    assert "No response object was returned" in exc_info.value.args[0]
+
+
+def test_internal_server_error():
+    from docs_src.dependencies.tutorial008c import app
+
+    client = TestClient(app, raise_server_exceptions=False)
+    response = client.get("/items/portal-gun")
+    assert response.status_code == 500, response.text
+    assert response.text == "Internal Server Error"
diff --git a/tests/test_tutorial/test_dependencies/test_tutorial008c_an.py b/tests/test_tutorial/test_dependencies/test_tutorial008c_an.py
new file mode 100644
index 000000000..10fa1ab50
--- /dev/null
+++ b/tests/test_tutorial/test_dependencies/test_tutorial008c_an.py
@@ -0,0 +1,38 @@
+import pytest
+from fastapi.exceptions import FastAPIError
+from fastapi.testclient import TestClient
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.dependencies.tutorial008c_an import app
+
+    client = TestClient(app)
+    return client
+
+
+def test_get_no_item(client: TestClient):
+    response = client.get("/items/foo")
+    assert response.status_code == 404, response.text
+    assert response.json() == {"detail": "Item not found, there's only a plumbus here"}
+
+
+def test_get(client: TestClient):
+    response = client.get("/items/plumbus")
+    assert response.status_code == 200, response.text
+    assert response.json() == "plumbus"
+
+
+def test_fastapi_error(client: TestClient):
+    with pytest.raises(FastAPIError) as exc_info:
+        client.get("/items/portal-gun")
+    assert "No response object was returned" in exc_info.value.args[0]
+
+
+def test_internal_server_error():
+    from docs_src.dependencies.tutorial008c_an import app
+
+    client = TestClient(app, raise_server_exceptions=False)
+    response = client.get("/items/portal-gun")
+    assert response.status_code == 500, response.text
+    assert response.text == "Internal Server Error"
diff --git a/tests/test_tutorial/test_dependencies/test_tutorial008c_an_py39.py b/tests/test_tutorial/test_dependencies/test_tutorial008c_an_py39.py
new file mode 100644
index 000000000..6c3acff50
--- /dev/null
+++ b/tests/test_tutorial/test_dependencies/test_tutorial008c_an_py39.py
@@ -0,0 +1,44 @@
+import pytest
+from fastapi.exceptions import FastAPIError
+from fastapi.testclient import TestClient
+
+from ...utils import needs_py39
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.dependencies.tutorial008c_an_py39 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_py39
+def test_get_no_item(client: TestClient):
+    response = client.get("/items/foo")
+    assert response.status_code == 404, response.text
+    assert response.json() == {"detail": "Item not found, there's only a plumbus here"}
+
+
+@needs_py39
+def test_get(client: TestClient):
+    response = client.get("/items/plumbus")
+    assert response.status_code == 200, response.text
+    assert response.json() == "plumbus"
+
+
+@needs_py39
+def test_fastapi_error(client: TestClient):
+    with pytest.raises(FastAPIError) as exc_info:
+        client.get("/items/portal-gun")
+    assert "No response object was returned" in exc_info.value.args[0]
+
+
+@needs_py39
+def test_internal_server_error():
+    from docs_src.dependencies.tutorial008c_an_py39 import app
+
+    client = TestClient(app, raise_server_exceptions=False)
+    response = client.get("/items/portal-gun")
+    assert response.status_code == 500, response.text
+    assert response.text == "Internal Server Error"
diff --git a/tests/test_tutorial/test_dependencies/test_tutorial008d.py b/tests/test_tutorial/test_dependencies/test_tutorial008d.py
new file mode 100644
index 000000000..043496112
--- /dev/null
+++ b/tests/test_tutorial/test_dependencies/test_tutorial008d.py
@@ -0,0 +1,41 @@
+import pytest
+from fastapi.testclient import TestClient
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.dependencies.tutorial008d import app
+
+    client = TestClient(app)
+    return client
+
+
+def test_get_no_item(client: TestClient):
+    response = client.get("/items/foo")
+    assert response.status_code == 404, response.text
+    assert response.json() == {"detail": "Item not found, there's only a plumbus here"}
+
+
+def test_get(client: TestClient):
+    response = client.get("/items/plumbus")
+    assert response.status_code == 200, response.text
+    assert response.json() == "plumbus"
+
+
+def test_internal_error(client: TestClient):
+    from docs_src.dependencies.tutorial008d import InternalError
+
+    with pytest.raises(InternalError) as exc_info:
+        client.get("/items/portal-gun")
+    assert (
+        exc_info.value.args[0] == "The portal gun is too dangerous to be owned by Rick"
+    )
+
+
+def test_internal_server_error():
+    from docs_src.dependencies.tutorial008d import app
+
+    client = TestClient(app, raise_server_exceptions=False)
+    response = client.get("/items/portal-gun")
+    assert response.status_code == 500, response.text
+    assert response.text == "Internal Server Error"
diff --git a/tests/test_tutorial/test_dependencies/test_tutorial008d_an.py b/tests/test_tutorial/test_dependencies/test_tutorial008d_an.py
new file mode 100644
index 000000000..f29d8cdbe
--- /dev/null
+++ b/tests/test_tutorial/test_dependencies/test_tutorial008d_an.py
@@ -0,0 +1,41 @@
+import pytest
+from fastapi.testclient import TestClient
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.dependencies.tutorial008d_an import app
+
+    client = TestClient(app)
+    return client
+
+
+def test_get_no_item(client: TestClient):
+    response = client.get("/items/foo")
+    assert response.status_code == 404, response.text
+    assert response.json() == {"detail": "Item not found, there's only a plumbus here"}
+
+
+def test_get(client: TestClient):
+    response = client.get("/items/plumbus")
+    assert response.status_code == 200, response.text
+    assert response.json() == "plumbus"
+
+
+def test_internal_error(client: TestClient):
+    from docs_src.dependencies.tutorial008d_an import InternalError
+
+    with pytest.raises(InternalError) as exc_info:
+        client.get("/items/portal-gun")
+    assert (
+        exc_info.value.args[0] == "The portal gun is too dangerous to be owned by Rick"
+    )
+
+
+def test_internal_server_error():
+    from docs_src.dependencies.tutorial008d_an import app
+
+    client = TestClient(app, raise_server_exceptions=False)
+    response = client.get("/items/portal-gun")
+    assert response.status_code == 500, response.text
+    assert response.text == "Internal Server Error"
diff --git a/tests/test_tutorial/test_dependencies/test_tutorial008d_an_py39.py b/tests/test_tutorial/test_dependencies/test_tutorial008d_an_py39.py
new file mode 100644
index 000000000..0a585f4ad
--- /dev/null
+++ b/tests/test_tutorial/test_dependencies/test_tutorial008d_an_py39.py
@@ -0,0 +1,47 @@
+import pytest
+from fastapi.testclient import TestClient
+
+from ...utils import needs_py39
+
+
+@pytest.fixture(name="client")
+def get_client():
+    from docs_src.dependencies.tutorial008d_an_py39 import app
+
+    client = TestClient(app)
+    return client
+
+
+@needs_py39
+def test_get_no_item(client: TestClient):
+    response = client.get("/items/foo")
+    assert response.status_code == 404, response.text
+    assert response.json() == {"detail": "Item not found, there's only a plumbus here"}
+
+
+@needs_py39
+def test_get(client: TestClient):
+    response = client.get("/items/plumbus")
+    assert response.status_code == 200, response.text
+    assert response.json() == "plumbus"
+
+
+@needs_py39
+def test_internal_error(client: TestClient):
+    from docs_src.dependencies.tutorial008d_an_py39 import InternalError
+
+    with pytest.raises(InternalError) as exc_info:
+        client.get("/items/portal-gun")
+    assert (
+        exc_info.value.args[0] == "The portal gun is too dangerous to be owned by Rick"
+    )
+
+
+@needs_py39
+def test_internal_server_error():
+    from docs_src.dependencies.tutorial008d_an_py39 import app
+
+    client = TestClient(app, raise_server_exceptions=False)
+    response = client.get("/items/portal-gun")
+    assert response.status_code == 500, response.text
+    assert response.text == "Internal Server Error"

From b6b0f2a7e6690b923957677807c5c6a4ff556422 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sat, 24 Feb 2024 23:06:56 +0000
Subject: [PATCH 63/70] =?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 e595ed927..2e8930ea3 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Breaking Changes
+
+* 🐛 Fix unhandled growing memory for internal server errors, refactor dependencies with `yield` and `except` to require raising again as in regular Python. PR [#11191](https://github.com/tiangolo/fastapi/pull/11191) by [@tiangolo](https://github.com/tiangolo).
+
 ### Docs
 
 * ✏️ Fix minor typos in `docs/ko/docs/`. PR [#11126](https://github.com/tiangolo/fastapi/pull/11126) by [@KaniKim](https://github.com/KaniKim).

From 32b56a8d08aece04d55331142a18f7b2ce580fa7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sun, 25 Feb 2024 00:18:13 +0100
Subject: [PATCH 64/70] =?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 | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/docs/en/docs/release-notes.md b/docs/en/docs/release-notes.md
index 2e8930ea3..c442f1449 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -10,6 +10,29 @@ hide:
 ### Breaking Changes
 
 * 🐛 Fix unhandled growing memory for internal server errors, refactor dependencies with `yield` and `except` to require raising again as in regular Python. PR [#11191](https://github.com/tiangolo/fastapi/pull/11191) by [@tiangolo](https://github.com/tiangolo).
+    * This is a breaking change (and only slightly) if you used dependencies with `yield`, used `except` in those dependencies, and didn't raise again.
+    * This was reported internally by [@rushilsrivastava](https://github.com/rushilsrivastava) as a memory leak when the server had unhandled exceptions that would produce internal server errors, the memory allocated before that point would not be released.
+    * Read the new docs: [Dependencies with `yield` and `except`](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-with-yield/#dependencies-with-yield-and-except).
+
+In short, if you had dependencies that looked like:
+
+```Python
+def my_dep():
+    try:
+        yield
+    except SomeException:
+        pass
+```
+
+Now you need to make sure you raise again after `except`, just as you would in regular Python:
+
+```Python
+def my_dep():
+    try:
+        yield
+    except SomeException:
+        raise
+```
 
 ### Docs
 

From e40747f10ae911910e9cb9a9684576f3b21304c9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Sun, 25 Feb 2024 00:19:38 +0100
Subject: [PATCH 65/70] =?UTF-8?q?=F0=9F=94=96=20Release=20version=200.110.?=
 =?UTF-8?q?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 c442f1449..e01c3544f 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,8 @@ hide:
 
 ## Latest Changes
 
+## 0.110.0
+
 ### Breaking Changes
 
 * 🐛 Fix unhandled growing memory for internal server errors, refactor dependencies with `yield` and `except` to require raising again as in regular Python. PR [#11191](https://github.com/tiangolo/fastapi/pull/11191) by [@tiangolo](https://github.com/tiangolo).
diff --git a/fastapi/__init__.py b/fastapi/__init__.py
index 3458b9e5b..234969256 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.109.2"
+__version__ = "0.110.0"
 
 from starlette import status as status
 

From 937378ff054fb760ace3779134b3d6211b825534 Mon Sep 17 00:00:00 2001
From: Vusal Abdullayev <vusal.abdullayev@khazar.org>
Date: Sun, 25 Feb 2024 18:25:12 +0400
Subject: [PATCH 66/70] =?UTF-8?q?=F0=9F=8C=90=20Add=20Azerbaijani=20transl?=
 =?UTF-8?q?ation=20for=20`docs/az/learn/index.md`=20(#11192)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/az/learn/index.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 docs/az/learn/index.md

diff --git a/docs/az/learn/index.md b/docs/az/learn/index.md
new file mode 100644
index 000000000..cc32108bf
--- /dev/null
+++ b/docs/az/learn/index.md
@@ -0,0 +1,5 @@
+# Öyrən
+
+Burada **FastAPI** öyrənmək üçün giriş bölmələri və dərsliklər yer alır.
+
+Siz bunu kitab, kurs, FastAPI öyrənmək üçün rəsmi və tövsiyə olunan üsul hesab edə bilərsiniz. 😎

From 7ef0b08897afa0972c7e8418d05a0ad654e45996 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Sun, 25 Feb 2024 14:25:31 +0000
Subject: [PATCH 67/70] =?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 e01c3544f..2d5ab2d9c 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -7,6 +7,10 @@ hide:
 
 ## Latest Changes
 
+### Translations
+
+* 🌐 Add Azerbaijani translation for `docs/az/learn/index.md`. PR [#11192](https://github.com/tiangolo/fastapi/pull/11192) by [@vusallyv](https://github.com/vusallyv).
+
 ## 0.110.0
 
 ### Breaking Changes

From c4c70fd7927dbd7d23894f1a69d42457fb7cadbc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Tue, 27 Feb 2024 12:18:27 +0100
Subject: [PATCH 68/70] =?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 2d5ab2d9c..12f8ffd8a 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -324,7 +324,7 @@ Read more in the [advisory: Content-Type Header ReDoS](https://github.com/tiango
 
 ### 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).
+* ⬆️ Upgrade Starlette to `>=0.29.0,<0.33.0`, update docs and usage of templates with new Starlette arguments. Remove pin of AnyIO `>=3.7.1,<4.0.0`, add support for AnyIO 4.x.x. PR [#10846](https://github.com/tiangolo/fastapi/pull/10846) by [@tiangolo](https://github.com/tiangolo).
 
 ## 0.107.0
 

From c0ad1ebabdb9e26b94c0e574c41bd6869e124bff Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= <tiangolo@gmail.com>
Date: Wed, 28 Feb 2024 15:04:08 +0100
Subject: [PATCH 69/70] =?UTF-8?q?=F0=9F=94=A7=20Update=20sponsors,=20remov?=
 =?UTF-8?q?e=20Jina,=20remove=20Powens,=20move=20TestDriven.io=20(#11213)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                 |  2 --
 docs/en/data/sponsors.yml | 12 +++---------
 2 files changed, 3 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index 874abf8c6..8d3e4c68d 100644
--- a/README.md
+++ b/README.md
@@ -55,9 +55,7 @@ The key features are:
 <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.withcoherence.com/?utm_medium=advertising&utm_source=fastapi&utm_campaign=banner%20january%2024" target="_blank" title="Coherence"><img src="https://fastapi.tiangolo.com/img/sponsors/coherence.png"></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-v2.jpg"></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>
 <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://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>
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
index fd8518ce3..8401fd33e 100644
--- a/docs/en/data/sponsors.yml
+++ b/docs/en/data/sponsors.yml
@@ -27,15 +27,9 @@ silver:
   - url: https://training.talkpython.fm/fastapi-courses
     title: FastAPI video courses on demand from people you trust
     img: https://fastapi.tiangolo.com/img/sponsors/talkpython-v2.jpg
-  - url: https://testdriven.io/courses/tdd-fastapi/
-    title: Learn to build high-quality web apps with best practices
-    img: https://fastapi.tiangolo.com/img/sponsors/testdriven.svg
   - url: https://github.com/deepset-ai/haystack/
     title: Build powerful search from composable, open source building blocks
     img: https://fastapi.tiangolo.com/img/sponsors/haystack-fastapi.svg
-  - url: https://careers.powens.com/
-    title: Powens is hiring!
-    img: https://fastapi.tiangolo.com/img/sponsors/powens.png
   - url: https://databento.com/
     title: Pay as you go for market data
     img: https://fastapi.tiangolo.com/img/sponsors/databento.svg
@@ -52,6 +46,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://bit.ly/3JJ7y5C
-    title: Build cross-modal and multimodal applications on the cloud
-    img: https://fastapi.tiangolo.com/img/sponsors/jina2.svg
+  - url: https://testdriven.io/courses/tdd-fastapi/
+    title: Learn to build high-quality web apps with best practices
+    img: https://fastapi.tiangolo.com/img/sponsors/testdriven.svg

From eef1b7d51530be64ddd48e02b5ca46f28a0ebfc1 Mon Sep 17 00:00:00 2001
From: github-actions <github-actions@github.com>
Date: Wed, 28 Feb 2024 14:04:27 +0000
Subject: [PATCH 70/70] =?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 12f8ffd8a..ad548327d 100644
--- a/docs/en/docs/release-notes.md
+++ b/docs/en/docs/release-notes.md
@@ -11,6 +11,10 @@ hide:
 
 * 🌐 Add Azerbaijani translation for `docs/az/learn/index.md`. PR [#11192](https://github.com/tiangolo/fastapi/pull/11192) by [@vusallyv](https://github.com/vusallyv).
 
+### Internal
+
+* 🔧 Update sponsors, remove Jina, remove Powens, move TestDriven.io. PR [#11213](https://github.com/tiangolo/fastapi/pull/11213) by [@tiangolo](https://github.com/tiangolo).
+
 ## 0.110.0
 
 ### Breaking Changes